NFS-e padrão nacional: o que a empresa que presta serviço precisa ter pronto no ERP

Por onde ler, conforme a sua pergunta

Comece pelo bloco do seu papel ou siga os cinco blocos por intenção. O tempo de cada seção é uma estimativa de leitura.

Comece por aqui

Cinco blocos por intenção

Datas-chave, cada uma com fonte

1. 01/01/2026Os municípios passam a ter de autorizar a emissão no ambiente nacional ou compartilhar as notas.Fonte: Lei Complementar 214/2025
2. 01/10/2026Começa o destaque obrigatório dos tributos da reforma nos serviços sujeitos ao imposto municipal em geral.Fonte: Perguntas e Respostas da NFS-e
3. 19/10/2026A Nota Técnica 010 (NFS-e Via e manifestação do adquirente) entra em produção.Fonte: Ato Técnico Conjunto 7
4. 01/11/2026Optantes do Simples Nacional passam a emitir só pelo Emissor Nacional.Fonte: Portal da NFS-e: Simples Nacional
5. 01/01/2027Os tributos da reforma passam a compor o total da nota.Fonte: Perguntas e Respostas da NFS-e
6. 31/12/2032Fim do prazo da obrigação dos municípios no art. 62, § 1º.Fonte: Lei Complementar 214/2025

Linha do tempo do padrão nacional: só datas com fonte

Cada linha tem o documento de origem. Onde o portal chama a data de previsão, a tabela diz que é previsão.

Duas ressalvas sobre leitura de datas. A primeira: o plano de implantação de 2022 usa o verbo prever, e o próprio portal o marca como previsão, de modo que ele descreve a intenção da época, não a data de entrada em produção de cada módulo. A segunda: o cronograma do destaque de IBS e CBS é escalonado por categoria de serviço e por regime. A Prefeitura de Belo Horizonte registra a existência de um Ato Conjunto RFB/CGIBS nº 4/2026 e de uma versão 4,A, de 30/07/2026, e as Perguntas e Respostas citam o Ato nº 4/2026 como base do cronograma. Antes de fixar uma data no projeto, confira o ato vigente da sua categoria de serviço.

Base legal com número de artigo

Quem decide o quê: lei, convênio, nota técnica e parâmetro municipal.

A hierarquia prática é esta: a lei complementar dá a obrigação e o limite, o convênio e o CGNFS-e dão o leiaute, as notas técnicas dão o campo, e a prefeitura dá o parâmetro local (alíquota, dedução, retenção, prazo). Quando um erro aparece na emissão, vale perguntar em qual dessas camadas ele nasceu antes de mexer no ERP. É a mesma lógica que a página de parametrização fiscal no SAP aplica ao cálculo de imposto: o defeito costuma estar na camada que decide, não na que executa.

Como funciona por dentro, com os termos oficiais

Seis conceitos explicam quase tudo: DPS, Sefin Nacional, ADN, Painel Municipal, CNC (Cadastro Nacional de Contribuintes) e evento.

A validação é síncrona. Isso muda a forma de testar: a rejeição aparece no momento do envio, com código, e o erro de parâmetro (alíquota, dedução, local) é tão comum quanto o erro de leiaute.

Termos oficiais, um a um

As APIs que o ERP encontra

Duas características decidem o desenho da integração. Primeiro, a assinatura da DPS e a autenticação mTLS (autenticação mútua por certificado) exigem o certificado digital ICP-Brasil do próprio prestador, e não existe hoje mecanismo de procuração eletrônica para terceiros ou integradores. Para emitir em nome de vários CNPJs, o sistema precisa assinar e transmitir cada lote com o certificado de cada contribuinte. O regulamento já prevê a figura do Provedor de Assinatura e Autorização de Documentos Fiscais Eletrônicos, mas a funcionalidade aparece como em desenvolvimento (Fonte: Perguntas e Respostas da NFS-e, tema 17.7). Segundo, só pessoa física e MEI emitem sem certificado, e apenas de forma manual por tela ou aplicativo. Emissão automatizada em lote por API sempre exige o certificado.

