API Receita Federal: o que dá e o que não dá para fazer

Quem integra dados de empresas a um CRM, ERP ou fluxo de cadastro quase sempre começa pela mesma busca: “API Receita Federal”. O cadastro do CNPJ é público, oficial e gratuito na origem, o que ajuda a resolver muita coisa. Este artigo mostra, campo a campo, o que os dados públicos da Receita entregam, o que eles não entregam, onde a confusão costuma acontecer e em quais casos o dado público basta, sem precisar de mais nada.

Pense no cadastro do CNPJ como a certidão de nascimento de uma empresa. Ela diz quando a empresa nasceu, como se chama, onde foi registrada, quem responde por ela e se continua ativa para o Fisco. Ela não diz quanto a empresa fatura hoje, quantas pessoas trabalham lá, quem decide a compra nem qual telefone de fato atende. Para validar um fornecedor, a certidão resolve. Para decidir se vale ligar para aquela empresa amanhã, ela conta só o começo da história.

Neste artigo:

• Existe uma API Receita Federal oficial?
• O que os dados públicos da Receita entregam
• O que a API RFB não entrega
• Tabela lado a lado: Receita Federal x dados enriquecidos
• WS Receita Federal e serviços de consulta de CNPJ: o que muda
• Quando o dado público da Receita basta
• Quando vale ir além da Receita
• Perguntas frequentes sobre a API Receita Federal

Existe uma API Receita Federal oficial?

Não existe uma API REST oficial, gratuita e aberta da Receita Federal para consultar CNPJ. Quando alguém fala em “API Receita Federal”, normalmente está falando de um destes três caminhos, que têm custo, formato e atualização diferentes.

O primeiro são os dados abertos do CNPJ. A Receita publica a base cadastral completa no conjunto de dados do CNPJ no portal dados.gov.br, em arquivos compactados (empresas, estabelecimentos, sócios, Simples Nacional e tabelas de apoio como CNAE e natureza jurídica), com atualização mensal. É gratuito, mas não é uma API: são dezenas de gigabytes que alguém precisa baixar, tratar, carregar num banco e manter atualizados todo mês.

O segundo é a API Consulta CNPJ do Serpro, a empresa pública de processamento de dados do governo federal. É a via oficial de acesso por API ao cadastro, com consulta em tempo real, mas é paga, com preço por faixa de volume publicado na Loja Serpro. Costuma ser a escolha de bancos, fintechs e áreas de cadastro que precisam de disponibilidade garantida em processos de KYC.

O terceiro são serviços de terceiros que reempacotam os dados públicos e expõem um endpoint simples por CNPJ, como ReceitaWS, BrasilAPI, CNPJ.ws e CNPJá. Eles facilitam a integração, mas a fonte continua sendo a mesma base da Receita, com os mesmos campos e as mesmas lacunas.

O que os dados públicos da Receita entregam

A base do CNPJ é um cadastro fiscal. Os campos existem porque o Fisco precisa deles, e é por isso que ela é tão boa para identificar e validar uma empresa.

Situação cadastral

Diz se o CNPJ está ativo, suspenso, inapto, baixado ou nulo, com data e motivo. É o campo mais valioso em qualquer integração: uma empresa baixada no meio de uma carteira de clientes gera nota emitida para quem não existe, cobrança que volta e campanha disparada para ninguém.

CNAE principal e secundários

A atividade econômica declarada pela empresa, base de qualquer segmentação por setor. O cuidado aqui é operacional: o código reflete o que foi declarado na abertura ou na última alteração, não necessariamente o que a empresa vende hoje. Em listas filtradas só por CNAE, é comum encontrar software houses registradas como consultoria e distribuidoras com CNAE de varejo nunca atualizado, o que explica parte das listas que “parecem certas” e não convertem.

Natureza jurídica

Indica se é sociedade limitada, sociedade anônima, empresário individual, associação ou órgão público, entre outras. Ajuda a separar empresas de entidades sem fins lucrativos e de administração pública, que têm processo de compra completamente diferente.

Capital social

O valor que os sócios declararam na constituição da empresa. Capital social não é faturamento nem patrimônio atual: uma empresa aberta com R$ 10 mil de capital pode faturar milhões dez anos depois sem nunca ter atualizado o contrato social.

Quadro de sócios e administradores

Nome dos sócios, qualificação (sócio-administrador, presidente, diretor), data de entrada e faixa etária. Nos dados abertos, o CPF dos sócios pessoa física vem parcialmente mascarado. Em empresas pequenas, o sócio-administrador costuma ser o próprio decisor de compra; em médias e grandes, raramente é.

Data de abertura

A data de início de atividade do CNPJ. Permite filtrar empresas recém-abertas, calcular tempo de mercado e separar negócios estabelecidos de recém-criados.

O que mais vem junto

A base traz ainda razão social, nome fantasia, endereço, indicação de matriz ou filial, porte fiscal e a opção pelo Simples Nacional e pelo MEI. Traz também telefone e e-mail declarados no cadastro, que é onde começa a confusão tratada a seguir.

O que a API RFB não entrega

