Criar e acompanhar uma campanha de desconto
Uma campanha define o desconto; os códigos são a forma de distribuí-lo; os resgates são a prova de uso.
Passo a passo
- Descontos → Novo. Dê um nome que você reconheça no relatório meses depois.
- Escolha o sabor. Cupom exige que o cliente digite um código; Sem código aplica automaticamente quando as condições são atendidas.
- Escolha o tipo e o valor. Percentual, valor fixo ou preço fixo no item. Lembre-se: preço fixo só funciona em escopo de item.
- Defina o escopo (carrinho, atração, passaporte ou produto) e o alvo, quando aplicável.
- Configure as condições: teto de abatimento, valor mínimo do pedido, validade, uso total e usos por CPF.
- Salve a campanha.
-
Gere os códigos (exige
discounts.generate_codes). Eles são criados sem caracteres ambíguos e são únicos por empresa. - Teste antes de divulgar. Monte um carrinho de valor próximo ao mínimo e confirme que o desconto aparece — e que não aparece abaixo do mínimo.
- Distribua os códigos.
- Acompanhe em Descontos → Resgates e no relatório Uso de Cupons.
Quando o resgate é contabilizado
Cliente digita o códigoA tela mostra o abatimento
Servidor revalidaValidade, mínimo, escopo e limites
Venda criadaCom desconto e vínculo à campanha
Pagamento aprovadoAí sim o resgate é registrado
Carrinho abandonado não consome uso
O resgate só é gravado quando a venda é confirmada. Isso evita que um cupom de 100 usos “acabe” por causa de carrinhos que nunca viraram compra.
Quando o cupom não aplica
| Motivo | Onde conferir |
|---|---|
| Campanha inativa ou fora da validade | Status e datas da campanha |
| Total abaixo do valor mínimo | Campo “valor mínimo do pedido” |
| Limite de uso total atingido | Tela de Resgates (é a fonte de verdade) |
| Limite do código atingido | Lista de códigos da campanha |
| Limite por CPF atingido | Resgates filtrados por CPF |
| O carrinho não tem o alvo do escopo | Escopo e alvo da campanha |
| Outro desconto não acumulável entrou primeiro | Configuração de acúmulo das campanhas ativas |
O cupom sumiu no meio da compra — é proposital
Se o cliente muda o carrinho e o cupom deixa de ser elegível (por exemplo, remove um item e cai abaixo do mínimo), a loja para de enviar o código para não travar o pagamento. A compra segue pelo valor cheio, em vez de exibir um erro que impediria a venda.
Cancelamento e devolução do uso
| Situação | O que acontece com o resgate |
|---|---|
| Venda cancelada por completo | O resgate é revertido e o uso volta — o cupom volta a valer, se ainda estiver dentro da validade. |
| Estorno parcial | O resgate permanece; o uso não volta. |
Limitações conhecidas
- O campo “ignora promoção” é respeitado apenas na exibição. No cálculo que define o valor cobrado, o desconto incide também sobre itens promocionais.
- O desconto manual do PDV não gera linha de resgate — ele não aparece no relatório de uso de cupons. Para medir desconto de balcão, use o relatório de Descontos e Cortesias.
Boas práticas
- Sempre defina validade — campanha sem data vira desconto permanente por esquecimento.
- Use teto de abatimento em percentuais sobre carrinhos grandes.
- Use limite por CPF em campanhas de aquisição.
- Acompanhe os resgates durante a campanha, não só no fim.