Como baixar XML de NFS-e Nacional em lote, e dar nome aos arquivos

O Emissor Nacional baixa uma nota por vez. Veja como baixar o XML da NFS-e Nacional em lote pela API do ADN ou por ferramentas, quanto elas custam e como dar nomes legíveis aos arquivos depois.

NameQuick Team

Escolher download

Teste o NameQuick no seu próximo lote

Use regras de nomeação com IA sem sair do seu fluxo no Mac.

Junte-se aclientes satisfeitos

O Emissor Nacional não tem exportação em lote: cada XML de NFS-e é baixado nota por nota. Para baixar em lote, há dois caminhos: a API do Ambiente de Dados Nacional (ADN), com o certificado digital da empresa, ou uma ferramenta que use essa API por você. Os arquivos chegam com o nome pela chave de acesso de 50 dígitos. Depois do download, o NameQuick dá a cada XML e PDF um nome legível, como 2026-10_Padaria-Ficticia-Pao-Dourado_NFSe-1842.xml.

Este guia é para quem fecha o mês de muitas notas de serviço, as próprias ou as de clientes, e não quer abrir uma por uma no portal.

Por que o Emissor Nacional não baixa em lote

No Emissor Nacional, os comandos Download XML e Download DANFS-e ficam em cada nota, nas listas de NFS-e emitidas e recebidas. O guia oficial do Emissor descreve esses comandos nota a nota; não encontramos nele uma exportação em lote. Em fóruns de contabilidade, usuários relatam ainda um captcha a cada download e chamam a mudança de retrocesso (Fórum Contábeis).

Para conferir o que cada arquivo é, veja DANFSe e NFS-e: qual a diferença. O XML é o documento fiscal; o DANFSe é a representação em PDF.

Caminho 1: a API do ADN

O Ambiente de Dados Nacional é onde ficam todas as NFS-e do padrão nacional. A API de distribuição entrega a uma empresa as notas em que ela aparece como emitente, tomadora ou intermediária, em ordem, por um número sequencial (NSU). Os pontos que importam para quem vai usar:

  • Endereço: GET https://adn.nfse.gov.br/contribuintes/DFe/{NSU}. Você guarda o último NSU lido e pede só o que veio depois.
  • Acesso: com o certificado digital ICP-Brasil da empresa (A1 ou A3), na própria conexão. Não há login por senha nem token.
  • Contadores: desde a versão 1.1 do manual (03/11/2026), o titular do certificado pode consultar outro CNPJ ou CPF informando cnpjConsulta ou cpfConsulta. Para isso, o cliente precisa ter cadastrado uma procuração no Portal de Serviços da Receita Federal. Sem procuração, a consulta é recusada com o erro E2245.
  • Só XML: a API devolve o XML. A API do governo que gerava o PDF do DANFSe foi suspensa em 03/08/2026, e cada sistema passou a gerar o PDF a partir do XML.
  • Ritmo: quando não há notas novas, a API exige pelo menos 1 hora antes de uma nova consulta. O primeiro download completo não é afetado.
  • Notas que faltam: uma nota de outro município só aparece depois que esse município a compartilha com o ADN.

Esse caminho serve para quem tem um sistema próprio ou um desenvolvedor. As fontes estão no fim da página.

Caminho 2: ferramentas que baixam por você

Desde meados de 2026 surgiram várias extensões de navegador e sistemas que usam a API do ADN com o seu certificado. Conferimos dois sites em 19/11/2026:

FerramentaPreçoComo entrega os arquivos
NFSe Downloader (extensão do Chrome)R$ 89,99 por mês ou R$ 849,99 por 12 meses; 1 sincronização grátis para testarUm ZIP organizado por competência, por empresa ou por tipo de documento
Portal Nacional Plus (extensão do Chrome)De R$ 29,90 por 50 notas a R$ 299,90 sem limite, por 30 diasPastas separadas para XML, PDF e relatórios

Sistemas fiscais como Fiscal.io, Jettax e NFE.io também baixam notas do padrão nacional, com preço sob consulta.

Antes de instalar uma extensão, confira as permissões que ela pede e onde o certificado fica. O NFSe Downloader diz que o certificado nunca sai do seu computador; o Portal Nacional Plus usa o certificado na sessão do navegador.

Depois do download: nomes que dizem de que nota se trata

Baixados em lote, os arquivos chegam com o nome pela chave de acesso, como 35503082248291537000194000000000184226110000000000.xml, ou com nomes genéricos. Para achar a nota de um cliente num mês, alguém precisa abrir arquivo por arquivo.

O NameQuick é o app que renomeia arquivos pelo conteúdo, para Mac e Windows. Com uma predefinição como a do guia renomear NFS-e em lote, ele lê a competência, o tomador e o número da NFS-e e sugere AAAA-MM_Tomador_NFSe-Número. O XML e o PDF da mesma nota recebem o mesmo nome, só com a extensão diferente. No nosso teste com 5 XMLs fictícios nomeados pela chave de acesso, os 5 nomes saíram iguais aos esperados (veja o teste).

Renomear muda só o nome do arquivo: o conteúdo e a assinatura do XML continuam iguais. Se o seu sistema contábil importa XMLs procurando a chave de acesso no nome, mantenha uma cópia com o nome original.

Se a ferramenta entregou um ZIP, descompacte-o primeiro e adicione a pasta ao NameQuick. Com Revisar primeiro ligado, você confere cada nome antes de aplicar.

Se você só tem os XMLs, a ferramenta grátis renomear XML de nota fiscal dá o mesmo padrão de nome a NFS-e, NF-e e NFC-e no navegador, sem enviar os arquivos, e devolve um ZIP com cópias renomeadas.

O NameQuick não baixa as notas: ele entra depois, quando os arquivos já estão na sua pasta. O teste tem 30 renomeações grátis, sem e-mail nem cartão. Depois, o plano inicial custa R$ 62 por mês por 500 renomeações, cerca de R$ 0,12 por arquivo; o PDF e o XML da mesma nota contam como dois arquivos.

Perguntas frequentes

Dá para baixar XML de NFS-e em lote de graça?

Pelo Emissor Nacional, o download é gratuito, mas nota por nota. A API do ADN também é gratuita, mas exige um sistema que a chame com o certificado digital da empresa. As ferramentas prontas são pagas; algumas oferecem um teste grátis.

Preciso de certificado digital para baixar em lote?

Sim, para a API do ADN: ela só aceita conexões com certificado ICP-Brasil, A1 ou A3. As ferramentas que usam a API pedem o mesmo certificado.

O contador consegue baixar as notas dos clientes?

Sim, com procuração. O cliente cadastra a procuração no Portal de Serviços da Receita Federal, e o contador consulta o CNPJ do cliente com o próprio certificado. Sem procuração, a API recusa a consulta com o erro E2245.

A API do ADN devolve o PDF da nota?

Não. Ela devolve o XML. Desde 03/08/2026, o PDF (DANFSe) é gerado pelo sistema ou pela ferramenta a partir do XML.

O NameQuick baixa as notas?

Não. O NameQuick não se conecta ao Emissor Nacional nem à API do ADN. Ele dá nome aos XMLs e PDFs depois que eles estão na sua pasta, baixados por você ou por uma ferramenta.

Fontes

As informações sobre a API vêm de documentos oficiais do Sistema Nacional NFS-e:

The NameQuick team writes practical guides for file organization, document workflows, and automation with NameQuick.

Começar

Pronto para organizar seus arquivos?

O NameQuick renomeia arquivos 10x mais rápido com regras baseadas em IA.

Mac ou Windows?