Programa de Fidelidade — Regras de Pontuação por Avaliações

O Programa de Fidelidade permite conceder pontos aos clientes quando eles realizam uma avaliação de um produto ou pedido.

O cálculo da pontuação pode ocorrer por três regras distintas:

Divisor
Valor Fixo
Percentual

As regras são configuradas em:

Configurações → Programa de Fidelidade → Programa de Avaliação

Configurações Disponíveis

Tipo de Regra	Campo de Configuração	Condição de Utilização
Divisor	Divisor Pontos Avaliação (`divisor_avaliacao`)	Quando `divisor_avaliacao` for maior que `0`.
Valor Fixo	Valor Fixo Pontos Avaliação	Quando o divisor não estiver configurado e a opção selecionada for Valor Fixo.
Percentual	Percentual Pontos Avaliação	Quando o divisor não estiver configurado e a opção selecionada for Percentual.

Clique para ampliar.

Prioridade das Regras

Importante
O sistema não utiliza apenas a opção selecionada no campo "Utilizar regra de divisor, valor fixo ou percentual".
Existe uma ordem de prioridade entre as regras.

A lógica aplicada é a seguinte:

Verifica se existe um Divisor configurado.
Caso exista, a regra de divisor é utilizada.
Somente quando não existir divisor válido o sistema utiliza a opção escolhida no combo (Valor Fixo ou Percentual).

Regra 1 — Divisor

A regra de divisor possui prioridade máxima.

Sempre que o campo Divisor Pontos Avaliação possuir um valor maior que zero (divisor_avaliacao > 0), esta será a regra aplicada.

Neste cenário:

a configuração Valor Fixo é ignorada;
a configuração Percentual também é ignorada;
o valor selecionado no combo não interfere no cálculo.

Regra 2 — Valor Fixo

A regra de Valor Fixo somente é utilizada quando:

divisor_avaliacao estiver igual a 0, nulo ou não configurado;
a opção selecionada for Valor Fixo.

Neste modo, todos os clientes recebem exatamente a quantidade de pontos configurada, independentemente do valor da compra.

Regra 3 — Percentual

A regra Percentual somente é utilizada quando:

não existir divisor configurado;
a opção selecionada for Percentual.

Nesse caso, o sistema calcula um percentual sobre os pontos-base da compra.

Quando Nenhuma Regra é Aplicada

Caso nenhuma das condições anteriores seja atendida, o sistema retorna:

0 pontos

Consequência Prática

Uma situação comum é alterar a configuração para Valor Fixo ou Percentual e não observar nenhuma alteração na pontuação.

Isso ocorre porque o campo Divisor Pontos Avaliação continua preenchido.

Enquanto esse campo possuir um valor maior que zero, ele sempre terá prioridade sobre as demais configurações.

Para utilizar Valor Fixo ou Percentual

É necessário definir:

Divisor Pontos Avaliação = 0

ou deixar o campo sem valor.

Somente após isso o sistema passará a utilizar a opção selecionada no combo.

Conversão de Dinheiro para Pontos

As regras Divisor e Percentual utilizam a mesma base de cálculo.

Antes da aplicação da regra, o sistema converte o valor da compra em pontos utilizando o multiplicador do Programa de Fidelidade.

Fórmula

pontos = (valor_da_compra) × multiplicador

Onde:

valor_da_compra: valor total considerado para pontuação.
multiplicador: configuração Multiplicador Dinheiro/Pontos.

Exemplo

Valor da compra:

R$ 100,00

Multiplicador:

Resultado:

pontos = (100) × 1
pontos = 100 pontos

Exemplos de Cálculo

1. Regra por Divisor

Configuração

Divisor Pontos Avaliação = 10

Cálculo

pontos = 100

pontos = (100 ÷ 10)

Resultado: 10 pontos

2. Regra por Valor Fixo

Configuração

Valor Fixo Pontos Avaliação = 5

Resultado

pontos_avaliacao = 5 pontos

Nesta modalidade, o valor da compra não influencia na quantidade de pontos.

3. Regra por Percentual

Configuração

Percentual Pontos Avaliação = 10%

Cálculo

pontos = 100

pontos_avaliacao = (100 × (10 ÷ 100))

Resultado: 10 pontos

Fluxo da Lógica

Início
   │
   ▼
Existe divisor (> 0)?
   │
 ┌─┴─────────────┐
 │               │
Sim             Não
 │               │
 ▼               ▼
Utiliza       Verifica
Divisor       opção do combo
 │               │
 │         ┌─────┴─────────┐
 │         │               │
 │     Valor Fixo     Percentual
 │         │               │
 ▼         ▼               ▼
Fim     Retorna      Calcula percentual
        valor fixo   sobre os pontos-base

Resumo

A prioridade das regras segue obrigatoriamente a seguinte ordem:

Divisor (caso esteja configurado).
Valor Fixo (quando não existir divisor).
Percentual (quando não existir divisor).
0 pontos, caso nenhuma regra seja válida.

Em outras palavras, a configuração de Divisor sempre prevalece sobre as demais, independentemente da opção selecionada no campo "Utilizar regra de divisor, valor fixo ou percentual".