NFS-e de padrão nacional: o que muda em 2026 e como integrar o sistema

O Sistema Nacional NFS-e tem dois componentes que aparecem o tempo todo na documentação. A Sefin Nacional recebe a declaração do contribuinte, valida as regras de negócio e gera a nota para os municípios conveniados que usam o emissor público. O Ambiente de Dados Nacional (ADN) funciona como repositório nacional dos documentos fiscais e distribui as notas e os eventos aos interessados, inclusive as notas geradas por emissores municipais.

Para o contribuinte, há três portas de entrada: o emissor web (nfse.gov.br/EmissorNacional), útil para quem emite poucas notas; a API, para quem tem sistema próprio de faturamento ou ERP; e, quando a prefeitura mantém sistema próprio, o emissor municipal, que passa a repassar as notas ao ADN. O portal gov.br/nfse informa que os municípios conveniados escolhem quais produtos do sistema nacional oferecem aos seus contribuintes, e esse ponto define qual caminho a empresa vai usar em cada cidade.

Na prática, isso significa que a integração deixou de depender apenas do leiaute. Antes de programar, é preciso saber, para cada município onde a empresa emite, se ele usa o emissor nacional ou o próprio.

A emissão pela API parte da DPS, a Declaração de Prestação de Serviço. O sistema da empresa monta a DPS em XML, assina e envia para a Sefin Nacional com POST /nfse. O processamento é síncrono: a resposta traz o XML da NFS-e gerada ou a mensagem de erro com o motivo da rejeição. A consulta de uma nota emitida é feita pela chave de acesso, com GET /nfse/{chaveAcesso}.

Cada DPS tem um identificador formado pelo código IBGE do município emissor, tipo e número de inscrição do emitente, série e número da DPS. Com GET /dps/{id}, o sistema recupera a chave de acesso da nota gerada a partir de uma DPS. Esse recurso resolve um problema real: se a conexão cair depois do envio, o sistema consulta pela DPS antes de reenviar e evita emitir duas notas para o mesmo serviço.

A API também expõe os parâmetros de cada município: alíquotas por item da lista de serviço, regimes especiais, deduções, retenções e benefícios concedidos a um contribuinte. Consultar esses parâmetros antes de montar a DPS reduz rejeições por alíquota ou regime incompatível.

Os endereços são separados por ambiente. A produção restrita, usada para homologação e testes, fica em sefin.producaorestrita.nfse.gov.br e adn.producaorestrita.nfse.gov.br; a produção, em sefin.nfse.gov.br e adn.nfse.gov.br. A documentação Swagger de cada API está publicada no portal da NFS-e.

O manual do Sistema Nacional NFS-e exige certificado emitido por autoridade certificadora credenciada na ICP-Brasil, tipo A1 ou A3, com o CNPJ ou o CPF do titular. O certificado tem dois usos. Na transmissão, ele autentica o sistema da empresa na conexão com TLS mútuo e precisa ter a permissão de autenticação de cliente. Na assinatura, ele assina a DPS e os pedidos de registro de evento no padrão XMLDSIG.

Os documentos XML trafegam compactados em GZip, com representação em base64, dentro de mensagens JSON. Para municípios conveniados que usam a Sefin Nacional, as notas geradas são assinadas com o certificado do Serpro.

O certificado A1 é um arquivo e pode ser instalado no servidor de emissão; o A3 fica em token ou cartão, o que dificulta a emissão automática em servidor. Para integração por API, confira com a contabilidade e com a equipe de TI qual tipo a empresa já tem e onde ele vai ficar guardado. Vencimento de certificado derruba a emissão inteira, então a data de renovação deve estar monitorada.

Depois de emitida, a NFS-e não é alterada. Tudo que acontece com ela é registrado como evento, enviado com POST /nfse/{chaveAcesso}/eventos. O evento de cancelamento muda a situação da nota sem mexer no XML, e encerra o ciclo de vida dela: nenhum outro evento pode ser registrado depois.

