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

> O DANFSe é a representação gráfica da NFS-e padrão nacional. Ele facilita a leitura e a conferência, mas não é a nota: o documento fiscal é o XML autorizado e guardado no Ambiente de Dados Nacional. Desde 03/08/2026, com a suspensão da API pública de geração do PDF, cada sistema emissor gera o DANFSe a partir do XML, seguindo o leiaute da NT 008.

- Seção: NFS-e: Nota Fiscal de Serviço Eletrônica
- URL: https://pegaxml.com.br/nfs-e/danfse
- Publicado: 07/11/2026 · Atualizado: 07/11/2026
- Publicado por: PegaXML, site da Myse Sistemas (a mesma empresa do FazNota)

## 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:

| Bloco | O que mostra |
|---|---|
| Cabeçalho | Identificação da NFS-e, número, data e hora, competência, chave de acesso de 50 dígitos e QR Code de consulta |
| Emitente/prestador | CNPJ ou CPF, inscrição municipal, nome, endereço, regime no Simples |
| Tomador | Identificação e endereço de quem contratou |
| Intermediário | Quando houver |
| Serviço | Código de tributação nacional, código municipal, local da prestação, descrição |
| Tributação municipal | Tributação do ISS, município de incidência, base, alíquota, valor, retenção |
| Tributação federal | Retenções de IRRF, contribuição previdenciária, CSLL, PIS e Cofins |
| Valores | Valor do serviço, descontos, deduções e reduções, valor líquido |
| IBS e CBS | Classificação, base e valores, conforme a fase de implantação |
| Totais aproximados | Valor aproximado dos tributos (Lei 12.741/2012) |
| Informações complementares | Texto livre e documentos referenciados |

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](https://pegaxml.com.br/nfs-e/dps-declaracao-de-prestacao-de-servico).

## 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

| Documento auxiliar | Documento fiscal | Função principal | Chave |
|---|---|---|---|
| DANFE | NF-e (modelo 55) | Acompanhar o trânsito da mercadoria | 44 dígitos |
| DANFE NFC-e | NFC-e (modelo 65) | Comprovante da venda ao consumidor, com QR Code | 44 dígitos |
| DACTE | CT-e (modelo 57) | Acompanhar a carga durante o transporte | 44 dígitos |
| DANFSe | NFS-e padrão nacional | Representar a nota de serviço para leitura e conferência | 50 dígitos |

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](https://pegaxml.com.br/nf-e/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](https://pegaxml.com.br/nf-e/danfe).

## Perguntas frequentes

### O DANFSe tem validade jurídica?

Não sozinho. O documento oficial para fiscalização e escrituração é o XML da NFS-e autorizada e guardada no ADN. O DANFSe é auxiliar e, pela Resolução CGNFS-e nº 3/2023, não pode conter informação que não esteja no XML.

### Por que o DANFSe do meu sistema é diferente do de outro sistema?

Desde 03/08/2026 a API pública que gerava o PDF está suspensa, e cada software gera o DANFSe a partir do XML. Todos devem seguir o leiaute da NT 008, mas a montagem é local.

### O DANFSe de 2026 mostra IBS e CBS?

Durante a produção restrita, os campos de IBS e CBS podem constar no XML sem aparecer no DANFSe. Em 2026, o valor total da nota é igual ao valor líquido; a soma de IBS e CBS ao total passa a valer em 01/01/2027.

### Preciso guardar o DANFSe?

O que deve ser guardado é o XML. O PDF pode ser regenerado a partir dele.

## Fontes

- [Perguntas Frequentes NFS-e v1.3, de 06/11/2026 (itens 15.5, 17.8, 26.3 e 26.6)](https://www.gov.br/nfse/pt-br/perguntas-frequentes/perguntas-frequentes-nfs-e-v1-3-20261106.pdf)
- [Portal da NFS-e: documentação técnica (NT 008, DANFSe)](https://www.gov.br/nfse/pt-br/biblioteca/documentacao-tecnica)
- [Emissor Nacional da NFS-e](https://www.nfse.gov.br/EmissorNacional)

## Leia também

- [NFS-e padrão nacional: como funciona o sistema que unificou a nota de serviço](https://pegaxml.com.br/nfs-e/nfs-e-padrao-nacional.md)
- [DPS: a declaração que vira NFS-e, seus grupos de dados e a chave de 50 dígitos](https://pegaxml.com.br/nfs-e/dps-declaracao-de-prestacao-de-servico.md)
- [Cancelamento de NFS-e no padrão nacional: prazos do município, análise fiscal e substituição](https://pegaxml.com.br/nfs-e/cancelamento-de-nfs-e.md)
- [DANFE: o que é o documento auxiliar da NF-e, o que ele mostra e quando é exigido](https://pegaxml.com.br/nf-e/danfe.md)
- [Guarda do XML da nota fiscal: por que se fala em 5 anos, quem deve guardar e o que guardar](https://pegaxml.com.br/nf-e/guarda-do-xml-por-5-anos.md)

As informações têm caráter educativo e não substituem a orientação do seu contador.