XMLFácil

Erros comuns ao gerar o DANFE a partir do XML da NF-e

Guia de solução de problemas. Atualizado em setembro de 2026

Se o seu arquivo XML não vira um PDF corretamente, na grande maioria das vezes o problema está no próprio arquivo: não na ferramenta usada para converter. Veja abaixo as causas mais comuns, em ordem de frequência, e como identificar cada uma.

1. O arquivo não é uma NF-e nem um CT-e (é um MDF-e ou outro tipo)

"XML não reconhecido como NF-e ou CT-e válido"
Abra o arquivo em um editor de texto e procure pela tag raiz logo no início. O XMLFácil converte <NFe>/nfeProc (NF-e e NFC-e) e <CTe>/cteProc (CT-e). Se aparecer <MDFe> ou qualquer outra tag, é um documento de outro tipo, como o Manifesto Eletrônico, que ainda não é suportado.

Isso acontece com frequência quando o XML é baixado em lote de um sistema que mistura vários tipos de documento na mesma pasta, ou quando o arquivo foi renomeado manualmente e o conteúdo não bate com a extensão.

2. XML de evento (cancelamento, carta de correção) em vez do XML principal

Uma NF-e emitida gera vários arquivos ao longo do tempo: o XML autorizado original, e depois, se aplicável, XMLs de eventos como cancelamento ou Carta de Correção Eletrônica (CC-e). Só o XML autorizado original (que contém as tags nfeProc ou NFe com todos os dados de produtos, valores e impostos) gera o DANFE completo. Um XML de evento é bem menor e só contém informações sobre a alteração, não a nota inteira.

3. Arquivo corrompido ou baixado incompleto

Se o download foi interrompido (conexão caiu, navegador travou no meio) ou o arquivo foi editado por engano em um programa que não preserva XML corretamente (alguns editores de planilha, por exemplo), o resultado costuma ser um XML com tags fechadas incorretamente ou cortado no meio. Sintomas comuns:

  • O arquivo abre em branco ou parcialmente em um navegador.
  • O tamanho do arquivo é muito menor do que outros XMLs de NF-e semelhantes (um XML de NF-e típico costuma ter entre 5 KB e 50 KB, dependendo da quantidade de itens).
  • Falta a tag de fechamento no final do arquivo.

Solução: baixe o XML novamente na origem: portal do emitente, e-mail original da compra, ou diretamente no portal da SEFAZ usando a chave de acesso.

4. Codificação de caracteres incorreta

XMLs de NF-e costumam usar codificação UTF-8. Se o arquivo foi salvo ou reexportado com outra codificação (comum quando se abre e resalva em certos editores no Windows), acentos e caracteres especiais em nomes e endereços podem aparecer corrompidos no PDF gerado, mesmo que a conversão em si funcione.

5. Chave de acesso no nome do arquivo não bate com o conteúdo

Isso não impede a geração do PDF, mas é um sinal de alerta: se o nome do arquivo (ex: 35260...xml) foi renomeado manualmente e não corresponde à chave de acesso real dentro do <infNFe Id="...">, você pode acabar organizando ou arquivando a nota errada. Vale sempre conferir a chave de acesso exibida no PDF gerado contra o nome do arquivo original.

6. Esperar um DANFE a partir de um CT-e

O CT-e não tem DANFE: o documento auxiliar dele se chama DACTE, e é isso que o XMLFácil gera quando você envia um XML de CT-e (o arquivo sai com o prefixo dacte- no nome). Já o MDF-e (modelo 58) ainda não é suportado; a ferramenta avisa em vez de gerar um PDF incorreto.

Já revisou seu arquivo e quer tentar a conversão?

Voltar ao conversor

Checklist rápido antes de enviar o XML

  1. O arquivo tem a extensão .xml e abre sem erro num editor de texto?
  2. A tag raiz é <NFe>/<nfeProc> ou <CTe>/<cteProc> (e não MDFe)?
  3. O arquivo contém as tags <det> com os produtos, não só um evento?
  4. O tamanho do arquivo é compatível com uma nota completa (não poucos KB)?