Guias › NFS-e Nacional (portal nfse.gov.br)

Guia

Como baixar XML e DANFSe de várias NFS-e de uma vez (em lote): os 3 jeitos que existem

Guia · atualizado em 30/10/2026

Resumo: o Emissor Nacional não tem "exportar tudo": em NFS-e Emitidas, XML e DANFSe saem uma nota por vez. Três caminhos para pegar várias de uma vez: manual com método (filtro, nome padronizado, conferência), API da NFS-e Nacional (consulta por chave e distribuição por NSU; exige certificado digital e software) e emitir por um sistema que já guarda XML e PDF e entrega o ZIP do mês. Pro contador vale o XML; o PDF é apoio.

Por que o portal não resolve (e quando isso vira problema)

O guia oficial do Emissor Nacional Web descreve a tela "NFS-e emitidas" como uma lista paginada, com campo de pesquisa e um totalizador (Total NFS-e emitidas). As ações ficam na linha de cada nota: Visualizar, Substituir, Cancelar, Download do XML e Download do DANFSe. O guia não descreve seleção múltipla nem exportação do período.

Com cinco notas por mês isso é tolerável. Vira problema em três situações:

  • Fechamento mensal: o contador pede todos os XMLs da competência. Com 30 notas são 60 downloads, mais renomear e conferir.
  • Vários tomadores: na comissão de afiliado, cada loja que pagou é um tomador diferente e quer o XML da nota dela.
  • Troca de contador ou fiscalização: alguém pede um ano inteiro de arquivos.

E o volume só cresce: o MEI emite no Emissor Nacional desde 01/09/2023 e, a partir de 01/11/2026, ME e EPP do Simples emitem só por lá (Resoluções CGSN 189/2026 e 191/2026).

Jeito 1: manual, com método

Funciona bem até umas 30 notas por mês. O segredo é não perder nenhuma.

  1. Filtre a competência. Em NFS-e Emitidas, deixe só o mês pedido e anote o totalizador (Total NFS-e emitidas): é a sua meta de arquivos.
  2. Crie a pasta antes. Uma por mês (2026-10), com subpastas xml e pdf.
  3. Baixe em ordem. Linha por linha: Download do XML, depois Download do DANFSe. A lista é paginada; termine uma página antes de ir para a próxima.
  4. Renomeie na hora. Padrão fixo: 2026-10_000123_CNPJ-do-tomador.xml, e o mesmo nome no .pdf. Ou use a chave de acesso de 50 dígitos, que é única.
  5. Confira a quantidade. O total de XMLs na pasta tem que bater com o totalizador. Se faltar um, volte à lista e ache qual é.
  6. Feche o pacote. Zipe a pasta do mês e mande junto a planilha-resumo (modelo abaixo).

Extensões de navegador que prometem "baixar todos os XML" existem, mas nenhuma aparece na documentação oficial. Elas rodam dentro da sua sessão logada e algumas pedem o certificado digital ou a senha dele. O que a extensão fizer com esse acesso é responsabilidade sua.

Jeito 2: API da NFS-e Nacional com certificado A1

A API é o jeito de um software falar com o sistema nacional. Toda chamada usa certificado digital, e nas consultas de distribuição e de DPS o sistema só devolve o que pertence a quem assina (prestador, tomador ou intermediário). Os manuais oficiais para contribuintes descrevem estas consultas:

OperaçãoO que devolve
GET /nfse/{chaveAcesso}A NFS-e correspondente à chave de acesso informada.
GET /dps/{id}A chave de acesso da NFS-e gerada a partir daquela DPS. Serve quando você tem o número da DPS, não a chave.
GET /DFe/{NSU}Os documentos fiscais do NSU informado, para quem figura como emitente, tomador ou intermediário (distribuição sequencial).
GET /nfse/{chaveAcesso}/eventosOs eventos vinculados à nota, como cancelamento e substituição.

As consultas por chave e por DPS estão no manual das APIs do Emissor Público Nacional; a distribuição por NSU, no guia das APIs do ADN. A API responde uma nota por chave ou um documento por NSU; o lote é um programa que percorre as chaves ou os NSUs, trata erro e salva cada arquivo com nome. A página oficial de APIs lista ainda uma documentação separada para DANFSe.