Aqui está o ponto que separa um cadastro fiscal de uma base de prospecção. Qualquer API RFB, seja a do Serpro ou a de um serviço que reempacota os dados abertos, não tem os campos abaixo, porque a Receita não os coleta ou não os publica. São justamente os campos que plataformas de inteligência B2B, como a Econodata, constroem cruzando outras fontes e modelos sobre o cadastro.

Faturamento estimado

A Receita não publica faturamento. O porte fiscal é um enquadramento por faixa definido no art. 3º da Lei Complementar 123/2006: receita bruta anual de até R$ 360 mil para microempresa e de até R$ 4,8 milhões para empresa de pequeno porte. Na categoria “demais” cabem desde uma empresa que fatura R$ 5 milhões até uma multinacional, o que torna o campo pouco útil para separar mid-market de enterprise.

Número de funcionários

Não existe campo de quantidade de funcionários no cadastro do CNPJ. É um dos dados mais pedidos em segmentação B2B e um dos que mais exigem modelagem, porque precisa ser estimado a partir de outras fontes.

Telefone validado

A base traz até dois telefones declarados, sem nenhuma indicação de que funcionam. Muitos números são do escritório de contabilidade que abriu a empresa, linhas desativadas ou números nunca atualizados. Um SDR que passa a manhã discando uma lista crua da Receita costuma ouvir mais “aqui é a contabilidade” e “número inexistente” do que “pois não, comercial”.

E-mail utilizável para prospecção

O e-mail do cadastro tem o mesmo problema, mais acentuado. É comum ser o endereço do contador ou um genérico criado para a abertura, sem validação de entrega e sem relação com quem decide a compra.

Decisores além dos sócios

A Receita conhece quem responde legalmente pela empresa, não quem compra. O diretor de TI, a gerente de compras e o head de vendas não aparecem no cadastro. Em uma empresa de 500 funcionários, começar pelo sócio-administrador costuma ser o caminho mais longo até a pessoa certa.

Tecnologias usadas

Que CRM, ERP ou plataforma de e-commerce a empresa usa não é informação fiscal. Esse dado vem da leitura do site e de outros sinais públicos, e é decisivo para quem vende software, integração ou serviço sobre uma tecnologia específica.

Dívidas

O cadastro do CNPJ não informa dívidas. Débitos inscritos em dívida ativa da União são publicados pela Procuradoria-Geral da Fazenda Nacional (PGFN) em outra base, que precisa ser cruzada com o CNPJ por conta própria.

Score de assertividade

A Receita entrega o dado como foi declarado, sem medida de confiança. Não há indicação de qual telefone tem mais chance de atender ou de qual e-mail chega à caixa de entrada.

Grupo econômico

Cada CNPJ é um registro isolado, e a base não diz que três razões sociais diferentes pertencem ao mesmo grupo. Dá para chegar perto cruzando sócios em comum, mas o cruzamento precisa ser mantido e revisado, porque um mesmo sócio pode ter participação em empresas sem relação comercial nenhuma.

Tabela lado a lado: Receita Federal x dados enriquecidos

“Declarado” significa que o campo existe, mas sem verificação.

Dado	Dados públicos da Receita (API RFB)	Base enriquecida de prospecção
Situação cadastral	Sim	Sim
CNAE principal e secundários	Sim	Sim
Natureza jurídica	Sim	Sim
Capital social	Sim	Sim
Sócios e administradores	Sim, com CPF mascarado	Sim
Data de abertura	Sim	Sim
Porte fiscal e opção pelo Simples	Sim	Sim
Faturamento	Não (só faixa fiscal de porte)	Estimado por modelo
Número de funcionários	Não	Estimado por modelo
Telefone	Declarado, sem validação	Com verificação e indicador de assertividade
E-mail	Declarado, sem validação	Com validação
Decisores além dos sócios	Não	Sim, com cargo e área
Tecnologias usadas	Não	Sim, detectadas no site
Dívidas com a União	Não (base separada da PGFN)	Sim, cruzadas ao CNPJ
Score de assertividade	Não	Sim
Grupo econômico	Não	Sim, por vínculos societários

WS Receita Federal e serviços de consulta de CNPJ: o que muda

“WS Receita Federal” virou quase sinônimo de webservice que consulta CNPJ, muito por causa do ReceitaWS, um dos primeiros serviços populares entre desenvolvedores brasileiros. Hoje há várias opções desse tipo, gratuitas e pagas, e todas fazem a mesma coisa: convertem a base pública em uma consulta por CNPJ com resposta em JSON.

O que muda entre elas é a experiência de integração, não o conteúdo. As versões gratuitas costumam limitar a poucas consultas por minuto por IP, o que funciona para preencher um formulário de cadastro, mas não para atualizar uma base de 50 mil empresas. A atualização também varia: serviços alimentados pelos arquivos mensais podem trazer uma situação cadastral com semanas de defasagem, e isso pesa quando o objetivo é justamente pegar uma baixa recente.

