Índice do artigofaltam 10 min de leitura
Adesão de um município ao padrão nacional é uma verificação. Parametrização é outra. Compartilhar as notas novas é uma terceira, e disponibilizar o histórico é uma quarta. Elas não se substituem.
O Sistema Nacional da NFS-e reduziu de verdade a fragmentação da nota de serviço no Brasil. Reduziu, não eliminou. Quem precisa das notas que a empresa recebe, e não das que ela emite, ainda encontra um terreno em que cada município conserva regra, calendário, obrigação acessória e pedaço de história própria.
Uma coluna chamada Brasil só quer dizer alguma coisa depois que a conversa desce ao nível de município e de competência.
Resumo do artigo
- O manual das APIs do ADN para contribuintes tem três páginas e documenta exatamente dois endpoints. Ele não traz limites, paginação, códigos de erro nem URL de produção.
- O tomador se manifesta na NFS-e nacional, com evento próprio e motivo de rejeição tipificado. A crença de que só a NF-e tem manifestação está errada.
- São Paulo tem API de notas recebidas e ela tem teto de 31 dias por consulta, o que transforma um ano de histórico em uma sequência de chamadas paginadas.
- O calendário de 2026 tem cinco datas que não se substituem, e a primeira a vencer atinge o grupo mais amplo.
O ADN é camada de compartilhamento, não é o emissor
O Ambiente de Dados Nacional, o ADN, é a camada onde o documento fica disponível para consulta pelo contribuinte. O Emissor Nacional é uma forma de produzir a nota. São peças diferentes, e sistemas municipais próprios podem coexistir com o compartilhamento nacional.
A distinção parece acadêmica e resolve um erro caro: um município chamar um web service próprio de Nacional não demonstra que aquele endereço seja a API atual do ADN.
O risco concreto está no vocabulário. Um município pode manter documentação antiga no ar muito depois de ela perder a vigência, e o nome do arquivo não diz qual das duas camadas ele descreve.
Antes de tratar um endereço como API do ADN, confira a versão e a data do documento que o descreve, e confirme no diretório oficial de ambientes.
O manual do contribuinte tem três páginas e dois endpoints
O documento oficial que descreve as APIs do ADN para contribuintes está na versão 1.0, de 12 de fevereiro de 2026, tem três páginas e documenta dois métodos: consulta de documento por número sequencial e consulta de eventos vinculados a uma chave. Não há um terceiro.
O que ele não traz é a parte que decide um orçamento: URL base de produção, esquema de autenticação além da menção ao certificado, formato de resposta, códigos de erro, tamanho de lote, paginação e limite de requisições. A única URL do documento aponta para um Swagger em produção restrita.
Um contraste dimensiona a maturidade da trilha: o manual das mesmas APIs para os municípios está na versão 1.2, de outubro de 2025, e o de contribuintes nasceu em 1.0, em fevereiro de 2026. A trilha de quem consome os próprios documentos é mais nova e mais magra que a de quem administra.
Certificado de mesma raiz: o que mudou em fevereiro de 2026
Desde esse manual, as consultas podem ser feitas com um certificado cujo CNPJ tenha a mesma raiz do contribuinte consultado, com validação explícita entre o CNPJ do parâmetro e o do certificado. O próprio texto diz que elas "agora podem ser realizadas" assim, descrevendo uma flexibilização em relação ao comportamento anterior, em que o certificado precisava ser do próprio CNPJ. Para grupo econômico com muitos estabelecimentos, é a mudança prática mais relevante do documento.
| Tema | O que o manual diz, e o que ele não diz |
|---|---|
| Atores | O contribuinte consulta documentos em que figure como emitente, tomador ou intermediário. O manual não define comportamento de lote nem faixa de números sequenciais: a consulta por documento é descrita no singular. |
| Certificado | Admite certificado de mesma raiz, com validação entre o CNPJ do parâmetro e o do certificado. Não nomeia o parâmetro de CNPJ, então quem for implementar depende da especificação do ambiente. |
| Escopo | O parâmetro foi adicionado na consulta por número sequencial. O manual não o estende à consulta de eventos por chave de acesso. |
Fonte: Manual dos Contribuintes das APIs do ADN, Sistema Nacional NFS-e, versão 1.0 de 12/02/2026, consultado em 08/09/2026.
O tomador também se manifesta na NFS-e, e quase ninguém sabe
O Sistema Nacional prevê 16 tipos de evento, em três categorias: cancelamentos, manifestações e ofícios. Entre as manifestações existem Confirmação do Tomador, Rejeição do Tomador e Confirmação Tácita, além dos equivalentes para prestador e intermediário.
Isso derruba a crença de que manifestação é coisa de NF-e. O desenho da NFS-e é até mais amplo: qualquer não emitente indicado na nota pode se manifestar, não apenas o destinatário, e a rejeição tem motivo tipificado obrigatório, o que transforma uma divergência em registro estruturado.
- Confirmação do TomadorO não emitente aceita e concorda com as informações registradas na nota.
- Rejeição do TomadorCom motivo obrigatório: duplicidade, nota já emitida pelo tomador, não ocorrência do fato gerador, erro de responsabilidade tributária, erro de valor ou de data, ou outros.
- Confirmação TácitaTem como autor o município de incidência, e não o contribuinte.
- Anulação da RejeiçãoExiste caminho de volta, também com autoria do município de incidência.
Para quem desenha contas a pagar, o efeito é direto: a divergência de valor que hoje vira corrente de e-mail tem, do lado da nota de serviço, um canal formal, com motivo classificado e trilha.
Rio: o emissor municipal acabou, as obrigações não
A prefeitura do Rio é explícita: a partir da competência de janeiro de 2026 não se emite mais a Nota Carioca, o emissor próprio foi descontinuado e a emissão passa a ser feita exclusivamente pelo Emissor Nacional. Descrever isso como coexistência de dois emissores é errado.
O que permanece é outra coisa: as notas do Emissor Nacional são integradas automaticamente à Nota Carioca e usadas para gerar as guias de ISS, e obrigações locais continuam existindo, com escopo delimitado.
Até 2025
Emissão e obrigação no mesmo sistema- Nota Carioca emitia e concentrava as obrigações
- Envio em lote por RPS
- Numeração de benefícios fiscais própria do município
A partir da competência de janeiro de 2026
Emissão nacional, obrigações locais delimitadas- Emissão exclusivamente pelo Emissor Nacional
- Quem enviava lote de RPS integra por API enviando DPS
- Tabela municipal de correlação entre os benefícios antigos e os do Ambiente Nacional
A obrigação do tomador ficou mais estreita do que se costuma dizer. A DSTOM permanece apenas em serviços tomados com obrigatoriedade de retenção, e só em três hipóteses: ausência de emissão pelo prestador ou indisponibilidade da nota no sistema da Nota Carioca, serviços vindos do exterior, e nota nacional emitida sem a indicação de retenção do ISS. Há ainda exceções nominadas à integração automática, para instituições financeiras que declaram DESIF e para consórcios de pedágio num código específico.
São Paulo: existe API de recebidas, e ela tem teto de 31 dias
O método se chama ConsultaNFeRecebidas, devolve as notas por CPF ou CNPJ do tomador, e o intervalo de datas tem teto de 31 dias: passar disso retorna o erro 1403. Consultar um ano de notas recebidas não é uma chamada com filtro amplo, é uma sequência de doze consultas, cada uma paginada até acabar.
Ele está documentado no manual do web service municipal, versão 3.3.7, de junho de 2026, aceita data de início, data de fim e número da página, e devolve até 50 notas por página.
- Assine com o certificado do tomador, não com o de quem emitiu. A mensagem também pode ser assinada por contador cadastrado ou terceiro autorizado no gerenciamento de usuários do município.
- Monte janelas de no máximo 31 dias, porque o serviço recusa intervalos maiores.
- Pagine até a página vir incompleta: com 50 notas, peça a próxima; com menos de 50, é a última; sucesso sem nota alguma significa página inexistente.
- Aponte para o endereço novo. O próprio manual avisa que o endpoint antigo não comportará o novo leiaute.
- Troque o leitor de TXT por CSV. As consultas e exportações em formato texto foram descontinuadas em 1º de agosto de 2026, e o CSV continua disponível.
O município chama a própria nota de serviço de NF-e, inclusive nos nomes dos métodos, e isso não tem relação com o modelo 55 da nota de mercadoria. A causa declarada da retirada do formato texto é o CNPJ alfanumérico, o que dá a medida de quanto essa mudança de identificador alcança leiautes que pareciam estáveis.
Do lado do tomador há uma obrigação que costuma ser descoberta tarde. Quem contrata prestador estabelecido fora do município precisa emitir a Nota Fiscal Eletrônica do Tomador/Intermediário de Serviços, a NFTS, e o decreto municipal é literal ao dizer que ela é devida "ainda que não haja obrigatoriedade de retenção na fonte do ISS". São quatro hipóteses de obrigatoriedade no decreto, e o próprio manual da NFTS lista apenas três.
Belo Horizonte: competência não é data de emissão
O FAQ municipal, na versão 7.1 de 9 de abril de 2026, responde na questão 4 que somente as notas com competências anteriores à migração continuam sendo emitidas no emissor de Belo Horizonte, e que fora disso a emissão é exclusivamente pelos emissores nacionais.
É o ponto que mais produz classificação errada num projeto de captura: uma nota emitida hoje pode se referir a competência tratada pelo sistema anterior, e escolher a fonte pela data de emissão coloca o documento no lugar errado.
A competência diz a que período o serviço pertence; a emissão diz quando o documento foi gerado. O regime aplicável segue a primeira, e a fonte do documento costuma seguir a segunda.
O modelo de dados precisa preservar as duas, mais o regime aplicável, ou a reconciliação com a contabilidade fica impossível de explicar depois.
O próprio documento é impreciso na regra que enuncia: as questões 4 e 17 usam "deverão continuar a ser emitidas" e a questão 20 usa "poderão". Dever e faculdade são regimes jurídicos distintos, e o FAQ não define qual prevalece. O cronograma de migração da capital mineira, esse sim, se encerrou: a última data era 1º de fevereiro de 2026.
O calendário de 2026 tem cinco datas que não se substituem
A primeira a vencer é 1º de outubro de 2026, e ela atinge o grupo mais amplo, os serviços gerais do ISS. Depois vêm 1º de novembro, 1º de dezembro, 31 de dezembro e 1º de janeiro de 2027. Quatro delas saem da orientação da Secretaria Executiva do Comitê Gestor da NFS-e, publicada em 7 de agosto de 2026 com base no Ato Conjunto RFB/CGIBS 4/2026; a de novembro vem da Resolução CGSN 191, de 4 de agosto de 2026.
-
Destaque de IBS e CBS nos serviços gerais do ISS
Atinge os fornecimentos de serviços sujeitos ao ISS da lista anexa à LC 116 não incluídos nos grupos anteriores. É o grupo mais amplo, e ele vence antes dos demais.
-
Microempresas e empresas de pequeno porte do Simples
A Resolução CGSN 191 revogou a Resolução 189, que previa 1º de setembro, e fixou a nova data. O MEI já usa o Emissor Nacional desde 2023 e não entra por esse dispositivo.
-
Plataformas digitais, locações, condomínios e o resto
Entram plataformas digitais e os serviços por elas intermediados, subitens específicos da lista da LC 116, bens imateriais fora dessa lista, taxas condominiais, locações de bens móveis e imóveis, e os fornecimentos não enquadrados em nenhuma hipótese anterior.
-
Até aqui, a ausência de IBS e CBS não rejeita a nota
Não rejeitar não é isentar: a orientação diz que a falta evidencia a desconformidade do documento fiscal e sujeita o emitente às sanções e prazos do Ato Conjunto.
-
Optantes do Simples que escolherem o destaque em setembro de 2026
A janela de opção corre agora, e ela define quem entra nessa data em vez das anteriores.
Fontes: orientação da SE/CGNFS-e de 07/08/2026, com base no art. 1º, III, do Ato Conjunto RFB/CGIBS 4/2026; Resolução CGSN 191, de 04/08/2026, publicada no DOU em 10/08/2026.
O escalonamento é por hipótese de fornecimento, ou seja por tipo de serviço, e não por porte de contribuinte: só a regra do Simples é definida por categoria. E a própria notícia oficial lista as datas fora de ordem cronológica, o que facilita o resumo invertido.
Como testar cobertura municipal antes de assinar
Cobertura de NFS-e recebida não é um número, é uma matriz: município, competência, modelo, papel do interessado e denominador vindo de fora do fornecedor avaliado.
- Separe adesão, parametrização, compartilhamento de notas novas, compartilhamento de eventos e histórico disponibilizado como cinco perguntas distintas
- Escolha três municípios de perfis diferentes, e não só o da sede: um com emissor municipal ativo, um recém-migrado e um com competências anteriores pendentes
- Teste três grupos de documentos por município: competência atual, competência anterior à migração e nota cancelada ou substituída
- Peça amostra do XML retornado e confira se é o documento fiscal original, o nacional compartilhado ou uma transformação do fornecedor
- Registre o comportamento quando a nota aparece em um ambiente e não no outro, inclusive nas hipóteses que a prefeitura do Rio nomeia: nota indisponível no sistema da Nota Carioca, que obriga DSTOM, e as exceções à integração automática
Guarde qual documento, em qual versão e em qual data sustentou cada decisão de implementação. Fonte oficial desatualizada é ocorrência comum aqui, e a trilha de versões é o que permite reconstruir, meses depois, por que a integração se comporta como se comporta.
Precisa provar cobertura de NFS-e recebida por município?
Solicite um orçamento e comece pela matriz de competências, antes de escolher fornecedor.
Perguntas frequentes
Retroatividade integral não foi demonstrada na documentação consultada, e a trilha do contribuinte é recente: o manual dela é de fevereiro de 2026 e não trata de histórico. Documento antigo precisa ser testado por período, e não presumido.
Pode. O Sistema Nacional prevê Confirmação do Tomador, Rejeição do Tomador e Confirmação Tácita, entre os 16 tipos de evento do anexo oficial. A rejeição tem motivo tipificado obrigatório, com opções como não ocorrência do fato gerador e erro quanto à responsabilidade tributária.
O emissor próprio da prefeitura foi descontinuado e, a partir da competência de janeiro de 2026, a emissão é feita pelo Emissor Nacional. A Nota Carioca continua recebendo automaticamente essas notas e gerando as guias de ISS, e obrigações locais específicas permanecem.
Dá. O manual do web service municipal, na versão 3.3.7, documenta o método ConsultaNFeRecebidas por CPF/CNPJ do tomador, com intervalo de datas e paginação de até 50 notas. O intervalo tem teto de 31 dias, então consultar um ano exige uma sequência de chamadas paginadas.
Não. Adesão institucional, parametrização, sistema emissor, compartilhamento de notas novas, compartilhamento de eventos e histórico disponibilizado são verificações diferentes. A cobertura precisa ser medida por município e por competência, com denominador.
Porque competência e data de emissão são coisas distintas. Uma nota emitida hoje pode se referir a uma competência anterior à migração do município, e nesses casos o sistema municipal anterior continua sendo o caminho de emissão em várias prefeituras.
Fontes e método
Este artigo é baseado em leitura direta de documentação oficial, feita em 8 de setembro de 2026. As fontes primárias são o Manual dos Contribuintes das APIs do ADN, versão 1.0 de 12 de fevereiro de 2026; o anexo oficial de tipos de evento do Sistema Nacional da NFS-e; a página de transição da prefeitura do Rio de Janeiro; o manual de utilização do web service da NFS-e do município de São Paulo, versão 3.3.7, e o comunicado municipal de 7 de abril de 2026 sobre as consultas; o FAQ da NFS-e de Belo Horizonte, versão 7.1 de 9 de abril de 2026; a orientação da SE/CGNFS-e de 7 de agosto de 2026; e a Resolução CGSN 191, de 4 de agosto de 2026.
Nenhuma chamada autenticada foi executada e nenhum produto de fornecedor foi testado. As afirmações sobre o que cada fonte documenta valem para a versão e a data citadas: várias delas mudaram nos últimos doze meses, e algumas páginas oficiais consultadas ainda publicavam regras já substituídas.
