Como Baixar o XML da NF-e pela Chave de Acesso (Guia 2026)

Para baixar o XML completo e assinado da NF-e pela chave de acesso você precisa de um certificado digital (A1 .pfx) em que o titular seja participante da nota — emitente, destinatário, transportador ou autorizado (autXML). Com a chave de 44 dígitos e o certificado em mãos, dá para baixar pelo painel (colando várias chaves, com resultados nota a nota) ou via API (uma chave por requisição), em segundos.

Se você só tem a chave de acesso (aqueles 44 números que aparecem no DANFE) e precisa do arquivo XML de verdade — o nfeProc com validade jurídica —, este guia mostra o caminho certo, o que a lei permite e como automatizar tudo.

XML ou DANFE? Entenda o que você está baixando#

Antes de tudo, uma distinção que confunde muita gente:

💡 Para escrituração, auditoria e guarda fiscal, o que vale é o XML. A guarda obrigatória é de 5 anos. PDF não substitui XML.

O limite legal que você precisa conhecer#

Desde 07/07/2020 (Ajuste SINIEF 16/2018), a consulta pública por chave de acesso sem certificado retorna apenas o resumo da nota: dados básicos como emitente, destinatário, valor total e situação. Não vêm os itens, NCM, CFOP nem os impostos detalhados.

Para baixar o XML completo, a SEFAZ exige um certificado digital de quem é participante da nota. Ou seja:

• Você não consegue XML completo de uma nota de terceiros aleatória.
• Você consegue XML completo das suas notas — onde você é emitente, destinatário, transportador ou autorizado (autXML).

Qualquer ferramenta que prometa "XML completo grátis e sem certificado" está, na melhor das hipóteses, entregando só o resumo.

Notas antigas e o fallback do portal#

A consulta por chave da SEFAZ pode não disponibilizar notas mais antigas, retornando a rejeição cStat 632 ("Solicitação fora de prazo"). Nesses casos a FiscalAPI tenta automaticamente o portal da NF-e com o mesmo certificado, recuperando boa parte das notas antigas. Ainda assim, o ideal é automatizar a captura dos seus XML logo após a emissão — não deixe para depois.

Como baixar o XML pela chave de acesso (passo a passo)#

A FiscalAPI tem a funcionalidade [NF-e por Chave](/nfe-por-chave/), que faz exatamente isso: recebe a chave de 44 dígitos e o seu certificado A1 e devolve o nfeProc assinado.

Um ponto importante sobre privacidade: a FiscalAPI opera em zero custódia. O certificado e a senha são usados apenas no momento da consulta e descartados em seguida — nunca ficam armazenados nos nossos servidores.

Pelo painel (sem código)#

Acesse app.fiscalapi.com.br/dashboard/nfe-xml e siga:

1. Suba o certificado A1 (.pfx) e informe a senha. Ele fica disponível só na sessão.
2. Cole uma ou várias chaves de acesso. Pode colar com ou sem espaços (como aparece no DANFE) — as chaves são normalizadas automaticamente.
3. Clique em consultar. A FiscalAPI busca cada nota na SEFAZ.
4. Baixe o XML. Individual, nota a nota, ou todos de uma vez em um arquivo `.zip`.

💡 Cobrança justa: você paga 1 crédito por chave que retorna XML. Chave que não retorna (fora de prazo, sem permissão, inexistente) não é cobrada.

Via API (para automatizar)#

Se você quer integrar a captura de XML ao seu ERP ou rotina, use o endpoint:

curl -X POST https://api.fiscalapi.com.br/api/consultar-nfe-xml \
  -H "X-API-Key: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chave": "43260689677595000128550030006074891411409127",
    "certificado": "<conteudo-do-pfx-em-base64>",
    "senha": "senha-do-certificado"
  }'

• `chave`: uma chave de 44 dígitos por requisição (com ou sem espaços).
• `certificado`: o seu .pfx codificado em base64.
• `senha`: a senha do certificado.

A resposta traz o XML de cada nota disponível. A documentação completa com os campos de retorno está em docs.fiscalapi.com.br/docs/nfe/consultar-nfe-chave. Para um tutorial focado em devs, veja API para baixar XML de NF-e por chave.

Baixar XML em lote: a forma mais eficiente#

Quem lida com volume — escritórios de contabilidade, departamentos fiscais — não quer consultar nota a nota. O fluxo em lote resolve:

• No painel: cole o bloco inteiro de chaves de uma vez — o painel consulta uma a uma e mostra cada resultado conforme chega; ao final, baixe todos os XML em um único .zip.
• Via API: faça uma requisição por chave (campo chave) e processe cada resposta no seu sistema. Para volume, dispare as chamadas em paralelo (com um limite) ou em sequência.

Como as chaves são normalizadas (espaços, quebras de linha), você pode copiar e colar direto de uma planilha, e-mail ou PDF sem ficar limpando o texto manualmente.

Erros comuns e como evitar#

• "Só veio o resumo, sem itens." Você consultou sem certificado ou com um certificado cujo titular não é participante da nota. Use o certificado de participante.
• Rejeição cStat 632. Nota mais antiga que a SEFAZ não disponibiliza pela consulta por chave. A FiscalAPI tenta o portal da NF-e automaticamente nesse caso.
• "Nada foi cobrado, mas também não veio XML." Correto: chave sem retorno não gera cobrança.
• Senha do certificado errada. Confira a senha do .pfx — é a mesma usada para assinar suas notas.

Resumo x XML completo: quando cada um basta#

Se você só precisa validar se uma nota existe e está autorizada, o resumo público resolve. Se precisa do documento fiscal para escriturar, auditar ou guardar, é XML completo com certificado. Aprofundamos essa diferença em Resumo x XML completo da NF-e.

Perguntas frequentes (FAQ)#

Consigo baixar o XML da NF-e só com a chave de acesso, sem certificado?#

Não o XML completo. Sem certificado, a consulta pública por chave retorna apenas o resumo (sem itens, NCM, CFOP e impostos), conforme o Ajuste SINIEF 16/2018, em vigor desde 07/07/2020. O nfeProc completo exige certificado de participante.

Preciso de qual tipo de certificado?#

Um certificado digital A1 (.pfx) cujo titular seja participante da nota — emitente, destinatário, transportador ou autorizado (autXML). Não dá para baixar o XML completo de notas em que você não participa.

A FiscalAPI guarda meu certificado?#

Não. A operação é zero custódia: o certificado e a senha são usados só no momento da consulta e descartados logo em seguida. Nada é armazenado.

Posso baixar vários XML de uma vez?#

Sim, pelo painel: cole várias chaves de uma vez — o painel consulta uma a uma, mostra cada resultado conforme chega e ao final você baixa todos em um .zip. Pela API é uma chave por requisição (campo chave); para volume, faça uma chamada por nota.

Consigo consultar notas antigas pela chave?#

Na maioria dos casos, sim. As notas recentes vêm direto da consulta por chave da SEFAZ; quando a SEFAZ não disponibiliza mais a nota (cStat 632, típico de notas antigas), a FiscalAPI tenta o portal da NF-e automaticamente com o mesmo certificado. Mesmo assim, capturar os XML logo após a emissão é a prática mais segura.

Pronto para parar de baixar XML manualmente? Crie sua conta gratuita e teste a captura de NF-e por chave em minutos.

Leia também#

• Rejeições da SEFAZ na NF-e: as mais comuns e como resolver
• SEFAZ fora do ar? Como verificar o status das 27 SEFAZs em tempo real
• IBS e CBS na NF-e: caiu a rejeição, não caiu a obrigação