Consulta e Download NFe por Chave de Acesso - XML + DANFE PDF
Pricing
from $550.00 / 1,000 nfes encontradas / invoices founds
Consulta e Download NFe por Chave de Acesso - XML + DANFE PDF
Consulte e baixe qualquer Nota Fiscal Eletrônica (NF-e) pela chave de acesso e receba o XML completo da nota e o DANFE em PDF. Modelo 55, em lote ou API REST. Exporte em JSON, CSV ou Excel, rode via API e agende. | NFe lookup by 44-digit access key: full NFe XML and DANFE PDF.
Pricing
from $550.00 / 1,000 nfes encontradas / invoices founds
Rating
5.0
(2)
Developer
brasildados.org - API de Dados Abertos
Maintained by CommunityActor stats
3
Bookmarked
69
Total users
10
Monthly active users
9 days ago
Last modified
Categories
Features
Share
🔎 O que é a Consulta NF-e por chave de acesso?
Informe a chave de acesso de uma ou várias Notas Fiscais Eletrônicas (NF-e) e receba, para cada nota, o link para baixar o XML completo, o link para baixar o DANFE em PDF, o conteúdo do XML e os principais dados da nota: modelo, série, número, natureza da operação, data de emissão e tipo de operação (entrada ou saída).
- ✅ Sem certificado digital da empresa: não precisa do certificado A1 ou A3, de procuração eletrônica nem de acesso ao e-CAC.
- ✅ Sem login na SEFAZ, no gov.br ou no portal da nota: basta a chave de 44 caracteres que aparece no DANFE, no XML ou no QR Code.
- ✅ XML completo (nfeProc): o mesmo arquivo autorizado pela SEFAZ, com emitente, destinatário, produtos, impostos, totais, transporte e protocolo de autorização.
- ✅ DANFE em PDF gerado a partir do XML, pronto para imprimir ou enviar.
- ✅ Links que abrem sem token: dá para repassar o XML e o PDF ao seu sistema ou a outra pessoa.
- ✅ Em lote: até 30 chaves por execução, consultadas em paralelo.
- ✅ Aceita a chave do jeito que você tiver: com espaços (como no DANFE), pontos, traços ou o prefixo
NFedo XML. - ✅ Exporta em JSON, CSV ou Excel, ou integra pela API.
💼 Casos de uso
- 📒 Contabilidade e escrituração: recuperar o XML de notas recebidas quando o fornecedor não enviou ou o arquivo se perdeu.
- 🏭 Entrada de mercadoria no ERP: importar o XML a partir da chave lida no DANFE ou no QR Code, sem digitar a nota.
- 🧾 Gerar o DANFE em PDF de uma nota só com a chave de acesso.
- 🔍 Conferência antes de pagar: checar número, série, data de emissão e natureza da operação antes de dar entrada ou liberar um pagamento.
- 🚚 Logística e transportadoras: obter o XML das notas da carga a partir das chaves do manifesto.
- 🤖 Automação: n8n, Make, Zapier, planilhas e agentes de IA (MCP) chamando a consulta por API.
🚀 Como usar pela API
Rode e receba as notas na mesma chamada:
curl -X POST "https://api.apify.com/v2/acts/brasildados~api-consulta-nfe-por-chave/run-sync-get-dataset-items" \-H "Authorization: Bearer SEU_TOKEN_APIFY" \-H "Content-Type: application/json" \-d '{"chaves":["35260444823938000187551090000002691092067649"]}'
Resposta real (o XML foi resumido):
[{"xmlUrl": "https://api.apify.com/v2/key-value-stores/<id-do-armazenamento>/records/xml-35260444823938000187551090000002691092067649?signature=<assinatura>","danfeUrl": "https://api.apify.com/v2/key-value-stores/<id-do-armazenamento>/records/danfe-35260444823938000187551090000002691092067649?signature=<assinatura>","xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><nfeProc versao=\"4.00\" ...>...</nfeProc>","chave": "35260444823938000187551090000002691092067649","modelo": "55","serie": "109","numero": "269","naturezaOperacao": "VENDA","dataEmissao": "2026-04-15T18:26:21-03:00","tipoOperacao": "saída","consultadoEm": "2026-09-19T11:52:10.412Z","erro": null}]
Use o endpoint run-sync-get-dataset-items: ele devolve as linhas do resultado. O endpoint run-sync devolve só o link do Dataset. O token fica em Settings → API & Integrations no Console da Apify.
🖱️ Pelo Console
- Clique em Try for free (ou Start) no topo desta página.
- No campo Chaves de acesso, cole uma chave por linha (de 1 a 30).
- Clique em Start.
- Abra a aba Output. Cada linha informada vira uma linha no resultado.
- Clique no link de
xmlUrlpara baixar o XML ou dedanfeUrlpara baixar o PDF.
⬇️ Entrada
| Campo | Descrição |
|---|---|
chaves | Obrigatório. De 1 a 30 chaves de acesso de NF-e, uma por linha, com ou sem formatação. |
{"chaves": ["35260444823938000187551090000002691092067649","3526 0444 8239 3800 0187 5510 9000 0002 6910 9206 7649"]}
Formato da chave
A chave de acesso da NF-e tem 44 caracteres. Você pode colar do jeito que tiver:
| Formato colado | Entende como |
|---|---|
35260444823938000187551090000002691092067649 | a chave |
3526 0444 8239 3800 0187 5510 9000 0002 6910 9206 7649 (com espaços, como no DANFE) | a mesma chave |
NFe35260444823938000187551090000002691092067649 (com o prefixo do XML) | a mesma chave |
Espaços, pontos, traços e o prefixo NFe são removidos antes da consulta. Chaves de CNPJ alfanumérico (com letras na parte do CNPJ) também são aceitas.
O que tem dentro da chave:
| Posição | Conteúdo | No exemplo |
|---|---|---|
| 1–2 | Código da UF do emitente | 35 (SP) |
| 3–6 | Ano e mês de emissão (AAMM) | 2604 |
| 7–20 | CNPJ do emitente | 44823938000187 |
| 21–22 | Modelo | 55 |
| 23–25 | Série | 109 |
| 26–34 | Número da nota | 000000269 |
| 35 | Tipo de emissão | 1 |
| 36–43 | Código numérico | 09206764 |
| 44 | Dígito verificador | 9 |
O que acontece com cada linha
| Você envia | O que acontece |
|---|---|
| Chave válida de uma nota existente | ✅ Linha com links, XML e dados da nota. |
| A mesma chave em duas linhas | ✅ Consultada uma vez; o resultado aparece nas duas linhas. |
Texto que não é uma chave de 44 caracteres (abc, 123, chave cortada) | ⚠️ Linha com erro: "Chave de acesso inválida...". |
| 44 caracteres que não formam uma chave real (dígito verificador errado, número digitado errado) | ⚠️ Linha com erro: "Chave de acesso inválida...". |
| Chave no formato certo, mas sem nota na origem | ⚠️ Linha com erro: "NF-e não encontrada...". |
| Linha em branco | ⏭️ Ignorada. |
| Mais de 30 chaves | ⛔ A Apify recusa a execução antes de começar. Divida em execuções de até 30. |
Pode colar tudo de uma vez: se uma chave estiver errada, as outras são consultadas normalmente. Cada chave vira uma linha no resultado, e a coluna Erro mostra o que aconteceu com ela:
- vazia: nota encontrada, com XML e DANFE;
- Chave de acesso inválida: a chave foi digitada ou copiada errada;
- NF-e não encontrada: a chave está certa, mas a nota não existe;
- indisponível / tempo esgotado: a fonte não respondeu agora; tente de novo mais tarde.
⬆️ Saída
Uma linha por chave informada, na ordem em que você colou. Download (JSON, CSV, Excel) e API sempre trazem todos os campos; as abas da aba Output do Console só mudam quais colunas aparecem na tela.
| Campo | Descrição |
|---|---|
xmlUrl | Link para baixar o XML completo da NF-e. |
danfeUrl | Link para baixar o DANFE em PDF. Pode vir null se o PDF não puder ser gerado naquele momento; o XML continua disponível. |
xml | Conteúdo completo do XML (nfeProc), para importar direto sem baixar o arquivo. Aparece na aba Todos os campos. |
chave | Chave de acesso com os 44 caracteres. Em linha inválida, o texto como foi informado. |
modelo | Modelo fiscal informado no XML (ex.: 55). |
serie | Série da nota. |
numero | Número da nota. |
naturezaOperacao | Natureza da operação (ex.: VENDA). |
dataEmissao | Data e hora de emissão (dhEmi do XML), com fuso horário. |
tipoOperacao | entrada ou saída, conforme o XML. |
consultadoEm | Data e hora da consulta (ISO 8601, UTC). |
erro | null quando a nota foi entregue; senão, o motivo. |
Linha sem nota (os campos da nota vêm null):
{"xmlUrl": null,"danfeUrl": null,"xml": null,"chave": "abc","modelo": null,"serie": null,"numero": null,"naturezaOperacao": null,"dataEmissao": null,"tipoOperacao": null,"consultadoEm": "2026-11-10T22:30:00.000Z","erro": "Chave de acesso inválida. Informe os 44 caracteres da chave."}
Mensagens possíveis em erro:
| Mensagem | Significado |
|---|---|
Chave de acesso inválida. Informe os 44 caracteres da chave. | O texto não é uma chave de NF-e válida: tamanho errado ou dígito verificador que não confere. |
NF-e não encontrada na origem para a chave informada. | A chave tem o formato certo, mas não há nota com ela. |
NF-e localizada, mas o XML não está disponível na origem. | A nota existe, mas o XML não pôde ser obtido agora. |
Tempo esgotado aguardando a NF-e na origem. | A nota não ficou pronta a tempo. |
NF-e indisponível na origem no momento. | Falha temporária na origem. |
Para filtrar só as notas entregues, use as linhas com erro igual a null.
Sobre os links do XML e do DANFE
- Os links abrem sem token da Apify, então podem ser repassados para o seu sistema ou para outra pessoa.
- Os arquivos ficam no armazenamento da execução e seguem o período de retenção de dados da sua conta Apify. Se precisar deles por mais tempo, baixe e guarde no seu sistema.
💰 Quanto custa?
Você paga por linha informada: cada chave que você cola vira uma linha no resultado e é cobrada, inclusive chave inválida, nota não encontrada e chave repetida. Cada execução tem também uma taxa fixa de início (Actor start). Os dois valores estão na aba Pricing.
| Situação | Gera linha? | Cobra? |
|---|---|---|
| Nota encontrada, com XML (com ou sem DANFE) | Sim | Sim |
| Chave repetida no lote | Sim, uma por linha | Sim, por linha |
| Chave fora do formato ou com dígito verificador errado | Sim, com erro | Sim |
| Nota não encontrada ou indisponível na origem | Sim, com erro | Sim |
| Linha em branco | Não | Não |
| Origem fora do ar para todas as chaves da execução | Não (a execução termina com falha) | Não |
🆓 Se a origem falhar em todas as chaves, a execução termina com falha e nada vai para o resultado, então nada é cobrado pelas linhas.
Se você definir um limite de gasto para a execução (Maximum cost per run), o Actor processa só as linhas que cabem nele e avisa no log quantas ficaram de fora. As que ficaram de fora não são cobradas.
💡 Para economizar:
- Confira as chaves antes de enviar: linha inválida ou repetida também é cobrada.
- Junte as chaves numa execução só (até 30). A taxa de início é cobrada uma vez por execução, não por chave.
⏱️ Quanto tempo demora?
- A maioria das notas responde em 2 a 3 segundos.
- Quando a nota ainda está na fila da origem, o Actor espera por ela por até cerca de 25 segundos antes de desistir dessa chave.
- 3 chaves são consultadas ao mesmo tempo; um lote de 30 chaves comuns termina em menos de 1 minuto.
- Se a origem falhar momentaneamente, o Actor tenta de novo sozinho, sem cobrança extra.
O endpoint run-sync-get-dataset-items da Apify espera no máximo 300 segundos pela execução. Para integrar lotes grandes sem depender desse limite, inicie a execução de forma assíncrona (POST /v2/acts/brasildados~api-consulta-nfe-por-chave/runs) e leia o dataset quando ela terminar.
📚 Como consultar mais de 30 notas
Divida a lista em blocos de 30 e rode uma execução por bloco.
JavaScript (npm i apify-client):
import { ApifyClient } from 'apify-client';const client = new ApifyClient({ token: 'SEU_TOKEN_APIFY' });const chaves = [/* suas chaves */];const notas = [];for (let i = 0; i < chaves.length; i += 30) {const run = await client.actor('brasildados/api-consulta-nfe-por-chave').call({ chaves: chaves.slice(i, i + 30) });const { items } = await client.dataset(run.defaultDatasetId).listItems();notas.push(...items.filter((n) => n.erro === null));}console.log(notas.length, 'notas entregues');
Python (pip install apify-client):
from apify_client import ApifyClientclient = ApifyClient("SEU_TOKEN_APIFY")chaves = [] # suas chavesnotas = []for i in range(0, len(chaves), 30):run = client.actor("brasildados/api-consulta-nfe-por-chave").call(run_input={"chaves": chaves[i:i + 30]})for nota in client.dataset(run["defaultDatasetId"]).iterate_items():if nota["erro"] is None:notas.append(nota)print(nota["numero"], nota["xmlUrl"], nota["danfeUrl"])print(len(notas), "notas entregues")
Cada execução cobra a taxa de início, e cada linha enviada é cobrada.
🔗 Integrações
- API REST e clientes oficiais da Apify para JavaScript e Python.
- n8n, Make e Zapier para levar o XML e o DANFE para o ERP, planilhas ou e-mail.
- Google Sheets e webhooks a partir do resultado de cada execução.
- Agendamento no Apify para processar chaves recebidas ao longo do dia.
- MCP para usar o Actor dentro de agentes de IA.
❓ Perguntas frequentes
Preciso do certificado digital da empresa?
Não. Nem certificado A1 ou A3, nem procuração eletrônica, nem login na SEFAZ ou no gov.br. Basta a chave de acesso.
Consigo baixar o XML de uma nota que eu recebi?
Sim. Basta a chave de acesso que está no DANFE impresso, no QR Code ou no e-mail do fornecedor.
O XML é o original da nota?
É o XML da nota autorizada (nfeProc, versão 4.00), com o protocolo de autorização da SEFAZ.
Uma chave inválida é cobrada?
Sim. A cobrança é por linha informada, válida ou não. Confira as chaves antes de enviar.
A mesma chave em duas linhas é cobrada duas vezes?
Sim, uma vez por linha. A origem é consultada uma vez só, e o resultado aparece nas duas linhas.
Por que uma chave voltou com erro?
O campo erro diz o motivo: a chave pode estar fora do formato, a nota pode não existir na origem ou a origem pode estar indisponível naquele momento. Veja a tabela de mensagens na seção Saída.
E se a origem estiver fora do ar?
Se a origem falhar em todas as chaves da execução, ela termina com falha e nada é cobrado pelas linhas. Tente de novo mais tarde.
Qual o limite por execução?
30 chaves. Para listas maiores, divida em várias execuções (há exemplos em JavaScript e Python acima).
Por quanto tempo os links do XML e do DANFE ficam disponíveis?
Pelo período de retenção de dados da sua conta Apify. Para guardar por mais tempo, baixe os arquivos.
Consulta NFS-e ou CT-e?
Não. Este Actor atende NF-e. Para CT-e, veja o Actor relacionado abaixo. NFS-e (nota de serviço municipal) não é atendida.
🧩 Outros Actors da BrasilDados
- 🚚 Consulta CT-e por chave de acesso para conhecimentos de transporte.
- 📦 Baixar NF-es em lote para volumes maiores.
🌐 https://brasildados.org/ · 🛒 Todos os Actors da BrasilDados
💬 Suporte
Encontrou um resultado diferente do descrito aqui? Abra uma issue na aba Issues do Actor com a chave consultada e o ID da execução. Não inclua tokens ou outras credenciais.
🇺🇸 English summary
Brazil NFe lookup by access key: XML, DANFE PDF and summary. No company digital certificate (A1/A3), SEFAZ or gov.br login required: just the 44-character access key.
- Input:
chaves(1 to 30 NFe access keys, one per line, any format: spaces, dots, dashes and theNFeprefix are removed). - Output: one row per key you enter, in input order:
xmlUrlanddanfeUrl(public signed links, no token needed), the fullxmlcontent,chave,modelo,serie,numero,naturezaOperacao,dataEmissao,tipoOperacao,consultadoEm, anderro(nullwhen the invoice was delivered, otherwise the reason). - Pricing: per key entered, plus a fixed Actor start fee per run. Invalid, not found and repeated keys are charged too; blank lines are not. If the source fails for every key in the run, the run fails and nothing is charged. See the Pricing tab.
- Speed: usually 2-3 s per invoice, up to ~25 s when the invoice is still queued at the source; 3 keys in parallel; automatic retries on temporary source failures.
- API:
POST https://api.apify.com/v2/acts/brasildados~api-consulta-nfe-por-chave/run-sync-get-dataset-itemswith{"chaves":["35260444823938000187551090000002691092067649"]}andAuthorization: Bearer <token>.