Existe ambiente de testes. O manual dos contribuintes indica a documentação interativa em Produção Restrita no endereço adn.producaorestrita.nfse.gov.br, e as Perguntas e Respostas recomendam validar a integração ali antes de apontar para produção (Fonte: Manual das APIs do Emissor Nacional, Perguntas e Respostas da NFS-e, tema 19.5). Notas geradas em Produção Restrita não têm efeito jurídico.

Quem emite e quem recebe

Quatro papéis aparecem na nota. O que cada um pode e não pode fazer define onde o ERP precisa de regra.

Retenção e tomador merecem atenção do ERP de quem compra serviço. A nota recebida carrega o campo tpRetISSQN, e a regra do padrão é restritiva: não é permitido marcar retenção pelo tomador quando o município de incidência é outro que não o do próprio tomador. Quando o imposto é devido ao município do prestador, o prestador recolhe, e a nota sai como não retida (Fonte: Perguntas e Respostas da NFS-e, temas 7.1 e 7.9).

Município aderente e não aderente

O padrão nacional convive com sistemas municipais até 2032. O que decide o canal é a configuração do município e o regime da empresa.

Três parâmetros da API de parâmetros municipais resumem essa convivência para uma software house, e valem também para uma equipe de ERP que integra diretamente. O primeiro é aderenteEmissorNacional: valor 1 significa que o município usa os emissores nacionais e a integração vai direto à Sefin Nacional, valor 0 significa que a emissão ocorre no sistema da prefeitura, com exceção do MEI e do item 99. O segundo é situacaoEmissaoPadraoContribuintesRFB: valor 1 habilita por padrão qualquer empresa do município na base de CNPJ da Receita, valor 0 exige que a prefeitura cadastre cada contribuinte no CNC, com inscrição municipal e data de autorização, o que é típico de migração faseada. O terceiro é permiteAproveitamentoDeCreditos, que só atua na apuração, no MAN, e não afeta o preenchimento do XML (Fonte: Perguntas e Respostas da NFS-e, tema 19.6).

Há uma regra de exclusividade que evita o erro mais caro dessa fase: um mesmo contribuinte não pode emitir ao mesmo tempo pelo sistema próprio e pelo Emissor Nacional na mesma competência. A autorização de uso do emissor define, contribuinte a contribuinte, por onde ele deve faturar em cada período. A emissão só é permitida a partir da maior entre a data de autorização individual e a data de vigência do convênio (Fonte: Perguntas e Respostas da NFS-e, temas 5.2 e 5.3). Para o ERP, isso significa guardar, por CNPJ emissor, de que data em diante o canal é o nacional.

ISS, IBS e CBS na mesma nota

A nota de serviço é o primeiro documento em que o imposto antigo e os novos aparecem juntos. Por isso, cada campo tem duas leituras.

O que a lei já diz e o que ela não diz sobre ISS e IBS na nota

A Lei Complementar 214 diz que as notas de serviço passam a poder informar IBS e CBS (art. 62, I) e que o ambiente nacional recebe o documento compartilhado (art. 62, II). O leiaute reflete isso com o grupo IBSCBS dentro da DPS. As regras de local de operação do IBS e da CBS têm base no art. 11 da lei e critério próprio, que nem sempre coincide com a lista de exceções do ISS. Por isso, a nota de 2026 em diante exige dois olhares separados sobre o mesmo fato: onde o ISS é devido, e onde a operação é considerada para IBS e CBS (Fonte: Perguntas e Respostas da NFS-e, tema 7.5; Nota Técnica 009, item 2.10).

