Guia prático para recuperar o XML da NF-e pela chave de acesso — de uma nota ou de centenas de uma vez.

Atualizado em outubro de 2026 · Equipe Inscrição Estadual Fácil

Quem trabalha com compras, recebimento fiscal ou contabilidade conhece a cena: o fornecedor mandou só o DANFE em PDF, ou a nota chegou impressa junto com a mercadoria, e o XML não está em lugar nenhum. Sem ele, a nota não entra direito na escrituração.

Este guia mostra de onde vem o XML, quais são os caminhos oficiais para baixá-lo pela chave de acesso e como fazer isso para dezenas ou centenas de notas de uma vez, sem abrir uma por uma.

Resumo rápido: o XML é o documento fiscal de verdade; o DANFE é só uma representação impressa. Com a chave de acesso de 44 dígitos você recupera o XML — pelo emitente, pela SEFAZ com certificado digital ou por uma ferramenta de download em lote.

DANFE ou XML: qual é a nota fiscal de verdade?

A NF-e existe apenas em formato digital: é um arquivo XML assinado digitalmente pelo emitente e autorizado pela SEFAZ. O DANFE (Documento Auxiliar da NF-e) é a versão impressa que acompanha a mercadoria e serve para consulta — ele não substitui o arquivo.

Por isso não existe "converter DANFE em XML". Um PDF não carrega a assinatura digital nem o protocolo de autorização. O que dá para fazer é usar a chave de acesso impressa no DANFE para baixar o XML original que está registrado na SEFAZ.

Por que você precisa do XML

  • Obrigação legal: emitente e destinatário devem guardar o XML pelo prazo decadencial — na prática, cinco anos contados a partir do primeiro dia do ano seguinte ao da emissão.
  • Escrituração e SPED: o XML é importado pelo sistema contábil e fiscal para lançar a entrada, apurar créditos de ICMS e gerar as obrigações acessórias.
  • Fiscalização: em uma auditoria, o fisco pode exigir os arquivos. Ter só o PDF não basta.

Onde fica a chave de acesso e o que ela diz

A chave de acesso tem 44 dígitos e aparece no DANFE, logo acima ou abaixo do código de barras. Ela identifica a nota de forma única no país. Cada trecho tem um significado:

PosiçãoDígitosO que representa
1–22Código da UF do emitente (ex.: 35 = SP, 41 = PR)
3–64Ano e mês de emissão (AAMM)
7–2014CNPJ do emitente
21–222Modelo do documento (55 = NF-e, 65 = NFC-e, 57 = CT-e)
23–253Série
26–349Número da nota
351Forma de emissão (normal ou contingência)
36–438Código numérico aleatório
441Dígito verificador

Dica prática: se a chave copiada de um PDF ou planilha ficou com 43 ou 45 caracteres, ou com espaços no meio, a consulta falha. Vale conferir o tamanho antes de qualquer download em lote.

As formas de baixar o XML pela chave de acesso

Existem quatro caminhos. Eles variam bastante em esforço quando o volume de notas cresce.

1. Pedir o XML ao emitente

A legislação da NF-e (Ajuste SINIEF 07/05) obriga o emitente a enviar ou disponibilizar o XML ao destinatário. Para uma nota isolada, um e-mail ao fornecedor costuma resolver. Para muitas notas de vários fornecedores, vira uma cobrança sem fim.

2. Portal Nacional da NF-e

No Portal Nacional da NF-e é possível consultar uma nota pela chave. A consulta resumida é aberta, mas o acesso completo e o download do XML exigem certificado digital de uma das partes da operação — emitente, destinatário ou transportador. Funciona nota a nota, com captcha, o que torna inviável para grandes volumes.

3. Distribuição de DF-e com certificado A1

Sistemas e ERPs podem usar o webservice de Distribuição de DF-e da SEFAZ para listar automaticamente as notas emitidas contra o seu CNPJ. Dois detalhes importam:

  • De início, o serviço entrega apenas um resumo da nota. O XML completo vem depois que o destinatário registra a manifestação Ciência da Operação.
  • O serviço só disponibiliza documentos dos últimos 90 dias. Notas mais antigas precisam ser buscadas pela chave de acesso.

4. Ferramenta de download em lote

