Teste o NameQuick no seu próximo lote
Use regras de nomeação com IA sem sair do seu fluxo no Mac.
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
cnpjConsultaoucpfConsulta. 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:
| Ferramenta | Preço | Como 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 testar | Um 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 dias | Pastas 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:
- Manual dos Contribuintes, APIs do ADN, versão 1.1 (03/11/2026): endereço, procurações e erro E2245
- Nota Técnica 008/2026, versão 1.02 – Especificações Técnicas do DANFSe: suspensão da API do DANFSe em 03/08/2026
- Biblioteca de documentação técnica da NFS-e: Perguntas Frequentes, versão 1.4 (18/11/2026), sobre o PDF gerado a partir do XML, o intervalo de 1 hora e as notas de outros municípios
- Guia do Emissor Público Nacional Web: download de XML e DANFS-e nota a nota
NameQuick Team
AutorThe NameQuick team writes practical guides for file organization, document workflows, and automation with NameQuick.