← Anterior: [Comissões](https://iurru.com/manual/Comissoes) · [Manual](https://iurru.com/manual/) · Próxima: [Preferências](https://iurru.com/manual/Preferencias)

# Fidelidade e alertas

**Menu:** Clientes → Fidelidade (config.) / Administração → Alertas (config.)

---

## Fidelidade

**Clientes → Fidelidade (config.)** — o **programa de pontos e cashback**.

Funciona em duas etapas separadas, que é importante não confundir:

1. **Ganhar pontos** — toda venda concluída com cliente vinculado (e fidelidade
   ativa) credita pontos automaticamente, na hora.
2. **Resgatar pontos** — o cliente (ou o operador, por ele) converte pontos
   acumulados em **saldo de cashback** (um valor em R$, separado dos pontos).
   Esse saldo de cashback é que pode ser usado como desconto numa compra
   futura, no PDV.

Ou seja: pontos não viram desconto sozinhos — primeiro é preciso resgatar
(transformar pontos em cashback), depois aplicar esse cashback numa venda.

### Configuração

| Campo | Efeito |
| --- | --- |
| **Programa ativo** | Liga/desliga o **ganho de pontos novos** para todos os clientes de uma vez. Resgate e uso de cashback já acumulado continuam funcionando mesmo desligado — só o crédito de pontos novos para |
| **Pontos por R$ 1,00 de compra** | Quantos pontos o cliente ganha a cada R$ 1,00 do total **líquido** da venda (já com desconto aplicado) — padrão: `1` |
| **Valor em R$ por ponto resgatado** | Quanto cada ponto vale em R$ ao ser resgatado — padrão: `R$ 0,01` (100 pontos = R$ 1,00) |
| **Validade dos pontos (dias)** | `0` = sem validade. Ver [Expirar pontos vencidos](#expirar-pontos-vencidos) — a regra é mais específica do que "cada ponto vence sozinho depois de X dias" |
| **% de cashback direto por compra** | **Este campo hoje não tem efeito nenhum** — fica salvo, mas nenhuma venda gera cashback automaticamente por ele. O único jeito de virar cashback é resgatando pontos manualmente (item acima). Deixe em `0` para não confundir a equipe |

### Fórmulas exatas

```
Pontos ganhos numa venda = arredonda pra baixo( total_líquido_da_venda × pontos_por_real )

Cashback gerado ao resgatar N pontos = arredonda( N × valor_por_ponto, 2 casas decimais )
```

**Exemplo com os valores padrão** (`1` ponto/R$, `R$ 0,01`/ponto): uma compra
de R$ 300,00 líquidos gera 300 pontos. Resgatando os 300 pontos, viram
R$ 3,00 de cashback — **1% de retorno**. Se quiser um retorno maior (ex.: 5%,
R$ 15 numa compra de R$ 300), aumente o **Valor em R$ por ponto resgatado**
pra `R$ 0,05` (mantendo 1 ponto por real) — o retorno percentual é sempre
`pontos_por_real × valor_por_ponto`.

### Expirar pontos vencidos

Botão **Expirar pontos vencidos**: roda a expiração conforme a validade
configurada. Quando não há nada a expirar, o sistema informa "Nenhum ponto
expirado (todos dentro da validade)."

A regra exata: um cliente perde **todo o saldo de pontos de uma vez** se
ficar **mais que a Validade configurada, em dias, sem nenhuma compra que
gere pontos e sem nenhum ajuste manual**. Não é uma expiração parcial por
lote (não é "os pontos da compra de janeiro vencem em janeiro do ano que
vem, os de fevereiro em fevereiro") — é olhar a **última movimentação de
ganho ou ajuste** do cliente; se ela for mais velha que a validade, zera
tudo que ele tinha acumulado até ali. O **saldo de cashback** (já
convertido em R$ por um resgate) não é afetado pela expiração — só pontos
ainda não resgatados vencem.

A expiração é **manual e explícita** — pontos não somem do saldo do cliente sem
que alguém tenha rodado a rotina (não há nenhuma tarefa agendada rodando isso
sozinha em segundo plano).

### Ativar/desativar por cliente

Além do interruptor geral acima, cada cliente tem seu próprio "Ativar" /
"Desativar" fidelidade (painel
[Fidelidade do cliente](https://iurru.com/manual/Clientes#fidelidade-do-cliente)). Desativar um
cliente específico **não apaga o saldo dele** — só bloqueia ganhar pontos
novos, resgatar ou aplicar cashback enquanto estiver desativado. Reativando,
o saldo antigo volta a ficar disponível, do jeito que estava.

### Ajuste manual

Quem tem permissão de gerenciar usuários (`config.users` — administrador ou
desenvolvedor, ver [Usuários e permissões](https://iurru.com/manual/Usuarios-e-permissoes#papéis))
pode corrigir o saldo de pontos de um cliente à mão, com um motivo escrito
(campo obrigatório na prática). Serve pra cortesia, correção de erro, ou
importação de saldo de outro sistema. O ajuste pode ser positivo ou
negativo; se o negativo for maior que o saldo atual, o saldo só vai a zero
(não fica negativo). O motivo digitado fica no histórico do cliente, mas o
sistema **não registra qual usuário fez o ajuste** — só a descrição.

### No dia a dia

- O saldo, o histórico e o resgate de cada cliente ficam no painel
  [Fidelidade do cliente](https://iurru.com/manual/Clientes#fidelidade-do-cliente).
- Na hora de pagar, o [PDV](https://iurru.com/manual/PDV#cashback-de-fidelidade) oferece o cashback
  disponível como abatimento.
- Movimentações são classificadas em **Ganho**, **Resgate**, **Ajuste** e
  **Expirado** — "Resgate" cobre dois casos parecidos: converter pontos em
  cashback, e gastar cashback numa venda. O histórico distingue os dois pela
  descrição de cada linha.

---

## Alertas de estoque

**Administração → Alertas (config.)**

| Campo | Efeito |
| --- | --- |
| **Ativar alertas de estoque mínimo** | Liga/desliga os avisos |
| **Percentual de antecipação (%)** | Quantos % acima do mínimo já disparam o aviso de "próximo do mínimo" |
| **Número WhatsApp para notificação** | Contato que recebe a notificação |

### Como calibrar a antecipação

O percentual de antecipação é o que separa "reagir tarde" de "ser bombardeado
por avisos":

- **0%** — só avisa quando o estoque já está no mínimo. Se o fornecedor demora
  10 dias, a peça falta.
- **20–30%** — o aviso chega com folga para comprar. Costuma ser o ponto de
  equilíbrio.
- **Muito alto** — tudo vira alerta, e alerta demais é o mesmo que alerta
  nenhum.

O **estoque mínimo** é definido produto a produto na
[ficha do produto](https://iurru.com/manual/Produtos#aba-geral). O mínimo certo depende do giro e do
prazo do fornecedor — a [Curva ABC](https://iurru.com/manual/Catalogo-apoio#curva-abc) ajuda a decidir
onde vale ser folgado.

### Onde os alertas aparecem

- [Sino de alertas](https://iurru.com/manual/Interface#sino-de-alertas), aba Estoque — com atalho para
  **criar pedido de compra**;
- [Painel inicial](https://iurru.com/manual/Painel-inicial), bloco *Estoque crítico (top 10)*.

---

← Anterior: [Comissões](https://iurru.com/manual/Comissoes) · [Manual](https://iurru.com/manual/) · Próxima: [Preferências](https://iurru.com/manual/Preferencias)