Nenhum WS Receita Federal cria dado que a Receita não tem. Se o serviço devolve faturamento ou número de funcionários, esses campos vieram de outra fonte ou de um modelo de estimativa, e vale perguntar ao fornecedor qual, a mesma pergunta que deve ser feita à Econodata ou a qualquer outra base enriquecida.

Quando o dado público da Receita basta

Em vários usos a base da Receita é a resposta certa, e pagar por mais dado seria desperdício.

• Validação de cadastro de clientes e fornecedores: conferir se o CNPJ existe, se está ativo e se a razão social bate com o que foi digitado. A Receita é a fonte oficial e nenhum enriquecimento muda a resposta.
• Preenchimento automático de formulários: digitar o CNPJ e preencher razão social, endereço e CNAE em um cadastro ou na emissão de nota. Um serviço gratuito dá conta, desde que o volume seja baixo.
• Checagem antes de faturar ou renovar contrato: verificar se a empresa continua ativa antes de emitir cobrança ou renovar um contrato longo.
• Limpeza básica de base: marcar CNPJs baixados ou inaptos em uma lista antiga antes de uma campanha. Só essa etapa tira da base registros que nunca vão converter.
• Dimensionamento macro por CNAE: contar empresas ativas por atividade e região para um estudo de mercado ou trabalho acadêmico, sabendo que o CNAE declarado tem imprecisões.
• Due diligence societária inicial: identificar sócios e administradores antes de uma negociação.

Se o seu caso está nesta lista, montar o processo sobre os dados abertos ou sobre uma API de consulta de CNPJ é uma decisão correta.

Quando vale ir além da Receita

O limite aparece quando a pergunta deixa de ser “esta empresa existe e está regular?” e passa a ser “vale a pena falar com esta empresa, e com quem?”. Priorizar contas por porte real, montar uma lista de empresas com mais de 200 funcionários em um setor, chegar no gerente de compras em vez do sócio ou saber se o prospect usa a ferramenta concorrente são perguntas que um cadastro fiscal não responde.

A base da Econodata parte de fontes públicas e oficiais, incluindo a Receita, e acrescenta o que o cadastro não traz: faturamento e número de funcionários estimados por modelo próprio, telefones com indicador de assertividade, e-mails validados, decisores por área, tecnologias detectadas no site, dívidas com a União e grupo econômico. Os campos disponíveis dependem do plano contratado.

Para quem já consome dados por integração, a API da Econodata entrega o cadastro e o enriquecimento no mesmo retorno, por CNPJ, em lote ou por segmentação com filtros, sem manter um pipeline sobre os arquivos mensais da Receita e outro para cada fonte complementar. Para atualizar uma base que já existe sem integração, há o enriquecimento e higienização de dados.

Conclusão

A busca por uma “API Receita Federal” costuma esconder duas necessidades diferentes. Para validar, preencher e limpar cadastros, a base pública do CNPJ, pelos dados abertos, pelo Serpro ou por um webservice de consulta, é a fonte certa e muitas vezes gratuita. Para prospectar, priorizar e chegar no decisor, faltam justamente os campos que mais pesam na decisão comercial.

Saber em qual das duas situações você está evita pagar por dado que a Receita entrega de graça e evita montar uma operação de vendas sobre um cadastro que nunca foi feito para isso. Se o problema é comercial, o dado da Receita é o ponto de partida, e a Econodata ajuda a completar o caminho.

Perguntas frequentes sobre a API Receita Federal

A Receita Federal tem uma API gratuita para consultar CNPJ?

Não há uma API REST oficial e gratuita. A Receita publica a base completa do CNPJ em arquivos de dados abertos, atualizados mensalmente, e a consulta oficial por API é feita pelo Serpro, de forma paga. Os serviços gratuitos de consulta por CNPJ são de terceiros e usam a base pública como fonte.

O que é a API RFB?

“API RFB” é o nome informal para qualquer API que consulta o cadastro do CNPJ da Receita Federal do Brasil. Pode se referir à API Consulta CNPJ do Serpro ou a serviços de terceiros que reempacotam os dados abertos.

O que é o WS Receita Federal?

É o termo usado para webservices que retornam dados do CNPJ em JSON a partir da base da Receita, como o ReceitaWS. Eles simplificam a integração, mas trazem os mesmos campos da base pública e costumam limitar as consultas por minuto nas versões gratuitas.

A base da Receita informa o faturamento da empresa?

Não. Ela traz o porte fiscal (microempresa, empresa de pequeno porte ou demais), que é uma faixa de enquadramento tributário, e o capital social, que é o valor declarado na constituição. Nenhum dos dois equivale ao faturamento atual.

O telefone e o e-mail da Receita servem para prospecção?

Servem como ponto de partida, com cautela. São dados declarados no cadastro, sem validação, e muitas vezes pertencem ao escritório de contabilidade ou estão desatualizados desde a abertura da empresa.

Com que frequência os dados da Receita são atualizados?

Os arquivos de dados abertos do CNPJ são atualizados mensalmente, e a API do Serpro consulta o cadastro em tempo real. Serviços de terceiros variam conforme a fonte, então vale conferir a data de referência antes de usar o dado em decisões sensíveis, como a checagem de uma baixa recente.