Base de conhecimento
Encontre respostas para suas dúvidas em quatro fontes de conhecimento diferentes ao mesmo tempo, simplificando o processo de pesquisa.

Cross Segmento - TOTVS Backoffice (Linha Protheus) - FIS - Uso do Operando T no Configurador de Tributos

time.png Tempo aproximado para leitura: 00:10:00 min

Dúvida


Como utilizar o novo operando "T:" para simplificar e padronizar o cadastro de fórmulas no Configurador de Tributos (CFGTRIB), eliminando a necessidade de referenciar os códigos de tributos específicos?

Ambiente


Cross Segmento - TOTVS Backoffice (Linha Protheus) - FIS - a partir da versão 12.1.2510

Solução
 

Para simplificar o cadastro de fórmulas no Configurador de Tributos (CFGTRIB), foi introduzido o operando "T:". Ele permite utilizar o ID Universal do Tributo baseado no Catálogo Nacional TOTVS (Tabela F2C), eliminando o acoplamento aos códigos locais do cliente e permitindo que uma mesma fórmula funcione para múltiplos cenários.

Com o novo modelo, as regras de negócios e cálculos podem ser descritas referenciando o ID Padrão, e o sistema traduz automaticamente sob demanda qual é o código correspondente naquele ambiente, não exigindo edição manual da fórmula.

 

1. Variáveis Suportadas 

O operando é construído adotando o formato T: e suporta as seguintes marcações de variáveis de cálculo:

  • T:VAL: : Busca o Valor Calculado correspondente ao tributo.

  • T:BAS: : Busca a Base de Cálculo correspondente ao tributo.

  • T:ALQ: : Busca o percentual de Alíquota correspondente ao tributo.

  • T:DIF: : Busca o Valor Diferido correspondente ao tributo.

  • T:OUT: : Busca e recupera o Valor Outros correspondente ao tributo.

  • T:ISE: : Busca e recupera o Valor Isento correspondente ao tributo.

2. Como funciona no Sistema (Tempo de Execução) 

O processador de fórmulas resolve os Identificadores Dinâmicos para cada item da Nota Fiscal de forma automática, seguindo a ordem abaixo:

  1. Detecta o elemento "T:" presente na fórmula (Exemplo: T:VAL:000021).

  2. Identifica a referência do código (Exemplo: 000021 refere-se ao ICMS).

  3. Busca se existe uma Regra Ativa e enquadrada na operação deste tributo.

  4. Substitui virtualmente o identificador dinâmico pela amarração real do sistema atual (Exemplo: VAL:ICM001) antes de realizar o cômputo matemático.

3. Cenários Práticos de Utilização 

Em legislações complexas, a Base de Cálculo ou o Valor de um tributo pode depender do montante de outros tributos gerados no mesmo item. Exemplos de aplicação do operando "T:".

  • Cálculo do ICMS-ST (Substituição Tributária): Deduzindo o Valor do ICMS Próprio (ID 000021) do cálculo do ICMS ST (ID 000056). 

Fórmula: (BAS:ICMSST * ALQ:ICMSST) - T:VAL:000021

  • Exclusão do ICMS da Base do PIS/COFINS: Abstraindo o ICMS (ID 000021) da base de cálculo. 

    Base do PIS: (BAS:PIS * ALQ:PIS) - T:VAL:000021 

    Base da COFINS: (BAS:COFINS * ALQ:COFINS) - T:VAL:000021

4. Restrições de Recursividade do Operando T: 

Limitação Crítica: 

O operando "T:" não possui permissão para ser utilizado de forma recursiva. Ao definir a fórmula de cálculo de um tributo (exemplo: ID 000021 - ICMS), não é permitido vincular variáveis que referenciem esse mesmo ID dentro de sua própria fórmula.

 

❌ Exemplo INVÁLIDO (Recursão Proibida)

Tributo de ICMS

ID 000021 (ICMS) = (BAS:VALTOT * ALQ:VALTOT) - T:VAL:000021


Neste caso, a fórmula do ICMS (000021) tenta referenciar o próprio ICMS (T:VAL:000021), criando uma recursão infinita que será rejeitada pelo sistema.

 

CFGTRIB - Configurador de Tributos

 

 

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0

0 Comentários

Por favor, entre para comentar.
X Fechar

Olá ,

Há pendência referente a um de seus produtos contratados para a empresa ().

Entre em contato com o Centro de Serviços TOTVS para tratativa.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cobrança – Verificação de pendências financeiras . clique aqui.

TOTVS

X Fechar

Olá ,

Seu contato não está cadastrado no Portal do Cliente como um perfil autorizado a solicitar consultoria telefônica.

Por gentileza, acione o administrador do Portal de sua empresa para: (1)configurar o seu acesso ou (2)buscar um perfil autorizado para registro desse atendimento.

Em caso de dúvidas sobre a identificação do contato administrador do Portal, ligue (11) 4003-0015, opção 7 e, em seguida, opção 4 para buscar o suporte com o time de Assessoria ao Portal do Cliente. . clique aqui.

TOTVS

X Fechar

Olá ,

Para o atendimento de "Consultoria Telefônica" você deverá estar de acordo com o Faturamento.

TOTVS

X Fechar

Olá,

Algo inesperado ocorreu, e o usuario nao foi reconhecido ou você nao se encontra logado

Por favor realize um novo login

Em caso de dúvidas, entre em contato com o administrador do Portal de Clientes de sua empresa para verificação do seu usuário, ou Centro de Serviços TOTVS.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cadastros . clique aqui.

TOTVS

Chat _

Preencha os campos abaixo para iniciar o atendimento:

Chat _