O que é o CNPJ
O CNPJ (Cadastro Nacional da Pessoa Jurídica) é o número de registro tributário da pessoa jurídica no Brasil. Toda empresa registrada no país possui um CNPJ de 14 dígitos, no formato 40.673.067/0001-34. O CNPJ não é apenas a identidade da empresa: é também a base para emitir NF-e, integrar-se à SEFAZ e firmar contratos.
Mas o CNPJ é apenas um número. As informações reais da empresa por trás dele (se está ativa, ramo de atividade, sócios, endereço, regime tributário) precisam ser consultadas na Receita Federal. É exatamente para isso que serve a API de Consulta CNPJ: você informa um CNPJ e recebe as informações oficiais completas daquela empresa.
Por que você precisa da API de Consulta CNPJ
- Validação KYC antes de emitir notas: evite emitir notas para empresas "fantasma" ou já baixadas (o que faz a NF-e ser rejeitada pela SEFAZ)
- Preenchimento automático de formulários: o usuário digita o CNPJ e os campos como razão social, endereço e inscrição estadual são preenchidos automaticamente, reduzindo a digitação manual e os erros
- Antifraude e controle de risco: identifique clientes suspeitos (por exemplo, abertos há apenas 3 dias, com capital social ínfimo ou com sede divergente do local de operação)
- Análise de conformidade de parceiros: verifique a idoneidade da outra parte antes de assinar o contrato
- Reverificação periódica de clientes: revise periodicamente a situação cadastral de clientes já contratados para evitar surpresas
Principais recursos da API de Consulta CNPJ da TF Fiscal
1. Dados direto da Receita Federal
A fonte de dados é o centro de dados oficial da Receita Federal (via canal SERPRO), com 100% de confiabilidade. Não é informação raspada e remontada da internet, nem cache desatualizado.
2. Visão geral dos campos retornados (mais de 40 itens)
- Informações básicas: Razão Social, Nome Fantasia, CNPJ, Data de Abertura
- Endereço: Endereço completo, Logradouro, Número, Bairro, CEP, Município, UF
- Atividade: CNAE Principal (código de 6 dígitos) + Atividades Secundárias + Descrição
- Situação cadastral: Situação Cadastral (Ativa / Suspensa / Baixada / Inapta / Nula) + Data Situação + Motivo
- Capital e porte: Capital Social, Porte (ME / EPP / Grande)
- Quadro societário: Quadro Societário (QSA, relação de sócios e representantes legais, com CPF / nacionalidade / qualificação)
- Regime tributário: Opção pelo Simples Nacional / Lucro Real / Lucro Presumido
- Contato: Telefone, E-mail
- Inscrições estaduais: Inscrições Estaduais (lista dos números de IE por estado)
- Filiais: Filiais (caso existam)
3. Estratégia de tempo real + cache
Três modos disponíveis:
- Modo tempo real: cada chamada acessa diretamente a Receita Federal (ideal para cenários de KYC com validação rigorosa)
- Modo cache: cache de 24 a 72 horas (ideal para preenchimento automático e exibição em listas, reduzindo custos)
- Lote assíncrono: envie mais de 1.000 CNPJs de uma vez e receba os resultados via Webhook (ideal para reverificações periódicas de clientes)
4. Log de chamadas e auditoria
Todas as chamadas registram horário, solicitante, parâmetros e campos retornados, com retenção permanente. Facilita auditorias internas de risco e a comprovação em casos de conformidade.
Formas de cobrança
A TF Fiscal oferece planos de cobrança flexíveis:
- Cobrança por chamada: R$ 0,50 por consulta (com deduplicação por CNPJ; consultas repetidas do mesmo CNPJ em 24h são contadas apenas uma vez)
- Pacotes pré-pagos: 1.000 consultas por R$ 450 (R$ 0,45 cada); 10.000 consultas por R$ 3.800 (R$ 0,38 cada)
- Planos personalizados para grandes empresas: para clientes com alto volume de chamadas, operações complexas ou requisitos de SLA dedicado, oferecemos soluções sob medida, com preços por ano / por linha de negócio / por setor, gerente de contas dedicado, pool de recursos exclusivo, suporte técnico prioritário e estrutura de auditoria de conformidade. Fale com o time comercial para receber uma cotação →
Observação: o preço final depende da escolha entre a versão Reduzida ou a versão Completa dos dados. A versão Completa inclui campos sensíveis como sócios e regime tributário, com preço unitário mais alto.
Exemplo 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": [ ... ]
}
Cenários de uso típicos
- Cadastro de novos clientes em ERPs transfronteiriços: informe o CNPJ e os dados da empresa são preenchidos automaticamente
- Aprovação de vendedores em marketplaces: validação de vendedores antes do credenciamento na Shopee / Mercado Livre
- Controle de risco financeiro: análise de conformidade em concessão de crédito e operações de factoring
- Reverificação da carteira de clientes: alerta imediato ao detectar situação Suspensa / Baixada
- Antifraude: cruzamento com os dados de emissão de NF-e para identificar transações suspeitas
Perguntas frequentes
P: Qual a diferença em relação a consultar diretamente o site da Receita Federal?
O site oficial tem limite diário (cerca de 100 consultas por IP) e não oferece API, apenas HTML, o que impede a automação. A TF Fiscal disponibiliza uma API por canal autorizado oficial, permitindo chamadas em larga escala com dados estruturados.
P: Com que frequência os dados são atualizados?
No modo tempo real, os dados vêm da base atual da Receita Federal, T+0. No modo cache, a atualização padrão é a cada 24 horas.
P: É possível consultar empresas já baixadas (Baixada)?
Sim. As informações de empresas com situação Baixada continuam disponíveis, sendo possível ver a data e o motivo da baixa.
P: Como funciona a conformidade com a privacidade?
Os dados de CNPJ são informações públicas (lei das empresas no Brasil) e não estão sujeitos às restrições rigorosas da LGPD. No entanto, se você também consultar o CPF dos sócios, é necessário cumprir a LGPD — veja o
Gateway de conformidade LGPD.
Soluções relacionadas