Fidelidade - Regras de Acúmulo

O que é

A página de Regras de Acúmulo controla como os seus clientes ganham pontos no programa de fidelidade. Cada regra combina um evento gatilho (por exemplo, uma compra, uma excursão concluída ou um aniversário) com uma fórmula de pontuação - fixa ou proporcional a um valor em reais. É aqui que o operador decide, na prática, quantos pontos cada ação do cliente vale.

O operador chega nesta tela logo após habilitar o módulo Programa de Fidelidade e definir o nome da moeda na Configuração. Sem nenhuma regra ativa, nenhum cliente acumula pontos, mesmo que o restante do programa esteja configurado.

Como usar

1. Vá em Fidelidade > Regras de Acúmulo no menu lateral. A página lista todas as regras ordenadas pelo campo Ordem e, em seguida, pelo tipo.
2. Para criar uma regra nova, clique em Nova Regra (botão violeta no canto superior direito). Se nenhuma regra existir ainda, use o botão Criar primeira regra no estado vazio.
3. Preencha o formulário Configuração da Regra:
   • Tipo de Regra - evento que dispara o ganho de pontos. Valores aceitos: Compra, Excursão Concluída, Primeira Compra, Aniversário, Indicação, Avaliação NPS e Recorrência.
   • Modo de Cálculo - escolha entre Proporcional (a cada R$ X), em que os pontos são multiplicados pelo valor gasto, ou Fixo (valor único), em que o cliente ganha sempre a mesma quantidade ao disparar o evento.
   • Quantidade de Pontos - número inteiro maior ou igual a 1. Define quantos pontos são creditados por unidade do critério.
   • Valor de Referência (R$) - só aparece quando o modo é Proporcional. É o valor em reais que, a cada múltiplo, gera a Quantidade de Pontos definida acima.
4. No bloco Detalhes, configure:
   • Descrição - texto obrigatório de até 255 caracteres mostrado na lista e nos extratos. Exemplo: "Ganhe 10 pontos a cada R$ 50,00 gastos".
   • Ordem de Exibição - número inteiro a partir de 0 que controla a posição na listagem (menores aparecem primeiro).
   • Regra ativa - toggle violeta. Quando desligado, a regra fica salva mas não credita pontos.
5. Acompanhe o bloco Preview da regra (área roxa abaixo do formulário), que monta automaticamente a frase final conforme tipo, modo e valores selecionados.
6. Confirme em Salvar no rodapé. A página volta para a listagem com a mensagem "Regra de acúmulo criada com sucesso!" (criação) ou "Regra atualizada com sucesso!" (edição).

Casos especiais

Regra fixa (sem valor em reais)

Quando Modo de Cálculo é Fixo (valor único), o campo Valor de Referência (R$) desaparece do formulário e é gravado como vazio no banco. Use esse modo para eventos pontuais como Aniversário, Primeira Compra ou Indicação, em que faz sentido sempre dar a mesma pontuação independentemente do valor gasto.

Múltiplas regras para o mesmo evento

Nada impede ter duas ou mais regras com o mesmo Tipo. O campo Ordem de Exibição controla a sequência em que aparecem na lista. Combine isso com o toggle Regra ativa para alternar entre regras sazonais (ex.: dobrar pontos em uma campanha) sem precisar excluir a regra padrão.

Desligar temporariamente em vez de excluir

Para suspender uma regra por um período sem perder a configuração, abra a regra em Editar e desligue o toggle Regra ativa. A regra continua na listagem com o badge vermelho Inativa e não credita pontos enquanto estiver nesse estado.

Excluir uma regra

Use o item Excluir no menu de três pontos da linha. O sistema abre o modal padrão de confirmação de exclusão exibindo a descrição da regra. Após confirmar, a regra é removida e a mensagem "Regra excluída com sucesso!" aparece no topo. A exclusão é definitiva - recadastre se precisar dela novamente.

Erros comuns e como resolver

• "O campo tipo é obrigatório." - Causa: o seletor Tipo de Regra ficou em "Selecione...". Solução: escolha um dos sete tipos disponíveis antes de salvar.
• "O campo valor pontos deve ser pelo menos 1." - Causa: o campo Quantidade de Pontos foi enviado vazio, com zero ou número negativo. Solução: informe um inteiro maior ou igual a 1.
• "O campo valor referência deve ser pelo menos 0.01." - Causa: modo Proporcional (a cada R$ X) selecionado sem preencher o Valor de Referência (R$) ou com valor menor que R$ 0,01. Solução: preencha um valor em reais com pelo menos dois centavos, ou troque o modo para Fixo (valor único).
• "O campo descrição é obrigatório." - Causa: campo Descrição vazio. Solução: escreva uma frase curta (até 255 caracteres) que ajude você e os clientes a identificarem a regra.
• A regra foi criada mas nenhum cliente está ganhando pontos - Causa: a regra foi salva com Regra ativa desligada (badge vermelho Inativa na lista). Solução: abra em Editar e ligue o toggle Regra ativa.

Onde encontrar

• URL: /admin/fidelidade/regras
• Caminho no menu: Fidelidade > Regras de Acúmulo
• Permissão necessária: ver a fidelidade para visualizar a lista; editar a fidelidade para criar, editar ou excluir
• Módulo necessário: Programa de Fidelidade (fidelidade)

Veja também

• Fidelidade - Visão Geral
• Configuração do Programa de Fidelidade
• Níveis do Programa
• Recompensas
• Indicações