Programa de fidelidade por pontos (cashback)

Cliente acumula pontos automaticamente quando o atendimento é concluído e troca por desconto na próxima comanda. Independente do Programa de fidelidade por visitas (a cada N visitas, ganha algo) — você pode ligar os dois ao mesmo tempo.

Como configurar

Em Configurações > Programa de pontos (cashback), liga o toggle e ajusta:

• Pontos por R$ gasto — quanto o cliente ganha por real no atendimento. Default: 1 ponto/real.
• Centavos por ponto — quanto cada ponto vale na hora de trocar. Default: 5 centavos (= R$ 0,05/ponto).
• A combinação dos dois define o cashback efetivo — a UI mostra a porcentagem em tempo real (1pt × R$ 0,05 = 5% de retorno).
• Validade dos pontos — em dias. Default 365. Use 0 pra "sem validade". Cron diário (03:50) marca pontos vencidos e gera lançamento de expiração no histórico.
• Pontos mínimos por resgate — evita resgates muito pequenos. Default 100.
• Desconto máximo (%) — limite do total da comanda que pode virar desconto. Default 50%. Protege contra comandas zeradas.

Como o cliente acumula

Quando você muda o status do agendamento pra Concluído, o sistema aplica EARN automaticamente com base no totalCents (líquido de cupom e de qualquer resgate de pontos já feito — você não ganha pontos sobre desconto).

Se você reverter o status (ex.: marcou como concluído por engano), o sistema gera lançamento de reverso pareado, zerando os pontos ganhos. A trilha fica registrada no histórico do cliente.

Como o cliente resgata

Na ficha do agendamento, o card Fidelidade — pontos mostra o saldo do cliente, o máximo permitido nesse atendimento (já considerando o cap de %) e o campo pra digitar quantos pontos usar. Confirmar gera o desconto na hora — separado do desconto de cupom pra DRE diferenciar as duas alavancas.

Pra remover um resgate aplicado por engano, o botão Remover resgate só aparece enquanto o agendamento não foi concluído (após COMPLETED, o histórico fica imutável pra preservar relatórios).

Saldo do cliente

Na ficha do cliente (Clientes > abrir), o card Pontos de fidelidade mostra:

• Saldo atual + valor estimado em R$ (= pontos × centsPerPoint).
• Histórico paginado (últimas 30 entradas) com tipo (Ganho / Resgate / Vencimento / Reverso / Ajuste / Bônus indicação) e quando cada movimentação aconteceu.
• Botão Ajustar (Owner/Admin) pra adicionar ou subtrair pontos manualmente — útil pra correção, bônus de boas-vindas ou compensação. Motivo é obrigatório (vai pro histórico).

Portal do cliente final

O cliente também vê o saldo no portal mágico (link via WhatsApp). A seção Pontos de fidelidade mostra o número de pontos + valor estimado em desconto. O resgate é feito pela recepção, não pelo cliente direto — V1 não permite auto-serviço pra evitar confusão na hora de aplicar.