FAQ Complementar - NFS-e e a Reforma Tributária

• Reforma Tributária na NFS-e
  • A NFS-e/Nacional já tem campos da Reforma Tributária?
  • Como recebo atualizações? Existe uma central?
• Adoção pelos municípios & prazos
  • O que são sistemas/padrões próprios?
  • Como saber se minha cidade já opera com a NFS-e Nacional ou se manteve utilizando um emissor próprio?
• Como a TecnoSpeed tratará os cenários
  • Padrões próprios x Padrão Nacional – estratégia
  • Status por produto (Reforma Tributária & NFS-e Padrão Nacional)
  • Liberação em produção
  • Campos mapeados
  • Rejeições do Padrão Nacional
• Últimas Atualizações
  • 19/09/2025 Lista com o mapeamento prévio
  • 06/11/2025 Disponibilização dos campos da Reforma Tributária no ambiente SandBox (PlugNotas)
  • 14/11/2025 Lista de padrões que já confirmaram que irão se adaptar aos novos campos da Reforma Tributária
  • 09/12/2025 - Liberação da atualização para testes da cidade de São Paulo

A NFS-e Nacional já tem os campos da Reforma Tributária?

Sim, a Nota Técnica 004/2025, publicada pela NFS-e Nacional, trouxe novos campos de IBS, CBS e totalizadores referentes à Reforma Tributária do Consumo. Esse layout, definido pela NT, será implementado no ambiente de produção restrita em dezembro de 2025 e entrará em produção oficial em 1º de janeiro de 2026.

Atualmente, nossa equipe técnica está trabalhando na implementação desses campos nos produtos Componente NFS-e Nacional e PlugNotas.

O Portal da Nota Fiscal de Serviço Nacional ainda não publicou as datas oficiais de homologação nem as atualizações do ambiente de produção restrita com os novos campos. Sem esses insumos, não há como validar o comportamento do Ambiente Nacional, impedindo a liberação segura dos campos em produção.

Por esta razão, para que nossos clientes do PlugNotas consigam realizar testes dos novos campos de forma antecipada, no dia 06/11/2025, os novos campos foram disponibilizados no ambiente sandbox do PlugNotas, apenas para testes com dados mockados (sem impacto em produção).

Para os clientes do Componente NFS-e Nacional, não será possível realizar testes antecipados, mas abaixo destacamos nossa documentação atualizada com os novos campos no tx2, que poderão ser mapeados previamente na integração do cliente.

A liberação em produção ocorrerá somente após a divulgação oficial dos artefatos técnicos pela NFS-e Nacional. Assim que a TecnoSpeed tiver estas novas informações, uma nova previsão de liberação oficial dos campos em produção será informada no FAQ para que possamos dar prosseguimento no desenvolvimento dos produtos PlugNotas e Componente NFS-e Nacional.

Sobre a NT 005/2025, publicada em novembro, informamos que os novos grupos e campos criados - como os referentes à locação de bens móveis, estorno de crédito e antecipação de pagamento - serão implementados nos ambientes de produção restrita e de produção em uma data futura, conforme determinação do Comitê Gestor da NFS-e na própria nota técnica.

Como recebo atualizações sobre essas mudanças? Existe uma central de novidades?

Sim. Manteremos nossa base de documentação atualizada tão logo as entregas forem sendo realizadas, para saber mais sobre as adequações dos padrões, acesse nossa FAQ Complementar e o Roadmap de adequação dos padrões. além disso, nossos clientes poderão solicitar apoio por meio do registro de um Ticket ou via Chat Online. Ou se preferirem, também temos uma sessão dedicada à Reforma Tributária em nosso Blog.

O que são sistemas/padrões próprios?

Sistemas próprios são soluções mantidas por empresas terceirizadas (como IPM, GINFES, BETHA, entre outras) para atender às necessidades de emissão fiscal de determinados municípios. Esses sistemas podem seguir layouts específicos, como o ABRASF, já outros possuem seu próprio layout e regras próprias de emissão. 

Vale ressaltar que, mesmo que o município utilize um sistema próprio, a Reforma Tributária exigirá mudanças em todos os ambientes emissores. Campos e grupos específicos precisarão ser implementados em conformidade com os novos tributos (IBS e CBS), impactando diretamente os fluxos de emissão.

Como saber minha cidade já está operando com a NFS-e Nacional ou se manteve utilizando um emissor próprio?

Para consultar os municípios que aderiram ao Padrão Nacional, pode ser consultada a tabela oficial de municípios já conveniados e ativos: Portal da Nota Fiscal de Serviço Eletrônica > Municípios Aderentes.

Já para os munícipios que mantiveram seu sistema próprio de emissão, você pode consultar a base da TecnoSpeed, ou verificar com a própria prefeitura qual empresa é responsável pela emissão. Exemplos comuns: IPM, GINFES, BETHA, etc..

