Padrão Nacional da NFS-e e o Ambiente de Dados Nacional: como o sistema funciona por dentro
Atualizado em · por Bruno Alexandre, contador (CRC-ES 005734/O-7)
O padrão nacional da NFS-e inverteu a lógica que você conhecia. Antes, cada prefeitura tinha um formato de nota, e o seu sistema precisava falar a língua de cada uma. Agora existe um documento único, e o que você envia não é a nota: é a DPS — Declaração de Prestação de Serviço. Quem calcula os tributos e autoriza a nota é a plataforma nacional; a DPS assinada fica encapsulada dentro da NFS-e gerada.
Do outro lado desse fluxo está o ADN — Ambiente de Dados Nacional, que é o repositório nacional dos documentos fiscais de serviço. Ele recebe, valida a consistência e armazena as NFS-e, os eventos, os créditos, os débitos e as apurações, tanto dos sistemas municipais quanto da plataforma nacional. Entender essas duas peças é o que permite você conversar com o fornecedor do seu sistema em pé de igualdade. Esta página foi escrita em 20/08/2026.
Resumo rápido
- Você preenche a DPS; a plataforma valida, calcula os tributos e autoriza a NFS-e em XML, com a DPS assinada encapsulada dentro dela.
- O ADN é o repositório nacional de documentos fiscais eletrônicos de serviço: notas, eventos, créditos, débitos e apuração.
- Sistemas autorizadores municipais e a plataforma nacional compartilham documentos com o ADN, que valida a consistência antes de armazenar.
- A adesão do município ao Sistema Nacional é feita por protocolo próprio, e cada prefeitura escolhe quais módulos vai usar.
- Para a reforma foi criado o grupo IBSCBS dentro da DPS e um grupo espelho, gerado pelo sistema, dentro da NFS-e.
O caminho que a sua nota percorre
A modelagem está descrita na documentação técnica oficial e é mais simples do que parece. O emissor, que é você ou o prestador de serviço, preenche a DPS. Ela é enviada à chamada Sefin Nacional, responsável pela validação das informações, pelo cálculo dos tributos e pela autorização da NFS-e. Se as informações atendem aos requisitos, é gerada a NFS-e em formato XML com o destaque dos tributos devidos, acessível ao emissor e aos demais envolvidos na operação.
Existe um detalhe técnico com consequência prática: a DPS é assinada e encapsulada no interior da nota gerada. Isso significa que o documento final carrega, dentro de si, a declaração original que você fez. Não há como alegar depois que o sistema preencheu algo por conta própria — o que você declarou fica lá, assinado.
É daí que vem a divisão de campos que confunde quem lê o layout pela primeira vez. Existem dois conjuntos de informação: um relativo à DPS, com campos que o contribuinte informa, e outro na NFS-e, com campos que a plataforma calcula a partir desses dados. Alíquotas parametrizadas, alíquotas efetivas e totalizadores são do segundo grupo. Você não os informa, e não adianta o seu sistema tentar mandá-los.
O que é o ADN e por que ele existe
O Ambiente de Dados Nacional é descrito oficialmente como um repositório nacional de Documentos Fiscais Eletrônicos, que guarda a NFS-e nacional, os eventos, os créditos, os débitos e a apuração. Ele não emite nada: recebe, confere e armazena.
Quem alimenta o ADN são duas fontes: os sistemas autorizadores de NFS-e dos municípios e a própria Sefin Nacional. Ambos compartilham os documentos fiscais com o ambiente, que realiza validações de consistência antes de gravá-los. Depois disso, os documentos ficam disponíveis para consulta pelas administrações tributárias e pelos contribuintes.
Essa arquitetura resolve um problema antigo, e vale você entender o alcance dele. O município que já tem sistema próprio e não quer abandoná-lo pode continuar autorizando localmente e apenas compartilhar os documentos com o ambiente nacional. O resultado é que a base passa a ser única mesmo com autorizadores diferentes — e é isso que permite a consulta nacional de uma nota de serviço, coisa que nunca existiu no ISS.
Para você, o efeito imediato é de rastreabilidade. A nota que você emite deixa de viver só no portal da prefeitura. Ela passa a existir em um repositório nacional, consultável, com eventos associados. Quem tratava nota de serviço como documento local precisa rever esse pressuposto.
Os módulos que o município pode escolher
O Sistema Nacional não é um bloco único: é um conjunto de módulos, e cada prefeitura monta a combinação que cabe na infraestrutura que ela já tem. Conhecer essa lista ajuda você a entender por que a experiência muda tanto de cidade para cidade:
A adesão do município ao Sistema Nacional é formalizada por protocolo de adesão próprio, publicado no portal oficial. Não é automática, e não decorre da reforma tributária: é decisão administrativa de cada prefeitura, anterior e independente da entrada do IBS e da CBS.
Por isso, se a sua empresa fatura em vários municípios, é bem provável que você conviva com mais de um cenário ao mesmo tempo: cidades que autorizam pelo ambiente nacional, cidades que autorizam localmente e compartilham com o ADN, e cidades que ainda estão fora.
- Ambiente de Dados Nacional (ADN) — o repositório, com integração por webservices para municípios que têm infraestrutura própria.
- Sefin Nacional — o autorizador nacional, que valida, calcula e autoriza a nota.
- Emissor público web e aplicativo emissor — as ferramentas gratuitas de emissão para prestadores e para servidores municipais.
- Módulo de Apuração Nacional (MAN) — apuração do ISSQN e emissão de guia unificada, de uso opcional pelo município.
- Portal da NFS-e — a interface pública de consulta das notas emitidas.
- Painel Administrativo Municipal — onde a prefeitura configura e parametriza a sua participação.
- EFD ISS e APIs — escrituração e integração entre o ambiente local e o nacional.
O que a reforma acrescentou ao padrão
As adequações ao IBS e à CBS foram publicadas em notas técnicas da Secretaria-Executiva do Comitê Gestor da NFS-e — documentos diferentes da nota técnica da NF-e, que muita gente cita por engano quando fala de serviço.
Do lado da DPS, foi criado o grupo IBSCBS, no caminho NFSe/infNFSe/DPS/infDPS/, com os campos que você informa. Do lado da NFS-e, foi criado um grupo IBSCBS espelho, no caminho NFSe/infNFSe/, com os campos parametrizados pelos entes ou calculados pela plataforma. É nesse segundo grupo que ficam o código IBGE da localidade de incidência, o nome dessa localidade e o percentual de redução em compra governamental.
Os totalizadores também vivem do lado da NFS-e, no grupo totCIBS, e trazem a definição mais importante para o seu negócio. O campo vTotNF é descrito como o valor total da nota considerando os impostos por fora: IBS e CBS, com a observação de que, por serem por fora, seus valores devem ser adicionados ao total. A fórmula publicada é explícita: vTotNF = vLiq em 2026 e vTotNF = vLiq + vCBS + vIBSTot a partir de 2027.
Guarde essa data. Em 2026 o total da sua nota de serviço não muda. Em 2027, muda — e é essa a conversa que você precisa ter com os seus clientes antes de janeiro, não depois.
A armadilha das versões de layout
Aqui vai um alerta que vale mais do que qualquer resumo de campo. A documentação técnica da NFS-e vem sendo publicada em versões sucessivas, e uma delas registra, com todas as letras, que os campos e grupos que estariam presentes nos ambientes de Produção e Produção Restrita em janeiro de 2026 seriam os da nota técnica anterior, e que as evoluções descritas naquele documento seriam disponibilizadas em data futura, a ser divulgada no Portal da NFS-e.
Isso significa que existiu, e pode voltar a existir, um descompasso entre o layout publicado e o layout em produção. Se o seu fornecedor de sistema disser que implementou o layout da NFS-e, a pergunta certa não é “implementou?”. É: “qual nota técnica, qual versão e qual data?”.
O mesmo documento também aponta os anexos onde estão as regras de negócio e a tabela de códigos indicadores de operação referenciados no campo cIndOp da DPS, baseada no art. 11 da LC 214/2025. Tudo isso fica na seção de documentação técnica do Portal da NFS-e, e é material aberto — você pode conferir sem intermediário.
O que ainda não está definido
Em 20/08/2026, estes pontos continuam em aberto no padrão nacional:
A base legal de toda essa padronização é o art. 62 da LC 214/2025, que obrigou União, estados, Distrito Federal e municípios a adaptarem os autorizadores de documentos fiscais eletrônicos para um leiaute padronizado. É uma obrigação dos entes, não sua — mas é você quem sente o efeito na ponta.
- A versão definitiva do layout com IBS e CBS. As notas técnicas se substituem em sequência e a própria documentação avisa que novas versões seriam publicadas.
- A data de disponibilização das evoluções nos ambientes de produção e produção restrita, que ficou remetida a divulgação futura no portal.
- As alíquotas de referência. Os campos existem e são parametrizados pelo sistema, mas os percentuais dependem de Resolução do Senado ainda não editada.
- A cobertura municipal. Nem todo município é conveniado, e a adesão a cada módulo é decisão individual de cada prefeitura.
Erros comuns relacionados ao tema
- Chamar a DPS de nota: A DPS é a declaração que você envia. A NFS-e é o documento que a plataforma gera, com a DPS assinada encapsulada dentro.
- Tentar informar campo calculado: Alíquotas efetivas e totalizadores são gerados pela plataforma. Enviar esses campos não adianta e pode gerar erro.
- Citar a nota técnica da NF-e para falar de serviço: A NFS-e tem documentação própria, da Secretaria-Executiva do Comitê Gestor da NFS-e. São documentos distintos.
- Achar que o ADN emite nota: O ADN é repositório: recebe dos autorizadores, valida consistência e armazena. Quem autoriza é o sistema municipal ou a Sefin Nacional.
- Supor que todo município já está no padrão nacional: A adesão é por protocolo e é decisão de cada prefeitura, com escolha de quais módulos usar.
Veja também
Perguntas frequentes
O que é a DPS?
É a Declaração de Prestação de Serviço, o documento que o prestador preenche e envia. A partir dela, a plataforma valida as informações, calcula os tributos e autoriza a NFS-e em XML. A DPS fica assinada e encapsulada dentro da nota gerada.
O que é o Ambiente de Dados Nacional?
É o repositório nacional dos documentos fiscais eletrônicos de serviço: NFS-e, eventos, créditos, débitos e apuração. Os sistemas autorizadores municipais e a Sefin Nacional compartilham documentos com ele, que faz validações de consistência antes de armazenar.
Meu município tem sistema próprio. Ele fica fora do padrão nacional?
Não necessariamente. O município pode manter o autorizador local e integrar-se ao Ambiente de Dados Nacional por webservices, compartilhando os documentos. A adesão ao Sistema Nacional é formalizada por protocolo próprio e cada prefeitura escolhe os módulos que vai usar.
O valor total da minha NFS-e vai mudar?
Em 2026 não: a fórmula publicada é vTotNF = vLiq. A partir de 2027 passa a ser vTotNF = vLiq + vCBS + vIBSTot, porque IBS e CBS são tributos por fora e somam ao total da nota.
Como sei qual versão de layout meu sistema usa?
Pergunte ao fornecedor o número da nota técnica, a versão e a data em que ele se baseou. A documentação registra que houve descompasso entre o layout publicado e o disponibilizado em produção, então a resposta genérica de que “está implementado” não é suficiente.
Preciso trocar de sistema para emitir no padrão nacional?
Nem sempre. Existe emissor público web e aplicativo gratuitos, integração por API e por webservice, e sistemas de mercado já adaptados. A escolha depende do volume, da integração com o seu faturamento e dos municípios onde você atua.
Quer transformar essa dúvida em decisão?
A Conexes analisa o cenário da sua empresa, aponta o caminho contábil mais seguro e orienta o próximo passo para orçamento ou implantação.
Falar com um analista no WhatsAppFale com um contador da Conexes agora, direto no WhatsApp.
Tirar dúvida no WhatsAppBruno Alexandre, contador com mais de 13 anos de experiência. MBA em Controladoria e Finanças pela Fucape e diversos cursos de extensão na área contábil desde 2012.
Assinado por: Bruno Alexandre — Especialista em abertura de empresas e rotinas contábeis.
Conexes Contabilidade — mais de 13 anos atendendo empresas no Espírito Santo.