O que a lei e os atos lidos não resolvem sozinhos, e que a empresa precisa decidir com a ajuda do Fiscal e dos assessores, é o efeito prático de cada período de transição na apuração. A página sobre a reforma com CBS e IBS trata da cobrança e dos regimes. Aqui interessa a nota: em 2026, a base do IBS e da CBS é apurada descontando o ISS, o PIS, a COFINS e os descontos incondicionados, tenha o ISS sido retido ou não (Fonte: Perguntas e Respostas da NFS-e, tema 32.6), e o total da nota continua igual ao valor líquido, porque IBS e CBS só passam a compor o total em 1º/01/2027 (Fonte: Perguntas e Respostas da NFS-e, tema 15.5). A Prefeitura de São Paulo lembra ainda que 2026 é ano de teste, em que quem cumpre as obrigações acessórias fica dispensado do recolhimento de IBS e CBS, e que a lei continua válida sem prorrogação de prazo nem exclusão de penalidades (Fonte: Prefeitura de São Paulo).

Calendário do destaque de IBS e CBS na NFS-e

Dois pontos evitam confusão. A suspensão da regra que exige o grupo IBSCBS na nota não suspende a obrigação do município de se integrar ao ambiente nacional, que segue com a sanção do art. 62, § 7º. E se a empresa decide informar o grupo antes da data, todas as validações de conteúdo do grupo passam a ser aplicadas normalmente, o que torna o preenchimento voluntário um teste real, não um ensaio (Fonte: Perguntas e Respostas da NFS-e, tema 15.2).

Campos e dados que o ERP precisa ter

Dezessete requisitos do padrão, cada um com a fonte e o ponto em que costuma pesar no cadastro ou no documento.

A última coluna descreve onde o dado costuma morar em um ambiente SAP de faturamento de serviço, e não uma função de produto que a SAP tenha anunciado. O ponto é o mesmo em qualquer ERP: cada campo do padrão tem um dono no cadastro ou no documento, e quando o dono não existe a nota sai de um preenchimento manual. A página de dados mestres fiscais no SAP descreve a conferência desses cadastros, e a de parametrização fiscal trata das regras de determinação que alimentam o valor.

O SAP e a NFS-e: o que a fonte confirma

Duas colunas honestas: o que a SAP publicou sobre o Brasil e o que o padrão exige, independentemente do produto.

Na prática de projeto, existem três arquiteturas possíveis para a NFS-e, e todas dependem do mesmo conjunto de dados. Na primeira, o ERP monta a DPS e a envia à Sefin Nacional por uma camada de integração própria ou de terceiro, com certificado do emitente. Na segunda, o ERP segue integrado ao WebService do município, que compartilha com o ADN, caminho que a lei admite até 2032 para quem está em município com emissor próprio e não é optante do Simples. Na terceira, parte das notas sai pelo emissor público (portal ou aplicativo) e o ERP importa o XML. A escolha entre elas é do projeto. O que não é opcional é que o faturamento de serviço entregue o dado completo, e que o retorno da nota volte ao ERP com número, chave e XML.

O que isso exige da camada fiscal fica concreto em cinco perguntas que a equipe consegue responder sem esperar nenhum anúncio de produto. Qual tabela traduz o serviço faturado no SAP para o código de tributação nacional e para a NBS? Onde está o endereço da unidade que usa o serviço, e não o da sede do cliente? Como o ERP distingue débito próprio de PIS e COFINS de retenção desses tributos? Quem mantém, por município de cada estabelecimento emissor, os parâmetros de alíquota, dedução, retenção e prazo de cancelamento? E, quando a nota é cancelada ou substituída, qual documento do SAP reverte o lançamento? Se uma dessas respostas é um nome de pessoa e não uma tabela, o risco é de processo, e não de ferramenta.

Eventos, cancelamento e substituição

A nota emitida não é o fim do ciclo. Eventos mudam o que a nota vale, e o ERP precisa acompanhar cada um.

Regras da substituição, que evitam retrabalho

Local de incidência errado é o erro que exige mais cuidado, porque substituir muitas vezes não resolve: o sistema tende a bloquear a mudança do local fora dos prazos padrão. As Perguntas e Respostas descrevem três riscos de uma nota emitida com o local errado: autuação por falta de nota correta no município real, dívida ativa no município indicado por engano e impedimento de certidão negativa ali. O caminho de correção é a Solicitação de Análise Fiscal para Cancelamento no município errado, com prova de que o serviço foi prestado em outro lugar (Fonte: Perguntas e Respostas da NFS-e, tema 29.3). Vale tratar o local de incidência como validação de teste e de revisão amostral, não como detalhe de preenchimento.

