API do ADN (NFS-e): guia oficial e endpoints

Resumo: o que é a API do ADN para contribuintes

O Manual dos Contribuintes “Guia para utilização das APIs do ADN (Ambiente de Dados Nacional)” está na página Documentação Atual do portal da NFS-e. A versão 1.0, de 12/02/2026, é a inicial e tem 3 páginas. O ADN é o repositório nacional da NFS-e, e o manual documenta a API de Distribuição dos Contribuintes, voltada a emitentes, intermediários e tomadores.

Com ela, o contribuinte consulta os documentos fiscais de serviço em que figura como emitente, tomador ou intermediário e os eventos vinculados a uma NFS-e pela chave de acesso. O manual não trata de emissão, cancelamento, consulta de DPS nem códigos de erro: a emissão fica na API da Sefin Nacional.

Endpoints da API do ADN

O manual descreve dois métodos de consulta:

Método	Entrada	Retorno
GET /DFe/{NSU}	NSU	Documento fiscal de serviço associado ao NSU informado
GET /NFSe/{ChaveAcesso}/Eventos	Chave de acesso da NFS-e	Documentos fiscais do tipo Evento vinculados à chave

GET /DFe/{NSU}: documentos por NSU

O solicitante informa um NSU e o sistema nacional devolve o documento fiscal eletrônico associado. É a consulta que alcança as notas em que o contribuinte aparece como emitente, tomador ou intermediário.

GET /NFSe/{ChaveAcesso}/Eventos: eventos de uma NFS-e

O solicitante informa a chave de acesso de uma NFS-e e a API retorna todos os eventos vinculados a ela.

Certificado e regra do CNPJ raiz

As consultas da API de Distribuição dos Contribuintes podem usar um certificado cujo CNPJ tenha o mesmo CNPJ raiz do contribuinte consultado. Na consulta por NSU, um novo parâmetro permite informar um CNPJ de consulta diferente do CNPJ do certificado usado na conexão. Nesse caso, o sistema valida o CNPJ raiz entre o parâmetro e o certificado. O manual não traz o nome do parâmetro, que deve ser conferido no Swagger.

Ambientes (Produção Restrita e Produção)

O manual indica o Swagger de Produção Restrita para testes. A página oficial “APIs - Prod. Restrita e Produção”, atualizada em 20/08/2026, lista os dois ambientes:

API	Produção Restrita	Produção
ADN Contribuintes	https://adn.producaorestrita.nfse.gov.br/contribuintes/docs/index.html	https://adn.nfse.gov.br/contribuintes/docs/index.html
ADN (geral)	https://adn.producaorestrita.nfse.gov.br/docs/index.html	https://adn.nfse.gov.br/docs/index.html
Sefin Nacional (emissão)	https://sefin.producaorestrita.nfse.gov.br/API/SefinNacional/docs/index	https://sefin.nfse.gov.br/SefinNacional/docs/index

A mesma página lista ainda os Swaggers do CNC, de Parâmetros Municipais e do DANFSe, todos nos domínios do ADN.

Emissão de NFS-e fica na Sefin Nacional, não no ADN

Quem precisa emitir usa a API da Sefin Nacional, cujo Swagger traz POST /nfse (recebe a DPS e gera a NFS-e), GET /nfse/{chaveAcesso}, POST /nfse/{chaveAcesso}/eventos, GET /nfse/{chaveAcesso}/eventos/{tipoEvento}/{numSeqEvento}, GET e HEAD /dps/{id} e POST /decisao-judicial/nfse. O último é o fluxo de emissão por decisão administrativa ou judicial.

O Swagger da Sefin Nacional exige TLS com autenticação mútua e certificado ICP-Brasil A1 ou A3, com documentos XML assinados e compactados em GZip e base64. O manual do ADN não detalha o transporte da API de Distribuição.

Os métodos de DANFSe e de parâmetros municipais saíram da Sefin Nacional e foram para o ADN (adn.nfse.gov.br/danfse e adn.nfse.gov.br/parametrizacao). A versão 1.0 da API de DANFSe do ADN foi desativada em 03/08/2026. O manual das APIs do ADN para municípios, versão 1.2 de outubro de 2025, é outro documento, voltado ao compartilhamento de notas pelos municípios.

Quem é impactado e prazos

A API de Distribuição atende emitentes, tomadores e intermediários que precisam receber no próprio sistema as notas e os eventos registrados no repositório nacional. O manual não fixa prazos de adoção.

Data	Evento
12/02/2026	Versão 1.0 do manual das APIs do ADN para contribuintes
03/08/2026	Desativação da versão 1.0 da API de DANFSe do ADN
20/08/2026	Atualização da página oficial de ambientes das APIs

Impacto para clientes Tax360

Para quem toma serviços, a consulta por NSU no ADN é um canal oficial para reunir os documentos em que o CNPJ figura como tomador ou intermediário. Os eventos de cada NFS-e vêm da consulta pela chave de acesso. O NFS-e Inbound captura as NFS-e recebidas pelo canal nacional e entrega XML e dados ao ERP por API REST. Na emissão, o NFS-e Outbound trabalha com a DPS validada na Sefin Nacional. Outras atualizações da NFS-e estão no hub de Notas Técnicas.

Documento oficial e referências

• Manual dos Contribuintes: Guia para utilização das APIs do ADN, v1.0 (12/02/2026)
• APIs - Prod. Restrita e Produção (portal da NFS-e)
• Swagger do ADN Contribuintes em Produção Restrita: https://adn.producaorestrita.nfse.gov.br/contribuintes/docs/index.html
• Artigos relacionados: Esquemas XSD NFS-e v1.01: download direto (ZIP), NFS-e por decisão judicial: fluxo bypass e API, NFS-e Nacional: 5 manuais atualizados v1.2