Guia prático
Baixar XML em lote das suas notas fiscais de serviço
Resposta curta: o site do Portal Nacional não baixa XML em lote — cada documento sai individualmente e, desde junho de 2026, com captcha. O caminho que funciona é a API oficial de distribuição (Ambiente de Dados Nacional, NT 008/2026), que entrega os documentos em lote. A extensão NFSe Downloader usa essa API e devolve tudo em um ZIP organizado, com o XML autenticado, o PDF (DANFSe) e uma planilha de resumo.
Quem fecha competência em escritório contábil conhece o problema: são dezenas ou centenas de notas por CNPJ, e o portal obriga a abrir uma por uma. Multiplicado por vários clientes, o fechamento consome dias — e ainda corre o risco de faltar documento na hora de escriturar.
Por que o portal não deixa baixar em lote
O nfse.gov.br foi desenhado para consulta pontual, não para volume. Em junho de 2026 o portal passou a exigir captcha em cada download individual, o que inviabilizou de vez qualquer automação sobre a interface web. Além disso, a consulta do portal tem janela limitada de período.
A própria Receita previu esse cenário: a NT 008/2026 especifica um serviço de distribuição em que o contribuinte busca os seus documentos por NSU (número sequencial único), em lotes. É o mesmo princípio já usado há anos na NF-e. Não é contorno nem raspagem de tela: é a via oficial.
Como baixar, na prática
- 1. Instale a extensão no Chrome.
- 2. Entre em nfse.gov.br com o certificado A1 ou A3 que você já usa.
- 3. No painel lateral, escolha o período, o tipo de documento e os formatos.
- 4. Clique em Sincronizar. O ZIP aparece no seu computador em segundos.
A partir da segunda vez, a sincronização é incremental: a extensão guarda o cursor de NSU por CNPJ e traz apenas o que chegou de novo. Não há retrabalho nem download duplicado.
O que vem no ZIP
- XML autenticado de cada documento, exatamente como assinado pela administração tributária.
- PDF (DANFSe) no layout oficial, gerado localmente a partir do próprio XML.
- Planilha Excel com uma linha por documento, incluindo cTribNac e os códigos da Reforma (CST, cClassTrib e NBS).
- Organização por mês de competência, por tomador ou por tipo de documento.
Teste com uma sincronização gratuita
Sem cartão. Basta o certificado que você já usa no portal.
Instalar no ChromePerguntas frequentes
Dá para baixar XML em lote no Portal Nacional NFS-e?
Pelo site do portal, não: cada download é individual e, desde junho de 2026, exige a resolução de um captcha por documento. A saída é usar a API oficial de distribuição (Ambiente de Dados Nacional, prevista na NT 008/2026), que entrega os documentos em lote por paginação de NSU. É esse caminho que a extensão NFSe Downloader usa.
O XML baixado em lote tem a mesma validade do baixado nota a nota?
Sim. É exatamente o mesmo arquivo assinado pela administração tributária, obtido da fonte oficial. A extensão não altera, não regrava e não reassina nada — apenas organiza os arquivos no seu computador.
Consigo baixar as notas recebidas, e não só as emitidas?
Sim. O feed de distribuição entrega os dois lados: as notas em que o seu CNPJ é prestador (emitidas) e aquelas em que é tomador (recebidas). É possível filtrar apenas um dos lados ou baixar tudo junto.
Existe limite de período, tipo os 30 dias do portal?
Não. A API oficial pagina por NSU, e não por data, então é possível recuperar meses ou anos inteiros de uma vez. O portal web é que impõe a janela curta.
Preciso enviar meu certificado digital para algum servidor?
Não, e isso é importante. A autenticação acontece no seu próprio navegador, por mTLS, com o certificado A1 ou A3 que você já usa no portal. Ele nunca é lido, copiado ou transmitido — nem para nós, nem para ninguém.
Os XMLs já vêm com os campos de IBS e CBS da Reforma Tributária?
Vêm, quando a nota foi emitida no layout novo. Desde 01/07/2026 a NT 007/2026 acrescentou o grupo de IBS/CBS ao XML da NFS-e, e o arquivo é entregue como a Receita o assinou. A planilha de resumo traz CST, cClassTrib e NBS em colunas próprias, o que permite varrer a competência inteira e ver quais notas ainda vieram sem os códigos novos.