DANFSe: o documento auxiliar da NFS-e nacional, o que ele mostra e por que o XML prevalece

Nota é o XML; o DANFSe é a imagem dela

Quem trabalha com NF-e conhece o DANFE: o papel ou PDF que acompanha a mercadoria e mostra a chave de acesso. Na NFS-e padrão nacional, o equivalente é o DANFSe, Documento Auxiliar da NFS-e.

O FAQ oficial da NFS-e (item 17.8) é direto: o documento fiscal, para fiscalização, escrituração e validade jurídica, é exclusivamente o arquivo XML da NFS-e autorizada e armazenado no Ambiente de Dados Nacional (ADN). O DANFSe é uma representação gráfica auxiliar e simplificada. Uma divergência visual nele não altera os dados fiscais gravados.

A regra está na Resolução CGNFS-e nº 3/2023, art. 13, § 4º, citada pelo FAQ: o DANFSe não pode conter informações que não existam no XML.

Quem gera o DANFSe desde agosto de 2026

Até 03/08/2026, o ambiente nacional oferecia uma API que gerava o PDF do DANFSe automaticamente. Essa API foi suspensa ("sobrestada") nessa data. Desde então:

• o Emissor Web e o aplicativo continuam oferecendo o download do DANFSe;
• quem emite por sistema integrado recebe o XML autorizado da Sefin Nacional e o próprio software gera o PDF.

O leiaute é o da NT 008 da NFS-e (versão 1.02, de 14/07/2026), que define a aparência do DANFSe no padrão nacional. Mesmo seguindo o mesmo leiaute, a montagem é feita por cada sistema, e erros de mapeamento podem fazer um campo do XML não aparecer ou aparecer errado no PDF.

Os blocos do DANFSe

O conteúdo exato está na NT 008. Em linhas gerais, o documento traz:

A chave de acesso tem 50 dígitos: município, ambiente gerador, tipo e número de inscrição, número da nota, ano e mês, código aleatório e dígito verificador. A composição está em DPS: a declaração que vira NFS-e.

Campos que confundem em 2026

O FAQ (item 15.5) explica dois comportamentos esperados durante a transição:

• "Valor líquido + IBS/CBS" igual ao valor líquido. Em 2026, a fórmula do total é simplificada: o total da nota é igual ao valor líquido. A soma de IBS e CBS ao total só passa a valer em 01/01/2027.
• IBS e CBS no XML, mas não no PDF. Durante a produção restrita, os campos de IBS e CBS podem existir no XML sem ser exibidos no DANFSe nem na consulta pública, para não confundir com o recolhimento vigente do ISS.

Outro campo que chama atenção é o de exclusões e reduções da base. Ele soma desconto incondicionado, ajustes de base do ISS, o próprio ISS, PIS e Cofins, porque em 2026 a base do IBS e da CBS desconta esses valores. Por isso o ISS aparece ali mesmo em notas sem retenção.

O "Total das retenções" zerado também pode ser normal: acontece em regimes especiais (autônomo, sociedade de profissionais) e para o MEI, que não informa retenções.

Como conferir uma NFS-e

1. Pela chave de acesso, na consulta pública do portal nacional. Qualquer interessado pode validar a existência da nota, com visualização limitada por sigilo fiscal (FAQ, item 26.3).
2. Pelo QR Code impresso no DANFSe.
3. Na área "NFS-e Recebidas" do Emissor Nacional, se você é o tomador: lá estão todas as notas em que a empresa figura como parte, com download do XML e do DANFSe (item 26.6).

Ao conferir, olhe também os eventos vinculados. Uma nota substituída aparece como cancelada (cancelamento por substituição). Se a consulta e o DANFSe mostram situações diferentes, vale a consulta, que reflete o ADN.

O que fazer se o PDF não bate com o XML

• Para fins fiscais e contábeis, use o XML. Escrituração, retenções e créditos se baseiam nele.
• Se você é o emissor, peça ao suporte do seu sistema que corrija a rotina de impressão para ler as tags do XML autorizado (deduções, retenções, descontos, tributos) no lugar certo do leiaute.
• Se você é o tomador, peça o XML ao prestador ou baixe-o no Emissor Nacional, em "NFS-e Recebidas".

DANFSe, DANFE e DACTE: o que muda entre eles

O DANFSe não acompanha mercadoria, porque serviço não circula. A função dele é dar ao tomador, ao contador e ao fisco uma leitura rápida da nota, com a chave e o QR Code para conferir o XML na base nacional.

Perguntas que aparecem na rotina

• "O cliente pediu a nota em papel." Imprima o DANFSe e envie também o XML. Para a escrituração, o que vale é o arquivo.
• "O DANFSe saiu sem o meu logotipo." O leiaute nacional é padronizado pela NT 008; personalizações dependem do que o leiaute admite e do sistema emissor.
• "A nota foi cancelada, mas o PDF antigo continua circulando." O PDF não se atualiza sozinho. Quem consulta pela chave vê a situação real no ADN, com os eventos vinculados.

Guarda e envio

O que precisa ser guardado é o XML, pelo prazo da legislação tributária. O PDF pode ser gerado de novo a qualquer momento a partir dele. O raciocínio sobre os 5 anos está em guarda do XML por 5 anos.

Na entrega ao cliente, o ideal é enviar os dois: o DANFSe para leitura rápida e o XML para escrituração. Para a NF-e, o paralelo é o DANFE.