API de Consulta de CNPJ en la Receita Federal
En CPF.CNPJ, simplificamos y agilizamos el acceso a información esencial de personas físicas y jurídicas.
El Desafío: Validar Empresas y Reducir el Riesgo en Operaciones B2B
Antes de cerrar un contrato, conceder crédito o liberar un pago, cualquier empresa necesita saber con quién está negociando. Validar proveedores, socios y clientes persona jurídica exige verificar la situación registral del CNPJ en la Receita Federal, confirmar la razón social y la dirección, y comprender la estructura societaria. Hecho manualmente — abriendo el sitio de la Receita, resolviendo un captcha y copiando datos en cada consulta — este proceso es lento, propenso a errores e imposible de escalar a cientos o miles de empresas.
El proceso de KYB (Know Your Business) es la base del compliance, la prevención del fraude empresarial y la gestión del riesgo de crédito. Negociar con un CNPJ Baja, No Apto o Suspendido puede significar una factura inválida, un proveedor inexistente, o la exposición a esquemas de fraude con empresas pantalla. Sin automatización, el equipo de registro y compliance se convierte en un cuello de botella y la operación se traba.
La solución es consultar el CNPJ directamente desde la fuente oficial vía API: confirmar que la empresa existe, está activa y habilitada, y enriquecer el registro con datos societarios completos — todo de forma programática, integrado al ERP, CRM o plataforma de onboarding, sin intervención manual.
Cómo lo Resuelve la API CPF.CNPJ
1. Identificación Completa de la Empresa
La API devuelve los datos de identificación de la empresa directamente desde la base de la Receita Federal: razón social, nombre de fantasía, situación registral (Activa, Baja, No Apta, Suspendida), fecha de la situación, fecha de apertura, naturaleza jurídica y dirección completa (calle, número, barrio, municipio, estado y código postal).
Con la situación registral en mano, el sistema decide automáticamente si libera o bloquea la operación: solo los CNPJ Activos siguen el flujo; las demás situaciones disparan revisión o rechazo, eliminando el riesgo de transaccionar con empresas irregulares.
2. CNAE, Tamaño y Régimen Tributario
Para el análisis de riesgo y la segmentación, la API entrega el CNAE principal y los CNAE secundarios (actividades económicas), el tamaño de la empresa (ME, EPP, Demás) y el capital social declarado.
También devuelve el régimen tributario: si la empresa es optante por el Simples Nacional y si es MEI (Microemprendedor Individual). Estos campos alimentan motores de scoring, reglas de límite de crédito y enrutamiento de propuestas comerciales.
3. Cuadro de Socios y Administradores (QSA)
La consulta incluye el cuadro societario (QSA) con la relación de socios y administradores, la calificación de cada uno y su participación en la empresa. Este dato es esencial para KYB, due diligence e identificación del beneficiario final en procesos de compliance y prevención del lavado de dinero.
Cruzar el QSA con listas restrictivas y bases de fraude permite detectar testaferros, empresas pantalla y conflictos de interés antes de cerrar el negocio.
4. Compatibilidad con el CNPJ Alfanumérico (2026)
A partir de 2026, los nuevos CNPJ pasan a emitirse en formato alfanumérico por la Receita Federal. La API CPF.CNPJ ya está preparada para recibir y validar tanto el CNPJ numérico tradicional como el nuevo CNPJ alfanumérico, garantizando que su integración siga funcionando sin retrabajo durante la transición.
Cómo Integrar: Consulta de CNPJ vía API
La integración es una llamada HTTP simple. Autentíquese con su token mediante Bearer y haga un GET pasando el CNPJ. La respuesta llega en JSON con todos los campos registrales y societarios:
# Consulta de CNPJ na Receita Federal via API
curl -X GET "https://api.cpfcnpj.com.br/v3/cnpj/27272134000118" \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Accept: application/json"
# Resposta (JSON)
{
"cnpj": "27272134000118",
"razao_social": "ALAS TECNOLOGIA LTDA",
"nome_fantasia": "CPF.CNPJ",
"situacao_cadastral": "ATIVA",
"data_abertura": "2017-01-30",
"natureza_juridica": "206-2 - Sociedade Empresária Limitada",
"porte": "DEMAIS",
"capital_social": 100000.00,
"optante_simples": false,
"mei": false,
"cnae_principal": {
"codigo": "6201501",
"descricao": "Desenvolvimento de programas de computador sob encomenda"
},
"cnae_secundarios": [
{ "codigo": "6311900", "descricao": "Tratamento de dados e hospedagem" }
],
"endereco": {
"logradouro": "Avenida Donato Quintino",
"numero": "90",
"bairro": "Cidade Cruzeiro do Sul",
"municipio": "Montes Claros",
"uf": "MG",
"cep": "39401-301"
},
"qsa": [
{
"nome": "Socio Exemplo",
"qualificacao": "Sócio-Administrador",
"participacao": 100
}
]
}Los mismos campos están disponibles en consultas en lote (bulk) para la validación de bases enteras de proveedores y clientes. La documentación completa, con todos los endpoints, parámetros y ejemplos de código, está disponible en cpfcnpj.com.br/dev/.
Por qué usar la API de CNPJ
- Datos D+0 en tiempo real: Consulta actualizada al instante, reflejando la situación registral del día
- Uptime del 99,9%: Alta disponibilidad para integrar en flujos críticos de registro y onboarding
- Fuente oficial de la Receita Federal: Datos extraídos directamente de la base oficial, sin intermediarios
- Datos societarios completos: Razón social, situación, CNAE, capital social, tamaño y cuadro de socios (QSA)
