Consulta de Nota Fiscal Eletrônica (NF-e)
Com o serviço de consulta de Notas Fiscais Eletrônicas (NF-e) você se informa sobre uma nota apenas informando a chave de acesso de 44 dígitos. A NFE.io oferece duas opções de consulta, ambas com cobertura nacional e retorno em JSON, XML e DANFE em PDF pela mesma autenticação.
Para utilizar nossa API, acesse a referência REST. Você precisa de uma conta em nossa plataforma com uma Chave de Dados ativa.
Opções disponíveis
| Opção | Fonte de dados | Eventos da nota | Quando usar |
|---|---|---|---|
| Consulta SEFAZ | Portal público nacional da Receita Federal (nfe.fazenda.gov.br) | ✅ Sim — endpoint /events/{accessKey} | Quando precisa do histórico de eventos (cancelamento, CC-e, manifestação) ou prefere a fonte pública oficial. |
| Consulta Irrestrita | Provedor oficial autorizado pela autoridade federal | ❌ Não nesta versão | Quando precisa de maior previsibilidade em momentos de instabilidade do portal público. |
Ambas usam a mesma chave de acesso de 44 dígitos e a mesma Chave de Dados no header Authorization (sem prefixo Bearer). A diferença está na origem técnica dos dados e na disponibilidade do endpoint de eventos.
Quais dados nossa API retorna?
Através da chave de acesso da nota fiscal eletrônica, nossa API retorna os dados da nota em três formatos:
- JSON estruturado — pronto para consumo por sistemas.
- XML oficial (
nfeProc) — documento fiscal para arquivamento legal. - DANFE em PDF — documento visual para anexo e apresentação.
O conteúdo é equivalente entre os formatos. Para fins legais, o XML é a evidência probatória — guarde-o pelos 5 anos exigidos por lei.
Como faço para ter acesso à documentação da API?
Veja a referência REST completa no menu Desenvolvedores. Caso tenha dúvidas ou sugestões, entre em contato — nossa equipe está disponível.