DANFSe é a sigla de Documento Auxiliar da NFS-e: o PDF que mostra, numa página, os dados de uma nota fiscal de serviço eletrônica. A nota é o arquivo XML assinado e guardado no Ambiente de Dados Nacional, e o DANFSe não pode trazer nada que não esteja nele. Desde 3 de agosto de 2026, o documento segue a Nota Técnica SE/CGNFS-e nº 008, que criou um bloco para os tributos da reforma do consumo. Quem emite a nota, e como, está na guia da NFS-e Nacional; os códigos impressos no PDF se conferem na consulta do código de tributação nacional.
O que é o DANFSe
A Resolução CGNFS-e nº 3/2023 instituiu o documento "destinado a facilitar a consulta resumida dos dados da NFS-e" (art. 13). Ele é gerado em PDF, pode ter leiautes diferentes conforme o tipo de operação e "não poderá conter informações que não existam no arquivo XML da NFS-e" (art. 13, §§ 1º e 4º). A Nota Técnica 004 foi mais direta: o documento auxiliar é "mera representação de dados básicos do documento fiscal eletrônico e que com ele não se pode confundir".
A Nota Técnica 008 dá ao DANFSe dois objetivos: facilitar a consulta resumida da nota e auxiliar os processos administrativos e financeiros do destinatário que não emite NFS-e. A validade jurídica fica no XML, com a assinatura eletrônica e a autorização de uso (Resolução CGNFS-e nº 3/2023, art. 2º).
DANFSe, NFS-e e DANFE: o que é cada um
As três siglas aparecem juntas porque a NF-e, a nota de mercadorias, também tem documento auxiliar, o DANFE, criado pelo Ajuste SINIEF 07/2005.
| Aspecto | NFS-e | DANFSe | DANFE |
|---|---|---|---|
| O que é | Documento fiscal de serviços, só digital | Representação da NFS-e em PDF | Representação da NF-e, a nota de mercadorias |
| Para que serve | Documentar o serviço para fins fiscais | Consulta resumida e apoio a quem recebe a nota | Acompanhar o trânsito das mercadorias e facilitar a consulta |
| Norma | Resolução CGNFS-e nº 3/2023, art. 1º | Resolução CGNFS-e nº 3/2023, art. 13, e Nota Técnica 008 | Ajuste SINIEF 07/2005, cláusula nona |
O DANFE segue a mesma regra de não trazer dado fora do XML (cláusula nona, § 12) e tem uma função a mais: acompanhar a mercadoria no transporte, o que só pode fazer depois da autorização de uso da NF-e (§ 1º).
Quando o DANFSe é usado e quem guarda
Quem emite guarda o XML pelo prazo da legislação tributária, e quem recebe a nota também, com o dever de verificar a validade e a autenticidade dela (Resolução CGNFS-e nº 3/2023, art. 6º). O DANFSe entra para o destinatário que não emite NFS-e nem é responsável tributário: ele "poderá manter sob sua guarda o arquivo eletrônico do Documento Auxiliar da NFS-e (DANFSe)", a ser apresentado ao fisco quando solicitado (art. 6º, § 2º).
O passo a passo oficial do emissor indica o PDF para encaminhar ao cliente. Impresso, o documento ocupa uma única página A4 ou maior, em modo retrato, numa via e em qualquer papel menos jornal (Nota Técnica 008).
O modelo novo da Nota Técnica 008
A Nota Técnica SE/CGNFS-e nº 008 traz as especificações do DANFSe para quem desenvolve emissores e sistemas fiscais. A versão em vigor, 1.02, de 14 de julho de 2026, ajustou o tamanho dos campos e o tratamento de PIS, Cofins e retenções, e foi ratificada pelo Ato Técnico Conjunto RFB/CGIBS nº 1, de 31 de julho de 2026 (art. 3º).
Em 3 de agosto de 2026, o Portal da NFS-e passou a gerar o DANFSe no modelo novo pela Consulta Pública, pelo Portal do Contribuinte e pelo Painel Administrativo Municipal, e desativou a API do DANFSe do Ambiente de Dados Nacional. Desde então, quem emite por sistema próprio monta o PDF a partir do XML (FAQ oficial, item 17.8). A NT avisa que as operações novas da reforma, que antes não tinham documento fiscal, terão nota técnica própria de DANFSe. O modelo do Anexo I e os tamanhos mínimos de fonte são obrigatórios; os tamanhos de campo, só sugestão.
Bloco a bloco: o que o documento mostra
Cabeçalho, chave de acesso e QR Code
À esquerda, o logotipo da NFS-e; no centro, "DANFSe v2.0" e "Documento Auxiliar da NFS-e"; à direita, o município do emitente, o ambiente gerador (sistema próprio da prefeitura ou Sefin Nacional) e o tipo de ambiente. Nota de teste, emitida em homologação, leva em vermelho "NFS-e SEM VALIDADE JURÍDICA". A chave de acesso sai num bloco único de 50 dígitos, e o QR Code aponta para a Consulta Pública.
Dados da nota e da declaração que a originou
Número da NFS-e, competência (a data da prestação do serviço), data e hora da emissão, número, série e data da DPS, emitente (prestador, tomador ou intermediário), situação e finalidade. A série revela o canal: 00001 a 49999 para API, 50000 a 69999 para o aplicativo, 70000 a 79999 para o emissor web e 80000 a 89999 para transcrição manual (FAQ oficial, item 18.1).
Prestador ou fornecedor
CNPJ, CPF ou NIF, inscrição municipal, telefone, nome, município, código IBGE, CEP, endereço e e-mail, mais a situação no Simples Nacional na data de competência (não optante, MEI ou ME/EPP) e o regime de apuração pelo Simples.
Tomador, destinatário e intermediário
Os três blocos repetem os campos de identificação. Sem tomador, o bloco traz só "TOMADOR/ADQUIRENTE DA OPERAÇÃO NÃO IDENTIFICADO NA NFS-e", e o mesmo vale para os outros dois. O destinatário entrou com a reforma porque o local da operação pode ser o endereço de quem recebe o serviço.
Serviço prestado
Código de tributação nacional, e o municipal se houver, no formato nn.nn.nn; código da NBS, no formato n.nnnn.nn.nn; local da prestação; descrição do código; e descrição do serviço, com reticências depois de 1.297 caracteres. O significado de cada código está na consulta do código de tributação nacional e na tabela NBS.
Tributação municipal
O bloco do ISS mostra o tipo de tributação (operação tributável, imunidade, exportação ou não incidência), município de incidência, regime especial, suspensão da exigibilidade, benefício municipal, deduções, base de cálculo, alíquota, retenção e ISS apurado. Sem ISS, como na locação do item 99, o bloco vira a linha "TRIBUTAÇÃO MUNICIPAL (ISSQN) - OPERAÇÃO NÃO SUJEITA AO ISSQN". Na empresa do Simples que apura o ISS no regime, o valor do imposto fica sem destaque (FAQ oficial, item 20.2).
Tributação federal
O título no modelo é Tributação Federal (exceto CBS): IRRF, contribuição previdenciária retida, contribuições sociais retidas e PIS e Cofins de apuração própria. A linha de PIS e Cofins só sai em notas com competência até dezembro de 2026 (nota 6 do item 2.4.5), e as duas contribuições acabam em 2027 (LC 214/2025, art. 542).
O bloco dos tributos da reforma
Com o título Tributação IBS / CBS, o bloco junta o que o emitente declarou e o que o sistema calculou: CST e classificação tributária (cClassTrib), indicador de operação com o município de incidência, exclusões e reduções da base, base depois delas, percentuais de redução, alíquotas do IBS estadual, do IBS municipal e da CBS, alíquotas efetivas e valores apurados. As exclusões somam desconto incondicionado, reembolsos e repasses, ISS, PIS e Cofins (LC 214/2025, art. 12, § 2º). Sem redução, a alíquota efetiva é igual à nominal. Cada CST está na tabela CST do IBS e da CBS, cada classificação na tabela cClassTrib, e os dois tributos, na guia de IBS e CBS.
Valor total da nota
Valor do serviço, descontos, total das retenções, valor líquido, total do IBS e da CBS e, com fundo cinza, o líquido somado aos dois. O valor líquido é o serviço menos descontos e retenções (FAQ oficial, item 13.2). Em 2026, o último campo repete o valor líquido; a soma passa a valer em 1º de janeiro de 2027 (item 15.5).
Informações complementares e canhoto
O campo final reúne, separados por barras verticais, as informações do contribuinte, a chave da nota substituída, dados de obra, evento, pedido e da prefeitura, e termina sempre com a linha "Totais Aproximados dos Tributos cfe. Lei nº 12.741/2012", em reais ou em percentual. O canhoto, com data de ciência, assinatura e número da nota, é opcional.
De onde vem cada campo no XML
Cada campo do DANFSe representa uma tag do XML da nota. A tabela segue o item 2.4.5 da NT 008 e o código do gerador de DANFSe publicado pela Receita Federal.
| Bloco | O que mostra | De onde vem no XML |
|---|---|---|
| Cabeçalho | Município, ambientes e chave | Id de infNFSe sem o prefixo NFS, xLocEmi, ambGer, tpAmb |
| Dados da NFS-e | Número, datas, DPS, emitente, situação e finalidade | nNFSe, dhProc, cStat; na DPS, dCompet, nDPS, serie, dhEmi, tpEmit, finNFSe |
| Prestador | Identificação, endereço e Simples | emit e prest/regTrib (opSimpNac, regApTribSN) |
| Outras partes | Tomador, destinatário e intermediário | toma, dest e interm |
| Serviço prestado | Códigos, local e descrição | cTribNac, cTribMun, cNBS, xDescServ, locPrest |
| Tributação municipal | ISS, base, alíquota e retenção | tribMun da DPS; vBC, pAliqAplic e vISSQN da NFS-e |
| Tributação federal | IRRF, retenções, PIS e Cofins | tribFed (vRetIRRF, vRetCP, vRetCSLL, piscofins) |
| Tributação IBS / CBS | CST, classificação, indicador, base, alíquotas e valores | IBSCBS da DPS (cIndOp, CST, cClassTrib) e da NFS-e (cLocalidadeIncid, valores, totCIBS) |
| Valor total | Valor, descontos, retenções, líquido e totais | vServ, vDescCondIncond, vTotalRet, vLiq, vIBSTot, vCBS, vTotNF |
| Informações complementares | Textos, substituição, obra, evento e tributos aproximados | infoCompl, chSubstda, obra, atvEvento, totTrib |
Fonte: Nota Técnica SE/CGNFS-e nº 008, versão 1.02, item 2.4.5, e gerador de DANFSe da Receita Federal (licença MIT). A Nota Técnica 009 muda alguns grupos de lugar, como o do destinatário.
Como ler os 50 dígitos da chave de acesso
A chave impressa no DANFSe tem 50 números. No XML, o identificador da nota tem 53 caracteres, porque leva o prefixo NFS na frente da mesma sequência (FAQ oficial, item 18.4).
| Posições | Conteúdo | Dígitos |
|---|---|---|
| 1 a 7 | Código do município | 7 |
| 8 | Ambiente gerador: 1 para sistema próprio da prefeitura, 2 para Sefin Nacional | 1 |
| 9 | Tipo de inscrição: 1 para CPF, 2 para CNPJ | 1 |
| 10 a 23 | Inscrição federal do emitente | 14 |
| 24 a 36 | Número da NFS-e | 13 |
| 37 a 40 | Ano e mês da emissão | 4 |
| 41 a 49 | Código numérico aleatório | 9 |
| 50 | Dígito verificador | 1 |
Fonte: FAQ oficial da NFS-e, versão 1.3, itens 18.4 e 26.3.
Exemplo com os números de uma nota de 2026
Uma nota hipotética de empresa do regime regular: serviço de R$ 1.000,00, sem desconto, ISS de R$ 50,00 não retido, PIS de R$ 6,50 e Cofins de R$ 30,00 de apuração própria e nenhuma retenção. Em 2026, a CBS é de 0,9% e o IBS de 0,1%, só estadual (LC 214/2025, arts. 343 e 346).
| Campo do DANFSe | No exemplo | Como sai |
|---|---|---|
| Valor líquido da NFS-e | R$ 1.000,00 | Sem desconto e sem retenção |
| Exclusões e reduções da base | R$ 86,50 | ISS de 50,00 + PIS de 6,50 + Cofins de 30,00 |
| Base de cálculo após exclusões | R$ 913,50 | 1.000,00 menos 86,50 |
| Valor apurado estadual do IBS | R$ 0,91 | 0,1% de 913,50 |
| Valor apurado municipal do IBS | R$ 0,00 | Não há parcela municipal em 2026 |
| Valor total apurado da CBS | R$ 8,22 | 0,9% de 913,50 |
| Total do IBS e da CBS | R$ 9,13 | 0,91 + 8,22 |
| Valor líquido somado ao IBS e à CBS | R$ 1.000,00 | Em 2026, igual ao valor líquido |
Valores hipotéticos, arredondados ao centavo. Em 2026, quem cumpre as obrigações acessórias fica dispensado de recolher o IBS e a CBS destacados (LC 214/2025, art. 348, § 1º).
A base fica abaixo do valor do serviço porque ISS, PIS e Cofins saem dela de 2026 a 2032 (LC 214/2025, art. 12, § 2º, V). Para refazer a conta com outra classificação ou com as regras de 2027, use a calculadora da reforma tributária.
Cancelada, substituída ou de teste: as marcas do documento
A nota cancelada sai com a marca d'água CANCELADA na diagonal, em cinza e com pelo menos 50 pontos; a substituída, com SUBSTITUÍDA, no mesmo formato (Nota Técnica 008, itens 2.5.1 e 2.5.2). A nota substituta traz nas informações complementares "NFS-e Subst.:" e a chave da nota que ela substituiu. A de teste, emitida em homologação, leva "NFS-e SEM VALIDADE JURÍDICA" em vermelho.
O XML da nota não muda quando ela é cancelada: o cancelamento é um evento que, "sem alterar dados da NFS-e, altera sua situação para torná-la sem efeitos" (Resolução CGNFS-e nº 3/2023, art. 8º, I). Por isso o gerador de DANFSe da Receita recebe a situação à parte do XML. Se PDF e consulta pública divergirem, vale a consulta (FAQ oficial, item 9.6).
Como gerar e conferir o documento
- No Emissor Nacional, a nota fica disponível em PDF e em XML, também para o tomador, em NFS-e Recebidas; no aplicativo, basta tocar na nota.
- Na Consulta Pública do Portal da NFS-e, qualquer pessoa com a chave de acesso vê a nota e gera o DANFSe no modelo novo, sem login.
- No sistema da empresa, o PDF é montado a partir do XML autorizado. A Receita Federal divulgou em 16 de novembro de 2026 o código-fonte aberto de um gerador de DANFSe, com licença MIT, que recebe o XML e devolve o PDF.
- Para conferir, leia o QR Code ou digite a chave na Consulta Pública e compare com o PDF.
O ValorFinal não gera DANFSe nem recebe arquivos de nota. O XML traz CPF, CNPJ e valores de clientes e deve ser aberto só nos canais oficiais ou no sistema emissor da empresa.
Leituras erradas mais comuns
- Achar que o valor líquido somado ao IBS e à CBS está errado por repetir o valor líquido. Em 2026, essa é a regra.
- Estranhar o traço em vários campos: é o que a NT 008 manda usar quando o XML não tem a informação.
- Procurar o ISS numa nota de empresa do Simples ou as retenções numa nota de MEI. Os dois casos saem sem valor por regra do sistema (FAQ oficial, itens 15.5 e 20.2).
- Procurar a linha de PIS e Cofins numa nota de 2027. Ela só existe até a competência de dezembro de 2026.
- Confiar no PDF quando ele diverge do XML. Vale o XML, e a causa mais comum da divergência é o sistema que montou o PDF (FAQ oficial, item 17.8).
Limitações
Esta guia descreve a Nota Técnica 008, versão 1.02, e as normas citadas, na situação conferida em 18/11/2026; o documento pode mudar com a nota técnica das operações novas e com a NT 009. O ValorFinal não tem vínculo com a Receita Federal nem com o Comitê Gestor da NFS-e e não valida documentos fiscais.
Fontes oficiais
- Nota Técnica SE/CGNFS-e nº 008, versão 1.02, de 14 de julho de 2026 (Portal da NFS-e): especificações do DANFSe.
- Resolução CGNFS-e nº 3, de 30 de agosto de 2023 (Portal da NFS-e): arts. 1º, 2º, 6º, 8º e 13.
- Perguntas Frequentes da NFS-e, versão 1.3, de 6 de novembro de 2026 (Portal da NFS-e): XML, chave de acesso, séries e consulta pública.
- Portal da NFS-e: Atualizações e Implantações: modelo novo e desativação da API em 3 de agosto de 2026.
- Ato Técnico Conjunto RFB/CGIBS nº 1, de 31 de julho de 2026 (Comitê Gestor do IBS): ratificação da NT 008, versão 1.02.
- Lei Complementar nº 214, de 16 de janeiro de 2025 (texto compilado): arts. 12, 343, 346 e 348.
Conclusão
O DANFSe resume em uma página uma nota que só existe como arquivo. Ele ajuda a conferir partes, códigos e a conta dos tributos novos, mas a palavra final é do XML e da consulta pública. Para emitir e corrigir notas, veja a guia do Emissor Nacional; para refazer a conta, a calculadora da reforma tributária. As outras ferramentas estão na área da reforma tributária, e o método do portal, em como validamos os cálculos.