CONTEÚDO

  1. Visão geral
  2. Exemplo de utilização
    1. Caminho
    2. Parâmetros dinâmicos
    3. Pré-requisitos, restrições e parametrizações
    4. Pré-requisitos técnicos
    5. Passo a passo 
  3. Tecnologias homologadas
  4. Documentação e assuntos relacionados
  5. Documentação de versões e atualizações

01. VISÃO GERAL

A NT 2025.002 define as alterações necessárias na NF-e e NFC-e para adequação à Reforma Tributária, contemplando a criação dos tributos:

  • IBS (Imposto sobre Bens e Serviços),

  • CBS (Contribuição sobre Bens e Serviços) e

  • IS (Imposto Seletivo),

Conforme estabelecido na Lei Complementar nº 214/2025.

Essa Nota Técnica substitui a versão anterior (NT 2024.002) e insere novos campos, grupos e eventos na estrutura XML da NF-e, para possibilitar a apuração assistida e automatizada dos novos tributos.

O preenchimento desses campos será obrigatório de forma escalonada, seguindo o cronograma contemplado nas respectivas atualizações das Notas Técnicas 2025.002.

Acesso ao Arquivo Completo

Portal da NF-eDocumentosNotas Técnicas
Link direto: https://www.nfe.fazenda.gov.br/portal/listaConteudo.aspx?tipoConteudo=04BIflQt1aY=

02. EXEMPLO DE UTILIZAÇÃO

Pré-Requisitos, Restrições e Parametrizações

Atenção: O layout poderá ser ativado sem que o cliente opte por enviar os novos impostos da reforma tributária e sem as respectivas configurações de cenários tributados. Porém, uma vez que o usuário passe a enviar valores escriturados no documento fiscal para esses impostos, no painel de envio à SEFAZ iniciará a validação das rejeições referentes às novas tags, conforme a composição do XML.

A partir da atualização do sistema para a SP mencionada nos documentos técnicos, torna-se obrigatória, no momento da ativação do layout, a atualização do patch da NDD para a respectiva versão de atualização, a fim de garantir a correta autorização dos documentos emitidos em ambiente nacional. 

A atualização do sistema e do patch da NDD devem sempre ser realizadas em conjunto para evitar rejeições e falhas do Schema na emissão dos documentos fiscais, bem como no recebimento dos documentos emitidos nesse mesmo ambiente.

Pré-Requisitos técnicos

Caso o usuário decida por iniciar o envio dos novos campos da reforma tributária, para que os cálculos dos novos impostos ocorram adequadamente no documento fiscal, é necessário que:

  1. O sistema esteja atualizado conforme indicado no documento técnico, em Requisito de versões.
    1. O layout para a Nota Técnica 2025.002 deve estar ativado, no Módulo Parâmetro, menu Parâmetros > Empresa > Aba NFe/NFSe > Botão: 'Configurar NT'.
  2. Atualize o patch da NDD para a versão indicada no documento técnico.
  3. No Configurador de Cenários Tributados: 
    1. Exista o cadastro prévio de Cenários Tributados, no Módulo Fiscal Web > Configurador de Cenários Tributados, para as operações.
    2. Esteja com status ativado de Homologação para Produção.
  4. O usuário confira se o cálculo está correto na emissão do documento/recebimento do documento.

Aviso Obrigatório:

Alterações ou parametrizações incorretas podem comprometer o desempenho e causar falhas no sistema. Sempre que necessário, consulte um especialista ou a equipe responsável para garantir a configuração correta.

