API para Baixar NF-e em Lote (XML e DANFE)

Envie até 50 chaves de acesso e receba um único ZIP com todos os XMLs e DANFEs, sem certificado digital.

JSON CSV XLSX XML

Não tem conta Apify? Crie grátis aqui.

Como integrar

curl -X POST "https://api.apify.com/v2/actors/brasildados~baixar-nfes-lote-api/run-sync-get-dataset-items" \
  -H "Authorization: Bearer SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"chaves":["35260444823938000187551090000002691092067649","35260444823938000187551090000002691092067650"]}'
Exemplo de resposta
{
  "chave": "35260444823938000187551090000002691092067649",
  "encontrado": true,
  "consultadoEm": "2026-09-08T15:48:37.311Z",
  "referenciaConsulta": "bd-af03c0f94e82",
  "temXml": true,
  "temDanfe": true,
  "erro": null,
  "zipUrl": "https://api.apify.com/v2/key-value-stores/*****/records/nfe-lote.zip?signature=*****"
}

O que a API de download de NF-e em lote retorna

  • URL de download do ZIP com todos os arquivos

  • XML individual de cada nota encontrada

  • DANFE em PDF de cada nota

  • Status por chave: encontrada ou não

  • Motivo do erro quando a chave falha

  • Contagem de sucessos e falhas da execução

  • Referência da consulta para conciliação

Exemplo de resultado da API de download de NF-e em lote: URL de download do ZIP com todos os arquivos

Casos de uso da API de download de NF-e em lote

Fechamento fiscal mensal em escritório de contabilidade

Arquivamento das notas exigido pela legislação

Importação de documentos fiscais para o ERP

Auditoria e recuperação de crédito tributário

Perguntas frequentes sobre download de NF-e em lote

Como baixar várias notas fiscais de uma vez pela chave de acesso?

Monte um array com até 50 chaves de 44 dígitos e envie em uma requisição. A API consulta todas em paralelo e devolve uma URL única de download com o ZIP contendo os XMLs e os DANFEs.

Preciso de certificado digital para baixar o XML da nota?

Não. A consulta é feita pela chave de acesso, sem e-CNPJ e sem instalar nada. É o caminho usual de quem recebeu a chave mas não tem o arquivo.

O que vem dentro do ZIP?

Um XML e um DANFE em PDF para cada chave encontrada, nomeados pela própria chave. As chaves que falharam ficam de fora do ZIP e aparecem no dataset com o motivo do erro.

Qual a diferença para a API de consulta de NF-e por chave?

A de consulta devolve a nota interpretada em JSON, campo a campo, e serve para integrar dado. Esta aqui é para arquivo em volume: você quer os arquivos, não os campos, e recebe tudo empacotado.

Como saber quais chaves falharam no download em lote?

Cada chave volta com o status de encontrada ou não e, quando falha, com o motivo do erro. A execução também traz a contagem de sucessos e falhas, então dá para separar as chaves com problema e reenviar só elas.

Quantas notas dá para baixar por execução?

Até 50 chaves por execução. Para volumes maiores, basta dividir em execuções sucessivas, e cada uma gera o seu próprio ZIP.

Artigos sobre download de NF-e em lote

6 min de leitura

Como baixar o XML da NF-e pela chave de acesso, sem certificado digital

Para baixar o XML de uma NF-e, você só precisa da chave de acesso, o número de 44 dígitos que aparece no DANFE, embaixo do código de barras. Com ela, dá para recuperar o XML completo e o DANFE em PDF da nota, sem certificado digital e sem login na SEFAZ. O XML é o documento fiscal que vale; o DANFE é só a versão para imprimir. Para uma nota, a consulta pela chave resolve; para dezenas, o download em lote entrega tudo num arquivo só.

Ler artigo

APIs relacionadas a download de NF-e em lote

Documentos Fiscais

Consulta de NF-e por Chave de Acesso

XML completo da nota fiscal eletrônica e DANFE em PDF a partir da chave de acesso de 44 dígitos.

Ver detalhes
Consulta de Dados Cadastrais

Enriquecimento de Lista de CNPJs

Suba uma lista de CNPJs e receba cada um completo: razão social, endereço, contato, porte e quadro societário.

Ver detalhes
Consulta de Dados Cadastrais

Busca de Empresas por CNPJ

Dados cadastrais completos, score cadastral, sócios e contatos de qualquer CNPJ brasileiro.

Ver detalhes