Validar el NIT de un proveedor antes de pagar

Antes de dar de alta a un proveedor o de pagar una factura, confirme por API que el NIT corresponde a una sociedad existente, que está activa y que su matrícula mercantil sigue renovada.

El problema: el alta se hace con prisa

En compras y en cuentas por pagar, el alta del proveedor suele hacerse con el RUT y un correo del vendedor. Los errores que aparecen después son los mismos: un NIT con un dígito de verificación cambiado, una sociedad cancelada o en liquidación, una razón social que no coincide con el contrato, una matrícula que no se renueva desde hace años. Cada error causa reprocesos, y algunos pueden tener consecuencias tributarias o contractuales que conviene revisar con su asesor.

Esta guía muestra una verificación corta, que se puede ejecutar en el alta y repetir cada cierto tiempo. No consulta la DIAN ni el RUT, y no dice nada del cumplimiento tributario de la empresa: responde a una pregunta previa, ¿existe esta sociedad en el registro mercantil y en qué situación está?

Cómo funciona con la API

• GET /companies/search?country=CO&company_number=<NIT> devuelve la sociedad, o una lista vacía.
• Compruebe el NIT antes de llamar: la herramienta de consulta de NIT muestra la regla del dígito de verificación, y la API responde 400 si no coincide.
• Si solo tiene el nombre, use name= y confirme el NIT con el proveedor.
• POST /monitor avisa por webhook si la sociedad cambia de estado después del alta.

import requests

BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
ANIO = 2026  # año en curso

def proveedor_ok(nit: str, razon_del_contrato: str) -> str:
    r = requests.get(f'{BASE}/companies/search', headers=H,
                     params={'country': 'CO', 'company_number': nit})
    if r.status_code == 400:
        return 'NIT inválido'
    datos = r.json().get('data', [])
    if not datos:
        return 'no encontrado: puede ser persona natural o entidad sin ánimo de lucro'
    s = datos[0]
    if s['status'] != 'active':
        return f"revisar: {s['local_status']}"
    if ANIO - int(s['registry_details']['last_renewal_year'] or 0) > 1:
        return 'activa, pero sin renovar hace más de un año'
    if s['company_name'].upper() != razon_del_contrato.upper():
        return 'razón social distinta de la del contrato'
    return 'ok'

Qué revisar de cada proveedor

Verificación	Dónde se ve
El NIT existe	Un resultado en company_number
La sociedad está activa	status y local_status
La razón social coincide con el contrato	company_name
La matrícula está renovada	registry_details.last_renewal_year
No está en liquidación ni en reorganización	status y local_status
El tipo de sociedad es el esperado	legal_form
La actividad económica registrada	activity_code (CIIU Rev. 4 A.C.)

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.

Cuando el NIT no devuelve nada

Un NIT válido sin resultado no prueba que el proveedor no exista. Solo se sirven las sociedades del registro mercantil: una persona natural, una fundación o una cooperativa no aparece, y tampoco una agencia o un establecimiento de comercio. En esos casos la verificación debe hacerse en la cámara de comercio o con la DIAN.

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. Para un pago de alto valor, pida además un certificado de existencia y representación legal reciente (vea la diferencia con la API).

Qué no entrega la API

• Solo sociedades del registro mercantil: S.A.S., Ltda., S.A., en comandita, colectivas, empresas unipersonales y sucursales de sociedades extranjeras. Las personas naturales, las entidades sin ánimo de lucro, las cooperativas y las entidades públicas nunca se sirven.
• Sin dirección (solo la región, es decir, el departamento de la cámara de comercio), sin representantes legales ni accionistas, sin capital social, sin datos de contacto y sin descripción de la actividad.
• Sin número de IVA: Colombia no tiene un número de IVA público ligado al NIT y una búsqueda con vat= se rechaza.
• Sin avisos de insolvencia: Colombia no es uno de los doce mercados de insolvencia. El registro no tiene un estado de liquidación; la liquidación, la liquidación judicial y la reorganización se leen del nombre de la sociedad y se sirven como estado.
• La actividad es la CIIU Rev. 4 adaptada para Colombia (CO-CIIU-REV4-AC), de 4 dígitos, no la NACE.
• Un registro por NIT, aunque la sociedad tenga matrículas en varias cámaras de comercio.

Qué plan sirve

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.

Páginas relacionadas

• Colombia en Prometiam
• Consulta de NIT
• API del RUES por NIT
• Factura electrónica y validación del NIT
• Diligencia de proveedores (inglés)
• Precios

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.