ADN - Ambiente de Dados Nacional da NFS-e

Função do ambiente

O ADN recebe e armazena os documentos fiscais de serviços emitidos no padrão nacional, independentemente de o emissor ser o nacional ou o municipal. É o ponto único a partir do qual os dados são distribuídos aos entes autorizados.

Para o Município, a integração ao ADN é o que garante que a informação de serviços prestados no seu território esteja disponível de forma estruturada e auditável.

O que precisa estar correto

A utilidade do ADN depende da qualidade do que entra nele: inscrição do prestador, identificação do tomador, código de serviço, local da prestação, valores e eventos de cancelamento ou substituição.

Erros nesses campos não ficam contidos no sistema local; eles se propagam para a base nacional usada em conferências e distribuição.

A mensagem "oriunda do ADN" que o emissor mostra

Quando o documento é compartilhado com o ambiente nacional, a resposta dele volta para o sistema emissor, e alguns emissores municipais exibem esse retorno ao contribuinte com a indicação de que a mensagem é oriunda do ADN. Não é um erro do sistema da prefeitura nem do próprio contribuinte em si: é o ambiente nacional dizendo o que encontrou no documento, seja uma rejeição, seja um aviso que não impede a emissão.

O que conferir, na ordem: se a inscrição e a situação cadastral do prestador estão corretas no cadastro municipal e no nacional; se o código de serviço e o local da prestação preenchidos existem e são compatíveis; e se o evento (emissão, cancelamento ou substituição) faz sentido para aquele documento. O texto da mensagem descreve o campo ou a regra que falhou, e é por ele que o atendimento municipal deve começar. Quando o retorno se repete para muitos contribuintes ao mesmo tempo, o problema costuma estar na integração do emissor próprio com o ambiente nacional, não nos documentos.

A expressão "oriunda do ADN" não aparece em documento oficial: é o jeito como alguns emissores rotulam o retorno. O que existe oficialmente são os códigos de rejeição e de alerta, como o E1262 (CNPJ não autorizado a compartilhar documento), listados no Perguntas e Respostas da NFS-e (versão 1.1, de 22 de setembro de 2026) e nos anexos de leiaute e regras do ADN publicados no Portal da NFS-e. O código que vem no retorno é o ponto de partida mais seguro do atendimento.

Como saber se a integração está saudável

Três indicadores bastam para acompanhar a integração no dia a dia: o percentual de documentos emitidos no território que chegaram ao ambiente nacional, o tempo entre a emissão e a chegada, e o volume de rejeições por tipo de erro. Os três podem ser lidos sem ferramenta sofisticada, desde que alguém seja responsável por olhá-los toda semana.

Rejeição concentrada em um único código de erro quase sempre indica parametrização, não erro do contribuinte - e é corrigível em dias. Rejeição espalhada por muitos códigos indica problema de cadastro ou de versão do sistema, e exige o roteiro completo de saneamento antes de qualquer conversa sobre volume de receita.

Impacto para a administração municipal

O ADN é onde a qualidade do dado municipal se torna visível nacionalmente. Testar integração em produção restrita antes da obrigatoriedade evita disputa de receita depois.

Fontes oficiais consultadas

Confirme o texto integral na fonte oficial antes de usar em decisão administrativa.