Sobre os municípios que não aderirem ao emissor nacional, conforme previsto na Lei Complementar 214/2025, os municípios poderão continuar utilizando seus emissores próprios até 31 de dezembro de 2032, desde que garantam o envio das informações ao ADN.

Como a TecnoSpeed vai tratar os dois cenários? Os campos da Reforma Tributária já estão implementados?

• Padrões Próprios

  • Primeiramente, é necessário que o padrão próprio implemente os campos previstos pela Reforma Tributária;

  • Em seguida, a TecnoSpeed deverá compatibilizar essas atualizações em seus produtos. Vale lembrar que essa adequação é realizada sob demanda, pois não há uma base centralizada que seja possível consultarmos às próximas atualizações de cada município. Caso o prestador identifique alguma atualização relacionada à cidade de emissão, é importante comunicar a Consultoria Técnica da TecnoSpeed para que possamos providenciar a devida adequação.

• NFS-e Nacional

  • Diferentemente dos padrões próprios, a NFS-e Nacional será adequada diretamente pela TecnoSpeed, conforme a liberação das Notas Técnicas, sem a necessidade de intervenção de terceiros.

  • A TecnoSpeed tem acompanhado de perto as movimentações relacionadas à NFS-e Nacional. Ainda não foi divulgado um data para disponibilização do ambiente de homologação. Com isso seguimos no aguardo de uma comunicação formal para dar continuidade ao planejamento. Enquanto isso, iniciaremos os ajustes preliminares com base nas especificações já divulgadas. O desenvolvimento será conduzido ao longo do segundo semestre de 2025, com previsão de conclusão conforme a liberação do ambiente de testes, o que viabilizará as validações finais e a liberação gradual das atualizações.

  • É importante destacar que qualquer prazo pode ser impactado caso sejam publicadas novas Notas Técnicas com alterações significativas ou um volume elevado de mudanças.

  • Documentação Complementar: NFSe Padrão Nacional, o que preciso saber?

Status por produto (Reforma Tributária & NFS-e Padrão Nacional)

Fique atento às informações abaixo de cada produto:

• Reforma Tributária

  • Componente V2

    • Será adequado normalmente e disponibilizado os campos relacionados a Reforma Tributária sob demanda, porém, apenas nos municípios que mantiverem emissor próprio.

  • API Notas Tomadas

    • Será adequado normalmente e disponibilizado os campos relacionados a Reforma Tributária sob demanda somente para os municípios que utilizam sistemas próprios. Não será possível consultar notas de cidades que estiverem conveniadas ao padrão nacional. Em alguns casos, o município pode optar por compartilhar os dados de emissão tanto com o ambiente nacional quanto com o sistema próprio. Nesses cenários, a consulta via webservice continuará funcionando normalmente por meio da integração da TecnoSpeed com o padrão do município, mas sem qualquer interação com o ambiente nacional.

  • Manager SaaS

    • Será adequado normalmente e disponibilizado os campos relacionados a Reforma Tributária sob demanda somente para os municípios que utilizam sistemas próprios. Não será possível emitir para municípios que estão conveniados ao padrão Nacional.

  • PlugNotas

    • Será adequado e disponibilizado os campos relacionados a Reforma Tributária sob demanda, tanto nos municípios que contém emissor próprio quanto nos municípios que estão conveniados ao ambiente Nacional.
       

• NFS-e Padrão Nacional

  • Componente V2

    • Não será possível realizar emissões ou consultas de notas de municípios que estão conveniados ao padrão Nacional. Para isto, deve ser utilizado os produtos PlugNotas ou Componente NFS-e Nacional.

    • Documentação Complementar: Uso Componente V2 e vou passar a utilizar o Componente Nacional. O que devo saber?

  • Componente Nacional

    • É possível realizar o fluxo completo de emissão e consulta para municípios de que estão conveniadas e utilizam o padrão Nacional. 

  • API de Notas Tomadas

    • A API de Notas Tomadas não fará consulta direta no ambiente nacional. Para consulta direto no Ambiente Nacional, deve ser utilizado os produtos PlugNotas ou Componente NFS-e Nacional. As notas que estão no Ambiente Nacional somente serão retornadas caso o webservice daquele município tenha emitido a nota e compartilhado com o Ambiente Nacional.

  • Manager SaaS

    • Não será possível realizar emissões ou consultas de notas de municípios que estão conveniados ao padrão Nacional. Para isto, deve ser utilizado os produtos PlugNotas ou Componente NFS-e Nacional.

    • Documentação Complementar: Uso Manager SaaS e vou passar a utilizar o PlugNotas. O que devo saber?

  • PlugNotas

    • É possível realizar o fluxo completo de emissão e consulta para municípios de que estão conveniadas e utilizam o padrão Nacional. 

🏁 Liberação em produção

• A liberação em produção ocorrerá somente após a divulgação oficial dos artefatos técnicos pela NFS-e Nacional.

