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

Consulta NF-e por chave de acesso: XML e DANFE sem certificado digital

Informe a chave de acesso de uma ou várias Notas Fiscais Eletrônicas (NF-e) e receba, para cada nota encontrada, o link para baixar o XML completo, o link para baixar o DANFE em PDF 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).

Não precisa de certificado digital, login na SEFAZ nem cadastro no portal da nota. Basta a chave de 44 caracteres que aparece no DANFE, no XML ou no QR Code da nota.

Você pode usar pelo Console da Apify, com poucos cliques, ou integrar pela API em sistemas de ERP, contabilidade, conciliação fiscal, logística e automações (Make, n8n, Zapier).

Para que serve

• Recuperar o XML de notas recebidas para escrituração, contabilidade ou importação no ERP.
• Gerar o DANFE em PDF de uma nota a partir só da chave de acesso.
• Conferir dados de uma nota (número, série, data de emissão, natureza da operação) antes de dar entrada em mercadoria ou pagar um fornecedor.
• Automatizar a entrada de notas em lote: até 50 chaves por execução, todas processadas em paralelo.

Como usar

Pelo Console da Apify

1. Abra o Actor e vá até a aba Input.
2. No campo Chaves de acesso, cole uma chave por linha (de 1 a 50).
3. Clique em Start.
4. Abra a aba Output (ou Dataset). Cada nota encontrada vira uma linha.
5. Clique no link de xmlUrl para baixar o XML ou de danfeUrl para baixar o PDF.

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. A mesma chave informada em formatos diferentes é consultada e cobrada uma única vez. Chaves de CNPJ alfanumérico (com letras na parte do CNPJ) também são aceitas.

Entrada

Campo	Obrigatório	Descrição
chaves	Sim	Lista de 1 a 50 chaves de acesso de NF-e, com ou sem formatação.

Exemplo:

{
  "chaves": [
    "35260444823938000187551090000002691092067649"
  ]
}

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"]}'

A resposta é a lista de notas em JSON, no formato da seção Dados entregues. Use o endpoint run-sync-get-dataset-items: ele devolve as notas. O endpoint run-sync devolve apenas o link do Dataset.

Para lotes, envie várias chaves na mesma chamada (até 50). Para mais de 50 chaves, divida em várias execuções.

Em Python, com o cliente oficial:

from apify_client import ApifyClient

client = ApifyClient("SEU_TOKEN_APIFY")
run = client.actor("brasildados/api-consulta-nfe-por-chave").call(
    run_input={"chaves": ["35260444823938000187551090000002691092067649"]}
)
for nota in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(nota["numero"], nota["xmlUrl"], nota["danfeUrl"])

Dados entregues

Cada NF-e encontrada gera uma linha no Dataset. Exemplo real:

{
  "xmlUrl": "https://api.apify.com/v2/key-value-stores/.../records/xml-35260444823938000187551090000002691092067649?signature=...",
  "danfeUrl": "https://api.apify.com/v2/key-value-stores/.../records/danfe-35260444823938000187551090000002691092067649?signature=...",
  "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
}

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.
chave	Chave de acesso consultada, só com os 44 caracteres.
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	Sempre null nas linhas entregues.

O XML completo (emitente, destinatário, produtos, impostos, totais) está no arquivo de xmlUrl. Ele não é repetido dentro do Dataset, para a linha continuar leve e fácil de exportar em CSV ou Excel.

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 dos arquivos por mais tempo, baixe e guarde no seu sistema.

O que é cobrado

A cobrança é por nota entregue no Dataset. Veja o preço vigente na aba Pricing.

Situação	Gera linha?	Cobra?
Nota encontrada, com XML	Sim	Sim
Nota encontrada, XML ok e DANFE indisponível	Sim (danfeUrl: null)	Sim
Mesma chave repetida no lote	Uma linha só	Uma vez
Chave fora do formato (não tem 44 caracteres válidos)	Não	Não
Chave válida, mas nota não encontrada na origem	Não	Não
Nota localizada, mas XML indisponível na origem	Não	Não
Origem fora do ar ou lenta demais	Não	Não

As chaves que não geram linha aparecem com um aviso no log da execução. Uma chave com problema não interrompe as outras.

Você pode definir um limite de gasto por execução (Maximum cost per run). Quando ele é atingido, a execução para e as chaves seguintes não são consultadas nem cobradas.

Limites

• De 1 a 50 chaves por execução. Um lote com mais de 50 é recusado antes de começar; divida em várias execuções.
• A consulta depende da disponibilidade da origem. Em raras exceções, uma nota válida não retorna naquele momento; tente de novo mais tarde.
• Atende NF-e. Não consulta NFS-e (nota de serviço municipal).

Perguntas frequentes

Preciso de certificado digital? Não. Basta a chave de acesso.

A mesma chave em dois formatos é cobrada duas vezes? Não. O Actor remove a formatação antes de consultar e consulta cada chave uma única vez.

Por que uma chave não retornou nada? Veja o aviso no log da execução: a chave pode estar fora do formato, a nota pode não existir na origem ou a origem pode estar indisponível naquele momento. Nesses casos não há cobrança.

Actors relacionados da BrasilDados

• Consulta CT-e por chave de acesso para conhecimentos de transporte.
• Baixar NF-es em lote para volumes maiores.
• 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.