Esta guía explica cómo integrar los datos del registro mercantil colombiano a su sistema: una llamada por NIT, un objeto JSON con estado y actividad, y una descripción franca de lo que el registro abierto no contiene.
El Registro Único Empresarial y Social (RUES) reúne en una sola plataforma los registros públicos que llevan las cámaras de comercio (el mercantil, el de entidades sin ánimo de lucro y el de proponentes), y Confecámaras opera la plataforma. Prometiam sirve solo las sociedades del registro mercantil. Quien busca una "API del RUES" suele querer lo mismo: pasar un NIT y recibir datos estructurados. El portal del RUES es una página para personas, no una API para programas, y Confecámaras publica además un extracto en el portal de datos abiertos del Gobierno de Colombia. Prometiam parte de ese extracto, lo normaliza y lo sirve en el formato común de la API.
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. No es una consulta en vivo a cada cámara de comercio, y no es un servicio oficial de Confecámaras.
GET /companies/search?country=CO&company_number=900843898-9 busca por NIT. El dígito de verificación es opcional; si lo escribe, se valida.GET /companies/search?country=CO&name=rappi busca por nombre, con coincidencia parcial normalizada.GET /companies/{id} devuelve el registro completo con el id que entregó la búsqueda.POST /monitor con {"company_id": ..., "country": "CO"} avisa por webhook de los cambios.curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=CO&company_number=900843898-9' \ -H 'Authorization: Bearer rk_live_...'
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'CO', 'company_number': '900843898-9'})
empresa = r.json()['data'][0]
print(empresa['company_name'], empresa['status'], empresa['registry_details']['last_renewal_year'])
El NIT de una sociedad tiene nueve dígitos y empieza por 8 o 9, más un dígito de verificación (DV) que se escribe tras un guion. La API acepta 900843898-9, 900843898 y la forma de diez dígitos 9008438989, y rechaza con un 400 validation_error un DV equivocado, un número que empieza por 1 a 7 (que suele ser una cédula) o cualquier cosa que no sea un NIT. El cálculo del DV está explicado en la herramienta de consulta de NIT.
| Campo | Uso |
|---|---|
company_name | Comparar la razón social con la del contrato o la factura |
status, local_status | Saber si la sociedad está activa, cancelada, en liquidación o en reorganización |
legal_form | Tipo de sociedad (S.A.S., Ltda., S.A. ...) |
founding_date | Fecha de la primera matrícula del NIT |
activity_code | CIIU Rev. 4 A.C. |
registry_details.last_renewal_year | Detectar matrículas sin renovar |
registry_details.chamber | Cámara de comercio de la matrícula |
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.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.