La DIAN regula la factura electrónica de venta, y cada factura se valida antes de expedirse. Esta guía trata de una comprobación anterior y complementaria: que el NIT del cliente corresponda a una sociedad que existe y está activa en el registro mercantil.
En Colombia, la factura electrónica de venta se rige hoy por la Resolución 000165 de 2023 de la DIAN, que sustituyó las reglas de la Resolución 000042 de 2020 sobre los obligados a facturar y los requisitos de la factura. La norma define quiénes están obligados a facturar electrónicamente (artículos 7 y 9), la habilitación y la validación previa: la factura se valida, antes de su expedición, por la DIAN o por un proveedor tecnológico autorizado, y se entiende expedida cuando se valida y se entrega al adquirente. Los requisitos de habilitación y las fechas aplicables a cada contribuyente están en el sitio de la DIAN; esta página no es asesoría legal, y conviene confirmar con la DIAN o con su contador.
Esta página no trata de la habilitación ni de la validación de la DIAN, y la API de Prometiam no está habilitada ni certificada por la DIAN, no emite facturas y no consulta el RUT. Lo que hace es otra cosa, previa a la emisión: comprobar contra el registro mercantil que la contraparte es una sociedad real y activa.
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
def cliente_ok(nit: str) -> dict:
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'CO', 'company_number': nit})
if r.status_code == 400:
return {'ok': False, 'motivo': 'NIT o dígito de verificación inválido'}
datos = r.json().get('data', [])
if not datos:
return {'ok': False, 'motivo': 'no es una sociedad del registro mercantil'}
s = datos[0]
return {'ok': s['status'] == 'active', 'razon_social': s['company_name'], 'estado': s['local_status']}
La respuesta incluye company_name, status y local_status. Guarde la razón social del registro junto con la del cliente: así detecta cuando el nombre de la factura no coincide con el que figura en el registro.
| Pregunta | Respuesta de la API |
|---|---|
| ¿El NIT es consistente? | Sí, el dígito de verificación se valida |
| ¿Existe la sociedad en el registro mercantil? | Sí, si devuelve un resultado |
| ¿Está activa? | status y local_status, con el último año de renovación |
| ¿Es facturador electrónico habilitado? | No; eso lo informa la DIAN |
| ¿Cuál es su responsabilidad tributaria o su régimen? | No; eso está en el RUT |
| ¿Cuál es su dirección? | No; el registro abierto no la publica |
La matrícula mercantil debe renovarse cada año, dentro de los tres primeros meses (Código de Comercio, art. 33). Un estado activo no garantiza que la matrícula esté al día: el registro mantiene como activa una sociedad que dejó de renovar. registry_details.last_renewal_year indica el último año de renovación.
vat= se rechaza.CO-CIIU-REV4-AC), de 4 dígitos, no la NACE.Los datos provienen del extracto del RUES en el portal de datos abiertos de Colombia, se actualizan cada día hábil y la fecha de la fuente está en data_as_of.
La prueba gratuita dura 14 días e incluye 500 créditos; se requiere una tarjeta, pero no se cobra nada durante la prueba. Después, el plan Starter cuesta € 9,99 al mes con 1.000 créditos, el Professional € 29,99 con 10.000 y el Scale € 99,99 con 50.000; el Enterprise tiene un precio a la medida. Consultar el registro de una empresa cuesta 1 crédito, unos € 0,01 en Starter y desde € 0,002 en Scale. Los precios son públicos y el plan anual incluye dos meses sin costo.
Contains data from Confecámaras (Registro Único Empresarial y Social, RUES), via the Portal de Datos Abiertos www.datos.gov.co, licensed CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/). Modified by Prometiam; the Colombian records are offered under CC BY-SA 4.0. Los registros colombianos se ofrecen bajo la licencia CC BY-SA 4.0 (con compartir igual): puede copiarlos, reutilizarlos y redistribuirlos, también con fines comerciales, citando la fuente y manteniendo la misma licencia.
Empezar la prueba gratuita de 14 días · Documentación de la API
La prueba dura 14 días e incluye 500 créditos. Se requiere una tarjeta; durante la prueba no se cobra nada y después se aplica el plan Starter (9,99 € al mes), salvo que cancele.