O Fim do Visualizador ADN: Painel de Conferência e Download de DANFSe v2.0 em Lote para Contabilidade

No fechamento fiscal de empresas prestadoras de serviço, a rotina de conferência é implacável: o escritório contábil ou o setor financeiro precisa abrir centenas de notas fiscais emitidas no mês para conferir alíquotas de ISS, retenções na fonte (PIS, COFINS, CSLL, INSS, IRRF) e cruzar os valores com os extratos bancários.

Até recentemente, essa rotina dependia de links públicos da API oficial do Visualizador ADN da Receita Federal. Com a desativação definitiva desse serviço em 2026, os links governamentais simplesmente deixaram de carregar, exibindo erros 504 Gateway Timeout ou páginas em branco.

Neste artigo, explicamos como superar esse bloqueio implementando um painel automatizado de conferência e download em lote do DANFSe v2.0, compatível com a Nota Técnica NT-008, utilizando a infraestrutura da Notaas.

💥 Por Que a Queda do Visualizador ADN Impactou os Escritórios?

O visualizador público governamental foi projetado como um facilitador provisório. Quando grandes municípios integraram seus sistemas ao Ambiente de Dados Nacional, o volume diário de emissões explodiu, tornando inviável para o poder público arcar com a computação necessária para renderizar milhões de PDFs dinamicamente.

Ao descentralizar a renderização para a iniciativa privada:

Quebra dos Portais de Clientes: Softwares que apenas apontavam um iframe para o site do governo federal pararam de funcionar.
Impossibilidade de Conciliação em Lote: O contador não consegue mais clicar em "Exportar todos os PDFs" no portal nacional em dias de pico.
Exigência da NT-008: O novo padrão do DANFSe v2.0 exige layout responsivo (layout fluido), supressão de blocos sem dados e QR Code com URL canônica de validação.

Para mais detalhes sobre o desligamento, confira nosso pilar sobre O Fim do Visualizador ADN e a Geração Local do DANFSe.

⚡ Como a Notaas Automatiza a Entrega do DANFSe v2.0

Diferente de soluções que repassam a dor da compilação visual para o seu servidor, a Notaas processa e renderiza o DANFSe v2.0 instantaneamente no momento da autorização:

📑 Fluxo de Conferência e Download em Lote do DANFSe v2.0:

1. Sistema Contábil: Solicita as notas da competência (GET /api/v1/invoices?competencia=2026-08).

2. Notaas API & CDN: Retorna a listagem de documentos com URLs diretas e assinadas dos arquivos PDF e XML.

3. Download Automatizado: Script ou painel baixa todos os DANFSe v2.0 com QR Code em lote para a pasta de fechamento fiscal.

Renderização Sub-segundo: Menos de 500ms para compilar o XML em PDF A4 de alta fidelidade.
Armazenamento em Nuvem com CDN: Os PDFs e XMLs são guardados com redundância por 5 anos (atendendo ao prazo decadencial do art. 173 do CTN).
QR Code Canônico: Todos os documentos possuem o código bidimensional oficial para leitura óptica imediata.

💻 Script em Node.js: Baixando Todos os PDFs do Mês em Lote

Veja como é simples criar um script em Node.js ou TypeScript para puxar todos os PDFs de notas de um cliente e salvar na pasta de fechamento da contabilidade:

import axios from "axios";
import * as fs from "fs";
import * as path from "path";

const NOTAAS_API_KEY = process.env.NOTAAS_API_KEY!;
const OUTPUT_DIR = "./fechamento_agosto_2026";

async function baixarDanfsesDoMes(competencia: string) {
  if (!fs.existsSync(OUTPUT_DIR)) {
    fs.mkdirSync(OUTPUT_DIR, { recursive: true });
  }

  // 1. Consultar notas autorizadas na competência
  const response = await axios.get("https://platform.notaas.com.br/api/v1/invoices", {
    params: {
      tipo: "nfse",
      status: "authorized",
      competencia: competencia, // Ex: "2026-08"
      limit: 100,
    },
    headers: { "X-API-Key": NOTAAS_API_KEY },
  });

  const invoices = response.data.items || [];
  console.log(`Encontradas ${invoices.length} notas para conferência.`);

  // 2. Fazer o download concorrente dos PDFs
  for (const inv of invoices) {
    if (!inv.pdfUrl) continue;

    const filePath = path.join(OUTPUT_DIR, `NFS-e_${inv.numero || inv.id}.pdf`);
    const fileStream = fs.createWriteStream(filePath);

    const pdfResp = await axios.get(inv.pdfUrl, { responseType: "stream" });
    pdfResp.data.pipe(fileStream);

    console.log(`✅ Salvo: ${filePath}`);
  }
}

baixarDanfsesDoMes("2026-08");

🧪 Visualizador Gratuito para Testes Imediatos

Se você ou seus clientes precisam visualizar ou imprimir uma NFS-e Nacional pontual a partir de um arquivo XML autorizado, disponibilizamos uma ferramenta gratuita online:

👉 Visualizador DANFSe Nacional Online (danfse.notaas.com.br)

O visualizador funciona 100% no navegador (client-side), sem enviar dados para servidores externos, respeitando rigorosamente a LGPD e o sigilo fiscal.

❓ Perguntas Frequentes (FAQ)

1. O DANFSe v2.0 é aceito para transporte de mercadorias?

Não. O DANFSe é o Documento Auxiliar da Nota Fiscal de Serviço Eletrônica. Para transporte e circulação de mercadorias, o documento legal obrigatório é o DANFE da NF-e modelo 55 ou DACTE do CT-e.

2. Como funciona a supressão de blocos na Nota Técnica NT-008?

Se uma prestação de serviços não envolver intermediários ou impostos federais retidos na fonte, o gerador da Notaas omite essas seções. Isso permite que descrições longas de serviços caibam inteiramente na primeira página A4, economizando papel e facilitando a leitura.

🚀 Comece a Integrar com a Notaas Hoje

Automatize a emissão de notas fiscais no seu SaaS, ERP ou plataforma com a API fiscal mais moderna e resiliente do mercado:

Plano Gratuito: 50 notas fiscais/mês em produção sem cartão de crédito
Sandbox Imediato: Ambiente de testes completo com webhooks e eventos em tempo real
Multi-cidades e SEFAZ: Suporte ao padrão NFS-e Nacional, capitais e NF-e/NFC-e de mercadorias

👉 Criar Conta Gratuita na Notaas Platform (50 Notas/Mês)
👉 Acessar a Documentação Técnica Oficial