No ecossistema de nota fiscal eletrônica de serviços no Brasil, a Receita Federal e a Secretaria Executiva do Comitê Gestor da NFS-e Nacional confirmaram o desligamento definitivo da API oficial do Visualizador ADN (Ambiente de Dados Nacional).
Para empresas de software, ERPs, fintechs e desenvolvedores de soluções fiscais, essa mudança exige ação imediata. Até então, muitos sistemas simplesmente redirecionavam o tomador de serviços para a URL pública do governo federal ou faziam requisições pontuais para obter o PDF formatado do DANFSe (Documento Auxiliar da Nota Fiscal de Serviço Eletrônica). Com o fim do visualizador público, qualquer sistema que dependa da infraestrutura pública para renderizar ou visualizar notas fiscais de serviço nacionais retornará erro ou tela em branco.
Neste guia técnico, analisaremos os impactos do desligamento da API ADN, as especificações do DANFSe v2.0 na Nota Técnica NT-008, como gerar o DANFSe 100% offline via biblioteca open-source, e como a Notaas entrega o DANFSe v2.0 e XML oficial já autorizados e com link de CDN seguro em menos de 500ms.
🛑 O que é a API ADN e Por Que Ela Será Desativada?
O Sistema Nacional da NFS-e (SNNFSE) foi projetado para unificar a emissão de notas fiscais de serviço em todo o território nacional. No início da implantação, o governo federal disponibilizou a API do visualizador ADN como um facilitador transitório para acelerar a adesão de prefeituras e emissores privados.
Sempre que uma nota fiscal era emitida com sucesso, o sistema gerava uma chave de acesso de 50 dígitos. O emissor enviava essa chave para o endpoint da API ADN e recebia o PDF pronto renderizado pelos servidores federais.
Contudo, essa centralização gerou três gargalos intransponíveis para a infraestrutura do governo:
- Consumo Extremo de Recursos de Servidor: Renderizar milhões de PDFs por dia dinamicamente sobrecarregou os clusters do SERPRO/Receita Federal.
- Quedas Recorrentes em Dias de Pico: No fechamento de mês e dias úteis de faturamento em lote, a API ADN apresentava lentidão severa e timeouts de conexão HTTP 504.
- Descentralização Responsável: O papel do Estado é validar e assinar a validade jurídica do XML da NFS-e. A renderização visual e entrega da representação gráfica (DANFSe) pertence à iniciativa privada e aos ERPs emissores.
A especificação oficial de diagramação visual foi padronizada na Nota Técnica NT-008. O governo continuará fornecendo e assinando o arquivo XML autorizado da nota fiscal, mas a transformação desse XML em uma folha A4 organizada e legível deve ser resolvida localmente ou por APIs especializadas.
⚡ O Impacto nos ERPs e SaaS de Faturamento
Se a sua aplicação ainda aponta para o link governamental da API ADN:
- Quebra de Links de Impressão: Os botões de "Visualizar DANFSe" ou "Download do PDF" nos painéis de clientes deixarão de funcionar.
- Envios Automáticos Interrompidos: Rotinas de faturamento que anexam o PDF da nota fiscal em disparos de e-mail ou WhatsApp vão quebrar.
- Explosão de Chamados no Suporte: Usuários finais não conseguirão conferir as retenções de impostos nem ler o QR Code para verificação municipal.
Para aprofundar na arquitetura de mensageria da NFS-e Nacional, confira nosso Guia Definitivo da API NFS-e Nacional.
📐 Especificações do DANFSe v2.0 (Nota Técnica NT-008)
O layout do DANFSe v2.0 introduz o conceito de layout fluido (flow-based) para otimizar o espaço físico na folha A4:
- Supressão Automática de Blocos Vazios: Se uma NFS-e não contiver tributos federais retidos (PIS, COFINS, CSLL, INSS), intermediários ou deduções de base de cálculo, esses blocos inteiros são omitidos do layout. Isso impede que a nota quebre desnecessariamente em uma segunda página.
- Mapeamento Rigoroso de Enums: O XML do SNNFSE armazena regimes tributários e naturezas de operação em códigos numéricos. O motor de renderização visual precisa decodificar esses códigos para as descrições textuais exatas exigidas pela norma (ex: Simples Nacional, Regime Especial de Tributação, ISS Fixo).
- QR Code e Chave de Acesso de 50 Dígitos: O QR Code deve codificar a URL de consulta pública do Comitê Gestor com a chave de 50 dígitos para conferência instantânea via smartphone.
🛠️ Opção 1: Geração Local Open-Source com @notaas/danfse-viewer
Para desenvolvedores que desejam manter o renderizador rodando localmente no Node.js ou Edge Runtime, a Notaas disponibiliza a biblioteca open-source @notaas/danfse-viewer (licença MIT).
Características da biblioteca:
- Zero Dependências Nativas de SO: Funciona no Node.js, Cloudflare Workers, AWS Lambda e navegadores modernos.
- Logos e Ativos Gráficos em Base64: Não necessita de acesso ao sistema de arquivos para carregar fontes ou brasões da República.
- Total Conformidade com a NT-008: Suporta todos os enums do schema
tiposSimples_v1.01.xsd.
Passo 1: Instalação do Pacote
npm install @notaas/danfse-viewer puppeteer
Passo 2: Conversão de XML para HTML
import { DanfseXmlParser, DanfseHtmlBuilder } from "@notaas/danfse-viewer";
import * as fs from "fs";
export async function converterXmlParaHtml(caminhoXml: string): Promise<string> {
const xmlContent = fs.readFileSync(caminhoXml, "utf-8");
// 1. Fazer o parse do XML padronizado da NFS-e Nacional
const parser = new DanfseXmlParser();
const dadosNfse = await parser.parse(xmlContent);
// 2. Construir o HTML compatível com a NT-008
const builder = new DanfseHtmlBuilder();
return builder.build(dadosNfse);
}
Passo 3: Renderizar em PDF via Puppeteer
import puppeteer from "puppeteer";
import * as fs from "fs";
import { converterXmlParaHtml } from "./gerador";
async function gerarDanfsePdf(caminhoXml: string, caminhoDestinoPdf: string) {
const html = await converterXmlParaHtml(caminhoXml);
const browser = await puppeteer.launch({
headless: true,
args: ["--no-sandbox", "--disable-setuid-sandbox"],
});
const page = await browser.newPage();
await page.setContent(html, { waitUntil: "domcontentloaded" });
const pdfBuffer = await page.pdf({
format: "A4",
printBackground: true,
margin: { top: "0mm", right: "0mm", bottom: "0mm", left: "0mm" },
});
await browser.close();
fs.writeFileSync(caminhoDestinoPdf, pdfBuffer);
console.log(`✅ DANFSe PDF gerado com sucesso em: ${caminhoDestinoPdf}`);
}
gerarDanfsePdf("./exemplo-nfse-autorizada.xml", "./danfse-resultado.pdf");
📚 Referências Oficiais & Guias Técnicos:
- 🌐 API de Nota Fiscal: Motor unificado para emissão e gestão de NFS-e, NF-e e NFC-e via REST API.
- ⚡ API NFS-e Nacional: Guia prático de integração técnica com o padrão nacional da Receita Federal.
- 📦 API NF-e (Modelo 55): Emissão simplificada de nota fiscal de produto com DANFE em PDF.
- 🛒 API NFC-e (Modelo 65): Automação de cupom fiscal para varejo e PDV com QR Code v2.
- 📄 DANFSe v2.0 em PDF: Geração local de DANFSe e conformidade com a NT-008 sem o visualizador do ADN.
- ⚖️ Comparativo de APIs Fiscais: Análise comparativa entre Notaas, Nuvem Fiscal, Focus NFe e TecnoSpeed.
🚀 Opção 2: Emissão e DANFSe Automático via API da Notaas
Se a sua equipe não quer arcar com os custos de CPU e memória para rodar instâncias de Chromium/Puppeteer no servidor para cada nota emitida, a forma mais eficiente é utilizar a Notaas Platform.
Ao emitir via Notaas, você envia apenas o JSON e recebe automaticamente:
- Validação tributária e assinatura digital XMLDSig.
- Transmissão e autorização junto ao SNNFSE ou prefeitura conveniada.
- DANFSe v2.0 gerado em milissegundos e armazenado em CDN de alta disponibilidade com URL segura.
- Notificação via webhook assinado com os links de PDF e XML prontos.
Chamada cURL com Retorno de DANFSe v2.0:
curl -X POST https://platform.notaas.com.br/api/v1/emitir -H "Content-Type: application/json" -H "X-API-Key: sk_live_sua_chave" -d '{
"tipo": "nfse",
"ambiente": "producao",
"referencia": "fat_98124",
"prestador": { "cnpj": "12345678000195" },
"tomador": {
"cpfCnpj": "98765432000109",
"razaoSocial": "Empresa Tomadora Ltda",
"email": "contato@tomador.com.br"
},
"servico": {
"codigoTributacaoNacional": "010701",
"discriminacao": "Desenvolvimento de software e suporte técnico",
"valorServicos": 2500.00,
"aliquota": 2.0
}
}'
Payload do Webhook Notificando a Disponibilidade do DANFSe:
{
"event": "nfse.issued",
"data": {
"id": "nfse_7a8b9c0d1e2f",
"numero": "202600000001234",
"chaveAcesso": "35260912345678000195560000000000000123456789",
"status": "authorized",
"pdfUrl": "https://cdn.notaas.com.br/danfse/35260912345678000195560000000000000123456789.pdf",
"xmlUrl": "https://cdn.notaas.com.br/xml/35260912345678000195560000000000000123456789.xml",
"issuedAt": "2026-09-04T21:45:00.000Z"
}
}
🧪 Playground Online Gratuito: Teste seu XML Agora
Quer testar a renderização do seu XML de NFS-e Nacional sem instalar nada no terminal?
Acesse nosso visualizador interativo client-side:
👉 Visualizador DANFSe Online Gratuito (danfse.notaas.com.br)
Arraste o arquivo XML da sua nota e visualize a renderização visual do DANFSe v2.0 com botão de impressão e download em PDF imediato. Seus dados não saem do navegador, garantindo conformidade com a LGPD.
❓ Perguntas Frequentes (FAQ)
1. Quando o visualizador ADN do governo federal deixa de funcionar?
A desativação do visualizador público faz parte do cronograma de descentralização da Receita Federal em 2026. Todos os emissores e ERPs devem adotar geradores locais ou serviços de API especializados em DANFSe v2.0.
2. O DANFSe gerado localmente tem validade jurídica?
O documento fiscal com validade jurídica perante a legislação tributária brasileira é exclusivamente o arquivo XML assinado digitalmente. O DANFSe é uma representação gráfica simplificada destinada a facilitar a leitura humana e transporte. Desde que obedeça aos padrões da NT-008 e contenha o QR Code e chave de acesso corretos, possui plena aceitação comercial e fiscal.
3. A Notaas cobra adicional pela geração e armazenamento do DANFSe?
Não. Todos os planos da Notaas, inclusive o plano gratuito de 50 notas/mês, incluem a geração automática do DANFSe v2.0 em PDF e o armazenamento dos arquivos em CDN de alta velocidade sem taxas ocultas.
🚀 Modernize a Emissão e Renderização Fiscal do seu Software
Elimine falhas de impressão e garanta conformidade imediata com a NT-008 do SNNFSE:
👉 Criar Conta Gratuita na Notaas (50 Notas/Mês Sem Cartão)
👉 Ler a Documentação de Webhooks e DANFSe
👉 Ver o Comparativo Completo de APIs Fiscais para 2026