DANFSe: o que é e como conferir uma NFS-e pela chave de acesso
Atualizado em 15 de novembro de 2026
Em resumo
- O DANFSe é o Documento Auxiliar da NFS-e: uma representação gráfica, com os dados resumidos da nota (NT 008, item 2; Guia do Emissor Nacional Web).
- A nota é o arquivo XML. Pelas Perguntas Frequentes do Portal da NFS-e (v1.3, item 17.8), só ele vale para fiscalização, escrituração e validade jurídica, e o DANFSe não pode trazer informação que não esteja no XML (NT 008, item 2.1).
- A NT 008 (v1.02, de 14/07/2026) traz o modelo do DANFSe para os sistemas emissores e fixou em 03/08/2026 a suspensão da API de geração do DANFSe do ambiente nacional.
- O DANFSe traz a chave de acesso, de 50 dígitos, e um QR Code que leva à consulta da nota no portal nacional.
- Qualquer pessoa confere a nota na Consulta Pública da NFS-e, sem login, pela chave de acesso ou pelos dados da DPS.
O que é o DANFSe
DANFSe quer dizer Documento Auxiliar da Nota Fiscal de Serviço Eletrônica. Pela NT 008 (item 2), é o documento auxiliar da NFS-e, impresso em papel, para facilitar a consulta resumida dos dados da nota e ajudar nos processos administrativos e financeiros de quem recebe o serviço e não é emissor de NFS-e.
O Guia do Emissor Nacional Web o descreve como a representação gráfica da NFS-e, com informações resumidas da nota, baixada em PDF.
É impresso em uma única página, em modo retrato, em papel de tamanho mínimo A4 de qualquer tipo, menos o de jornal, e em uma única via, salvo disposição expressa em contrário (NT 008, itens 2, 2.2 e 2.2.1).
O DANFSe de nota de teste, gerada no ambiente de produção restrita (homologação), traz no cabeçalho a expressão "NFS-e SEM VALIDADE JURÍDICA".
Qual documento vale: o XML ou o PDF?
O Portal da NFS-e define a NFS-e como um documento de existência digital, gerado e armazenado eletronicamente. Quando aceita a DPS, a Sefin Nacional devolve o XML da NFS-e gerada (Guia do Emissor Nacional Web, item 4.1.4).
As Perguntas Frequentes do portal (v1.3, de 06/11/2026, item 17.8) são diretas: o documento fiscal oficial, para fiscalização, escrituração e validade jurídica, é só o XML da NFS-e autorizada e armazenada no Ambiente de Dados Nacional (ADN). O DANFSe é uma representação gráfica auxiliar, e uma diferença visual nele não muda os dados da nota.
Por isso, os campos do DANFSe têm de reproduzir as tags do XML, e ele não pode trazer informação que não esteja no arquivo da NFS-e (NT 008, item 2.1). Se o PDF e o XML divergirem, valem as informações do XML (item 17.8).
O que mudou com a NT 008
- A NT 008, "Especificações Técnicas do DANFSe", é a base para a geração do DANFSe pelos softwares de emissão de NFS-e, ERPs e sistemas fiscais (item 1).
- Por isso, a NT fixou o sobrestamento (suspensão) da API de geração do DANFSe do ambiente nacional em 03/08/2026; as versões 1.01 (30/06/2026) e 1.02 (14/07/2026) mudaram essa data. As Perguntas Frequentes do portal (item 17.8) registram a suspensão em 03/08/2026: desde então, cada sistema emissor gera o PDF a partir do XML devolvido pela Sefin Nacional.
- O modelo é um só (Anexo I da NT 008, Modelo de DANFSe): no cabeçalho, a logomarca da NFS-e, "DANFSe v2.0 – Documento Auxiliar da NFS-e", o município do emitente, o ambiente gerador e o tipo de ambiente (itens 2.2.4 e 2.4.3).
- Há um bloco próprio do IBS e da CBS, com CST, cClassTrib, indicador da operação, alíquotas e valores apurados, e o valor total traz o total do IBS/CBS e o "Valor Líquido da NFS-e + IBS/CBS" (itens 2.1.10 e 2.1.11).
- Nota cancelada ou substituída leva a marca d'água "CANCELADA" ou "SUBSTITUÍDA", na diagonal (itens 2.5.1 e 2.5.2), e a nota substituta traz a chave da substituída nas informações complementares. Veja o guia de cancelamento e substituição.
- Para as operações que passam a ser formalizadas por NFS-e por serem novos fatos geradores do IBS e da CBS, será publicada uma nota técnica específica do DANFSe (item 1).
O que aparece no DANFSe
Pela NT 008 (item 2.1), o DANFSe traz, no mínimo:
- Identificação da nota: a chave de acesso, em um bloco de 50 dígitos; o número e a competência da NFS-e; a data e a hora da emissão; o número, a série, a data e a hora da DPS; o emitente; a situação e a finalidade. Ao lado, o QR Code.
- Prestador e tomador: CNPJ, CPF ou NIF, inscrição municipal, telefone, nome, município e CEP, além do endereço e do e-mail (linhas que a NT permite suprimir); do prestador, também a situação no Simples Nacional na competência e o regime de apuração. Sem tomador, o bloco pode trazer só o aviso de que ele não foi identificado na NFS-e.
- Destinatário e intermediário da operação, quando houver.
- Serviço: os códigos de tributação nacional e municipal, a NBS, o local da prestação e a descrição.
- Tributação municipal (ISSQN), federal e do IBS/CBS, e o valor total: valor do serviço, descontos, retenções e valor líquido.
- Informações complementares, com os totais aproximados dos tributos da Lei nº 12.741/2012 e, quando houver, os dados de obra, evento e imóvel.
- Canhoto, que é opcional.
A chave de acesso
A chave de acesso tem 50 dígitos e identifica a nota. No XML, ela fica no identificador da NFS-e, precedida de "NFS" (Perguntas Frequentes, item 18.4). Os dígitos são, em ordem (Guia do Emissor Nacional Web, item 9.1):
- Código IBGE do município do emitente (7 dígitos).
- Ambiente gerador (1 dígito): 1 – sistema próprio do município; 2 – Sefin Nacional.
- Tipo de inscrição federal (1 dígito): 1 – CPF; 2 – CNPJ.
- CPF ou CNPJ do emitente (14 dígitos; o CPF é completado com zeros à esquerda).
- Número da NFS-e (13 dígitos).
- Ano e mês da emissão (4 dígitos).
- Código numérico aleatório (9 dígitos) e dígito verificador (1 dígito).
Como conferir uma NFS-e pela chave de acesso
A consulta pública é aberta a prestadores, tomadores e fiscalização, sem login (Guia do Emissor Nacional Web, item 9; Perguntas Frequentes, item 26.3). Ela fica no portal nacional, em nfse.gov.br/ConsultaPublica, e no link "Consultar Nota Fiscal" do Portal da NFS-e no gov.br.
Sem a chave, dá para consultar "Por Dados da DPS": CPF ou CNPJ do emitente, série e número da DPS e município de emissão (Guia, item 9.2).
- Abra a Consulta Pública da NFS-e.
- Em "Como deseja consultar?", escolha "Por Chave de Acesso".
- Digite os 50 dígitos da chave de acesso, que estão no DANFSe e no XML da nota.
- Marque o hCaptcha e consulte.
- Pelo celular, leia o QR Code do DANFSe: ele leva à consulta pública com a chave da nota (NT 008, item 2.4.3).
Como o NotaGoiana faz
- O PDF que vai ao cliente, por e-mail ou pelo link, é o DANFSe no leiaute nacional, feito a partir do XML oficial da nota, ou, na nota que a Prefeitura de Goiânia publica no ISSNet, a página da nota na prefeitura.
- O DANFSe do NotaGoiana traz o cabeçalho "DANFSe v2.0", a chave de acesso, o QR Code da consulta pública e a marca "CANCELADA" ou "SUBSTITUÍDA" quando for o caso.
- A nota vai ao cliente por e-mail, com o PDF e o XML. Com o envio automático ligado, cada nota autorizada vai sozinha ao e-mail do tomador.
- Na lista de notas, "Copiar link para o tomador" e "Enviar pelo WhatsApp" mandam ao cliente um link que abre sem login, com os dados da nota, a chave de acesso e os botões para baixar o PDF oficial e o XML. Se a nota foi cancelada ou substituída, a página avisa.
No NotaGoiana, a nota vai ao cliente por e-mail ou WhatsApp, com o PDF oficial e o XML, e o DANFSe sai do XML oficial, com a chave de acesso e o QR Code da consulta pública. O suporte atende 24 horas pelo WhatsApp.
Perguntas frequentes
O DANFSe tem validade jurídica?
O DANFSe é um documento auxiliar. Pelas Perguntas Frequentes do Portal da NFS-e (v1.3, item 17.8), o documento fiscal oficial, para fiscalização, escrituração e validade jurídica, é só o XML da NFS-e autorizada e armazenada no Ambiente de Dados Nacional.
Como consultar uma NFS-e pela chave de acesso?
Na Consulta Pública da NFS-e: escolha "Por Chave de Acesso", digite os 50 dígitos, marque o hCaptcha e consulte. O QR Code do DANFSe leva à mesma consulta.
Onde fica a chave de acesso da NFS-e?
No DANFSe, no bloco de identificação, em 50 dígitos. No XML, no identificador da nota, precedida de "NFS" (53 caracteres no total).
A API de DANFSe do governo foi desativada?
A NT 008 (v1.02) fixou o sobrestamento (suspensão) da API de geração do DANFSe do ambiente nacional em 03/08/2026, e as Perguntas Frequentes do portal (item 17.8) registram a suspensão nessa data. Desde então, cada sistema emissor gera o DANFSe a partir do XML, seguindo a NT 008.
O DANFSe mostra uma situação e a consulta, outra. Qual vale?
A consulta. As Perguntas Frequentes do portal (item 9.6) explicam que o DANFSe é gerado a partir do XML e dos eventos da nota e pode demorar a refletir, por exemplo, um cancelamento; a situação mostrada na consulta é o dado oficial do Ambiente de Dados Nacional.
Legislação e fontes oficiais
- Nota Técnica SE/CGNFS-e nº 008, v1.02 (14/07/2026): Especificações Técnicas do DANFSe
- Portal da NFS-e: Perguntas Frequentes, v1.3 (06/11/2026), itens 9.6, 17.8 (DANFSe e XML), 18.4 (chave de acesso) e 26.3 (consulta pública)
- Guia do Emissor Público Nacional Web da NFS-e, v1.3, itens 4.1.4, 4.1.5, 9.1 e 9.2 (DANFSe e consulta pública)
- Portal da NFS-e: O que é a NFS-e
- Portal Nacional da NFS-e: Consulta Pública de NFS-e
Este guia resume a regra e não substitui a orientação do seu contador. Fontes conferidas em 15 de novembro de 2026.
Outros guias
- Simples Nacional: NFS-e pelo Emissor Nacional a partir de 1º de novembro de 2026
- NFS-e do MEI: como emitir a nota de serviço pelo Emissor Nacional
- Retenção do ISS na NFS-e: quando o tomador retém e como fica a nota
- Como cancelar ou substituir a NFS-e de padrão nacional
- Código de tributação nacional e NBS na NFS-e: como escolher o código do serviço
- NFS-e de exportação de serviços: como emitir a nota para cliente no exterior
- NFS-e para escritórios de contabilidade: a carteira de clientes em um só lugar
- NFS-e em Goiânia: como emitir a nota fiscal pelo ISSNet ou pelo Emissor Nacional
- NFS-e de padrão nacional: o que é e o que muda em 2026
- IBS e CBS na NFS-e: o que muda na nota com a Reforma Tributária
- Rejeições da NFS-e nacional: o que significam os erros E0xxx e como resolver
- NFS-e recebidas (tomadas): como a empresa e o contador consultam as notas no ambiente nacional
- NFS-e para pessoa física: nota com CPF ou sem tomador identificado
- Retenção de PIS, Cofins, CSLL, IR e INSS na NFS-e: quando o tomador retém
- NFS-e de construção civil: dados da obra, local do ISS e dedução de materiais
NFS-e nas capitais
Aracaju (SE) · Belém (PA) · Belo Horizonte (MG) · Boa Vista (RR) · Brasília (DF) · Campo Grande (MS) · Cuiabá (MT) · Curitiba (PR) · Florianópolis (SC) · Fortaleza (CE) · Goiânia (GO) · João Pessoa (PB) · Macapá (AP) · Maceió (AL) · Manaus (AM) · Natal (RN) · Palmas (TO) · Porto Alegre (RS) · Porto Velho (RO) · Recife (PE) · Rio Branco (AC) · Rio de Janeiro (RJ) · Salvador (BA) · São Luís (MA) · São Paulo (SP) · Teresina (PI) · Vitória (ES)