Segue abaixo, o Resumo do Processo – NT 2025.002

    Fluxo

    O processo de cálculo dos tributos IBS, CBS e IS utiliza o Configurador de Cenários Tributários como base. Nele, o usuário cadastra os cenários aplicáveis às suas operações.
    A partir dessas definições, os módulos de Vendas e Recebimento consultam as configurações cadastradas para realizar a emissão dos documentos eletrônicos, conforme as parametrizações vigentes.


    Conheça o Configurador de Cenários Tributários.

     

    🔹 Módulo Vendas

      • Os valores dos novos impostos são calculados e gerados automaticamente na movimentação de venda, com base no retorno recebido do Configurador de Cenários Tributários.

    🔹 Módulo Recebimento

      • Os valores dos novos impostos são calculados e gerados automaticamente na movimentação de venda, com base no retorno recebido do Configurador de Cenários Tributários.

    🔹 Documentos Eletrônicos

      • Responsável pela leitura das novas informações geradas pelos módulos anteriores e envio das informações para NDD, para emissão do XML.

    🔹Integração com a NDD

          • A NDD consome o conteúdo CLOB gerado pelo módulo Documentos Eletrônicos.

          • Realiza a conversão do conteúdo para o layout XML conforme as regras da NT 2025.002.

          • Efetua a comunicação com a SEFAZ para emissão e autorização dos documentos fiscais (NF-e/NFC-e) com os tributos atualizados.

    ❓ O que fazer em caso de Rejeição de Documentos Eletrônicos?

    1. Avaliar o documento eletrônico rejeitado

      • Verifique as informações operacionais geradas, como:

        • CST/cCLASSTRIB

        • Valores dos novos impostos (IBS, CBS, IS)

    2. Validar o Cenário Tributário utilizado

      • Consulte o cenário cadastrado no Configurador de Cenários Tributários.

      • Confirme se as parametrizações estão conforme as regras da Reforma Tributária.

      • Exemplo: O produto que causou a rejeição está enquadrado no cenário adequado, conforme as regras da Reforma tributária?

    3. Corrigir as parametrizações

      • Ajuste o cenário tributário para refletir corretamente a regra aplicável.

      • Após a correção, as próximas emissões deverão ocorrer sem rejeições.

    🔹 Módulo Fiscal

      • O modulo Fiscal, recebe automaticamente a Nota Fiscal emitida eletronicamente (NF-e) e, em seguida, realiza as escriturações fiscais e contábeis necessárias, conforme a legislação vigente.

    📑 FAQ – Perguntas Frequentes sobre Erros de Validação


    1. O que significa a rejeição “CST do IBS/CBS informado não permite informação de redução de alíquota da CBS [nItem:1]”?

    ➡ Essa rejeição ocorre porque determinados Códigos de Situação Tributária (CST) do IBS/CBS não aceitam campos de redução de base de cálculo ou redução de alíquota.
    Exemplo: O CST informado para o item não admite informação de redução de alíquota, já que o imposto não é devido.


    2. Como corrigir o erro de CST incompatível com redução de alíquota?
    ➡ Nesse caso, deve-se ajustar o CST ou o valor escriturado, conforme a operação correta para o produto:

    • Se a operação é realmente tributada com redução, deve-se usar o CST específico.

    • Se for uma operação isenta ou que não permite redução, deve-se remover o valor escriturado no campo de redução.


    3. O que fazer ao receber uma rejeição de validação?
    ➡ O procedimento recomendado é:

    1. Identificar o CST e cClasstrib  informado para o item no XML, que é único para IBS e CBS;

    2. Verificar se o campo adicional (redução, crédito, isenção, etc.) é compatível com esse CST.

    3. Verificar qual cenário tributário do Sistema Totvs Varejo Linha Consinco foi vinculado ao item, tanto para IBS como para CBS.
    4. Corrija o cadastro do Cenário Tributário para novas integrações.


    Imagem 1 - Exemplo de geração de CST incompatível com redução de alíquota


    Atenção

    O cadastro do Cenário Tributado deve ser igual para os impostos IBS e CBS, pois no XML do documento fiscal há apenas um campo para o envio do CST e cClasstrib.

    Caso o sistema identifique cadastros com informações divergentes, será considerado, de forma prioritária, o campo de CST e cClasstrib do cadastro do Cenário para o imposto IBS.

    Parametrização

    Caminho: Modulo Parâmetros/Parâmetros/ Cadastro de Empresa/Aba NF-e

    Os novos campos do XML serão disponibilizados inicialmente com o status inativo.
    Para as novas informações serem enviadas, o usuário deverá ativar manualmente esses campos.

                     Imagem 01: Parâmetros da Empresa

    Passo a Passo para a ativação

    Ativação

    Pré‑requisitos

    • Estar logado na empresa MATRIZ com usuário autorizado.


    Importante

    Verificar se as seguintes Notas Técnicas dependentes estão ativas na aplicação Configurar Informações da Nota Técnica:

      • NT 2020.006 - versão 1.0
      • NT 2020.005 – versão 1.0

      • NT 2019.001 – versão 1.60

    Essas NTs devem estar ativadas com data início e data fim definidas e o campo "Enviar" marcado.
    Caso contrário, a montagem da linha das linhas 2100 - IDE – Informações da Nota Fiscal Eletrônica e 3000 - PROD – dados dos produtos e serviços da NF-e do clob que contem novos campos da NT 2025.002 não serão geradas corretamente.

    Procedimento

    1. Na aplicação, pesquise por Nota Técnica 2025.002, layout 4.

    2. Na tela da nota técnica, clique em Ativar.

    3. Salve as informações para confirmar a ativação.


     O processo foi alterado para incluir a opção de ativar o layout em todas as empresas filiais da Matriz. Dessa forma, a ativação foi otimizada, eliminando a necessidade de realizar o procedimento empresa por empresa.

    03. TECNOLOGIAS HOMOLOGADAS

    O uso do Tipo de Produto em diferentes tecnologias não homologadas, como em Sistema Operacional, Plataforma, Navegadores e outros dispositivos, pode comprometer a segurança dos sistemas e está sujeito a situações não previstas, sem cobertura de suporte.
    Tipo de produtoERP
    Sistema Operacional

    Desktop

    Plataforma

    Windows Desktop

    NavegadorN/A
    Utilização/Experiência

    Aplicações Desktop em geral

    04. DOCUMENTOS E ASSUNTOS RELACIONADOS

    AçãoDescrição
    Ativação de layoutConfigurar Informações da Nota Técnica

    05. DOCUMENTOS DE VERSÕES E ATUALIZAÇÕES

    Clique para expandir