Pricing

Rating

Developer

Actor stats

Categories

Share

📦 Baixar NF-e em Lote: XML e DANFE em ZIP

Consulte uma ou mais chaves de acesso NF-e (modelo 55), sem necessidade de certificado digital, e receba um único arquivo .zip com os XMLs e os DANFEs (PDF) de todas as notas. Ideal para contadores, ERPs e rotinas de arquivo fiscal que precisam de vários documentos de uma vez sem fazer uma requisição por nota.

🎯 Diferencial: uma única chamada para até 50 chaves; o actor consulta em paralelo, monta o .zip com XMLs + DANFEs e devolve a URL pronta para download - sem precisar gerenciar cada nota individualmente.

O que retorna

Estrutura interna do ZIP:

nfe-lote.zip
├── xmls/
│ └── 35260444...xml ← XML completo da NF-e
├── danfes/
│ └── 35260444...pdf ← DANFE em PDF
└── manifest.json ← array com todos os resultados

Por que usar

• 🔄 Lote sem código extra - envie até 50 chaves numa única chamada; sem loop de requisições
• ⚡ 8 consultas em paralelo - todas as notas são buscadas ao mesmo tempo
• 📁 ZIP organizado - XMLs em xmls/, DANFEs em danfes/, manifesto incluso
• 💰 Cobrança justa - paga somente por nota encontrada; inválidas e não encontradas não cobram
• 🔗 Integração via API ou Standby - lote assíncrono ou endpoint HTTP síncrono

Como usar

1. Cole as chaves de acesso

No campo "Chaves de Acesso NF-e", informe uma ou mais chaves de 44 dígitos (pontuação é ignorada):

{
"chaves":[
"35260444823938000187551090000002691092067649",
"35260444823938000187551090000002691092067650"
]
}

2. Execute o actor

Clique em "Save & Start". O actor consulta cada nota em paralelo e gera o arquivo .zip.

3. Baixe o ZIP

Na aba Output, clique em Arquivo ZIP (XMLs e DANFEs) para baixar. Ou use a zipUrl retornada para integrar no seu sistema.

Precificação

Cobrado por nota encontrada - $0.10 por NF-e localizada (evento consulta-nfe-lote).

• Chaves inválidas (dígito verificador errado): sem cobrança
• Notas não encontradas no banco: sem cobrança
• 50 notas encontradas: $0.10 × 50 = $5.00

Exemplo de saída

{
"zipUrl":"https://api.apify.com/v2/key-value-stores/abc.../records/nfe-lote.zip?signature=...",
"totalChaves":2,
"totalEncontradas":1,
"totalNaoEncontradas":1,
"totalInvalidas":0,
"erros":[
{"chave":"35260444823938000187551090000002691092067650","erro":"Nota não encontrada."}
],
"geradoEm":"2026-06-09T10:20:54.324Z",
"resultados":[
{
"chave":"35260444823938000187551090000002691092067649",
"encontrado":true,
"consultadoEm":"2026-06-09T10:20:52.955Z",
"referenciaConsulta":"bd-af03c0f94e82",
"temXml":true,
"temDanfe":true,
"erro":null
},
{
"chave":"35260444823938000187551090000002691092067650",
"encontrado":false,
"consultadoEm":"2026-06-09T10:20:53.100Z",
"referenciaConsulta":"bd-c1d2e3f4a5b6",
"temXml":false,
"temDanfe":false,
"erro":"Nota não encontrada."
}
]
}

Perguntas frequentes

Quais NF-es são suportadas? NF-e modelo 55 (nota eletrônica de mercadoria). Não inclui NFS-e (serviços) nem CT-e (conhecimento de transporte). Para CT-e, use o actor Consulta CT-e por Chave.

Qual o limite de chaves por execução? 50 chaves por run. Para volumes maiores, divida em lotes e execute sequencialmente.

E se o DANFE não estiver disponível? Algumas notas têm XML mas não têm DANFE disponível no banco. Nesse caso temXml: true e temDanfe: false - o ZIP terá o XML mas não o PDF para aquela chave.

O link do ZIP expira? Sim. O link zipUrl fica ativo pelo tempo de retenção do run (padrão Apify: 7 dias em planos pagos). Para arquivo permanente, baixe e guarde o ZIP no seu sistema.

Posso chamar em tempo real (Standby)? Sim. O endpoint POST /export responde de forma síncrona. Veja os exemplos curl abaixo.

🔌 Integração via API

Execução em lote:

curl-X POST "https://api.apify.com/v2/acts/brasildados~baixar-nfes-lote-api/run-sync-get-dataset-items?token=SEU_TOKEN"\
-H"Content-Type: application/json"\
-d'{"chaves":["35260444823938000187551090000002691092067649"]}'

Standby (POST /export):

curl-X POST "https://brasildados--baixar-nfes-lote-api.apify.actor/export"\
-H"Authorization: Bearer SEU_APIFY_TOKEN"\
-H"Content-Type: application/json"\
--compressed\
-d'{"chaves":["35260444823938000187551090000002691092067649"]}'

Actors relacionados

Legal

Este actor acessa informações de NF-e por meio de chave de acesso (dado público por design da SEFAZ para o portador da chave). O usuário é responsável por garantir que possui autorização para acessar as notas consultadas.

🇬🇧 English

Query NF-e access keys (Brazilian electronic invoices, model 55) in parallel and receive a single .zip file with all XMLs and DANFEs (PDFs). Maximum 50 keys per run — no need to fetch each invoice individually.

How to use:

{
"chaves":["35260444823938000187551090000002691092067649"]
}

Batch run:

curl-X POST "https://api.apify.com/v2/acts/brasildados~baixar-nfes-lote-api/run-sync-get-dataset-items?token=YOUR_TOKEN"\
-H"Content-Type: application/json"\
-d'{"chaves":["35260444823938000187551090000002691092067649"]}'

Standby (POST /export):

curl-X POST "https://brasildados--baixar-nfes-lote-api.apify.actor/export"\
-H"Authorization: Bearer YOUR_APIFY_TOKEN"\
-H"Content-Type: application/json"\
--compressed\
-d'{"chaves":["35260444823938000187551090000002691092067649"]}'

Pricing: $0.10 per found invoice (event consulta-nfe-lote). Invalid keys and not-found invoices are not charged.

Related: Individual NF-e lookup (structured data: issuer, items, taxes, payment).

Dúvidas ou problemas? contato@brasildados.org | brasildados.org