A NFS-e Nacional já tem API oficial para emissão de nota de serviço por sistema próprio, e desde 1º de novembro de 2026 ela faz parte da rotina de quem é ME ou EPP do Simples Nacional. Segundo a documentação técnica publicada no portal gov.br/nfse, o software envia uma declaração de prestação de serviços (DPS) à SEFIN Nacional, que valida os dados e devolve a nota com chave de acesso.

Neste artigo
  1. Os três ambientes da documentação técnica da NFS-e Nacional
  2. Como funciona a emissão pela API: DPS, chave de acesso e eventos
  3. Prazo do Simples Nacional: o que a Resolução CGSN 191 fixa
  4. O que ainda não está claro sobre agentes de IA e certificado
  5. Antes de ligar um agente à API, o que checar

A documentação não menciona inteligência artificial nem prevê canal específico para agentes. Na prática, um agente de IA que emita nota é só mais um cliente da API: precisa das mesmas credenciais, do mesmo layout e passa pelas mesmas regras de validação de qualquer programa. Quem responde pela nota continua sendo o emitente.

Antes da mudança, cada prefeitura tinha o seu sistema de emissão. A Resolução CGSN nº 191, de 4 de agosto de 2026, alterou a Resolução CGSN nº 140/2018 e passou a exigir que ME e EPP optantes do Simples usem a NFS-e de padrão nacional, emitida pelo Emissor Nacional da NFS-e. A emissão pode ser feita pela aplicação web ou por integração via API.

Os três ambientes da documentação técnica da NFS-e Nacional

A página de documentação técnica do gov.br separa o material em três blocos: "Documentação Atual (Produção)", "Documentação Técnica (Homologação/testes)" e "APIs - Prod. Restrita e Produção". A página da documentação atual foi publicada em 10/12/2025 e atualizada em 04/11/2026.

A lista de APIs traz os portais Swagger, tanto de produção restrita (o ambiente de testes) quanto de produção, de quatro componentes: o CNC (cadastro nacional de contribuintes), o ADN (Ambiente de Dados Nacional, com subáreas de contribuintes, municípios, parametrização e DANFSe), a SEFIN Nacional e o Painel Administrativo Municipal.

ComponenteEndereço de teste (produção restrita)Endereço de produção
ADN – contribuintesadn.producaorestrita.nfse.gov.br/contribuintes/docs/index.htmladn.nfse.gov.br/contribuintes/docs/index.html
SEFIN Nacionalsefin.producaorestrita.nfse.gov.br/API/SefinNacional/docs/indexsefin.nfse.gov.br/SefinNacional/docs/index

A página "API de integração" resume o papel delas: "As APIs fazem a comunicação entre o ambiente de dados dos municípios, das empresas e dos entes conveniados com o Ambiente de Dados Nacional (ADN)." O texto acrescenta que o município pode enviar notas emitidas localmente e que empresas com software próprio podem se conectar para emitir notas e baixar parâmetros municipais.

Como funciona a emissão pela API: DPS, chave de acesso e eventos

O Manual do Emissor Público (API), versão 1.2 de outubro de 2025, descreve o fluxo. O método POST /nfse faz a geração síncrona da NFS-e: a API recebe a DPS enviada pelo contribuinte, aplica validações de negócio e rejeita a declaração se alguma falhar. Se a DPS trouxer a chave de uma nota já gerada, indicada para substituição, a API cria um evento vinculado à nota anterior.

Os demais métodos listados no manual cobrem o resto do ciclo:

  • GET /nfse/{chaveAcesso} consulta a nota;

  • GET /dps/{id} recupera a chave de acesso a partir do identificador da DPS, e só vale para DPS emitida pelo Sistema Nacional;

  • HEAD /dps/{id} informa se já existe nota gerada para aquela DPS;

  • POST /nfse/{chaveAcesso}/eventos registra um evento vinculado à nota;

  • GET de eventos por chave, por tipo e por sequencial.

