Toda empresa que vende, contrata o se relaciona con otras empresas en Brasil necesita, en algún momento, verificar quién está del otro lado. El CNPJ — Cadastro Nacional da Pessoa Jurídica, el registro fiscal de las empresas en Brasil — es el documento clave para eso. Pero hay una diferencia enorme entre consultar CNPJ manualmente, uno por uno en el sitio de la Receita Federal (la autoridad tributaria federal de Brasil), y automatizar ese proceso vía API dentro de su sistema.
En esta guía explicamos cómo funciona cada enfoque, por qué la consulta manual no escala y cómo usar una API de consulta de CNPJ para automatizar validaciones de forma confiable. Si usted lidera una operación que hace KYB (Know Your Business), onboarding de proveedores, análisis de crédito de empresas o prevención de fraudes, este contenido es para usted.
Qué es la consulta de CNPJ en la Receita Federal
El CNPJ es emitido y mantenido por la Receita Federal do Brasil (RFB). Cada número identifica a una persona jurídica y está vinculado a un conjunto de información registral: razón social, nombre de fantasía, fecha de apertura, naturaleza jurídica, tamaño de la empresa, actividad económica (CNAE, el clasificador brasileño de actividades económicas), dirección, cuadro de socios y administradores (QSA), opción por el Simples Nacional (el régimen tributario simplificado brasileño) y — quizás el campo más importante para decidir — la situación registral, que puede ser Activa, Suspendida, No Apta, Dada de Baja o Nula.
La Receita ofrece una consulta pública en el Comprovante de Inscrição e de Situação Cadastral. El proceso es simple: usted informa el número del CNPJ, resuelve un captcha y recibe un comprobante con los datos registrales de la empresa.
Esa consulta es gratuita y funciona bien para verificaciones puntuales — revisar el registro de un único proveedor antes de cerrar un contrato, por ejemplo. Pero cuando la necesidad es empresarial y recurrente, los problemas aparecen rápido.
Por qué la consulta manual no escala
En la práctica, quien intenta usar la consulta manual de la Receita Federal como parte de un proceso de negocio se topa con limitaciones estructurales.
Captcha obligatorio. Toda consulta exige resolver un captcha, lo que impide la automatización directa y obliga a la intervención humana en cada verificación.
Una consulta a la vez. No hay funcionalidad de lote. Validar 300 CNPJ de nuevos proveedores en un día significa 300 accesos manuales, 300 captchas y 300 copias de resultados.
Sin integración con sistemas. El resultado es una página HTML — un comprobante visual. No existe un retorno estructurado que su sistema pueda procesar automáticamente para aprobar o rechazar un registro.
Sin disponibilidad garantizada. El sitio de la Receita no tiene SLA para uso externo. Puede estar caído o lento en horas pico, sin previsibilidad.
Sin log ni trazabilidad. La consulta manual no genera un registro estandarizado. En una auditoría o disputa, reconstruir el historial de verificaciones es trabajoso y propenso a fallas.
Para cualquier operación que valide más de un puñado de CNPJ por día, la consulta manual es un cuello de botella operativo.
Qué cambia con la consulta de CNPJ por API
Una API de consulta de CNPJ hace la misma verificación que la consulta manual, pero de forma programática. Su sistema envía el número del CNPJ y recibe, en milisegundos, una respuesta estructurada con los datos registrales, el cuadro societario y la situación del documento — máquina a máquina, sin captcha y sin copiar y pegar entre pantallas.
Con ese retorno estructurado, su sistema decide automáticamente: aprueba el registro si la empresa está Activa, lo bloquea si está Dada de Baja o No Apta, o lo deriva a revisión humana si hay divergencia en la razón social. Los campos de QSA permiten cruzar quiénes son los socios, y los datos de tamaño y CNAE ayudan a segmentar al cliente o calibrar límites de crédito.
En la práctica, integrar es simple: una solicitud HTTP autenticada con su clave de API devuelve todo en JSON. Los ejemplos completos de solicitud y respuesta — en cURL, Python, Node.js y otros lenguajes — están en la documentación de FonteData, listos para copiar y adaptar.
Validación del dígito verificador vs. consulta oficial: no las confunda
Un error común es creer que validar el CNPJ significa solamente comprobar que los dígitos verificadores sean correctos. El algoritmo mod-11 sirve para eliminar errores de tipeo — responde a la pregunta "¿este número es matemáticamente posible?". Pero no dice si el CNPJ existe de verdad, si la empresa está activa, cuál es la situación registral actual ni quiénes son los socios. Los defraudadores generan CNPJ válidos según el mod-11 a escala, porque el cálculo es público.
La consulta vía API resuelve el segundo problema: va a la fuente oficial y confirma existencia y situación. En una buena arquitectura, las dos etapas trabajan juntas — el dígito verificador en el front-end, para feedback inmediato, y la consulta oficial en el back-end, antes de habilitar cualquier acción sensible como la activación de una cuenta, la aprobación de crédito o la liberación de un pedido.
Atención al CNPJ alfanumérico. A partir de julio de 2026, los nuevos CNPJ pasan a contener letras además de números, y el cálculo del dígito verificador cambia. Si su validación de front-end usa una regex o un algoritmo de DV antiguo, va a empezar a rechazar CNPJ legítimos. Cubrimos el cronograma, el nuevo formato y el código actualizado en la guía CNPJ Alfanumérico 2026.
Qué viene en el retorno de una consulta de CNPJ
A diferencia del CPF (el número de identificación fiscal de las personas físicas en Brasil), el CNPJ trae un conjunto mucho más rico de información, porque describe a una organización entera. Vale la pena entender los campos que más pesan a la hora de decidir:
Situación registral. El campo más importante. Activa significa empresa en operación regular. Suspendida suele indicar una pendencia registral. No Apta (Inapta) aparece cuando la empresa dejó de cumplir obligaciones declarativas. Dada de Baja (Baixada) es una empresa cerrada. Nula indica una inscripción anulada, frecuentemente ligada a fraude. Para la mayoría de los flujos, solo Activa debería pasar automáticamente.
Cuadro de Socios y Administradores (QSA). Quiénes son los socios, sus calificaciones y la fecha de entrada a la sociedad. Esencial para due diligence, KYB e identificación del beneficiario final.
CNAE (actividad económica). Define el rubro de actuación. Útil para segmentar clientes, aplicar reglas por sector o identificar actividades incompatibles con su producto.
Tamaño y rango de facturación. MEI, ME, EPP o demás (las categorías brasileñas de micro y pequeña empresa). Ayuda a calibrar límites de crédito, condiciones comerciales y expectativa de volumen.
Opción por el Simples Nacional. Impacta la tributación y la emisión de facturas — frecuentemente necesario para el equipo fiscal.
Dirección, teléfonos y correos electrónicos. Datos de contacto y ubicación, útiles tanto para enriquecer el registro como para la validación cruzada.
Casos de uso: dónde la consulta de CNPJ por API es indispensable
Onboarding B2B y KYB. Marketplaces, plataformas SaaS, adquirentes y fintechs que venden a empresas necesitan verificar a cada cliente corporativo antes de habilitar operaciones. La consulta de CNPJ es la primera capa: confirma que la empresa existe, está activa e identifica a sus socios.
Registro y homologación de proveedores. Antes de dar de alta a un proveedor y habilitar pagos, confirme la situación registral, un CNAE compatible y el cuadro societario. Un CNPJ No Apto o Dado de Baja intentando registrarse es una alerta inmediata.
Análisis de crédito de empresas. Antes de correr un score o consultar burós, verifique si el CNPJ está regular y cuál es el tamaño de la empresa. Si la situación ya es impeditiva, el pipeline de crédito se corta antes de generar costos con consultas más caras.
Prevención de fraudes. Las empresas fantasma tienen patrones reconocibles: apertura muy reciente combinada con pedidos de alto valor, CNAE incompatible o situación registral irregular. Validar en el registro reduce fraude y morosidad.
Emisión de facturas. Para emitir una NF-e (la factura electrónica brasileña) a un destinatario empresa, los datos deben estar correctos y la inscripción activa. Consultar antes de emitir evita el rechazo por parte de la SEFAZ (la administración tributaria estatal) y el retrabajo fiscal.
Due diligence e inteligencia de mercado. Cruzar QSA, participación societaria y situación registral permite mapear grupos económicos, identificar conflictos de interés y evaluar el riesgo de contraparte — incluso señales de estrés financiero como la recuperación judicial (el proceso brasileño de reorganización concursal).
Cumplimiento de las nuevas reglas del Pix. Desde 2025, las claves Pix de personas jurídicas exigen validación del CNPJ en la Receita Federal. Lo tratamos en la guía de las nuevas reglas del Pix 2026.
Las soluciones de Persona Jurídica de FonteData
FonteData agrega más de 100 fuentes de datos en una API unificada — con la misma integración y la misma clave, usted accede a todo el ecosistema de consultas de empresas, sin mantener múltiples contratos con proveedores distintos. Cada caso de uso pide una profundidad de datos diferente, así que ofrecemos un abanico de endpoints para que elija el que mejor equilibra información y costo:
- Cadastro PJ Plus — registro completo, socios y enriquecimiento (teléfono, correo electrónico, rango de facturación) en una sola llamada. Ideal para onboarding y enriquecimiento de registros.
- Cadastro PJ Básica — datos registrales esenciales, el camino más económico para una validación simple.
- Consulta CNPJ Receita — registro completo con QSA en el formato de la Receita, ideal para validación de alto volumen.
- Participação Societária — en qué empresas participan los socios. Esencial para due diligence y mapeo de grupos económicos.
- Vínculos Societários — la red de relaciones entre socios y empresas.
- Beneficiário Final — identificación del beneficiario final, requisito de compliance y prevención del lavado de dinero.
- Relação de Filiais — matriz y filiales vinculadas al CNPJ.
Para una due diligence profunda, estos endpoints se combinan naturalmente con las consultas de compliance, sanciones y crédito del mismo hub. La documentación completa trae los parámetros, el formato de respuesta y ejemplos listos de cada uno.
Buenas prácticas
Valide en el front, consulte en el back. El dígito verificador puede comprobarse en el front-end para feedback inmediato; la consulta oficial debe ocurrir en el back-end, donde usted protege su clave y controla la decisión. Recuerde actualizar el algoritmo de DV al formato alfanumérico que entra en vigor en julio de 2026.
Cache con criterio. Los datos registrales de CNPJ no cambian con frecuencia, así que un cache de 24 h a 7 días reduce llamadas repetidas. Para decisiones de crédito o contratos de alto valor, consulte siempre en tiempo real — la situación registral puede cambiar de un día para otro.
Tenga un fallback. La API puede estar temporalmente indisponible; defina qué hacer en ese caso (encolar para retry, habilitar con restricción provisoria o bloquear y notificar). Nunca apruebe silenciosamente sobre un error.
Mantenga logs estructurados. Registre cada consulta con timestamp, CNPJ, resultado y decisión. En una auditoría, ese log es su evidencia de due diligence.
Consulta manual vs. API: resumen comparativo
| Aspecto | Consulta manual (Receita) | Consulta vía API |
|---|---|---|
| Velocidad | 30 s–2 min por consulta | < 1 segundo |
| Captcha | Obligatorio | Ninguno |
| Formato del retorno | HTML visual | JSON estructurado |
| Integración con sistemas | Ninguna | Directa vía HTTP |
| Volumen | Unitaria | Miles por minuto |
| Cuadro societario (QSA) | Limitado | Estructurado y cruzable |
| Costo operativo | Tiempo de analista | Centavos por consulta |
| Trazabilidad | Manual | Logs automáticos |
| Disponibilidad | Sin SLA | SLA contractual |
¿Y la LGPD?
La consulta de CNPJ trabaja mayoritariamente con datos de personas jurídicas, que no son datos personales en el sentido de la LGPD (la ley brasileña de protección de datos). Sin embargo, el cuadro societario contiene nombres y documentos de personas físicas — y esos sí son datos personales. Por eso, el tratamiento necesita una base legal y una finalidad definida: KYB, prevención de fraudes, cumplimiento de una obligación legal o ejecución de un contrato son bases adecuadas. No debe consultar CNPJ y sus socios de forma indiscriminada, sin relación con una operación concreta.
FonteData opera en conformidad con la legislación brasileña, actuando como intermediaria tecnológica. Los datos se obtienen de fuentes públicas oficiales y/o de proveedores tercerizados, y corresponde al usuario garantizar que la finalidad del tratamiento tiene una base legal adecuada.
Próximo paso
Si usted necesita validar CNPJ en su sistema — para onboarding B2B, homologación de proveedores, análisis de crédito, emisión fiscal o due diligence — la forma más eficiente es integrar vía API.
FonteData ofrece un conjunto completo de consultas de CNPJ como parte de un hub con más de 100 fuentes de datos, incluyendo CPF, KYC, Receita Federal, compliance y sanciones. Usted paga por consulta, sin mensualidad, con R$50 en créditos gratuitos (reales brasileños) para empezar.
¿Quiere ver todos los endpoints de empresas con parámetros y ejemplos de respuesta? Acceda a la documentación →
Pruebe la API de FonteData
Consulte datos de empresas y personas vía API — CNPJ, CPF, KYC, compliance y más. R$50 en créditos gratis para probar.
Crear cuenta gratis →