NF-e

Consultar NF-e pela chave de acesso e baixar o XML: o guia

Como consultar uma NF-e pela chave de acesso de 44 dígitos, o que a consulta pública mostra (só o resumo) e como baixar o XML completo pelo canal oficial da SEFAZ.

Por Aiteks

A chave de acesso é a "impressão digital" da nota: um número de 44 dígitos que identifica cada NF-e de forma única. Com ela dá para consultar a nota — mas há uma diferença importante entre ver o resumo na tela e baixar o XML completo, que é o documento com validade fiscal.

O que é a chave de acesso

São 44 dígitos que codificam UF, ano/mês, CNPJ do emitente, modelo (55 para NF-e), série, número, tipo de emissão e um código verificador. Ela aparece no DANFE e no próprio XML, e é o que você usa para localizar uma nota específica.

Consulta pública x XML completo

A consulta pública por chave (no portal da NF-e) mostra a situação e um resumo da nota, normalmente com captcha, uma de cada vez. Serve para conferir se a nota está autorizada. Mas o resumo não é o documento fiscal: para escriturar e comprovar crédito, é o XML completo (procNFe) que vale.

  • Consulta por chave: situação e resumo na tela. Boa para conferir uma nota.
  • XML completo: itens, NCM, CFOP, impostos e protocolo de autorização. É o documento válido.

Como baixar o XML completo

O XML completo das notas emitidas contra o seu CNPJ é distribuído pelo serviço oficial de Distribuição de DF-e da SEFAZ, autenticado pelo seu certificado digital. Quando uma nota chega apenas como resumo, é possível buscar a versão completa consultando pela própria chave de acesso, quando a SEFAZ a disponibiliza.

O NFe/CTe Downloader consulta a Distribuição DFe e, durante a sincronização ativa, busca pela chave o XML completo das notas que vieram como resumo — sem manifestar nada. O resultado sai em ZIP com XML, PDF e Excel.

Quando você tem centenas de chaves

Conferir chave por chave não escala. Se o objetivo é reunir todas as notas de entrada do mês, o caminho é a consulta em lote pela distribuição, e não a digitação de cada chave no portal.

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.