Segundo o manual, a consulta HEAD "atende a qualquer usuário desde que realize a consulta com um certificado digital válido". Para quem automatiza, o HEAD tem uso evidente: antes de reenviar uma DPS que deu erro de rede, o sistema pergunta se a nota já foi gerada e evita duplicidade.

O Guia para utilização das APIs do ADN, versão 1.0 de 12/02/2026, trata da consulta. Ele descreve a busca de documentos fiscais de serviço em que o contribuinte aparece como emitente, tomador ou intermediário, com os métodos GET /DFe/{NSU} e GET /NFSe/{ChaveAcesso}/Eventos. Nas consultas de distribuição, o certificado pode ser de um CNPJ com a mesma raiz do contribuinte consultado, o que interessa a grupos com matriz e filiais.

A lista de documentos de produção inclui ainda os esquemas XSD v1.01 (09/02/2026), o anexo de layout da DPS e da NFS-e do SNNFSe v1.01 (09/02/2026) e a Lista de Serviço Nacional NBS 2 v1.01 (22/01/2026). São esses arquivos que definem como o XML precisa ser montado, e um agente que gere o documento sem seguir o layout terá a DPS rejeitada.

Prazo do Simples Nacional: o que a Resolução CGSN 191 fixa

A Resolução 191 revogou a Resolução CGSN nº 189, de 23/04/2026, e fixou no art. 2º, I, a vigência de 1º/11/2026 para a obrigatoriedade. Segundo resumos da imprensa contábil, a data anterior era 1º de setembro. A mesma resolução diz que o acesso dos entes da federação aos arquivos de dados da NFS-e de padrão nacional segue requisitos mínimos de segurança do ambiente de dados (§ 1º-D e § 1º-E).

Há ainda informações que vêm só de resumos da imprensa contábil e que o tekimobile não conseguiu conferir no texto oficial: que as regras de CBS e IBS para optantes do Simples começam em 1º de janeiro de 2027, e que a prefeitura que não bloquear a emissão pelo sistema antigo terá a nota rejeitada automaticamente pelo ADN. Vale checar com a contabilidade e com a prefeitura antes de depender delas.

O que ainda não está claro sobre agentes de IA e certificado

O tekimobile não encontrou, nas páginas lidas, regra específica para uso de IA ou automação, nem cadastro próprio para isso. Não dá para dizer que o governo aceita ou deixa de aceitar agentes: a documentação trata de "software", e o agente cairia nessa categoria.

O tipo de certificado exigido para emitir pelo POST /nfse também não ficou confirmado. O manual só fala em "certificado digital válido" na consulta HEAD, e a página Swagger do ADN não pôde ser lida na apuração. Outro ponto: o aviso da página de documentação técnica diz que as "Minutas de documentação técnica" são minutas e que "a documentação técnica definitiva será homologada e publicada pelo CGNFS, quando instalado". O texto não deixa claro quais artefatos são minutas, então não se deve tratar tudo como definitivo. Também não há dado público de adoção, volume de emissões ou problemas relatados na API.

Antes de ligar um agente à API, o que checar

Para quem quer testar, o caminho que a documentação sugere começa pelo ambiente de produção restrita. É ali que se descobre se a DPS passa nas validações.

  • Teste primeiro na produção restrita, com os endereços da tabela acima.

  • Tenha o certificado digital válido; confirme com o suporte qual tipo vale para emissão, já que isso não está claro nas fontes.

  • Siga os XSD e o layout v1.01 e use a Lista de Serviço Nacional NBS 2 para classificar o serviço.

  • Guarde o identificador da DPS e use o HEAD /dps/{id} antes de reenviar.

  • Mantenha uma pessoa conferindo as notas: a responsabilidade é do emitente, não do agente.

O próximo marco que pode mexer com o tema é 1º de janeiro de 2027, data que a imprensa contábil aponta para as regras de CBS e IBS no Simples. Ainda sem confirmação no texto da Resolução 191.