API de Consulta de CNPJ na Receita Federal
Na CPF.CNPJ, nós simplificamos e agilizamos o acesso a informações essenciais de pessoas físicas e jurídicas.
O Desafio: Validar Empresas e Reduzir Risco em Operações B2B
Antes de fechar contrato, conceder crédito ou liberar pagamento, qualquer empresa precisa saber com quem está negociando. Validar fornecedores, parceiros e clientes pessoa jurídica exige checar a situação cadastral do CNPJ na Receita Federal, confirmar razão social e endereço, e entender a estrutura societária. Feito manualmente — abrindo o site da Receita, resolvendo captcha e copiando dados a cada consulta — esse processo é lento, sujeito a erro e impossível de escalar para centenas ou milhares de empresas.
O processo de KYB (Know Your Business) é a base de compliance, prevenção à fraude empresarial e gestão de risco de crédito. Negociar com um CNPJ Baixado, Inapto ou Suspenso pode significar nota fiscal inválida, fornecedor inexistente, ou exposição a esquemas de fraude com empresas de fachada. Sem automação, o time de cadastro e compliance vira gargalo e a operação fica travada.
A solução é consultar o CNPJ diretamente da fonte oficial via API: confirmar que a empresa existe, está ativa e habilitada, e enriquecer o cadastro com dados societários completos — tudo de forma programática, integrada ao ERP, CRM ou plataforma de onboarding, sem intervenção manual.
Como a API CPF.CNPJ Resolve
1. Identificação Completa da Empresa
A API retorna os dados de identificação da empresa direto da base da Receita Federal: razão social, nome fantasia, situação cadastral (Ativa, Baixada, Inapta, Suspensa), data da situação, data de abertura, natureza jurídica e endereço completo (logradouro, número, bairro, município, UF e CEP).
Com a situação cadastral em mãos, o sistema decide automaticamente se libera ou bloqueia a operação: apenas CNPJs Ativos seguem o fluxo; demais situações disparam revisão ou recusa, eliminando o risco de transacionar com empresas irregulares.
2. CNAE, Porte e Enquadramento Tributário
Para análise de risco e segmentação, a API entrega o CNAE principal e os CNAEs secundários (atividades econômicas), o porte da empresa (ME, EPP, Demais) e o capital social declarado.
Também retorna o enquadramento tributário: se a empresa é optante pelo Simples Nacional e se é MEI (Microempreendedor Individual). Esses campos alimentam motores de scoring, regras de limite de crédito e roteamento de propostas comerciais.
3. Quadro de Sócios e Administradores (QSA)
A consulta inclui o quadro societário (QSA) com a relação de sócios e administradores, qualificação de cada um e participação na empresa. Esse dado é essencial para KYB, due diligence e identificação do beneficiário final em processos de compliance e prevenção à lavagem de dinheiro.
Cruzar o QSA com listas restritivas e bases de fraude permite detectar laranjas, empresas de fachada e conflitos de interesse antes de fechar negócio.
4. Suporte ao CNPJ Alfanumérico (2026)
A partir de 2026, novos CNPJs passam a ser emitidos no formato alfanumérico pela Receita Federal. A API CPF.CNPJ já está preparada para receber e validar tanto o CNPJ numérico tradicional quanto o novo CNPJ alfanumérico, garantindo que sua integração continue funcionando sem retrabalho durante a transição.
Como Integrar: Consulta de CNPJ via API
A integração é uma chamada HTTP simples. Autentique-se com seu token via Bearer e faça um GET passando o CNPJ. A resposta vem em JSON com todos os campos cadastrais e societários:
# 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
}
]
}Os mesmos campos estão disponíveis em consultas em lote (bulk) para validação de bases inteiras de fornecedores e clientes. A documentação completa, com todos os endpoints, parâmetros e exemplos de código, está disponível em cpfcnpj.com.br/dev/.
Por que usar a API de CNPJ
- Dados D+0 em tempo real: Consulta atualizada na hora, refletindo a situação cadastral do dia
- Uptime de 99,9%: Alta disponibilidade para integrar em fluxos críticos de cadastro e onboarding
- Fonte oficial da Receita Federal: Dados extraídos diretamente da base oficial, sem intermediários
- Dados societários completos: Razão social, situação, CNAE, capital social, porte e quadro de sócios (QSA)
