Consulta e Download NFe por Chave de Acesso - XML + DANFE PDF avatar

Consulta e Download NFe por Chave de Acesso - XML + DANFE PDF

Pricing

from $550.00 / 1,000 nfes encontradas / invoices founds

Go to Apify Store
Consulta e Download NFe por Chave de Acesso - XML + DANFE PDF

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

Actor stats

3

Bookmarked

69

Total users

10

Monthly active users

9 days ago

Last modified

Features

Limited permissions

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 NFe do 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

  1. Clique em Try for free (ou Start) no topo desta página.
  2. No campo Chaves de acesso, cole uma chave por linha (de 1 a 30).
  3. Clique em Start.
  4. Abra a aba Output. Cada linha informada vira uma linha no resultado.
  5. Clique no link de xmlUrl para baixar o XML ou de danfeUrl para baixar o PDF.

⬇️ Entrada

CampoDescrição
chavesObrigató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 coladoEntende como
35260444823938000187551090000002691092067649a 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çãoConteúdoNo exemplo
1–2Código da UF do emitente35 (SP)
3–6Ano e mês de emissão (AAMM)2604
7–20CNPJ do emitente44823938000187
21–22Modelo55
23–25Série109
26–34Número da nota000000269
35Tipo de emissão1
36–43Código numérico09206764
44Dígito verificador9

O que acontece com cada linha

Você enviaO 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.

CampoDescrição
xmlUrlLink para baixar o XML completo da NF-e.
danfeUrlLink para baixar o DANFE em PDF. Pode vir null se o PDF não puder ser gerado naquele momento; o XML continua disponível.
xmlConteúdo completo do XML (nfeProc), para importar direto sem baixar o arquivo. Aparece na aba Todos os campos.
chaveChave de acesso com os 44 caracteres. Em linha inválida, o texto como foi informado.
modeloModelo fiscal informado no XML (ex.: 55).
serieSérie da nota.
numeroNúmero da nota.
naturezaOperacaoNatureza da operação (ex.: VENDA).
dataEmissaoData e hora de emissão (dhEmi do XML), com fuso horário.
tipoOperacaoentrada ou saída, conforme o XML.
consultadoEmData e hora da consulta (ISO 8601, UTC).
erronull 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:

MensagemSignificado
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.

  • 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çãoGera linha?Cobra?
Nota encontrada, com XML (com ou sem DANFE)SimSim
Chave repetida no loteSim, uma por linhaSim, por linha
Chave fora do formato ou com dígito verificador erradoSim, com erroSim
Nota não encontrada ou indisponível na origemSim, com erroSim
Linha em brancoNãoNão
Origem fora do ar para todas as chaves da execuçãoNã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 ApifyClient
client = ApifyClient("SEU_TOKEN_APIFY")
chaves = [] # suas chaves
notas = []
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).

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

🌐 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 the NFe prefix are removed).
  • Output: one row per key you enter, in input order: xmlUrl and danfeUrl (public signed links, no token needed), the full xml content, chave, modelo, serie, numero, naturezaOperacao, dataEmissao, tipoOperacao, consultadoEm, and erro (null when 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-items with {"chaves":["35260444823938000187551090000002691092067649"]} and Authorization: Bearer <token>.