Criação de Regras tributárias On Demand

Essa funcionalidade tem como objetivo criar uma regra tributária via recurso on demand do motor através de uma chamada feita no Cockpit com os parâmetros de operação (cenário) e produto, nos quais apenas o cenário deve existir no cliente. Dessa forma, a regra é criada no Cockpit com uma nova estatística. Os dados de produtos são retornados com base no cadastro do Supermercado Systax.

Para as regras da Reforma podem ser criadas regras específicas ou regras gerais, dependendo da condição tributária que o produto estiver enquadrado.

  1. Configurações

Na página "Configuração Tax Engine" é necessário a combinar os dois métodos: "calculoOnDemand" e "AtivaCriacaoRegraOnline" para configurar a ferramenta. O primeiro ativa o recurso com o cálculo On Demand nas chamadas no Tax Engine. Já o segundo, cria no Cockpit as regras tributárias chamadas pelo motor através do recurso On Demand, segundo as condições explicadas no documento. 

Configurar o On Demand

Configurar o On Demand para criação de regras tributárias:

O setup deverá ser feito da forma como mostra a imagem abaixo:

fee1.jpg

  1. Definições

Somente será criada a regra no cockpit para as chamadas on demand em que o cenário seja conhecido na base do Cockpit. Para os produtos não há necessidade de cadastro na base do cliente, pois ele irá considerar os itens cadastrados na base do Supermercado Systax. A lista de cenários pode ser pesquisada através das página "Cenários" do menu "Documentos". 

Quando a regra for criada, o produto será automaticamente adicionado ao grupo de produtos associado ao cenário da nova regra, se for o caso.

Caso o cenário possua grupo de produtos.

A nova regra criada terá a estatística Z05 específica dessa nova funcionalidade e será validada pelas queries de qualidade do Cockpit. Caso não seja retida, será aprovada. Caso contrário, permancerá pendente de aprovação pelo usuário. A carga que receberá essa regra será identificada como "regra temporária". Quando é recebida uma regra idêntica por meio de carga interna ou expressa, a estatística da regra é atualizada para a estatística da regra recebida (igual ao recurso da base intermediária). Caso a regra recebida seja diferente, a regra que já existia será atualizada mantendo no histórico da regra a estatística Z05.

  1. Exemplos: A seguir uma simulação de chamada feita pelo Tax Engine:

Regra específica

image.png

image.png

image.png

image.png

O motor de cálculo faz a chamada no Cockpit e identifica que o cenário existem na base do cliente. Por tanto, o recurso On Demand é acionado e a mensagem "Regra criada" é exibida para o usuáiro no Tax Engine.

image.png

Exemplo: Regra Geral

Para regra geral o produto da chamada é incluído na tabela de Produtos com Regra Geral, e se não houver uma regra geral já criada no cockpit para operação da chamada, é criada a regra.

image.png

image.png

image.png

É possível identificar o tipo de regra pela coluna "Tipo de Regra":

0 - regra específica 

1- regra geral

A criação de uma regra ondemand é assincrona, ou seja, as regras são inseridas em uma fila e podem ser acompanhadas através da tela "Consulta Fila de criação de regra" no menu da Reforma.


Revision #4
Created 23 February 2026 14:59:39 by Josielma Xavier
Updated 24 February 2026 13:53:14 by Josielma Xavier