Que XML serve para gerar o DANFE
O arquivo certo é o XML da nota autorizada, normalmente com a tag nfeProc na raiz. Ele junta a nota assinada (NFe) e o protocolo de autorização (protNFe), que é de onde sai o número do protocolo impresso no DANFE. Esse é o arquivo que o fornecedor manda por e-mail e que o seu ERP guarda depois da emissão.
Um arquivo só com a tag NFe, sem o protocolo, ainda é a nota assinada, mas não carrega a prova de que a SEFAZ a autorizou. Para arquivar e para gerar o DANFE, prefira sempre o nfeProc. A diferença entre a nota e o documento auxiliar está em diferença entre NF-e e DANFE.
- Serve: XML de NF-e modelo 55, de preferência o nfeProc completo.
- Serve: XML de NFC-e modelo 65, que sai no layout DANFCE.
- Serve: XML de CT-e, que sai como DACTE.
- Não serve: XML de NFS-e de prefeitura, que não usa DANFE.
- Não serve: PDF ou HTML renomeado para .xml.
Como abrir e copiar o XML sem estragar o arquivo
O XML é texto puro, mas editores comuns às vezes mudam a codificação ou quebram linhas, e uma alteração qualquer invalida a assinatura digital. Para ler o conteúdo, abra no navegador ou num editor de texto simples, sem salvar por cima. O passo a passo está em como abrir arquivo XML da NF-e.
Para gerar o DANFE você não precisa abrir nada: basta enviar o arquivo como ele chegou. Se a nota veio compactada em .zip, extraia antes e envie o .xml de dentro.
Um cuidado com notas recebidas por e-mail: muitos fornecedores mandam o XML e o PDF juntos, com nomes parecidos. O arquivo que interessa termina em .xml e, aberto no navegador, começa com uma declaração de XML seguida de nfeProc ou NFe. Se o que aparece é texto embaralhado ou uma página com logotipo, você está com o PDF ou com uma página de portal.
Mensagens de erro e o que fazer
Quando o gerador não reconhece o arquivo, a mensagem diz o motivo em vez de mostrar um erro técnico. Os casos mais comuns têm solução direta:
- XML incompleto ou cortado: o texto colado perdeu o final. Envie o arquivo pelo upload.
- Falta um bloco obrigatório da nota: emitente, destinatário, itens ou totais ausentes. Peça o XML de novo ao emitente.
- Não é uma NF-e: o arquivo é NFS-e, página de portal, JSON ou uma chave colada no campo errado. A chave vai na aba Chave de Acesso.
- Arquivo acima de 1 MB: confira se é mesmo um XML de nota, e não um lote ou outro documento.
Depois de gerar: imprimir, arquivar ou automatizar
O PDF pode ir direto para a impressora; dicas de papel e de configuração estão em imprimir DANFE. Para arquivo, lembre que o documento que a empresa precisa guardar, em regra pelo prazo decadencial de 5 anos, é o XML; o PDF é uma cópia de conveniência que você gera de novo quando quiser.
Se a conversão de XML em PDF é rotina diária, crie uma conta para manter o histórico de tudo o que foi gerado. E se ela acontece dentro de um ERP ou sistema de logística, a API DANFE recebe o XML e devolve o PDF sem intervenção manual, com detalhes técnicos em documentação da API.