Cross Segmento - Backoffice Linha Protheus - SIGACTB - Contabilização com Base na Classificação do Tributo – Central de Atendimento TOTVS

Tempo aproximado para leitura: 00:10:00 min

Dúvida
Como realizar a contabilização de documentos fiscais utilizando a Classificação do Tributo no Protheus?

Ambiente
Cross Segmento - TOTVS Backoffice (Linha Protheus) - Contabilidade Gerencial - Todas as versões

Solução
Visando aprimorar o processo contábil e simplificar a manutenção de regras, foi implementada uma solução que permite a contabilização através da Classificação do Tributo (definida na Regra de Cálculo) em vez de utilizar apenas a sigla específica (campo F2D_TRIB).

Esta abordagem permite configurações de sequências contábeis mais genéricas e maior reutilização de parâmetros.

Para viabilizar este processo, deve-se utilizar a função de contabilização CTBVLTRIB diretamente nos Lançamentos Padrões.

Sintaxe da Função:

CTBVLTRIB (<ID_TRIBUTO>, <TRIBUTO>, <OPERACAO>, <LDESDOCENT>)
- <ID_TRIBUTO>: Campo que contém o ID do tributo (Ex: SD1->D1_IDTRIB ou SD2->D2_IDTRIB)
- <TRIBUTO>: Campo com a sigla do tributo desejado, criado no configurador de tributo (Ex: "ICMS", "IPI").
- <OPERAÇÃO>: (.T. ou .F.) Indica se deve considerar a regra de custo (Soma/Subtração) configurada para o tributo no Configurador de Tributos. Campo opcional
- <LDESDOCENT>: (.T. ou .F.) Indica se retorna o valor desmembrado para Ativo Fixo no módulo de Compras (SD1). O padrão é .F.. Campo opcional
  
  Exemplo de uso:
  
  OBS: Caso o argumento <operação> e <LDESDOCENT> não seja informado, o valor padrão (default) para a ambos será falso (.F.).
Uso do argumento <Operação>:
Ao definir como verdadeiro (.T.), a função respeita a regra definida no Configurador de Tributos em regra de custo:
- Operação 0 (Sem Ação): A função retorna zero.
- Operação 1 (Somar): A função retorna o valor do tributo.
- Operação 2 (Subtrair): A função retorna o valor do tributo com sinal negativo, facilitando cálculos de valor líquido.
  
  Cadastro Regra Custo:
  
  Exemplo de Cadastros:
  
  Vinculo do Custo a Regra de Cálculo Documentos Fiscais:
  
  Exemplo de uso com lógica condicional:
  
  IIF(CTBVLTRIB(SD1->D1_IDTRIB, "ICMS", .T.) < 0, FAÇA_X(), FAÇA_Y())
  
  Neste exemplo, a função verifica se o valor do tributo é negativo, permitindo executar diferentes rotinas conforme o tipo da operação (como crédito ou débito).
  
  Exemplo de cálculo com ajuste automático:
  
  SD1->D1_TOTAL + CTBVLTRIB(SD1->D1_IDTRIB, "ICMS", .T.)
  
  Se CTBVLTRIB retornar -180 e D1_TOTAL for 1000, o resultado será 820.
  
  Esse cálculo representa o valor líquido da operação, considerando automaticamente a dedução do ICM — viabilizada pelo sinal negativo retornado pela função.
  
  Esse comportamento é especialmente útil para simplificar regras e fórmulas nos lançamentos contábeis, evitando a necessidade de ajustar o sinal manualmente.
  
  Verifique na documentação abaixo exemplos utilizando a operação de custo:
  Documentação operação de custo
Configuração para Ativo Fixo (argumento <LDESDOCENT>):

Caso a TES esteja configurada para desmembrar ativos (F4_BENSATF = Sim), o uso de .T. no quarto argumento fará com que o sistema divida o valor do imposto pela quantidade de itens da nota (D1_QUANT), permitindo a contabilização individual por bem.

Exemplo de chamada da função com o quarto parâmetro: CTBVLTRIB(SN1→N1_IDTRIB,"IBSEST",,.T.)