Fidelidade - Recompensas

O que é

A página Catalogo de Recompensas e o local onde você monta a vitrine de beneficios que os clientes inscritos no programa de fidelidade podem trocar pelos pontos acumulados. Cada item desta lista vira uma opção visivel para o cliente final no portal de fidelidade e gera um pedido na página de Resgates quando solicitado.

O usuário normalmente chega aqui depois de configurar o programa de fidelidade (moeda de pontos, regras de acumulo e niveis) para entao publicar as primeiras recompensas. Também e o ponto de retorno sempre que for criar campanhas sazonais, desativar premios sem estoque ou ajustar o custo em pontos.

Como usar

1. Va em Modulos > Programa de Fidelidade > Recompensas no sidebar.
2. Clique em Nova Recompensa (botao roxo no canto superior direito da página, ao lado da contagem do catalogo).
3. No card Dados da Recompensa, preencha:
   • Nome da Recompensa - texto curto (ate 100 caracteres) que aparece para o cliente. Ex.: "Cupom 10% de desconto".
   • Descrição - texto opcional (ate 500 caracteres) com detalhes do beneficio.
   • Tipo de Recompensa - escolha entre Desconto Percentual, Desconto em Valor Fixo, Desconto por Passageiro, Brinde / Experiência ou Upgrade. O tipo define quais campos seguintes aparecem.
   • Custo em {moeda do programa} - quantos pontos o cliente paga para resgatar. O nome da moeda segue a configuração do programa (ex.: "Pontos", "Milhas", "Estrelas").
   • Valor do Desconto - aparece apenas para os tres tipos de desconto. Em Desconto Percentual o valor e em %, nos demais em R$.
   • Validade do Cupom (dias) - aparece apenas para tipos de desconto. Padrão 30, máximo 365.
4. No card Configurações, ajuste:
   • Estoque - quantidade total disponível. Deixe vazio para estoque ilimitado.
   • Nivel Mínimo - se ja houver tiers cadastrados, restringe a recompensa a clientes daquele nivel ou acima. Use "Todos os niveis" para liberar para qualquer cliente.
   • Ordem de Exibicao - número inteiro que ordena o catalogo do menor para o maior.
   • Recompensa ativa - toggle roxo. Quando desligado, a recompensa some do catalogo do cliente mas continua salva.
5. Confirme em Salvar no rodape da página.

Para editar, clique no nome da recompensa na lista (ou em Editar no dropdown de ações). Para excluir, use Excluir no mesmo dropdown.

Casos especiais

Tipos de desconto x demais tipos

Os campos Valor do Desconto e Validade do Cupom so são salvos quando o tipo escolhido for Desconto Percentual, Desconto em Valor Fixo ou Desconto por Passageiro. Se você trocar para Brinde / Experiência ou Upgrade, o sistema ignora esses campos automaticamente - para essas modalidades a entrega e operacional, registrada no fluxo de Resgates.

Estoque ilimitado

Deixar o campo Estoque em branco marca a recompensa como ilimitada (sem controle de saldo). Quando preenchido, cada resgate aprovado diminui o estoque e a recompensa some do catalogo publico ao chegar em zero.

Restricao por nivel

Se o programa ainda não tem niveis cadastrados, o campo Nivel Mínimo nem aparece no formulario. Após criar tiers em Niveis do Programa, retorne aqui para restringir recompensas premium aos clientes de nivel mais alto.

Recompensa desativada mas mantida

Desligar o toggle Recompensa ativa preserva o histórico de resgates e permite reativar a recompensa depois sem precisar recadastrar. Util para campanhas sazonais.

Erros comuns e como resolver

• "Não e possível excluir uma recompensa que ja possui resgates." - Causa: existe ao menos um resgate (pendente, aprovado ou rejeitado) vinculado a esta recompensa. Solucao: em vez de excluir, desligue o toggle Recompensa ativa para retira-la do catalogo sem perder o histórico.
• Campo Valor do Desconto vazio com tipo de desconto selecionado - Causa: o tipo escolhido exige valor mínimo de 0,01. Solucao: preencha o valor antes de salvar.
• Custo em pontos zerado ou negativo - Causa: o sistema exige inteiro maior ou igual a 1. Solucao: informe ao menos 1 ponto de custo.
• Recompensa não aparece para o cliente - Causa: toggle Recompensa ativa desligado, estoque zerado ou cliente abaixo do Nivel Mínimo configurado. Solucao: verifique cada uma destas condicoes na lista (o badge Inativa aparece em cinza quando desligada).

Onde encontrar

• URL: /admin/fidelidade/recompensas
• Caminho no menu: Modulos > Programa de Fidelidade > Recompensas
• Permissão necessária: ver a fidelidade para visualizar, editar a fidelidade para criar, editar ou excluir
• Módulo necessário: Fidelidade

Veja também

• Regras de Acumulo - define quantos pontos cada compra gera para os clientes resgatarem.
• Niveis do Programa - configura tiers usados no campo Nivel Mínimo das recompensas.
• Resgates - fluxo de aprovacao e entrega dos pedidos gerados pelo catalogo.
• Configuração do Programa - define o nome da moeda de pontos exibido no formulario.