Como baixar XML de NFS-e Nacional em lote

Guia para escritórios de contabilidade · atualizado em 12/11/2026

Resposta curta: o portal nacional da NFS-e não tem download em lote. Nele, cada nota é aberta e baixada uma por vez. Para baixar os XMLs de vários clientes de uma vez, existem dois caminhos: consultar a API de distribuição do Ambiente de Dados Nacional (ADN) com o certificado A1 de cada CNPJ, ou usar uma ferramenta que faça essa consulta por você, todo dia.

1. Os três caminhos, lado a lado

Caminho	Como funciona	Serve para	Limite
Manual no portal	Entrar no portal do contribuinte e baixar o XML de cada nota	Poucas notas, de um CNPJ, de vez em quando	Uma nota por vez; repetir para cada cliente, todo mês
API do ADN	Um programa consulta a distribuição de documentos com o certificado A1 do CNPJ	Quem tem programador no escritório	Exige desenvolver, guardar os certificados com segurança e respeitar os limites de consulta
Coleta automática	Uma ferramenta consulta a mesma API todo dia e guarda as notas num painel	Escritório com vários clientes e fechamento mensal	É um serviço pago e exige o A1 de cada cliente

2. Manual, no portal nacional

O portal do contribuinte da NFS-e (gov.br/nfse) lista as notas emitidas e as recebidas do CNPJ que fez o acesso. De cada nota dá para baixar o XML e o PDF (DANFSe).

O acesso é por CNPJ: para cada cliente, é preciso entrar de novo com o certificado dele ou com a conta gov.br.
O download é nota por nota. Não há botão para baixar o mês inteiro.
Os arquivos chegam com nomes técnicos, e cabe ao escritório organizar por cliente e competência.

Funciona bem para conferir uma nota ou atender um cliente pequeno. Para dezenas de CNPJs, vira horas de trabalho repetido todo mês.

3. Pela API do Ambiente de Dados Nacional

O ADN é a base onde ficam as NFS-e de todos os municípios integrados ao padrão nacional. Ele tem uma API de distribuição de documentos, pensada para sistemas, que entrega ao CNPJ as notas em que ele aparece como prestador ou como tomador.

Autenticação: a conexão usa o certificado digital do próprio CNPJ consultado (certificado de cliente na conexão segura).
Sequência por NSU: cada documento tem um número sequencial. O sistema pede "o que veio depois do último número que eu já tenho" e recebe os documentos em blocos.
XML compactado: cada documento vem compactado dentro da resposta e precisa ser aberto antes de salvar.
Limites de consulta: repetir pedidos sem necessidade leva a bloqueio temporário. É preciso guardar o último NSU de cada CNPJ e esperar entre as consultas.
Eventos: além das notas, chegam eventos, como o cancelamento. Quem só guarda o XML da nota e ignora os eventos fica com nota cancelada na pasta como se valesse.

É o caminho certo para quem tem equipe técnica. A documentação oficial fica em gov.br/nfse.

4. Coleta automática diária

Uma ferramenta de coleta faz a consulta do item anterior por você, para todos os CNPJs do escritório, e entrega as notas já organizadas. O que diferencia este caminho de um download em lote feito uma vez:

Roda sozinha, todo dia. No fechamento, as notas do mês já estão lá.
Todos os clientes num lugar só, separados por CNPJ, competência, emitidas e recebidas.
Avisa o que mudou: nota cancelada, coleta que falhou, certificado perto de vencer.
Exporta em lote: ZIP com os XMLs do filtro, planilha e PDF, para importar no sistema contábil.

O Credens NFS-e faz isso para NFS-e Nacional e também para NF-e. Você cadastra o certificado A1 de cada cliente e as notas emitidas e recebidas chegam ao painel até 4 vezes por dia. Dá para testar por 14 dias, sem cartão, com até 5 CNPJs.

5. O que você precisa ter em mãos

Certificado A1 de cada CNPJ (arquivo .pfx e senha), dentro da validade. O A3 em token ou cartão não serve para coleta em servidor.
Município no padrão nacional. Só entram no ADN as notas de municípios que já enviam dados para lá. Confira o seu em Meu município já aderiu à NFS-e Nacional?
Um lugar seguro para os certificados. Quem tem o A1 e a senha pode agir em nome do cliente. Pergunte a qualquer ferramenta como o arquivo é guardado e quem consegue abri-lo.

6. Perguntas frequentes

O portal nacional da NFS-e tem download de XML em lote?

Não. No portal do contribuinte cada nota é aberta e baixada uma por vez. Para baixar em lote é preciso usar a API de distribuição do Ambiente de Dados Nacional, com o certificado A1 do CNPJ, ou uma ferramenta que faça isso.

Preciso do certificado digital de cada cliente?

Sim. A distribuição de documentos exige o certificado do próprio CNPJ consultado. Na coleta automática em servidor, precisa ser o A1 (arquivo .pfx). O A3 em token ou cartão e a procuração eletrônica não servem para isso.

Dá para baixar as notas recebidas, e não só as emitidas?

Sim. O Ambiente de Dados Nacional distribui ao CNPJ as NFS-e em que ele aparece como prestador e também como tomador.

E as NF-e de produto, vêm junto?

Não. NF-e é outro sistema: a distribuição de documentos da SEFAZ. Ela só entrega notas a partir da primeira consulta, sem retroativo, e o XML completo das notas recebidas depende da Ciência da Operação.