Como consultar NFS-e recebidas pelo Ambiente de Dados Nacional (ADN)

Se a sua empresa contrata serviços — de consultoria a limpeza, de TI a transporte — ela recebe NFS-e (nota fiscal de serviço eletrônica) de prestadores espalhados por dezenas de municípios diferentes. Até pouco tempo, cada prefeitura tinha seu próprio sistema de emissão, seu próprio leiaute de XML e, na prática, nenhum jeito centralizado de consultar o que você recebeu como tomador do serviço.

O Ambiente de Dados Nacional (ADN) muda isso. Ele é o repositório único, mantido em nível nacional, pelo qual passam os documentos fiscais de serviço de todos os municípios participantes — e é dali que uma empresa tomadora pode, hoje, consultar de forma programática as notas emitidas contra o seu CNPJ, sem precisar integrar prefeitura por prefeitura.

O problema que o ADN resolve

Antes da centralização, uma empresa com fornecedores em 30 municípios diferentes enfrentava, na prática, 30 problemas diferentes: 30 leiautes de XML, 30 portais (quando existiam), 30 formatos de autenticação. Consolidar isso manualmente — pra conferência fiscal, para o financeiro validar retenções, ou só pra saber que uma nota chegou — significava um trabalho manual que crescia junto com a base de fornecedores.

Com o ADN, existe uma única fonte de consulta. O documento fiscal de serviço distribuído por qualquer município participante fica disponível ali, referenciado pelo CNPJ do tomador — de novo, independente de onde o prestador está localizado.

Como a consulta funciona na prática

O acesso ao ADN é feito via API, autenticado por certificado digital A1 do próprio CNPJ que quer consultar. A sincronização usa um número sequencial (NSU) que garante que nenhum documento seja perdido nem duplicado entre uma consulta e outra — o sistema que consulta sempre sabe exatamente de onde retomar.

• O documento fiscal (a nota em si) e os eventos relacionados a ela — cancelamento, substituição, entre outros — chegam pelo mesmo canal.
• A consulta é por CNPJ tomador: você só recebe o que foi emitido contra a sua própria empresa, nunca dados de terceiros.
• É possível reconstituir histórico — não só o que chega dali pra frente, mas o que já existia antes de você começar a monitorar.

Onde a automação entra

Consultar o ADN diretamente exige lidar com certificado digital, controle de NSU, tratamento de eventos e reprocessamento em caso de falha — trabalho de integração real, não só uma chamada de API isolada. É exatamente esse trabalho que a IntegroBR NFS-e Recebidas assume: você cadastra o CNPJ e o certificado uma vez, e as notas passam a chegar sozinhas — pelo painel, pela nossa API pública ou por webhook, em tempo real.