Município por município: o que as prefeituras publicam

Quatro prefeituras, lidas nos portais oficiais, com a data de cada publicação.

A leitura cruzada desses quatro casos mostra por que um calendário nacional único não existe na prática. Rio e Porto Alegre chegaram à exclusividade do emissor nacional em momentos diferentes, São Paulo mantém dois layouts em convivência, e Belo Horizonte acrescenta exigências próprias de código, benefício e dedução dentro do padrão. O ERP de uma empresa com estabelecimentos em várias capitais precisa de uma tabela de parâmetros por município, não de uma regra global. Outras capitais, como Curitiba, Salvador, Recife e Fortaleza, publicam o próprio cronograma, e o endereço oficial delas deve ser consultado antes de fechar o escopo.

O portal nacional disponibiliza, ainda, um arquivo com as alíquotas do ISS por município na biblioteca técnica, atualizado periodicamente, e um painel de monitoramento das adesões (Fonte: Documentação técnica, Monitoramento das adesões). Em município de alto volume de serviço, vale usar essas fontes para validar o parâmetro que o ERP carrega antes de testar.

Como se preparar: roteiro em quatro passos

Um roteiro de readiness para empresas com SAP e obrigação de serviço, sem depender de um produto específico.

O passo mais subestimado é o terceiro. Rejeição de leiaute aparece cedo e é fácil de corrigir. Rejeição de parâmetro, como dedução não admitida, retenção incompatível ou benefício não informado, só aparece com a operação real, município por município.

O primeiro passo tem ferramenta própria: a avaliação de prontidão ajuda a montar o inventário de emissão antes de qualquer teste.

Se o inventário mostrar estabelecimentos em municípios com regra própria, leve essa lista a uma conversa com a DFSpro antes do primeiro teste de integração.

Quatro perfis de empresa com SAP

Indústria, distribuição, locação, transporte e grupos econômicos aparecem na NFS-e por caminhos diferentes.

Os quatro perfis têm em comum o fato de que o risco não está na emissão em si, mas no dado que chega nela. A rotina de conferência por amostra que a DFSpro descreve na página de comércio exterior no SAP para a importação tem equivalente aqui: amostrar notas por município, por código de serviço e por regime, e comparar com o parâmetro oficial.

Erros comuns e riscos de rejeição

Vinte famílias de código, com a causa que mais aparece nas orientações oficiais e a correção indicada. Abra cada código para ver as duas.

Todas as linhas vêm do material oficial de Perguntas e Respostas (Fonte: Perguntas e Respostas da NFS-e, temas 4, 7, 8, 10, 11, 15, 17, 18, 21, 23, 27 e 31) e do manual dos contribuintes. A coluna de correção resume a orientação publicada, que pode mudar a cada evolução da plataforma. Antes de usar uma correção em produção, vale conferir a versão do Anexo de leiaute e regras de negócio vigente.

Se esses códigos já aparecem na sua operação, a avaliação de prontidão ajuda a separar o erro de leiaute do erro de parâmetro municipal antes de mexer no ERP.

Duplicidade e sistemas em paralelo

Dois riscos reais da migração: a nota emitida duas vezes e o contribuinte emitindo por dois canais ao mesmo tempo.

O número da nota merece um parágrafo à parte, porque é o ponto em que o hábito de ERP e a regra nacional mais se chocam. Quando a DPS chega, a Sefin Nacional reserva o próximo número e tenta gravar a nota no ADN. Se há timeout, falha de banco ou alta concorrência, o número reservado pode não virar nota, e fica um intervalo na sequência. A Nota Técnica 007 chama esses intervalos de pulos e explica que eles não são defeito: a unicidade vale mais que a continuidade. Um ERP que audita a sequência de numeração como se fosse um livro precisa aceitar que, na NFS-e nacional, buracos não indicam nota perdida (Fonte: Nota Técnica 007, item 3.b; Perguntas e Respostas da NFS-e, temas 18.5 e 18.6).

