Como baixar o XML de NFS-e dos clientes em lote

Quais são os caminhos para baixar o XML da NFS-e?

A NFS-e nacional tem três caminhos, e só um deles foi pensado para volume. As perguntas e respostas da NFS-e Nacional (v1.1, de 22/09/2026) descrevem a API como um fluxo de distribuição contínua, em que o sistema informa o último NSU conhecido.

As perguntas e respostas oficiais não descrevem download de várias notas de uma vez pela tela. Se a sua rotina depende disso, confirme no Emissor Nacional antes de prometê-lo ao cliente.

O que limita o download em lote?

Quatro pontos decidem se o XML chega ao escritório, e nenhum deles depende do sistema que você usa.

• Município no padrão nacional. Só entram as notas compartilhadas com o Ambiente de Dados Nacional. A obrigação de compartilhar vale para os municípios com emissor próprio (LC 214/2025, art. 62), mas o prazo real de cada lote depende da prefeitura.
• Certificado por empresa. A API autentica o ator da nota. Para uma carteira, isso quer dizer um certificado A1 por empresa.
• Matriz e filial são entidades distintas. No portal, cada estabelecimento é identificado por município, CNPJ e inscrição municipal. Quem entra como matriz só vê a matriz; para a filial, o login pede o CNPJ completo.
• Papel na nota. A empresa precisa constar como prestadora, tomadora ou intermediária. Notas em que ela não aparece não chegam por esse caminho.

Por que baixar o XML e não só o PDF?

O arquivo que vale para fiscalização e escrituração é o XML. O DANFSe é uma representação auxiliar, e desde 3 de agosto de 2026 a API do governo que gerava o PDF automaticamente está suspensa: cada sistema emissor renderiza o PDF por conta própria a partir do XML. Se o PDF mostrar um valor diferente do XML, vale o XML. Quem arquiva só o PDF guarda a cópia, não a nota.

Erros comuns no download

• Consultar a API sem guardar o último NSU. O sistema repete a leitura e esbarra na espera de 1 hora.
• Procurar a nota do cliente pelo login da matriz. A filial exige o login com o CNPJ dela.
• Achar que toda NFS-e está no ambiente nacional. A nota de município com sistema próprio só aparece depois do compartilhamento.
• Esperar o fechamento para baixar. Quem consulta só no fim do mês descobre a lacuna quando a apuração já está em andamento.

Como a Trevio faz

A busca de notas fiscais captura NFS-e tomadas e prestadas com o certificado A1 de cada empresa, nos municípios que aderiram ao padrão nacional, junto das NF-e e dos CT-e recebidos.

• Cada XML é guardado uma vez, pela chave, e sai em ZIP por competência.
• O A1 fica no cofre do cadastro único, com aviso antes do vencimento.
• A captura roda em segundo plano, e o botão “Buscar agora” consulta uma empresa sob demanda.

O guia de como baixar o XML das notas do cliente mostra o caminho completo, com NF-e e CT-e. Para a obrigação do Simples, veja o guia da NFS-e nacional.