Para corrigir uma nota, existe a substituição. O sistema envia uma nova DPS informando a chave de acesso da nota a ser substituída; a Sefin Nacional valida a nova DPS, cancela a nota anterior com um evento de cancelamento por substituição e gera a nota substituta, com as duas vinculadas.

Quando o cancelamento direto não é permitido pelas regras do município, o emitente pode pedir análise fiscal. É um procedimento manual, em que a administração tributária municipal defere ou indefere o pedido, e cada decisão também gera um evento. O sistema da empresa precisa exibir essas situações para o usuário, porque, enquanto o pedido está em análise, a nota ainda não está cancelada.

Prazos para cancelamento e substituição fazem parte da parametrização de cada município. Não existe um prazo único nacional que o sistema possa assumir.

A Lei Complementar 214/2025 fixou, para fatos geradores ocorridos em 2026, alíquota de 0,1% para o IBS e de 0,9% para a CBS. O art. 348 dispensa o recolhimento desses valores para quem cumprir as obrigações acessórias previstas na legislação, e essas alíquotas não se aplicam às operações de optantes pelo Simples Nacional. Em 2026, portanto, o ponto central para quem emite nota é informar os dados corretamente.

Na NFS-e, isso aparece nos grupos IBSCBS do leiaute. Segundo a página de documentação da reforma tributária no portal da NFS-e, a Nota Técnica SE/CGNFS-e nº 004 ficou disponível na produção restrita em 10 de dezembro de 2025 e em produção a partir de 5 de janeiro de 2026. O mesmo portal informou previsão de obrigatoriedade dos grupos IBS/CBS, com suas regras de validação, a partir de 3 de agosto de 2026, com base no leiaute da NT 004 acrescido do campo tpRetPisCofins da NT 007.

Há notas técnicas mais recentes, como a NT 009, que o portal indica como ainda sem data de implantação. Como o leiaute segue mudando, a integração precisa ser feita de forma que uma nova versão dos esquemas XSD possa ser adotada sem reescrever o módulo fiscal.

Antes de integrar, levante para cada município onde a empresa presta serviço se ele é conveniado ao sistema nacional, se usa o emissor nacional ou emissor próprio e quais parâmetros publicou. O portal da NFS-e mantém uma página de monitoramento das adesões, e a API de parâmetros municipais permite consultar os parâmetros do convênio de cada cidade.

Alguns erros aparecem com frequência nas primeiras semanas de uma integração:

• Reenviar a DPS depois de um timeout sem consultar antes se a nota foi gerada, o que resulta em nota duplicada.
• Usar alíquota fixa no código em vez de consultar os parâmetros do município e do item de serviço.
• Tratar cancelamento como exclusão e apagar a nota do sistema, quando ela continua existindo com um evento vinculado.
• Emitir nota nova para corrigir erro em vez de usar a substituição, deixando duas notas válidas para o mesmo serviço.
• Testar apenas no emissor web e descobrir as regras de validação da API só em produção.
• Deixar os grupos IBS/CBS vazios ou preenchidos com valores padrão sem validação da contabilidade.

Um roteiro mínimo para tirar a emissão de NFS-e do trabalho manual:

• Lista dos municípios de emissão, com a informação de convênio e de emissor (nacional ou próprio) de cada um.
• Certificado ICP-Brasil do tipo A1 com CNPJ, instalado com segurança no servidor e com renovação monitorada.
• Cadastro dos serviços da empresa com item da lista nacional, código NBS e tratamento tributário revisado pela contabilidade.
• Testes completos na produção restrita: emissão, consulta, cancelamento, substituição e rejeições.
• Rotina de consulta por DPS antes de qualquer reenvio.
• Armazenamento do XML de cada nota e de cada evento, além do PDF para o cliente.
• Responsável definido para acompanhar as notas técnicas publicadas no portal gov.br/nfse.

A Tox já integrou sistemas à emissão de NFS-e. Se a sua empresa precisa conectar o faturamento ao ambiente nacional ou revisar uma integração que vem gerando rejeições, podemos analisar o fluxo atual e os municípios envolvidos antes de propor o caminho técnico.