Casos de Uso - Calculo de Valor Promocional via Formula
Esta página apresenta exemplos práticos de como o sistema pode se comportar ao calcular valores promocionais e descontos nos itens de um Pedido de Vendas, considerando o uso de fórmulas no Avaliador de Expressões.
Os cenários descritos têm caráter ilustrativo, com o objetivo de:
- Demonstrar comportamentos possíveis do sistema.
- Evidenciar o impacto do uso ou não de tokens relacionados à Tabela de Promoção.
- Facilitar o entendimento das funcionalidades.
- Apoiar análises, homologações e validações de entendimento funcional.
Os exemplos abaixo não definem procedimentos obrigatórios, servindo apenas como referência de funcionamento do cálculo.
Dados Utilizados nos Exemplos
Os exemplos a seguir consideram o mesmo contexto base, conforme a documentação:
- Cliente: 1058 – GILBERTO ANTONIO DE MELO
- Categoria da Pessoa: 9 – CLIENTE PF
- Produto: 31.877 – RACAO BOM DEMAIS 27% 40KG
- Quantidade: 1,00
- Tabela Dinâmica: 1 – TABELA DE PREÇOS DINÂMICA
- Preço de venda (Tabela Base): R$ 84,70
- Tabela de Promoção configurada:
- Faixa 1: 1,00 a 10,00 → R$ 75,00
- Faixa 2: 11,00 a 20,00 → R$ 70,00
Exemplo de Uso 01 — Sem Uso de Tokens de Tabela de Promoção
Neste cenário, o Avaliador de Expressões não utiliza tokens relacionados à Tabela de Promoção.
Tokens considerados
- Nenhum dos tokens abaixo é utilizado:
- @achou_tabela_promocao@
- @id_tabela_promocao@
- @valor_tabela_promocao@
O que acontece nesse cenário
- O sistema calcula o preço unitário do produto em R$ 84,70, conforme a Tabela Dinâmica.
- Existe uma Tabela de Promoção válida para a quantidade informada.
- O desconto segue o comportamento padrão do sistema, sem interferência de fórmulas.
Resultado observado
- Valor unitário: R$ 84,70
- Valor promocional: R$ 75,00
- Desconto aplicado: R$ 9,70
Este cenário demonstra a preservação do comportamento tradicional quando não há uso de tokens na condição da fórmula.
Exemplo de Uso 02 — Uso do Token @achou_tabela_promocao@
Neste cenário, a fórmula está condicionada à existência de uma Tabela de Promoção aplicável ao produto.
Tokens considerados
- @achou_tabela_promocao@
- @valor_tabela_promocao@
O que acontece nesse cenário
- O preço unitário permanece em R$ 84,70.
- O sistema avalia o token @achou_tabela_promocao@ e identifica valor igual a 1.
- O token @valor_tabela_promocao@ retorna R$ 75,00.
- A fórmula utiliza esse valor como base para o cálculo promocional.
- O desconto é calculado pela diferença entre os valores.
Resultado observado
- Valor unitário: R$ 84,70
- Valor promocional: R$ 75,00
- Desconto aplicado: R$ 9,70
Este exemplo ilustra o uso direto do valor da Tabela de Promoção dentro da fórmula.
Exemplo de Uso 03 — Desconto Percentual com Uso do Token @achou_tabela_promocao@
Neste cenário, o valor promocional é calculado a partir de um percentual de desconto, aplicado somente quando duas condições são atendidas: existência de Tabela de Promoção válida e enquadramento do cliente em uma categoria específica.
Tokens considerados
- @achou_tabela_promocao@
- @valor_venda@
- @valor_tabela_promocao@
Condições ilustrativas da fórmula
- @achou_tabela_promocao@ = 1
- Categoria da Pessoa = 9 – CLIENTE PF
A fórmula só é executada quando ambas as condições são atendidas.
Fórmula ilustrativa
- @valor_venda@ - 20%
O que acontece nesse cenário
- O sistema identifica que existe Tabela de Promoção válida para o produto e quantidade.
- O token @achou_tabela_promocao@ retorna valor igual a 1.
- O sistema valida a categoria do cliente e identifica que ele pertence à categoria 9 – COOPERADO PF.
- Como todas as condições são atendidas, a fórmula percentual é executada.
- O valor promocional é recalculado com base no valor de venda.
Resultados observados
- Valor unitário: R$ 84,70
- Valor promocional = @valor_venda@ - 20% = R$ 84,70 - 20% = R$ 84,70 - 16,94 = R$ 67,76
- Desconto aplicado: R$ 16,94
Este exemplo demonstra que o desconto percentual não depende apenas da promoção, mas também do perfil do cliente, garantindo aplicação correta da política comercial.
Exemplo de Uso 04 — Uso do Token @id_tabela_promocao@
Neste cenário, a aplicação da fórmula depende da identificação de uma Tabela de Promoção específica.
Tokens considerados
- @id_tabela_promocao@
O que acontece nesse cenário
- O sistema identifica a Tabela de Promoção associada ao produto.
- O token @id_tabela_promocao@ é comparado com o identificador configurado na fórmula.
- Quando há correspondência, a fórmula é aplicada.
- Caso contrário, o sistema mantém o cálculo padrão.
Resultado observado
- Quando a Tabela de Promoção esperada é encontrada:
- A fórmula é aplicada e o desconto segue a regra configurada.
- Quando não é encontrada:
- Valor unitário: R$ 84,70
- Valor promocional e desconto seguem o padrão existente.
Este exemplo demonstra como restringir regras a campanhas específicas, evitando aplicações indevidas.