Consulta NFe por Chave de Acesso - XML e DANFE PDF

Consulta NFe por Chave de Acesso

Consulta NFe por Chave de Acesso é uma API para consultar a Nota Fiscal Eletrônica (NF-e, modelo 55) no Brasil a partir da chave de acesso de 44 dígitos. Informe a chave e receba o XML completo da nota (layout nfeProc 4.00) em um único campo, mais links de download prontos para o XML e o DANFE em PDF. Cada chave gera um registro estruturado com a situação da consulta, pronto para escrituração fiscal, conciliação contábil, validação de notas e integração com ERP. Processe até 50 chaves por execução e exporte em JSON, CSV, Excel ou XML, rode via API, agende e monitore execuções, use webhooks ou consulte em tempo real pela API REST Standby (POST /check). Chave com dígito verificador inválido falha localmente, sem cobrança.

Casos de uso

• Escrituração fiscal: capturar o XML da NF-e pela chave para SPED, EFD e obrigações acessórias
• Conciliação contábil: validar notas recebidas e cruzar valores com lançamentos
• Validação e antifraude: confirmar autorização (protocolo e situação) direto da origem
• Importação para ERP: trazer o XML completo da nota pronto para importar
• Auditoria em lote: processar centenas de chaves e exportar para planilha ou data lake
• Download com um clique: baixar o XML e o DANFE em PDF de cada nota pelos links retornados

O que este Actor retorna?

🧾 XML completo	xml.data com o nfeProc (layout 4.00) inteiro, sem alterações
📥 Download do XML	xmlUrl: link público para baixar o XML com um clique
📄 Download do DANFE	danfeUrl: link público para baixar o DANFE em PDF
🔑 Identificação	chave, encontrado, consultadoEm, referenciaConsulta
⚠️ Erros	erro claro para chave inválida ou nota não localizada

Por que usar este Actor?

• 🧾 Só a chave: a chave de acesso de 44 dígitos é tudo o que você precisa informar
• 📥 XML inteiro: a nota completa em um campo só, estável a mudanças de layout
• 🔗 Links de download: XML (xmlUrl) e DANFE em PDF (danfeUrl) prontos para clicar, em toda nota encontrada
• 📤 Lote: até 50 chaves por execução, com exportação em JSON, CSV, Excel ou XML
• ⚡ API Standby: POST /check para ERP, contabilidade e automações em tempo real
• 💰 Cobrança justa: só nota com encontrado: true; chave inválida não é cobrada

Como consultar NFe em lote

1. Abra o actor no Console Apify na aba Input.
2. Cole as chaves na lista chaves (uma por linha, 44 dígitos cada).
3. Clique em Start e exporte o Dataset em JSON, CSV ou XLSX.

Exemplo de entrada:

{
  "chaves": ["35260444823938000187551090000002691092067649"]
}

Exemplo de saída

{
  "chave": "35260444823938000187551090000002691092067649",
  "encontrado": true,
  "consultadoEm": "2026-06-03T11:00:00.000Z",
  "referenciaConsulta": "bd-af03c0f94e82",
  "xml": {
    "name": "NFE-35260444823938000187551090000002691092067649.xml",
    "type": "NFE",
    "format": "XML",
    "data": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><nfeProc versao=\"4.00\" ...>...</nfeProc>"
  },
  "xmlUrl": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/xml-35260444823938000187551090000002691092067649?signature=...",
  "danfeUrl": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/danfe-35260444823938000187551090000002691092067649?signature=...",
  "erro": null
}

API Standby (consulta em tempo real)

Mantenha o actor em Standby e consulte a NF-e por uma requisição REST:

curl -X POST "https://brasildados--api-consulta-nfe-por-chave.apify.actor/check?token=SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"chaves":["35260444823938000187551090000002691092067649"]}'

Retorna um array com um registro por chave, ideal para integrar em ERP, sistemas contábeis e fluxos antifraude.

Perguntas frequentes

Preciso informar mais alguma coisa além da chave? Não. A chave de acesso de 44 dígitos é o único dado obrigatório.

O actor parseia os campos do XML? Nesta versão, não. O XML completo é entregue em um campo só (xml.data), o que mantém o actor estável a mudanças de layout. Você parseia exatamente os campos que precisar.

Como baixo o XML e o DANFE? Toda nota encontrada já vem com xmlUrl (download do XML) e danfeUrl (download do DANFE em PDF). São links públicos clicáveis, sem precisar de token. A validade segue o período de retenção do run, então baixe dentro desse prazo se precisar arquivar.

Funciona com notas antigas? A consulta é feita pela chave de acesso, sem janela de data fixa. Notas não localizadas na origem retornam encontrado: false.

Quando há cobrança? Apenas quando a nota é encontrada (encontrado: true). Chave inválida ou não localizada não é cobrada.

Posso usar via API e agendamento? Sim. Rode por API, agende execuções, configure webhooks ou use a API Standby para tempo real, tudo pela plataforma Apify.

---

🇬🇧 English

Brazilian NFe Lookup by Access Key

Look up a Brazilian electronic invoice (NF-e, model 55) by its 44-digit access key and get the full NFe XML (nfeProc 4.00 layout) in a single field, plus ready-to-use download links for the XML (xmlUrl) and the DANFE PDF (danfeUrl). Each key returns one structured record with the lookup status, ready for tax bookkeeping, accounting reconciliation, invoice validation and ERP integration. Process up to 50 keys per run and export to JSON, CSV, Excel or XML, run via API, schedule and monitor runs, use webhooks, or query in real time through the Standby REST API (POST /check). An invalid check digit fails locally, with no charge.

Use cases

• Capture the NF-e XML by access key for tax bookkeeping and accessory obligations
• Reconcile received invoices and cross-check totals with accounting entries
• Confirm authorization (protocol and status) straight from the source for anti-fraud
• Import the complete invoice XML into your ERP
• Audit hundreds of keys in batch and export to spreadsheets or a data lake
• Download the XML and DANFE PDF of each note with a single click

This version does not parse XML fields - it delivers the complete XML so your system can parse exactly what it needs, staying resilient to layout changes. Billing only applies when the note is found (encontrado: true).

---

📧 contato@brasildados.org · 🌐 brasildados.org