NF-e, NFS-e e CT-e: como obter todos os arquivos XML da empresa de uma só vez, automatizar a coleta e cumprir a obrigação de guarda.
Atualizado em agosto de 2026 · Equipe IM Fácil
Baixar XML em lote é obter, de uma única vez, todos os arquivos XML dos documentos fiscais eletrônicos ligados ao CNPJ de uma empresa em determinado período — em vez de procurar nota por nota, digitando chaves de acesso de 44 dígitos em portais diferentes.
Para um escritório de contabilidade que fecha a competência de dezenas de clientes todo mês, essa diferença é enorme: coletar manualmente as notas de entrada de 40 empresas pode consumir dias de trabalho; o mesmo volume, obtido de forma automatizada pelo serviço de distribuição da SEFAZ, leva minutos.
O download em lote é usado principalmente para três finalidades:
É comum a empresa achar que está com a documentação em ordem porque guarda os DANFEs em PDF recebidos por e-mail. Isso é um erro que só aparece quando chega a fiscalização.
O DANFE (Documento Auxiliar da Nota Fiscal Eletrônica) é apenas uma representação gráfica simplificada. Ele existe para acompanhar a mercadoria no transporte e permitir a consulta rápida pela chave de acesso. O documento com validade jurídica é o arquivo XML assinado digitalmente e autorizado pela SEFAZ — é ele que contém a assinatura do emitente, o protocolo de autorização, todos os itens da nota, a tributação completa e as informações que a contabilidade precisa importar.
O prazo de guarda segue a regra dos cinco anos aplicável aos documentos fiscais, contados conforme a legislação tributária de cada tributo. Ou seja: o XML de uma nota recebida hoje ainda pode ser exigido daqui a meia década — inclusive se a empresa tiver trocado de sistema, de contador ou de servidor no meio do caminho.
| Documento | Competência | Como obter o XML em volume |
|---|---|---|
| NF-e (modelo 55) | Estadual | Serviço nacional de Distribuição de DFe, com certificado digital do destinatário |
| CT-e (modelo 57) | Estadual | Também disponível na Distribuição de DFe do destinatário/tomador |
| NFC-e (modelo 65) | Estadual | Pelo próprio emitente, no ambiente da SEFAZ da UF ou no sistema emissor |
| MDF-e (modelo 58) | Estadual | Consulta e download no portal nacional/SVRS pelo emitente |
| NFS-e | Municipal | Portal da prefeitura, webservice municipal ou padrão nacional da NFS-e |
| CT-e OS, BP-e, NF3e | Estadual | Portais específicos e ambientes autorizadores estaduais |
A grande diferença prática está entre os documentos estaduais e os municipais. Os estaduais seguem um padrão nacional de layout e de webservices, o que torna a automação relativamente uniforme em todo o país. Já a NFS-e é municipal: cada prefeitura pode ter seu próprio sistema, seu próprio layout e suas próprias regras de acesso — motivo pelo qual a coleta de notas de serviço costuma ser a parte mais trabalhosa da rotina.
É o serviço nacional que entrega ao destinatário os documentos fiscais emitidos contra o seu CNPJ. Funciona com um contador sequencial chamado NSU (Número Sequencial Único): a empresa informa o último NSU que já processou e recebe os documentos seguintes. Cada consulta devolve um lote com vários documentos, e o processo se repete até que o ambiente informe que não há mais nada novo.
Requisitos e limitações que todo mundo descobre na prática:
Na distribuição, é comum receber primeiro apenas o resumo da nota (com emitente, valor, chave e data) e não o XML completo. Para liberar o documento integral, o destinatário registra um evento de manifestação: ciência da emissão, confirmação da operação, desconhecimento da operação ou operação não realizada.
Além de destravar o download, a manifestação tem valor defensivo: registrar o desconhecimento de uma nota emitida indevidamente contra o CNPJ da empresa é a forma de se proteger contra operações fraudulentas feitas em seu nome. Existem prazos definidos na legislação para cada tipo de evento, e em determinadas operações a manifestação é obrigatória.
Serve para conferências pontuais pela chave de acesso, e não para volume. O download do XML completo no portal exige certificado digital e vale apenas para quem participa da operação. É útil para tirar dúvida sobre uma nota específica, não para fechar a competência.
É o método mais frágil de todos, embora ainda seja o mais usado. Depende de o fornecedor lembrar de enviar, do e-mail não cair em spam, de alguém salvar o anexo na pasta certa e de esse alguém não sair de férias. Serve como complemento — nunca como processo principal.
Como a nota de serviço é municipal, o caminho muda de cidade para cidade. As situações mais comuns são: exportação de XML por período no próprio portal da prefeitura, webservice municipal com autenticação por login/senha ou certificado, e adesão ao padrão nacional da NFS-e, que concentra os documentos em um ambiente de dados nacional e reduz bastante a fragmentação. Antes de automatizar, vale verificar qual desses cenários se aplica ao município — a página de cada capital aqui no IM Fácil indica o sistema utilizado localmente.
Uma rotina bem construída, independentemente da ferramenta escolhida, tem sempre os mesmos elementos:
/CNPJ/ANO/MÊS/TIPO/chave-de-44-digitos.xml.Não é obrigatório desenvolver tudo internamente. Hoje há basicamente quatro caminhos, cada um com um perfil de custo e de esforço:
Entre as ferramentas brasileiras que seguem esse último modelo está o iLoveXML, que monitora os CNPJs cadastrados, baixa os XML de NF-e e NFS-e automaticamente, organiza os arquivos por empresa e por mês, gera o DANFE/DANFSe em PDF a partir do XML e permite enviar tudo direto para uma pasta no Google Drive. Para escritórios contábeis que precisam repetir o mesmo processo em muitos clientes, esse tipo de organização automática por CNPJ costuma ser o que mais reduz tempo de trabalho.
Depois de baixados, os XML costumam alimentar três saídas:
Uma observação técnica útil para quem desenvolve: ao ler os XML, use sempre o nome local das tags, ignorando o namespace. Layouts de fornecedores diferentes trazem prefixos distintos, e leituras que dependem do namespace quebram sem motivo aparente.
Reunimos abaixo os acessos diretos aos principais sistemas oficiais de consulta de documentos fiscais eletrônicos e de cadastros federais. Todos os links levam a portais públicos mantidos pela Receita Federal, pelas Secretarias de Fazenda estaduais ou pela SUFRAMA.
Os endereços acima pertencem aos respectivos órgãos públicos e podem sofrer alteração sem aviso prévio. Em caso de indisponibilidade, verifique o portal oficial do órgão responsável.
Sim. O serviço de Distribuição de DFe exige certificado e-CNPJ (A1 ou A3) do destinatário ou de procurador com poderes eletrônicos. O A1 é o mais usado em automação por ser um arquivo instalável, sem dependência de token físico.
Nem sempre. O ambiente de distribuição mantém os documentos por um período limitado. Notas muito antigas geralmente precisam ser solicitadas ao emitente ou recuperadas do backup da própria empresa — mais um motivo para não deixar a coleta acumular.
Porque falta a manifestação do destinatário. Ao registrar o evento de ciência ou de confirmação da operação, o XML completo passa a ser disponibilizado.
É uma proteção contra consultas repetidas em intervalo muito curto. A solução é espaçar as chamadas, respeitar o retorno de "nenhum documento localizado" como sinal de que a fila está em dia e evitar reiniciar a varredura de NSU sem necessidade.
Não da mesma forma. A NFS-e é municipal e segue o sistema de cada prefeitura. Com a adesão ao padrão nacional, parte dos municípios passa a concentrar os documentos em um ambiente comum, mas a cobertura ainda varia bastante entre cidades.
Pode, desde que a empresa mantenha o acesso e a integridade dos arquivos durante todo o prazo de guarda. O recomendável é ter pelo menos duas cópias em locais distintos — a responsabilidade pela conservação do documento fiscal é do contribuinte.