Os sistemas municipais em paralelo pedem um desenho simples e explícito. Enquanto o município com emissor próprio compartilha os documentos com o ADN, o contribuinte pode continuar falando com o WebService local, e a prefeitura transcreve para o leiaute nacional. Para as notas antigas, a obrigação de compartilhar continua mesmo depois da migração, por até seis anos de retroatividade (Fonte: Perguntas e Respostas da NFS-e, temas 5.6 e 23.5). Para o contribuinte, o resultado prático é que a consulta pública nacional, por chave, passa a servir de prova comum entre prestador, tomador e município.

Relação com SPED e EFD

A nota de serviço alimenta a escrituração, mas o produto de escrituração do ISS nacional ainda não está definido nas fontes oficiais.

A NFS-e é um documento fiscal. A escrituração dos serviços prestados e tomados continua pertencendo ao conjunto de obrigações da empresa, e a relação entre os dois mundos é desigual. A Escrituração Fiscal Digital do ISS (EFD ISS) aparece no portal como produto da cesta nacional, mas a página oficial está marcada como Em construção, e por isso nenhuma obrigação de EFD ISS nacional pode ser afirmada hoje (Fonte: Portal da NFS-e: produtos). Já a guia de recolhimento padronizada é descrita como o documento de arrecadação dos tributos destacados na NFS-e, que distribui o produto aos entes e permite emitir um só documento mesmo com filiais espalhadas, no modelo análogo ao do Simples Nacional (Fonte: Portal da NFS-e: produtos). O módulo que a executa, o MAN, é descrito como Produção Restrita, e a adesão municipal é opcional (Fonte: Perguntas e Respostas da NFS-e, tema 14.8).

Na prática, três pontos ligam a nota à escrituração e merecem atenção do Fiscal. O primeiro é que a Prefeitura de Belo Horizonte deixou de exigir os documentos comprobatórios de dedução na DES (Declaração Eletrônica de Serviços), porque a informação passa a ser exigida na própria nota, quando o município assim determina. O segundo é que a retenção de PIS, COFINS e CSLL na NFS-e foi agregada no campo vRetCSLL sem mudar a forma de prestar a informação na EFD-Reinf, segundo a Nota Técnica 007 (Fonte: Nota Técnica 007). O terceiro é que o escopo de obrigações municipais, estaduais e federais tem página própria: a página de obrigações acessórias e SPED descreve a camada de escrituração, e as obrigações municipais de serviço variam de uma prefeitura para outra.

Como a DFSpro atua

Consultoria de Governança Fiscal SAP, fundada em 2018, em Curitiba, com foco na camada fiscal do projeto.

O GUEPARDO Tax é um produto da NTT DATA, e a DFSpro o comercializa como Canal Autorizado. Ele faz parte do ambiente fiscal integrado ao SAP em que a DFSpro atua, e a conversa sobre o encaixe dele com o fluxo de NFS-e da sua empresa é do projeto, caso a caso. Quem quer ver como a camada fiscal de um projeto SAP é conduzida pode ler a página de Diagnóstico Fiscal SAP e a de GUEPARDO Tax. Se a dúvida é o que acontece com o fluxo de documentos quando a solução de emissão muda, a página de migração do GRC NF-e para o DRC cobre esse tema para a NF-e.

Fontes oficiais com link

Todos os fatos legais e técnicos da página vêm destes documentos, e cada afirmação traz o link da sua fonte.

Os documentos foram consultados em 13/10/2026. Os portais mudam: antes de decidir prazo ou regra, abra o ato vigente.

Comece pelo seu primeiro estabelecimento emissor

Se você tem uma lista de estabelecimentos que emitem nota de serviço e quer saber o que cada município exige do ERP, a avaliação de prontidão organiza essa lista. Se a dúvida é o encaixe com o seu projeto SAP, a conversa por contato é o canal.