Fidelidade - Gestão de Resgates

O que é

A página Gestão de Resgates centraliza todas as solicitações em que clientes trocaram pontos do programa de fidelidade por recompensas (cupons de desconto, brindes físicos, upgrades ou outros itens cadastrados em Recompensas). Cada resgate registra qual recompensa foi escolhida, quantos pontos foram gastos e, quando aplicável, o código de cupom gerado automaticamente.

O administrador chega aqui sempre que precisa processar um resgate pendente - seja para confirmar que o brinde foi entregue ao cliente, seja para cancelar uma solicitação que não pode ser atendida (devolvendo os pontos, restaurando estoque e desativando o cupom emitido).

Como usar

1. Vá em Modulos > Programa de Fidelidade no sidebar e abra a opção Resgates dentro do submenu de fidelidade.
2. Use o campo Buscar por cliente ou recompensa... para localizar uma solicitação específica pelo nome do cliente ou pelo nome da recompensa.
3. Para focar no que precisa de ação, abra o select Status e escolha Pendentes. Os resgates são exibidos em ordem decrescente pela data de criação.
4. Cada item da lista mostra:
   • Recompensa resgatada (título da linha).
   • Cliente que fez o resgate (subtítulo).
   • Badges de status (Pendente, Entregue ou Cancelado), tipo da recompensa, pontos gastos e, se houver, código do cupom gerado.
   • Data do pedido e, quando processado, data de entrega e observação.
5. Para processar uma solicitação pendente, abra o dropdown de ações (ícone à direita do item) e escolha:
   • Marcar como entregue - confirma a entrega. Você pode registrar uma observação interna sobre a operação.
   • Cancelar resgate - abre o modal Cancelar Resgate, onde é obrigatório informar o motivo do cancelamento antes de confirmar.

Casos especiais

Cancelamento de resgate já entregue

O cancelamento funciona para resgates em qualquer status diferente de Cancelado. Ao cancelar um resgate que já estava marcado como Entregue, o sistema ainda devolve os pontos ao cliente, restaura o estoque da recompensa e desativa o cupom (se houver). Use com cautela quando o benefício já foi usufruído pelo cliente.

Resgate de recompensa do tipo cupom

Quando a recompensa é um cupom de desconto, o sistema cria automaticamente o código e exibe o badge azul com o código gerado ao lado dos demais badges. Ao cancelar um resgate desse tipo, o cupom é desativado automaticamente para impedir o uso posterior.

Recompensa removida do catálogo

Se a recompensa associada ao resgate foi excluída do catálogo, o título do item passa a exibir Recompensa removida. O histórico do resgate continua acessível, mas perde a referência ao tipo e detalhes originais.

Lista vazia

Quando nenhum cliente fez resgates ainda, a página mostra o estado vazio Nenhum resgate registrado com a mensagem orientando que os itens vão aparecer conforme os clientes trocarem pontos por recompensas no portal do cliente ou site público.

Erros comuns e como resolver

• "Este resgate ja foi processado." - Causa: tentativa de marcar como entregue um resgate que não está mais com status Pendente (já foi entregue ou cancelado). Solução: atualize a página e verifique o status atual; o dropdown de ações só aparece para pendentes.
• "Este resgate ja foi cancelado." - Causa: tentativa de cancelar um resgate que já está com status Cancelado. Solução: nenhuma ação necessária - os pontos já foram devolvidos na primeira operação.
• Campo "Motivo do cancelamento" obrigatório - Causa: envio do modal Cancelar Resgate com o campo de motivo vazio. Solução: descreva em até 255 caracteres o motivo do cancelamento; ele fica salvo na observação do resgate e pode ser consultado depois.

Onde encontrar

• URL: /admin/fidelidade/resgates
• Caminho no menu: Modulos > Programa de Fidelidade > Resgates
• Permissão necessária: ver a fidelidade para visualizar; editar a fidelidade para marcar como entregue ou cancelar
• Módulo necessário: Fidelidade (precisa estar ativo no plano da sua empresa)

Veja também

• Recompensas - Catálogo de itens que podem ser resgatados
• Clientes da Fidelidade - Saldo de pontos e histórico por cliente
• Dashboard Fidelidade - Visão geral do programa
• Configuração da Fidelidade - Ativar e configurar o programa