GESTÃO DE DOCUMENTOS FISCAIS

Como baixar XML de NF-e em lote da SEFAZ

Baixar o XML de uma nota é simples. Baixar o XML de centenas de notas de uma vez — todas as que foram emitidas contra o seu CNPJ no mês — já é outra história. É justamente nesse ponto que muita empresa trava: o contador pede os arquivos, o financeiro não tem, e a corrida atrás de cada fornecedor começa. Neste guia você vai entender as duas formas de obter esses XMLs: o método manual da SEFAZ e o método automatizado em lote via DistDFe.

Por que o XML importa (e o DANFE não basta)

O XML é o documento fiscal original e válido juridicamente. O DANFE em PDF é apenas uma representação impressa — não serve para escrituração, apuração de créditos nem como prova em uma fiscalização. Como destinatário das mercadorias, você é obrigado a guardar os XMLs por no mínimo 5 anos, que é o prazo decadencial em que a Receita pode auditar suas operações.

Ou seja: não basta receber a mercadoria. Você precisa ter, organizado e arquivado, o arquivo XML de cada NF-e que entrou na sua empresa.

Método 1: Baixar pelo Portal Nacional da NF-e (manual)

O Portal Nacional da NF-e, mantido pela SEFAZ, oferece consulta pública e gratuita de documentos. O passo a passo é direto, mas tem limitações sérias para quem precisa de volume.

  1. Acesse o site da Consulta NF-e do Portal Nacional.
  2. Digite a chave de acesso de 44 dígitos da nota (ela aparece impressa no rodapé do DANFE, ou no código de barras).
  3. Resolva o reCAPTCHA ("não sou um robô").
  4. Visualize a nota e, quando disponível, baixe o XML ou o DANFE.

As limitações do método manual

Você não baixa em lote. O portal trabalha uma nota por vez. Para 200 notas, são 200 chaves digitadas, 200 captchas resolvidos e 200 downloads — sem contar que, na consulta pública, nem sempre o XML completo fica disponível para download, apenas os dados resumidos. E há um problema anterior: você precisa ter a chave de 44 dígitos. Se o fornecedor não te enviou o XML nem o DANFE, você nem sabe que aquela nota existe.

Na prática, o método manual só resolve casos pontuais: uma nota perdida, uma conferência rápida. Para o fechamento mensal de uma empresa com movimento real, ele simplesmente não escala.

Método 2: Baixar em lote via DistDFe (automatizado)

Existe um caminho oficial pensado exatamente para isso: o DistDFe — sigla de Distribuição de Documentos Fiscais Eletrônicos. É um webservice da SEFAZ que entrega, para o destinatário, todos os DF-e (documentos fiscais eletrônicos) emitidos contra o seu CNPJ.

A grande diferença é conceitual: no DistDFe você não procura nota por nota com a chave. Você se identifica com o certificado digital e a SEFAZ devolve a lista do que existe vinculado ao seu CNPJ, em lote.

O que você precisa

  • Certificado digital A1: um arquivo no formato .pfx ou .p12, instalável em servidor e válido por 1 ano. Diferente do A3 (mídia física), o A1 permite que um sistema consulte a SEFAZ de forma automática, sem intervenção manual.
  • Um software que implemente o webservice DistDFe e saiba paginar os lotes (a SEFAZ entrega os documentos em blocos, controlados por um número sequencial chamado NSU).

Como o DistDFe funciona, na prática

O sistema assina cada requisição com o seu certificado A1 e pergunta à SEFAZ: "existem novos documentos para este CNPJ a partir do último NSU consultado?". A SEFAZ responde com um lote de XMLs — resumos de notas e, conforme o tipo, os documentos completos. O sistema avança o NSU e repete, até esgotar a fila. Esse ciclo roda sozinho, várias vezes ao dia.

Manifestação do destinatário: a etapa que destrava o XML completo

Há um detalhe importante. Pelo DistDFe, em muitos casos a SEFAZ primeiro entrega apenas o resumo da NF-e (quem emitiu, valor, chave). Para receber o XML completo da nota, você precisa fazer a manifestação do destinatário — declarar formalmente sua ciência ou confirmação da operação. A manifestação não é só burocracia: confirmar a operação é o que garante seu direito ao crédito de ICMS e protege contra notas emitidas indevidamente em seu nome.

Manual x Automatizado: o resumo

  • Portal Nacional (manual): grátis, mas exige a chave de 44 dígitos, é uma nota por vez, tem captcha e não lista o que você ainda não conhece.
  • DistDFe (automatizado): dispensa a chave, traz tudo do seu CNPJ em lote, roda sozinho e ainda permite manifestar para puxar o XML completo — desde que você tenha o certificado A1 e um sistema que faça o trabalho.

Deixe o Flow Fiscal baixar e guardar seus XMLs por você

O Flow Fiscal não emite notas — ele gerencia os documentos fiscais que você recebe. Conecte seu certificado A1 uma única vez e a plataforma captura automaticamente, via DistDFe, todas as NF-e, NFS-e e CT-e emitidas contra o seu CNPJ, faz a manifestação do destinatário, guarda os XMLs por 5 anos e ainda concilia cada nota com o seu Contas a Pagar.


Criar Conta Gratuita e Conectar A1

Conclusão

Para uma nota avulsa, o Portal Nacional resolve. Mas se o seu objetivo é baixar o XML de NF-e em lote da SEFAZ com regularidade — sem depender da boa vontade dos fornecedores e sem digitar chaves de 44 dígitos —, o caminho é o DistDFe com certificado A1. Automatizar essa captura e a guarda dos arquivos não é luxo: é o que garante créditos de ICMS, evita perda de documentos e protege a empresa em qualquer fiscalização.

Perguntas frequentes

É possível baixar o XML de várias NF-e de uma vez no Portal Nacional?

Não. A consulta pública funciona uma nota por vez: você informa a chave de acesso de 44 dígitos, resolve o captcha e baixa aquele documento. Para obter os XMLs em lote sem a chave é preciso usar o webservice DistDFe com certificado digital A1.

Preciso da chave de acesso de 44 dígitos para baixar pelo DistDFe?

Não. O DistDFe distribui os documentos emitidos contra o seu CNPJ usando apenas o seu certificado digital como identificação. Ele retorna os XMLs em lote, sem que você precise digitar nenhuma chave.

Que tipo de certificado digital é necessário?

Para automação via webservice, o ideal é o certificado A1, que é um arquivo (.pfx ou .p12) instalável em servidor e válido por 1 ano. Ele permite consultar a SEFAZ automaticamente, sem mídia física como ocorre no A3.

Por quanto tempo preciso guardar os XMLs baixados?

No mínimo 5 anos, prazo decadencial em que o Fisco pode auditar suas operações. O DANFE em PDF não substitui o XML para fins legais.

O Flow Fiscal emite notas fiscais?

Não. O Flow Fiscal gerencia os documentos fiscais recebidos: captura automática de NF-e, NFS-e e CT-e via DistDFe, manifestação do destinatário, guarda dos XMLs por 5 anos e conciliação com o financeiro.

Pare de caçar XML dos seus fornecedores

O Flow Fiscal captura suas NFe, NFSe e CTe direto da SEFAZ, resolve a manifestação do destinatário e guarda tudo organizado por 5 anos. Conecte seu certificado A1 e veja funcionar em minutos.

Sem cartão de crédito • Conexão com a SEFAZ em poucos minutos