Consulta e Download NFe por Chave de Acesso - XML + 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, sem necessidade de certificado digital. Informe a chave e receba a nota já quebrada em campos (campo dados): emitente, destinatário, itens com impostos detalhados (ICMS, IPI, PIS, COFINS), totais e protocolo de autorização. Junto vem o XML completo (layout nfeProc 4.00) e 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.

🎯 O diferencial: a maioria das consultas de NFe devolve só o XML cru e deixa o trabalho pesado com você. Aqui você cola a chave e recebe a nota pronta para usar - cada campo já extraído (emitente, destinatário, produtos, impostos por item, totais e protocolo de autorização), sem escrever uma linha de parser. O XML completo e o DANFE em PDF vêm junto, para quando você precisar do arquivo original.

Casos de uso

• Escrituração fiscal: capturar a NF-e pela chave em campos prontos (e o XML) para SPED, EFD e obrigações acessórias
• Conciliação contábil: cruzar itens, impostos e totais já estruturados com seus lançamentos, sem parsear XML
• Validação e antifraude: confirmar autorização (protocolo e situação) direto da origem
• Importação para ERP: mapear os campos do objeto dados direto para o seu sistema, ou usar o XML completo
• Auditoria em lote: processar centenas de chaves e exportar itens e impostos 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?

📊 Dados estruturados	dados com identificação, emitente, destinatário, itens (impostos detalhados), totais, transporte, pagamento e protocolo
🧾 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?

• 📊 Nota já estruturada: cada campo extraído no objeto dados (emitente, destinatário, itens, impostos por item, totais, protocolo) - sem precisar escrever parser de XML
• 🧾 Só a chave: a chave de acesso de 44 dígitos é tudo o que você precisa informar
• 💸 Impostos detalhados: ICMS, IPI, PIS e COFINS por item, prontos para conferência fiscal e contábil
• 📥 XML + DANFE juntos: o nfeProc 4.00 completo (xml) e links de download para o XML (xmlUrl) e o DANFE em PDF (danfeUrl), 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",
  "dados": {
    "identificacao": {
      "chave": "35260444823938000187551090000002691092067649",
      "modelo": "55",
      "serie": "109",
      "numero": "269",
      "naturezaOperacao": "Venda de mercadoria",
      "dataEmissao": "2026-04-15T10:30:00-03:00",
      "tipoOperacao": "saída",
      "ambiente": "produção"
    },
    "emitente": {
      "cnpjCpf": "44823938000187",
      "razaoSocial": "Empresa Emitente LTDA",
      "inscricaoEstadual": "123456789",
      "regimeTributario": "Regime Normal",
      "endereco": { "municipio": "São Paulo", "uf": "SP", "cep": "01001000" }
    },
    "destinatario": {
      "cnpjCpf": "12345678000199",
      "razaoSocial": "Cliente Destinatário S.A.",
      "endereco": { "municipio": "Campinas", "uf": "SP" }
    },
    "itens": [
      {
        "numero": 1,
        "codigo": "P-001",
        "descricao": "Produto exemplo",
        "ncm": "84713012",
        "cfop": "5102",
        "unidadeComercial": "UN",
        "quantidade": 2,
        "valorUnitario": 150.0,
        "valorTotal": 300.0,
        "impostos": {
          "icms": { "origem": "0", "cst": "00", "baseCalculo": 300.0, "aliquota": 18.0, "valor": 54.0 },
          "pis": { "cst": "01", "baseCalculo": 300.0, "aliquota": 1.65, "valor": 4.95 },
          "cofins": { "cst": "01", "baseCalculo": 300.0, "aliquota": 7.6, "valor": 22.8 }
        }
      }
    ],
    "totais": {
      "valorProdutos": 300.0,
      "valorICMS": 54.0,
      "valorPIS": 4.95,
      "valorCOFINS": 22.8,
      "valorTotalNota": 300.0
    },
    "pagamento": [{ "forma": "PIX", "valor": 300.0 }],
    "protocolo": {
      "numero": "135260000123456",
      "dataAutorizacao": "2026-04-15T10:31:00-03:00",
      "status": "100",
      "motivo": "Autorizado o uso da NF-e",
      "situacao": "autorizada"
    }
  },
  "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? Sim. A nota vem quebrada em campos no objeto dados (identificação, emitente, destinatário, itens com impostos detalhados, totais, transporte, pagamento e protocolo), pronta para planilha e ERP. O XML completo (xml.data) continua disponível, então você pode usar os campos prontos ou parsear o XML como preferir.

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 invoice already parsed into fields (the dados object): issuer, recipient, line items with detailed taxes (ICMS, IPI, PIS, COFINS), totals and the authorization protocol. The full NFe XML (nfeProc 4.00 layout) is included too, 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.

🎯 What sets it apart: most NFe lookups return only the raw XML and leave the heavy lifting to you. Here you paste the key and get the invoice ready to use - every field already extracted (issuer, recipient, products, per-item taxes, totals and authorization protocol), with no parser to write. The full XML and DANFE PDF come along for when you need the original file.

Use cases

• Capture the NF-e by access key as ready-to-use fields (and the XML) for tax bookkeeping
• Reconcile line items, taxes and totals already structured against your accounting entries
• Confirm authorization (protocol and status) straight from the source for anti-fraud
• Map the dados fields straight into your ERP, or use the complete XML
• Audit hundreds of keys in batch and export items and taxes to spreadsheets or a data lake
• Download the XML and DANFE PDF of each note with a single click

The invoice comes parsed into fields (the dados object) with line items and detailed taxes, ready for spreadsheets and ERP, and the complete XML is delivered as well so your system can parse exactly what it needs. Billing only applies when the note is found (encontrado: true).

---

📧 contato@brasildados.org · 🌐 brasildados.org