NF-e e CT-e

Como baixar XML de NF-e em lote (todas as notas contra o seu CNPJ)

Passo a passo para capturar em lote os XMLs de todas as NF-e emitidas contra o seu CNPJ pela API oficial da SEFAZ, sem baixar nota por nota.

Por Aiteks

Baixar nota por nota no portal é inviável para quem recebe dezenas ou centenas de NF-e por mês. A boa notícia é que existe um caminho oficial para capturar tudo de uma vez: o serviço de Distribuição de DF-e da SEFAZ.

O que você precisa

  • Um certificado digital ICP-Brasil (A1 ou A3) do CNPJ que vai consultar.
  • O Google Chrome com o certificado instalado (A1) ou o token/cartão conectado (A3).
  • A extensão NFe/CTe Downloader.

Como funciona

A extensão consulta o webservice oficial com o seu certificado. O Chrome apresenta o certificado na conexão segura — nada é enviado para nenhum servidor nosso. Os documentos chegam em lotes, a extensão organiza tudo por mês e emitente, e no fim você baixa um único arquivo ZIP com os XMLs, PDFs e uma planilha Excel fiscal detalhada.

E as notas que vêm só como resumo?

Algumas notas são distribuídas inicialmente como resumo (só a chave, emitente, valor e data). Durante a sincronização ativa, a extensão consulta cada uma pela chave de acesso para buscar o XML completo, quando disponível — sem assinar ou manifestar documento nenhum.

Se houver muitos resumos pendentes, escolha períodos menores. Assim você acompanha cada lote com mais clareza e mantém maior controle sobre as consultas.

O processo guarda o cursor de NSU e respeita a janela entre consultas para reduzir o risco de bloqueio por consumo indevido (erro 656).

Leia também

Alcance da consulta

Antes de assinar, veja os limites da SEFAZ

NF-e: janela de até 90 dias

Contados da recepção no Ambiente Nacional, não da emissão. A distribuição não consulta um arquivo histórico por mês. No início do uso do serviço, a geração de NSU não é retroativa; uma interrupção superior a 60 dias também afeta essa geração.

Consultas têm cota e intervalos

NF-e: consultas por chave e NSU compartilham o limite de 20 por hora por CNPJ. A extensão usa até 18 por segurança. Após uma consulta de distribuição sem documentos ou no fim da fila, aguarde 1 hora. Um bloqueio 656 exige pausa; insistir antes pode renová-lo. Outros sistemas do mesmo CNPJ também podem afetar o acesso.

XML completo depende da disponibilidade

A SEFAZ pode entregar resumo, XML completo ou evento. Resumos não têm todos os itens e não geram DANFE. A extensão não faz manifestação do destinatário. Os dados do Excel e o PDF dependem do conteúdo recebido e das regras de acesso do serviço.

Pro mantém as regras da SEFAZ

O plano remove o limite de sincronizações da extensão durante a vigência; não amplia a janela, a cota ou as permissões da SEFAZ. Documentos emitidos pela própria empresa devem ser obtidos no emissor ou no portal estadual. Portais estaduais e acervos históricos não são integrados aqui.

Na versão 1.4.0, a recuperação por NSU de NF-e permite consultar uma faixa conhecida, com pausa e retomada manual, preservando o ponto da busca normal. O NSU da NFS-e é de outro serviço. “Baixar novamente” só gera arquivos já armazenados neste navegador; não recupera documentos ausentes na SEFAZ.

Fonte: Nota Técnica 2014.002 v1.40 — Distribuição de NF-e
NFe/CTe Downloader · na Chrome Web Store

Baixe XML de NF-e e CT-e em lote — sem subir o seu certificado.

Extensão Chrome que sincroniza pela Distribuição DFe da SEFAZ com o seu certificado no navegador. ZIP por competência, emitente ou tipo, mais planilha Excel.