Qué es el CNPJ
El CNPJ (Cadastro Nacional da Pessoa Jurídica) es el número de registro tributario de las personas jurídicas de Brasil, equivalente al identificador fiscal de una empresa. Toda empresa registrada en Brasil tiene un CNPJ de 14 dígitos, con un formato como 40.673.067/0001-34. El CNPJ no solo es el documento de identidad de la empresa, sino también la base para emitir NF-e, conectarse con la SEFAZ y firmar contratos.
Pero el CNPJ es solo un número; la información real de la empresa que hay detrás (si está activa, su actividad, sus socios, su domicilio, su régimen tributario) debe consultarse en la Receita Federal. Para eso sirve la API Consulta CNPJ: usted envía un CNPJ y recibe la información oficial completa de esa empresa.
Por qué necesita la API Consulta CNPJ
- Verificación KYC previa a la facturación: evita emitir facturas a "empresas fantasma" o a empresas ya dadas de baja (lo que haría que la SEFAZ rechace la NF-e).
- Autocompletado de formularios: el usuario ingresa el CNPJ y se completan automáticamente la razón social, el domicilio, el número de inscripción tributaria, etc., reduciendo la carga manual y los errores de digitación.
- Control de riesgo y antifraude: identifica clientes sospechosos (por ejemplo, recién constituidos hace 3 días, con capital social muy bajo, o con domicilio de registro distinto del de operación).
- Revisión de cumplimiento de socios comerciales: verifica las credenciales de la otra parte antes de firmar un contrato.
- Reverificación periódica de clientes: revisa regularmente la situación registral de los clientes ya contratados para evitar sorpresas.
Capacidades clave de la API Consulta CNPJ de TF Fiscal
1. Datos conectados directamente con la Receita Federal
La fuente de datos es el centro de datos oficial de la Receita Federal de Brasil (a través del canal de SERPRO), con 100 % de autoridad. No se trata de datos extraídos de la web ni de cachés desactualizados.
2. Resumen de los campos devueltos (más de 40)
- Información básica: Razão Social (razón social), Nome Fantasia (nombre comercial), CNPJ, Data de Abertura (fecha de apertura).
- Domicilio: Endereço completo, Logradouro (calle), Número, Bairro (barrio), CEP (código postal), Município (municipio), UF (estado).
- Actividad: CNAE Principal (código de actividad principal de 6 dígitos) + Atividades Secundárias (lista de actividades secundarias) + Descrição (descripción de la actividad).
- Situación registral: Situação Cadastral (Ativa / Suspensa / Baixada / Inapta / Nula) + Data Situação (fecha de vigencia del estado) + Motivo (motivo del cambio).
- Capital y porte: Capital Social (capital social), Porte (porte de la empresa: ME / EPP / Grande).
- Estructura societaria: Quadro Societário (QSA, lista de socios y representantes legales, con CPF / nacionalidad / cualificación).
- Régimen tributario: Opção pelo Simples Nacional / Lucro Real / Lucro Presumido.
- Contacto: Telefone (teléfono), Email.
- Inscripciones estatales: Inscrições Estaduais (lista de números de IE de cada estado).
- Sucursales: Filiais (si las hay).
3. Estrategia de tiempo real + caché
Se admiten tres modos:
- Modo en tiempo real: cada llamada se conecta directamente con la Receita Federal (ideal para escenarios de KYC con validación estricta).
- Modo en caché: caché de 24 a 72 horas (ideal para autocompletado de formularios y vistas de listas, ahorrando costes).
- Lote asíncrono: envíe más de 1000 CNPJ de una vez y reciba los resultados por Webhook (ideal para la reverificación periódica de clientes).
4. Registro de llamadas y auditoría
Todas las llamadas registran la fecha, el solicitante, los parámetros y los campos devueltos, y se conservan de forma permanente. Facilita la auditoría interna de control de riesgo y la obtención de evidencia de cumplimiento.
Modelo de tarifas
TF Fiscal ofrece planes de tarifas flexibles:
- Cobro por consulta: R$ 0,50 por consulta (deduplicado por CNPJ único; las consultas repetidas del mismo CNPJ dentro de 24 h se cobran una sola vez).
- Paquetes prepagos: 1.000 consultas por R$ 450 (R$ 0,45 por unidad); 10.000 consultas por R$ 3.800 (R$ 0,38 por unidad).
- Soluciones personalizadas para grandes empresas: para clientes con alto volumen de consultas, operaciones complejas o requisitos de SLA dedicado, ofrecemos un servicio a medida uno a uno: precios por paquete anual / por línea de negocio / por sector, con gerente de cuenta dedicado, pool de recursos independiente, soporte técnico prioritario y paquete de auditoría de cumplimiento. Contacte con ventas para obtener una cotización →
Nota: el precio real depende de si elige los datos en su versión "reducida" (Reduzida) o "completa" (Completa). La versión completa incluye campos sensibles como socios y régimen tributario, por lo que su precio unitario es más alto.
Ejemplo de API
GET /v1/consulta/cnpj/40673067000134
Response:
{
"cnpj": "40.673.067/0001-34",
"razao_social": "TF SOFTWARE LTDA",
"nome_fantasia": "TF Software",
"situacao": "ATIVA",
"data_abertura": "2020-...",
"endereco": { "uf": "SP", "municipio": "São Paulo", ... },
"cnae_principal": "6202-3/00",
"capital_social": "...",
"socios": [ ... ]
}
Escenarios de uso típicos
- Registro de nuevos clientes en un ERP transfronterizo: ingrese el CNPJ y se completa automáticamente la información de la empresa.
- Verificación de vendedores en plataformas de comercio electrónico: validación de vendedores de Shopee / Mercado Livre antes de su alta.
- Control de riesgo financiero: revisión de cumplimiento empresarial para aprobación crediticia y operaciones de factoraje.
- Reverificación de clientes en cartera: detecta a tiempo los estados Suspensa / Baixada y emite alertas.
- Antifraude: validación cruzada con los datos de facturación de NF-e para identificar transacciones sospechosas.
Preguntas frecuentes
P: ¿Qué diferencia hay con consultar directamente el portal oficial de la Receita Federal?
El portal oficial tiene un límite diario (unas 100 consultas por IP) y no ofrece API, solo HTML, por lo que no se puede automatizar. TF Fiscal ofrece una API a través de un canal autorizado oficial, lo que permite consultas a gran escala con datos estructurados.
P: ¿Con qué frecuencia se actualizan los datos?
En modo en tiempo real, los datos provienen de la base de datos actual de la Receita Federal, en T+0. En modo en caché, se actualizan por defecto cada 24 horas.
P: ¿Se pueden consultar empresas ya dadas de baja (Baixada)?
Sí. La información de las empresas con estado Baixada sigue siendo consultable, y se puede ver la fecha y el motivo de la baja.
P: ¿Cómo se gestiona el cumplimiento de privacidad?
Los datos del CNPJ son información pública (según la ley de sociedades de Brasil) y no están sujetos a las restricciones estrictas de la LGPD. Pero si consulta a la vez el CPF de los socios, deberá cumplir con la LGPD; vea la
Pasarela de cumplimiento LGPD.
Soluciones relacionadas