Na prática, o Jeito 2 pede um ERP, um integrador ou um sistema de emissão com essa integração pronta. E um alerta: quem pede a senha do seu A1 para "baixar as notas" está pedindo o poder de assinar em nome do seu CNPJ. Não entregue.

Jeito 3: emitir por um sistema que já guarda e entrega tudo

O momento mais barato para guardar o XML é a emissão, quando o arquivo já está na mão. O Nota Fiscal Afiliados emite as notas em lote pela API da NFS-e Nacional, com o seu certificado A1, e a partir daí:

  • guarda o XML e o DANFSe (PDF) de cada nota emitida por ele;
  • manda XML e PDF por e-mail ao tomador;
  • gera o ZIP do mês no fechamento, com todos os XMLs e PDFs da competência;
  • mostra a lista das notas no painel.

O limite é claro: ele só tem as notas que ele emitiu; o que saiu direto no portal continua no Jeito 1 ou no 2. Para quem fatura comissão de afiliado com dezenas de tomadores, é a diferença entre uma tarde de cliques e um arquivo pronto.

XML e PDF de cada nota guardados, e-mail ao tomador e o ZIP do mês pronto pro contador.

O que entregar pro contador

  • XML de todas as notas da competência. É o documento fiscal e é dele que sai o lançamento.
  • DANFSe em PDF. Apoio de leitura; sozinho, gera retrabalho.
  • Planilha-resumo com número, data de emissão, competência, tomador, valor, situação e chave de acesso. É com ela que o contador bate a quantidade.
  • Notas canceladas ou substituídas identificadas, com o XML do evento. Veja cancelar NFS-e Nacional.

Um ZIP por competência, nomes padronizados e a planilha dentro. Os termos (DPS, chave de acesso, NSU) estão no glossário da NFS-e Nacional.

Perguntas frequentes

Dá para baixar todas as NFS-e de uma vez no Emissor Nacional?

Não. O guia oficial descreve o download do XML e do DANFSe como ações na linha de cada nota, sem seleção múltipla nem exportação por período. Para volume, use a API por meio de um software ou um sistema que guarde os arquivos na emissão.

A extensão de navegador que baixa XML em lote é segura?

Nenhuma consta na documentação oficial. Ela roda dentro da sua sessão no portal e algumas pedem o certificado digital ou a senha dele. Avalie quem publica e o que ela acessa; a responsabilidade é sua. Nunca informe a senha do A1 a terceiros.

O DANFSe substitui o XML?

Não. O XML é o documento fiscal, assinado e autorizado. O DANFSe é a representação em PDF, para ler e conferir. Entregue os dois, mas o que vale é o XML.

Perdi o XML de uma nota. E agora?

Se você é o emitente ou o tomador, baixe de novo no Emissor Nacional (NFS-e Emitidas ou Recebidas) ou pela API, com a chave de acesso. Com a chave, a consulta pública mostra o DANFSe sem login, mas não o XML. Se a nota saiu pelo Nota Fiscal Afiliados, ela está no painel e no ZIP do mês.

Por quanto tempo preciso guardar XML e DANFSe?

Pelo menos 5 anos, pelas regras de decadência e prescrição do Código Tributário Nacional. Guarde o XML como documento principal e o DANFSe como apoio; o detalhe está em DANFSe e XML: como baixar e guardar.

Este guia é informativo e não substitui o seu contador. Fontes: Guia do Emissor Público Nacional Web (seção 5), API - Manual de Contribuintes - Emissor Público, Guia de Utilização das APIs do ADN, página APIs - Prod. Restrita e Produção em gov.br/nfse e Código Tributário Nacional (arts. 173, 174 e 195). O Swagger das APIs não foi consultado.

Leia também

Fale com a gente

Quer ver a nota da sua comissão saindo hoje?

Se preferir que eu te mostre antes, deixe o e-mail: eu mando o passo a passo e respondo a sua dúvida pessoalmente.

Sem spam: só o passo a passo e uma resposta sua, de pessoa pra pessoa. Ver planos e criar conta →