Pular para o conteúdo principal
Ver como MarkdownDocs para agentes

Consulta de CNPJ — V2 (legada)

Legada: a V2 ainda responde normalmente e não há data de descontinuação definida. Para integrações novas, use a V3.

Endpoint​

MétodoURL
GEThttps://legalentity.api.nfe.io/v2/legalentities/basicInfo/{federalTaxNumber}

O CNPJ é informado no parâmetro federalTaxNumber, sem barras, traços ou pontos.

Limitação: CNPJ alfanumérico​

A V2 não aceita CNPJ no formato alfanumérico (padrão pós IN RFB nº 2.229/2024, em vigor desde julho de 2026). Requisições com CNPJ contendo letras são rejeitadas na borda da API, antes de qualquer processamento:

  • HTTP 400 Bad Request, com o código de erro 40001 e a mensagem: CNPJ alfanumérico não é suportado nesta versão. Utilize a v3.

Se sua integração pode receber CNPJs alfanuméricos, trate o código 40001 como sinal de migração e use a V3. Veja o guia de migração.

Autenticação​

Mesma autenticação por API Key das demais APIs de consulta da NFE.io — veja chaves de autenticação.

Documentação completa da API​

A referência completa de campos, exemplos e códigos de status da V2 está na documentação da API de Consulta de CNPJ (V2).

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.