Quando você já tem a lista de chaves — exportada do SPED, de uma planilha do fornecedor, do relatório do ERP ou digitada dos DANFEs —, uma ferramenta de lote faz o trabalho repetitivo: consulta cada chave, baixa o XML e organiza os arquivos.

MétodoPrecisa de certificado?Bom paraLimitação
Pedir ao emitenteNãoPoucas notasDepende da resposta do fornecedor
Portal Nacional da NF-eSim, de uma das partesConsulta pontualUma nota por vez
Distribuição de DF-eSim (A1)Rotina automática de entradasSó os últimos 90 dias
Ferramenta em loteDepende da modalidadeMuitas notas de uma vezRitmo limitado pela SEFAZ

Como baixar XML em lote com o iLoveXML

O iLoveXML foi criado justamente para o caso de quem tem muitas chaves e pouco tempo. O fluxo é direto:

  1. Reúna as chaves de acesso das notas que você precisa, uma por linha. Pode copiar de uma planilha ou de um relatório do sistema.
  2. Cole a lista no iLoveXML.
  3. Aguarde o processamento. As consultas respeitam o ritmo permitido pela SEFAZ, então lotes grandes levam alguns minutos.
  4. Baixe os XML e, se precisar, o DANFE em PDF de cada nota.

Para quem tem certificado digital A1 e quer parar de correr atrás de XML, o iLoveXML também oferece um agente que roda no seu próprio computador — o certificado não sai da sua máquina — e busca automaticamente as notas emitidas contra o seu CNPJ, registra a manifestação e organiza os arquivos, com opção de envio para o Google Drive.

Há uma versão gratuita para baixar XML e gerar DANFE, e planos pagos por CNPJ para quem precisa de automação contínua.

O iLoveXML é desenvolvido pela mesma equipe que mantém o Inscrição Estadual Fácil.

Erros comuns ao baixar XML pela chave

  • Chave incompleta ou com espaços: confira se tem exatamente 44 números.
  • Modelo errado: os dígitos 21 e 22 dizem se é NF-e (55), NFC-e (65) ou CT-e (57). Cada tipo é consultado em um serviço diferente.
  • Nota cancelada ou denegada: o XML pode até ser obtido, mas a nota não tem validade para crédito de imposto. Confira sempre a situação.
  • Esperar demais: pelo serviço de Distribuição de DF-e, depois de 90 dias a nota some da lista e só pode ser recuperada pela chave.
  • Guardar só o PDF: o DANFE não substitui o XML na fiscalização nem na escrituração.

Antes de lançar a nota, confira o fornecedor

XML em mãos, vale um último cuidado: verificar se a Inscrição Estadual do emitente está ativa. Nota de empresa com IE baixada, suspensa ou não habilitada pode comprometer o crédito de ICMS. A consulta é gratuita: consultar Inscrição Estadual pelo CNPJ.

Perguntas frequentes

Dá para converter DANFE em XML?

Não diretamente. O DANFE é só a representação impressa da NF-e e não contém a assinatura digital nem o protocolo de autorização. O que se faz é usar a chave de acesso de 44 dígitos impressa no DANFE para baixar o XML original registrado na SEFAZ.

Preciso de certificado digital para baixar o XML?

Para usar os serviços da SEFAZ (Portal Nacional da NF-e e Distribuição de DF-e), sim: o certificado deve ser de uma das partes da operação. Sem certificado, o caminho é pedir o XML ao emitente, que é obrigado a enviá-lo, ou usar uma ferramenta de download pela chave de acesso.

Por quanto tempo devo guardar o XML da nota fiscal?

Pelo prazo decadencial, que na prática é de cinco anos contados a partir do primeiro dia do ano seguinte ao da emissão. A obrigação vale para o emitente e para o destinatário.

Por que a Distribuição de DF-e não mostra notas antigas?

O serviço de Distribuição de DF-e da SEFAZ só disponibiliza documentos dos últimos 90 dias. Notas mais antigas precisam ser recuperadas a partir da chave de acesso.

O mesmo vale para CT-e e NFC-e?

Sim. O CT-e (modelo 57) e a NFC-e (modelo 65) também têm chave de acesso de 44 dígitos, e o XML é o documento válido. O modelo aparece nos dígitos 21 e 22 da chave.

Leia também