DANFSe: o que é, o que mudou em 2026 e como baixar o PDF da NFS-e

O DANFSe (Documento Auxiliar da Nota Fiscal de Serviço Eletrônica) é a representação em PDF ou papel da NFS-e do padrão nacional. Ele não é a nota: a nota é o arquivo eletrônico, e o DANFSe é um resumo para leitura, com a chave de acesso de 50 dígitos e um QR Code para conferir a autenticidade da nota. Em 2026, a Nota Técnica nº 008 padronizou o modelo em todo o país. A API oficial de geração do DANFSe foi suspensa em 3 de agosto de 2026, mas o Emissor Nacional continua gerando e baixando o DANFSe. Para baixar, use o Emissor Nacional (se você emitiu ou recebeu a nota) ou a FiscalAPI, que devolve o PDF só com a chave, pela API ou no painel.

Atualizado em 8 de novembro de 2026.

DANFSe x NFS-e#

Se o seu fornecedor mandou só o PDF, você tem o DANFSe. Os dados oficiais estão na nota, que você confere pela chave.

O que mudou com a NT 008/2026#

A Nota Técnica nº 008, da Secretaria-Executiva do Comitê Gestor da NFS-e, saiu em 5 de maio de 2026. Os pontos que mais afetam quem emite e quem recebe:

• Modelo único nacional. O DANFSe segue um modelo permitido, com tamanho mínimo de fonte e blocos definidos.
• Fim da API oficial de geração. A NT serve de base para softwares emissores, ERPs e sistemas fiscais gerarem o DANFSe. Por isso, a API oficial de geração do DANFSe foi suspensa. A versão 1.0 marcava 1º de julho de 2026. A versão 1.02, de 14 de julho de 2026, fixou a suspensão em 3 de agosto de 2026. O Emissor Nacional continua gerando e baixando o DANFSe.
• IBS e CBS no documento. O modelo tem um bloco de tributação do IBS e da CBS, ao lado do ISSQN e dos tributos federais.
• QR Code obrigatório. Fica à direita da identificação da nota, com no mínimo 1,52 cm x 1,52 cm, para conferir a autenticidade da nota.
• Chave em bloco único. Os 50 dígitos da chave de acesso aparecem juntos.
• Marca d'água de situação. Nota cancelada traz "CANCELADA" na diagonal. Nota substituída traz "SUBSTITUÍDA".
• Nota de teste. DANFSe de nota emitida em homologação traz "NFS-e SEM VALIDADE JURÍDICA".

O que o DANFSe mostra#

A NT 008 lista os blocos do documento. No mínimo:

Para conferir as retenções linha a linha, veja como conferir as retenções de uma NFS-e recebida.

Como baixar o DANFSe#

Se você emitiu a nota no Emissor Nacional: entre no Emissor Nacional, abra "NFS-e Emitidas", escolha a nota e use "Download DANFSe".

Se você é o tomador: entre no Emissor Nacional com o acesso da sua empresa e abra "NFS-e recebidas". Ali aparecem as notas em que a empresa é tomadora ou intermediária, com opção de baixar o XML e o DANFSe.

Se você só tem a chave: peça o PDF ao prestador ou consulte a nota pela chave na FiscalAPI, no painel ou pela API, e baixe o DANFSe.

Se o emitente usa o sistema da prefeitura: o DANFSe sai pelo sistema do município ou pelo software do prestador. Se a nota não for do padrão nacional, ela pode não aparecer na consulta pela chave de 50 dígitos.

Um PDF antigo não mostra o cancelamento#

O DANFSe é uma foto da nota no momento em que foi gerado. Se a nota for cancelada depois, o PDF que você já tem continua sem a marca "CANCELADA". Antes de pagar ou lançar, peça um DANFSe atualizado ao prestador ou confira no Emissor Nacional, em "NFS-e recebidas". Veja como saber se uma NFS-e foi cancelada ou substituída.

Baixar o DANFSe na FiscalAPI#

No painel da FiscalAPI, você cola a chave e baixa o PDF do DANFSe, sem programar. Quando o DANFSe precisa ir para o seu sistema, use a API: com danfse=true, ela devolve o PDF em base64 junto com os dados da nota em JSON. Não precisa de certificado, e você não precisa ser o tomador.

import base64
import requests

resp = requests.get(
    "https://api.fiscalapi.com.br/api/consultar-nfse",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={
        "chave": "35503082211222333000181000000000012326100000045676",  # fictícia
        "danfse": "true",
    },
    timeout=100,
)
resp.raise_for_status()
nota = resp.json()
if nota.get("danfse_pdf_base64"):
    with open(f"{nota['chave']}.pdf", "wb") as f:
        f.write(base64.b64decode(nota["danfse_pdf_base64"]))
else:
    print(nota.get("aviso"))  # dados vieram, o PDF não: tente de novo em instantes

• Preço: o mesmo da consulta sem PDF. De R$ 0,05 (Enterprise) a R$ 2,01 (Lite) por nota entregue. Nota não encontrada e chave inválida não são cobradas.
• Tempo: em geral, de 30 a 60 segundos numa nota nova; com nova tentativa, até cerca de 90 segundos. Se você já consultou a chave sem o PDF, pedir o PDF depois é rápido.
• Sem XML: a FiscalAPI devolve os dados em JSON e o PDF do DANFSe. O XML da nota não faz parte da resposta.

Campos e exemplos em cURL, Node.js e PHP na documentação da consulta de NFS-e.

Perguntas frequentes#

DANFSe tem validade jurídica? Ele é um documento auxiliar. A validade está na NFS-e. Por isso o DANFSe traz a chave e o QR Code, para conferir a autenticidade da nota.

Qual a diferença entre DANFSe e DANFE? O DANFE é o documento auxiliar da NF-e (nota de produto), com chave de 44 dígitos. O DANFSe é o da NFS-e (nota de serviço), com chave de 50 dígitos. Para o DANFE, veja DANFE ou XML: qual a diferença.

O DANFSe pode ser impresso em qualquer papel? Pela NT 008, sim, exceto papel jornal, em uma única via.

Recebi só o PDF. Preciso do XML? Para conferir a nota, a chave basta. Para escriturar, siga o que o seu contador e o seu sistema exigem. O tomador baixa o XML no Emissor Nacional, em "NFS-e recebidas".

Por que o DANFSe do meu fornecedor mudou de cara? Por causa da NT 008/2026, que trocou os modelos municipais por um modelo nacional e incluiu o bloco de IBS e CBS.

Fontes#

• Nota Técnica nº 008/2026, versão 1.0, especificações do DANFSe, SE/CGNFS-e, 05/05/2026
• Nota Técnica nº 008/2026, versão 1.02, 14/07/2026 (cópia publicada pela Fenacon), data de suspensão da API de geração e item 2.4.3 (QR Code e autenticidade)
• DANFSe tem novos ajustes e prazo para adequação é prorrogado, Fenacon, 15/07/2026
• Guia do Emissor Público Nacional Web, v1.2.1, seções 5.5 e 6.3 (download do DANFSe), gov.br/nfse
• Consulta de NFS-e pela chave, documentação da FiscalAPI

Artigos relacionados#

• Como consultar uma NFS-e pela chave de acesso
• Chave de acesso da NFS-e: os 50 dígitos, campo a campo
• Como saber se uma NFS-e foi cancelada ou substituída

Precisa do DANFSe e dos dados da nota no seu sistema? Veja a consulta de NFS-e pela chave ou crie sua conta e consulte no painel ou pela API.