API Receita Federal para consultar CPF y CNPJ en tiempo real
En CPF.CNPJ, simplificamos y agilizamos el acceso a información esencial de personas físicas y jurídicas.
El desafío: acceder a los datos de la Receita Federal de forma directa y legal
La Receita Federal mantiene las bases oficiales de CPF y CNPJ de Brasil, pero no ofrece una API pública unificada de consulta para integración en sistemas. Las alternativas comunes — formularios web con captcha, raspado de datos (scraping) y portales con límites de uso — son frágiles, inestables y jurídicamente arriesgadas para operaciones que necesitan validar documentos a escala.
Las empresas que ejecutan KYC (Know Your Customer), KYB (Know Your Business) y procesos de compliance necesitan datos confiables en la fuente: situación registral del CPF, situación del CNPJ, cuadro societario (QSA) y CNAE. Cuando esos datos provienen de copias desactualizadas o de scraping sujeto a bloqueos, el resultado son onboardings trabados, falsos positivos y exposición regulatoria.
CPF.CNPJ resuelve esto ofreciendo una capa de API que entrega datos oficiales de la Receita Federal de CPF y CNPJ de forma programática, en tiempo real (D+0), sin captcha y sin scraping. Una única integración REST cubre persona física y jurídica, con la confiabilidad exigida por flujos de registro, crédito y antifraude.
Cómo lo resuelve la API CPF.CNPJ
1. CPF y CNPJ en una única API
Una sola integración cubre los dos documentos. Para CPF, la API devuelve la situación registral (Regular, Suspendido, Cancelado, Pendiente de Regularización, Nulo, Cancelado por Multiplicidad o Titular Fallecido) y el nombre oficial vinculado al documento.
Para CNPJ, la API entrega situación registral (Activa, Dada de Baja, Inapta, Suspendida, Nula), razón social, nombre fantasía, fecha de apertura, tamaño, CNAE principal y secundarios, dirección y el cuadro de socios y administradores (QSA). Todo a partir de la fuente oficial de la Receita Federal.
2. REST y JSON, fáciles de integrar
La API es RESTful y responde en JSON, sin dependencia de SDK propietario. Cualquier lenguaje capaz de hacer una petición HTTP puede consumir los datos, lo que reduce el tiempo de integración a minutos en flujos de backend, ETLs y trabajos por lotes.
La estructura de respuesta es estable y documentada, permitiendo mapear campos directamente al motor de decisión de KYC/KYB sin tratamientos frágiles de HTML.
3. Autenticación por token y datos en tiempo real (D+0)
La autenticación se realiza por token, sin necesidad de captcha, certificado digital ni fecha de nacimiento. El token identifica la aplicación y el paquete contratado en cada petición.
Las consultas reflejan el estado actual de las bases de la Receita Federal (D+0), garantizando que las decisiones de onboarding, crédito y compliance usen la situación registral más reciente disponible en la fuente oficial.
4. Conformidad LGPD
El acceso a los datos está estructurado para uso legítimo en prevención del fraude, validación registral y cumplimiento de obligaciones legales, con tratamiento conforme a la LGPD (Ley 13.709/2018).
Esto permite que instituciones financieras, fintechs, marketplaces y empresas reguladas validen CPF y CNPJ en la fuente oficial sin recurrir a scraping ni a bases informales de origen dudoso.
Cómo integrar
La integración es una llamada REST autenticada por token. El ejemplo siguiente consulta un CPF y un CNPJ en la base oficial de la Receita Federal y devuelve la situación registral en JSON:
# Consulta de CPF na Receita Federal
curl -X GET "https://api.cpfcnpj.com.br/SEU_TOKEN/9/00000000000"
# Consulta de CNPJ (situação, QSA, CNAE) na Receita Federal
curl -X GET "https://api.cpfcnpj.com.br/SEU_TOKEN/6/00000000000000"
# Resposta (exemplo simplificado)
# {
# "status": 1,
# "documento": "00000000000000",
# "situacao": "ATIVA",
# "razao_social": "EMPRESA EXEMPLO LTDA",
# "abertura": "2015-03-10",
# "cnae_principal": "62.01-5-01",
# "qsa": [ { "nome": "SOCIO EXEMPLO", "qualificacao": "Sócio-Administrador" } ]
# }Para detalles de endpoints, paquetes de consulta, códigos de situación y ejemplos en otros lenguajes, consulta la documentación completa en https://www.cpfcnpj.com.br/dev/.
Por qué usar la API CPF.CNPJ
- Fuente oficial: Datos extraídos directamente de las bases de la Receita Federal de CPF y CNPJ.
- D+0 en tiempo real: Situación registral actualizada, reflejando el estado actual de la fuente oficial.
- 99,9% de uptime: Disponibilidad pensada para flujos críticos de onboarding y compliance.
- CPF y CNPJ en una sola API: Una única integración REST cubre persona física y jurídica.
