Geração de DANFE

O que é a geração de DANFE?

A NF-e é, na essência, um arquivo XML assinado digitalmente e autorizado pela SEFAZ. Esse arquivo é feito para ser lido por sistemas, não por pessoas. A geração de DANFE é a etapa que pega esse XML e monta uma representação legível dele, com campos organizados, valores, impostos, dados do emitente e do destinatário.

DANFE significa Documento Auxiliar da Nota Fiscal Eletrônica. O nome já indica o papel: ele é auxiliar. O documento fiscal com validade jurídica é o XML autorizado. O DANFE serve para facilitar a conferência e acompanhar fisicamente a mercadoria.

Para que serve o DANFE gerado?

O uso mais conhecido é acompanhar a mercadoria durante o transporte. A fiscalização no caminho pode ler o código de barras ou a chave de acesso impressa e consultar a nota diretamente na base da SEFAZ.

Além disso, o DANFE é útil para o recebimento da mercadoria, para o cliente conferir o que comprou e para o envio por e-mail junto com o XML. Muitas empresas também o anexam em portais de pedidos, áreas do cliente e sistemas de atendimento.

Como funciona a geração de DANFE?

Primeiro, a NF-e precisa ser emitida e receber a autorização de uso da SEFAZ. Com o XML autorizado em mãos, um software lê os dados do arquivo e os encaixa em um leiaute padronizado, que define onde ficam a chave de acesso, o código de barras, os produtos, os totais, os tributos e as informações de transporte.

O resultado costuma ser um PDF, que pode ser impresso em papel comum. Existem variações de formato, como a orientação retrato ou paisagem e versões simplificadas usadas em algumas situações. Em uma emissão por API, essa etapa normalmente acontece de forma automática: o sistema envia os dados da venda e recebe de volta o XML autorizado e o PDF do DANFE.

Qual a diferença entre o DANFE e o XML da NF-e?

O XML é o documento fiscal propriamente dito: tem assinatura digital, protocolo de autorização e é o arquivo que deve ser guardado e entregue ao destinatário. O DANFE é apenas uma representação impressa ou visual desse conteúdo.

Por isso, perder o PDF do DANFE não é um problema grave, já que ele pode ser gerado novamente a partir do XML. Já perder o XML pode trazer dificuldades na guarda de documentos fiscais e na escrituração.

Qual a diferença entre DANFE, DANFCE, DACTE e DAMDFE?

Cada documento fiscal eletrônico tem seu próprio documento auxiliar. O DANFE corresponde à NF-e, usada principalmente em vendas de produtos entre empresas. O DANFCE corresponde à NFC-e, a nota do varejo para o consumidor final, e costuma ser impresso em formato de cupom com QR Code.

O DACTE é o documento auxiliar do CT-e, usado no transporte de cargas, e o DAMDFE corresponde ao MDF-e, que reúne os documentos de uma viagem. A lógica de geração é parecida em todos: ler o XML autorizado e montar o documento no leiaute correto.

O que pode dar errado na geração de DANFE?

O erro mais comum é tentar gerar o DANFE antes de a nota estar autorizada. Sem autorização, o documento não tem valor, exceto em situações específicas de contingência, nas quais o DANFE é impresso com a indicação dessa condição. Outro problema frequente é usar um leiaute desatualizado, que não acompanha as mudanças publicadas em notas técnicas.

Também podem ocorrer falhas visuais, como textos cortados em notas com muitos itens ou informações complementares longas. Por isso, muitas empresas preferem delegar a geração a uma API fiscal que já mantém o leiaute atualizado.

Exemplos de Geração de DANFE

• Um ERP industrial envia os dados de um pedido para uma API fiscal, recebe a NF-e autorizada e baixa automaticamente o PDF do DANFE para imprimir e colocar junto com a carga.
• Uma loja virtual que vende para empresas anexa o DANFE em PDF ao e-mail de confirmação do pedido, junto com o arquivo XML da nota.
• O setor de expedição de um distribuidor reimprime o DANFE a partir do XML guardado no sistema porque a via em papel foi danificada antes do embarque.
• Um agente de inteligência artificial com acesso autorizado via MCP localiza uma NF-e pela chave de acesso e devolve ao atendente o link do DANFE para enviar ao cliente.