Baixar XML pela chave de acesso: como baixar o XML da NF-e (2026)

Para baixar o XML de uma nota fiscal pela chave de acesso, use o certificado digital de quem participou da nota: com ele, você baixa o XML oficial no Portal Nacional da NF-e ou, com o A1, na FiscalAPI. Sem certificado, peça o XML a quem emitiu a nota ou baixe na FiscalAPI uma cópia para leitura, sem a assinatura digital.

Este guia mostra o caminho com certificado na FiscalAPI: o que é preciso, o passo a passo, quanto custa e o que fazer quando o XML não vem. Só tem a chave? Veja como baixar o XML de uma NF-e sem certificado digital.

Atualizado em 7 de novembro de 2026.

O que você precisa#

Não dá para baixar o XML oficial de uma nota em que você não aparece. Por que a chave sozinha não basta está em Resumo x XML oficial: o que a SEFAZ mostra só com a chave.

Passo a passo no painel (sem código)#

1. Crie sua conta ou entre em app.fiscalapi.com.br e abra a tela de NF-e.
2. Suba o certificado A1 e digite a senha. Ele é usado só na consulta e não fica guardado.
3. Cole uma ou várias chaves. Pode colar como está no DANFE, com espaços ou pontos.
4. Clique em consultar e baixe o XML de cada nota, ou todos de uma vez em um arquivo .zip. O DANFE em PDF sai na mesma tela, sem custo extra.

As notas baixadas ficam no histórico do painel e podem ser baixadas de novo, XML e DANFE, sem nova cobrança.

Conta que ainda não assinou nenhum plano tem 10 XML grátis por mês nessa tela, sem cartão: basta confirmar o e-mail. Chave que não traz XML não gasta a cota. Detalhes em onde baixar XML de NF-e grátis pela chave.

Pela API#

Uma chave por requisição, com a sua chave de API no header X-API-Key:

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

A chave acima é fictícia. Quando a nota é encontrada, resultados[0].status vem ok e o campo xml traz o nfeProc. Exemplos em Node.js e Python estão em API para baixar XML de NF-e por chave e na documentação.

Quanto tempo e quanto custa#

Nas consultas feitas pela FiscalAPI de junho a outubro de 2026, o XML chegou em cerca de 2,7 segundos na mediana, e 90% em até 3,5 segundos (tempo medido no nosso servidor, só consultas que retornaram XML).

Chave que não retorna XML não é cobrada. Detalhes em planos e preços.

Quando o XML não vem#

Chave sem 44 dígitos nem chega a ser consultada: volta o erro CHAVE_INVALIDA (HTTP 400), sem cobrança. Chave de NFC-e (modelo 65) não baixa por aqui: veja XML de NFC-e pela chave.

Sem certificado#

Só com a chave, a consulta pública da SEFAZ mostra o resumo da nota, sem itens nem impostos. O XML oficial vem de quem emitiu a nota, que é obrigado a enviá-lo ao destinatário (Ajuste SINIEF 07/05). Os outros caminhos estão em Tenho só a chave de acesso da nota. Como consigo o XML?.

XML, chave e DANFE não são a mesma coisa#

A chave é só o número que identifica a nota. O XML é o documento fiscal. O DANFE é a impressão do XML, então quem precisa do PDF pela chave primeiro baixa o XML. A diferença completa está em XML e chave de acesso são a mesma coisa?.

Perguntas frequentes#

Dá para baixar o XML de graça? Sim, até 10 XML por mês no painel da FiscalAPI, sem cartão. Vale para conta que ainda não assinou nenhum plano, com o e-mail confirmado, e exige o certificado A1 de quem participou da nota. Chave que não traz XML não gasta a cota. Pela API, a NF-e por chave começa no plano Lite.

Serve certificado A3 (token ou cartão)? Não. A consulta usa o certificado A1: o arquivo .pfx ou .p12 com a senha. O A3 fica preso no token ou no cartão e não pode ser enviado. Se a empresa só tem o A3, peça o XML a quem emitiu a nota ou providencie um A1 com a certificadora.

Dá para baixar o PDF (DANFE) pela chave? Sim, depois que o XML é baixado. No painel da FiscalAPI o DANFE sai junto, sem custo extra.

Posso baixar várias notas de uma vez? Sim: até 50 chaves por vez no painel, ou uma planilha na aba Lotes. Na API, uma requisição por chave. Veja como baixar o XML de várias notas fiscais de uma vez.

Consigo baixar nota antiga? A consulta por chave da SEFAZ só entrega a nota por 90 dias, mas a FiscalAPI aceita chaves de qualquer data. Se a nota não puder ser entregue, a resposta diz o motivo (por exemplo, fora_prazo) e não é cobrada.

A FiscalAPI guarda o meu certificado? Na consulta avulsa e na API, não: o certificado e a senha são usados só durante a consulta e descartados em seguida. No lote, com a sua autorização, ficam cifrados só enquanto o lote processa e são apagados no fim, ou depois de 72 horas com o lote parado.

Fontes#

• Ajuste SINIEF 16/18, CONFAZ: a consulta completa da NF-e é só para quem tem relação com a operação, identificado por certificado digital ou acesso identificado
• Como baixar uma nota fiscal com chave de acesso, Tecnoblog: no Portal Nacional da NF-e, o download do documento pede o certificado digital
• Nota Técnica 2014.002 v1.40, Portal da NF-e: distribuição de documentos por chave e prazo de 90 dias
• Consultar NF-e por chave, documentação da FiscalAPI
• Planos e preços, FiscalAPI

Artigos relacionados#

• XML de NF-e grátis: como baixar 10 por mês pela chave de acesso
• Resumo x XML oficial: o que a SEFAZ mostra só com a chave
• Como baixar o XML de NF-e antiga (mais de 90 dias)
• Chave de acesso inválida: deve ter 44 caracteres
• XML e chave de acesso são a mesma coisa? O que é o nfeProc
• XML de NFC-e (modelo 65) pela chave: dá para baixar?
• Perdi o XML da nota fiscal: como recuperar
• Rejeições da SEFAZ na NF-e: as mais comuns