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

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 (é um CT-e, NFC-e ou outro tipo)

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. CT-e enviado esperando um DANFE de NF-e

No momento, o XMLFácil gera o Documento Auxiliar apenas para NF-e (modelos 55 e 65). Se você enviar um XML de CT-e, a ferramenta avisa que esse tipo ainda não é suportado — isso é intencional, não um bug: o layout do DACTE (documento do CT-e) é diferente do DANFE e requer um mecanismo de geração próprio, que ainda não implementamos.

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> ou <nfeProc> (não CTe)?
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)?