Como consultar uma NF-e pela chave de acesso e baixar o XML

Atualizado em 14/10/2026 · Equipe Ágil Fiscal

Para baixar o XML de uma NF-e pela chave de acesso, a empresa precisa consultar a Distribuição DF-e da SEFAZ autenticada com o próprio certificado digital. Na Ágil Fiscal basta colar a chave de 44 dígitos em consulta.agilfiscal.com.br e escolher o certificado na janela do navegador: o XML vem direto da SEFAZ, de graça.

Passo a passo

1. Instale a extensão. Instale a extensão Ágil Fiscal no Google Chrome ou no Microsoft Edge, no computador em que o certificado digital da empresa está instalado.
2. Cole a chave de acesso. Abra consulta.agilfiscal.com.br e cole a chave de 44 dígitos da NF-e. O site identifica o modelo, a UF e o número da nota automaticamente.
3. Escolha o certificado. Clique em Consultar. Na primeira consulta, o navegador pergunta qual certificado usar: escolha o e-CNPJ da empresa que participa da nota.
4. Baixe o XML. Clique em Baixar XML para salvar o arquivo, ou em Visualizar Nota para abrir o DANFE pronto para imprimir.

Onde a SEFAZ guarda o XML da NF-e

Toda NF-e autorizada fica disponível no Ambiente Nacional pelo serviço NFeDistribuicaoDFe (Distribuição de Documentos Fiscais Eletrônicos). Esse serviço é a fonte oficial do XML e responde a uma consulta pela chave de acesso (consChNFe), desde que quem consulta seja parte da nota.

O portal da NF-e permite ver os dados de uma nota pela chave, mas o download do XML completo pelo portal também exige certificado digital. A Ágil Fiscal faz a mesma consulta oficial, só que em um campo único e sem precisar de programa instalado: o certificado que já está no Windows é usado pelo próprio navegador.

Quem pode baixar o XML de uma NF-e

A SEFAZ só entrega o XML ao CNPJ ou CPF que aparece na nota:

• Emitente — quem emitiu a NF-e;
• Destinatário — quem comprou ou recebeu a mercadoria;
• Transportador informado na nota;
• Autorizados no grupo autXML, como o escritório de contabilidade.

Se o certificado escolhido não pertence a nenhuma dessas partes, a SEFAZ recusa a consulta. Isso vale para qualquer site ou sistema que baixe XML: é a proteção do sigilo fiscal.

Resumo da NF-e e Ciência da Operação

Para o destinatário, a SEFAZ costuma liberar primeiro apenas o resumo da NF-e (resNFe), com emitente, valor e situação. O XML completo é liberado depois que o destinatário registra o evento Ciência da Operação (código 210210). A ciência não confirma nem recusa a compra; ela apenas informa que a empresa tomou conhecimento da nota.

Quando a consulta retorna só o resumo, o site avisa e permite baixar o resumo. Assim que a ciência estiver registrada, a mesma chave passa a retornar o XML completo.

Erros comuns na consulta

• Chave inválida — o último dígito (DV) não confere. Copie a chave de novo do DANFE ou do e-mail; veja como ler a chave de acesso.
• Rejeição 593 (CNPJ do certificado diferente) — o certificado escolhido não é de uma das partes da nota. O site pede o CNPJ da empresa ou permite reiniciar o navegador para escolher outro certificado.
• Nota fora do prazo — o Ambiente Nacional só disponibiliza para download as NF-e dos últimos 90 dias. Notas mais antigas precisam ser obtidas com o emitente ou no sistema da empresa.
• Consumo indevido (656) — a SEFAZ limita consultas repetidas em pouco tempo. Aguarde cerca de uma hora e tente de novo.

Perguntas frequentes