• Assim que a TecnoSpeed obtiver essas informações, uma nova previsão de liberação oficial dos campos em produção será informada neste FAQ, para que possamos dar prosseguimento ao desenvolvimento dos produtos PlugNotas e Componente NFS-e Nacional.

📄 Campos mapeados

• Componente NFS-e Nacional: os novos campos estão disponíveis aqui nesta documentação e estão com a seguinte descrição: "Adicionado em NT Reforma Tributária do Consumo, ainda não disponível em produção. Faz parte apenas de um mapeamento prévio de campos." Incluímos um exemplo de tx2 que poderá ser utilizado para o mapeamento prévio dos campos na integração do cliente, porém, não é possível testar estes campos em produção/homologação.

• PlugNotas: os novos campos estão disponíveis aqui nesta documentação e estão com a seguinte descrição: "Adicionado em NT Reforma Tributária do Consumo, ainda não disponível em produção. Faz parte apenas de um mapeamento prévio de campos."  Ao lado direito da documentação disponibilizamos um exemplo de json com o nó de ibscbs. Lembrando que estes campos não são validados em produção e apenas no dia 30/10/2025 que iremos adicionar esses campos no ambiente sandbox para testes.

Rejeições do Padrão Nacional

Estamos trabalhando para catalogar as rejeições e trazer soluções práticas para cada uma delas. Abaixo, você encontra as rejeições já documentadas até agora. Esta seção será atualizada continuamente conforme novas ocorrências forem analisadas.

https://atendimento.tecnospeed.com.br/hc/pt-br/sections/36128806726935-Rejei%C3%A7%C3%B5es-NFS-e-Padr%C3%A3o-Nacional

Ultimas Atualizações

19/09/2025 - Lista com o mapeamento prévio dos campos (Atualizada em 29/10/2025)

Segue abaixo a lista com o mapeamento prévio dos novos campos a serem criados para emissão de NFS-e adequada a Reforma Tributária, usando como base os campos da cidade do novo layout de São Paulo. A documentação dos produtos será atualizada também até o dia 06/11/2025. Lembrando que inicialmente será somente listado estes campos em nossas documentações, mas eles ainda não estarão disponíveis para envio em produção/homologação no arquivo de integração (json/tx2). Reforçamos que cada cidade pode criar um campo específico, portanto, as adequações serão feitas sob demanda para as demais cidades, conforme mencionado neste FAQ no tópico "Todos os produtos relacionados a emissão e consulta de NFS-e serão compatibilizados com a Reforma Tributária e com o layout da NFS-e Padrão Nacional?"

06/11/2025 - Disponibilização de campos da Reforma Tributária no ambiente SandBox e Documentação (PlugNotas)

Foi disponibilizada no ambiente Sandbox do PlugNotas a atualização que contempla os campos previstos pela Reforma Tributária, aplicável tanto à NFSe Nacional quanto às demais cidades.

⚠️ Reforçamos que, para a implementação dos campos da Reforma Tributária nas demais cidades que não migraram para o ambiente Nacional, a base utilizada é o novo layout da cidade de São Paulo. Entretanto, outras prefeituras poderão adotar campos específicos, o que poderá demandar ajustes adicionais em nossos mapeamentos.

Em caso de dúvidas, consulte a nossa Documentação da API PlugNotas, onde estão disponíveis todas as rotas referentes ao ambiente Sandbox.

09/12/2025 - Publicação do Roadmap de adequação dos padrões (IBS/CBS)

Reforma Tributária (RTC) na NFS-e - Roadmap de adequação dos padrões (IBS/CBS)

09/12/2025 - Liberação da atualização para testes da cidade de São Paulo

Informamos que as adequações necessárias para integrar os novos campos da Reforma Tributária na Nota Fiscal de Serviço Eletrônica (NFSe) da cidade de São Paulo (SP) foram publicadas em nossos produtos: Componente V2, Manager SaaS e PlugNotas.

Para realização dos testes os clientes do produto componente V2 devem realizar atualização para a versão 2.1.84.7707. Clientes dos produtos Manager SaaS e PlugNotas, a atualização se encontra publicada e disponível para testes.

Por padrão, nossos produtos estão configurados para a comunicação Síncrona. Para que você possa testar a integração, será necessário incluir (ou ajustar) os seguintes campos nos seus arquivos de integração (TX2 ou JSON):

• Versao=2 (informar no grupo INCLUIR/SALVAR)

Exemplos: Para auxiliar na configuração, estamos deixando em anexo exemplos de arquivos de integração nos formatos TX2 e JSON.

Importante: A simples inclusão dos dados da Reforma Tributária no arquivo de integração não garante o uso do novo esquema. Para realizar a geração do XML na Versão nova de esquema, o cliente deverá informar também o campo Versao=2. Caso contrário, a geração seguirá o esquema padrão da versão anterior, que continua em operação.

Documentação Técnica - Padrão SAOPAULO