Como Baixar XML de Notas Fiscais em Lote

O que significa "baixar XML em lote"

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:

• Escrituração fiscal e contábil — os XML alimentam o SPED Fiscal, o SPED Contribuições e a apuração de créditos de ICMS, PIS e COFINS;
• Guarda legal dos documentos — o XML é o documento fiscal propriamente dito e precisa ser arquivado pelo prazo previsto na legislação;
• Conferência e auditoria — comparar o que o fornecedor emitiu contra o que efetivamente entrou no estoque, identificar notas emitidas indevidamente contra o CNPJ e detectar divergências de preço, CFOP ou tributação.

Por que o XML é o documento fiscal — e o PDF não

É 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.

Quais documentos fiscais têm XML disponível para download

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.

Formas de obter os arquivos XML

1. Distribuição de DFe (a forma correta para volume)

É 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:

• Certificado digital e-CNPJ (A1 ou A3) do destinatário ou de um procurador com poderes eletrônicos;
• Controle de NSU — se o contador for perdido, é preciso recomeçar a varredura, o que consome tempo e pode esbarrar em limites de consulta;
• Controle de frequência — o ambiente nacional limita consultas repetidas em curto intervalo e pode responder com uma mensagem de consumo indevido, bloqueando temporariamente o CNPJ. Por isso, uma boa rotina automatizada respeita intervalos entre chamadas em vez de tentar "puxar tudo" o mais rápido possível;
• Janela de retenção — os documentos ficam disponíveis por um período limitado. Empresa que passa meses sem baixar corre risco real de perder notas antigas.

2. Manifestação do destinatário

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.

3. Portal nacional da NF-e (consulta unitá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.

4. E-mail e portais de fornecedores

É 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.

5. NFS-e: o caso à parte

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.

Quando você só tem o PDF: baixar o XML pela chave de acesso

Nem sempre a coleta automática resolve. É comum chegar ao fechamento do mês com notas que nunca entraram na rotina: o fornecedor mandou só o PDF por e-mail, a nota é de um período que a distribuição já não alcança, ou o cliente perdeu os arquivos e só guardou o DANFE impresso.

Nesses casos, a peça que importa é a chave de acesso — o número de 44 dígitos impresso no documento, junto ao código de barras. Ela identifica a nota de forma única e permite recuperar o XML original autorizado, mesmo sem o arquivo em mãos. Um PDF nunca pode ser "convertido" em XML: o que se faz é buscar, pela chave, o documento que está registrado no fisco.

Para uma ou duas notas, a consulta manual resolve. Quando a lista tem dezenas ou centenas de chaves — típico de uma auditoria interna ou da troca de escritório contábil —, o trabalho manual deixa de compensar. O iLoveXML permite colar a lista de chaves, uma por linha, e baixar os XML e os PDF em lote, sem abrir uma nota de cada vez.

Como montar uma rotina de download automático

Uma rotina bem construída, independentemente da ferramenta escolhida, tem sempre os mesmos elementos:

1. Certificado digital instalado e monitorado. Prefira o A1 para automação (é um arquivo, não depende de token físico) e mantenha um alerta de vencimento com pelo menos 30 dias de antecedência. Certificado vencido interrompe a coleta silenciosamente.
2. Cadastro dos CNPJs. Inclua matriz e filiais. Cada CNPJ tem sua própria fila de distribuição e seu próprio controle de NSU.
3. Agendamento com intervalo. Executar de uma a quatro vezes por dia costuma ser suficiente. Rodar de minuto em minuto não traz nenhum ganho e aumenta o risco de bloqueio temporário por consumo indevido.
4. Persistência do NSU. Guarde o último NSU processado por CNPJ em banco de dados ou arquivo. É esse número que evita rebaixar tudo do zero a cada execução.
5. Manifestação automática. Configure o registro de ciência para liberar o XML completo, mantendo a confirmação e o desconhecimento sob decisão humana.
6. Organização dos arquivos. Uma estrutura previsível economiza horas depois: /CNPJ/ANO/MÊS/TIPO/chave-de-44-digitos.xml.
7. Backup em nuvem. Sincronizar a pasta com um serviço de armazenamento (Google Drive, OneDrive, S3) protege contra perda de HD, formatação de máquina e ransomware.
8. Relatório de conferência. Um resumo por período — quantidade de notas, valor total, fornecedores, notas canceladas — permite perceber rapidamente se alguma coisa deixou de ser baixada.

Ferramentas: o que existe no mercado

Não é obrigatório desenvolver tudo internamente. Hoje há basicamente quatro caminhos, cada um com um perfil de custo e de esforço:

• Módulo do próprio ERP — muitos sistemas de gestão já trazem a captura de XML embutida. É a opção mais integrada quando existe, mas costuma cobrir apenas os CNPJs cadastrados no sistema e raramente resolve NFS-e de municípios diversos;
• Desenvolvimento próprio — viável para quem tem equipe técnica. Exige lidar com assinatura digital, SOAP, compactação dos lotes, controle de NSU e tratamento dos códigos de retorno da SEFAZ. Dá controle total e trabalho proporcional;
• Serviços em nuvem — o certificado A1 é enviado para o servidor do fornecedor, que faz a coleta e disponibiliza os arquivos em um painel. Prático, mas exige atenção à política de tratamento do certificado e dos dados;
• Agente local com painel web — um pequeno programa roda no computador ou servidor da empresa, usa o certificado que já está instalado ali e envia apenas os metadados para um painel de acompanhamento. É o modelo preferido por quem não quer que o certificado saia do ambiente da empresa.

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.

Erros mais comuns em rotinas de download

• Deixar para baixar só no fechamento — quando a coleta acontece uma vez por mês, notas antigas já podem ter saído da janela de disponibilidade;
• Ignorar as filiais — cada CNPJ precisa ser consultado individualmente; a matriz não traz as notas das filiais;
• Não tratar notas canceladas e eventos — cancelamentos, cartas de correção e manifestações também chegam pela distribuição e precisam ser guardados junto com o documento original;
• Confundir emissão com recebimento — a distribuição entrega o que foi emitido contra o CNPJ; os XML emitidos pela empresa saem do próprio sistema emissor e precisam de rotina de backup separada;
• Armazenar sem redundância — arquivo fiscal em uma única máquina, sem backup, é perda de documento esperando acontecer;
• Renomear os arquivos — manter o nome baseado na chave de acesso de 44 dígitos facilita busca, conferência e importação por qualquer sistema.

Do XML ao PDF e à planilha

Depois de baixados, os XML costumam alimentar três saídas:

• DANFE / DANFSe em PDF — gerado a partir do próprio XML, para conferência visual, envio a clientes e anexo em processos;
• Planilha de resumo — chave, emitente, CNPJ, data, valor, CFOP, impostos. É o formato que a maioria das áreas financeiras usa para conciliar contas a pagar;
• Importação no sistema fiscal — leitura direta dos XML pelo software contábil para escrituração e apuração.

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.

Outras consultas fiscais úteis

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.

Perguntas frequentes

Continue lendo

• Como emitir NFS-e: passo a passo por município
• Consulta de Inscrição Estadual pelo CNPJ
• Inscrição Municipal, Estadual e CNPJ: qual a diferença
• ISS (ISSQN): guia completo do imposto sobre serviços
• Glossário fiscal: termos usados no dia a dia