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:
Detecta o elemento "T:" presente na fórmula (Exemplo: T:VAL:000021).
Identifica a referência do código (Exemplo: 000021 refere-se ao ICMS).
Busca se existe uma Regra Ativa e enquadrada na operação deste tributo.
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
0 Comentários