Cupons de desconto
🛂 Permissões:
coupon.view,coupon.create,coupon.edit,coupon.delete📍 Caminho: Clientes & Vendas → Cupons de Desconto
Cupons são códigos que o cliente digita no carrinho/checkout para receber um desconto. Diferentes da promoção (automática), o cupom exige ação do cliente — por isso é a ferramenta certa para campanhas direcionadas, primeira compra, recuperação de carrinho ou comissão de vendedor.
Tipos suportados
| Tipo | Descrição |
|---|---|
| PERCENTAGE | Desconto percentual (ex.: 10 = 10% off). |
| FIXED_AMOUNT | Desconto fixo em R$ (ex.: 50 = R$ 50 off). |
| FREE_SHIPPING | Frete grátis (em desenvolvimento — confirmar disponibilidade no painel). |
Campos disponíveis
| Campo | Descrição |
|---|---|
| Código | Texto que o cliente digita (armazenado em maiúsculas). Único por tenant. |
| Tipo | PERCENTAGE / FIXED_AMOUNT / FREE_SHIPPING. |
| Valor | 0–100 para PERCENTAGE; valor em R$ para FIXED_AMOUNT. |
| Compra mínima | Subtotal mínimo para o cupom valer (ex.: aplicar só em pedidos > R$ 200). |
| Desconto máximo | Teto para cupons percentuais (ex.: 10% até R$ 50). |
| Limite total de usos | Quantas vezes o cupom pode ser usado no total (NULL = ilimitado). |
| Limite por cliente | Quantas vezes o mesmo cliente pode usar (ex.: 1 = só primeira compra). |
| Válido a partir de | Data/hora de início. |
| Válido até | Data/hora de término. |
| Status | ACTIVE / INACTIVE / EXPIRED. |
| Descrição | Texto curto interno (não exibido ao cliente). |
Como criar
- Em Clientes & Vendas → Cupons de Desconto, clique em Novo Cupom.
- Preencha os campos acima.
- Salve.
Como o cliente usa
- Na loja online, o campo "Cupom" aparece no carrinho e no checkout.
- O sistema valida em tempo real: data, status, limite total, limite por cliente, compra mínima.
- O desconto aparece como linha separada no resumo do pedido.
Vinculando um cupom a um vendedor (comissão)
Em Clientes & Vendas → Comissões → aba Cupons, é possível associar um cupom a um vendedor. Quando um cliente usa esse cupom, a comissão do pedido é creditada automaticamente para o vendedor — mesmo que o pedido tenha vindo da loja online.
Detalhes em Comissões.
Como acompanhar
- A coluna Usos na listagem mostra
current_usage_count. - Quando o cupom expira ou bate o limite, o status passa para EXPIRED automaticamente.
Boas práticas
- Use códigos curtos, fáceis de digitar e relacionados à campanha (
BOASVINDAS10,FRETE2025). - Combine compra mínima com % off para proteger margem.
- Use limite por cliente = 1 para promoções de aquisição ("primeira compra").
- Para influencers, gere um cupom vinculado ao vendedor — assim a comissão é automática.
- Não dependa exclusivamente de cupom para divulgar preço — combine com promoção (automática) ou banner.
Cupom vs. Promoção
| Pergunta | Use promoção | Use cupom |
|---|---|---|
| Preciso atingir todo mundo automaticamente | ✅ | |
| Preciso de código que só "iniciados" usam | ✅ | |
| Quero limitar por cliente | ✅ | |
| Quero vincular a vendedor para comissão | ✅ | |
| Estou queimando estoque sazonal | ✅ |
Promoção e cupom podem ser usados juntos: a promoção define o preço de tela; o cupom aplica desconto adicional sobre o subtotal.