Cupons de desconto

Cupons são códigos que o cliente digita no carrinho ou checkout para ganhar desconto. Diferente das promoções, os cupons são aplicados de ponta a ponta: criar, validar, descontar e contar usos. Ficam em Gestão → Marketing → Cupons.

Criando um cupom

Clique em Novo Cupom. O formulário é dividido em 4 abas para não assustar quem está começando:

Aba Geral

• Código - o que o cliente digita (ex.: DESCONTO10). É convertido automaticamente para maiúsculas e é único por loja.
• Descrição - anotação interna, só você vê.
• Tipo - escolha entre:
  • Percentual - abate um % do total (ex.: 10%).
  • Valor fixo (R$) - abate um valor em reais (ex.: R$ 25,00).
  • Frete grátis - zera o frete na hora do checkout.
• Cupom ativo - switch para ligar/desligar sem precisar excluir.

Aba Valor

• Valor - o percentual (0 a 100) ou o valor em reais. Cupons do tipo "Frete grátis" não pedem valor.
• Valor mínimo do pedido - o cupom só pode ser aplicado se o subtotal atingir esse valor (opcional).

Aba Limites

• Uso máximo (total) - quantas vezes o cupom pode ser usado no total (deixe em branco para ilimitado).
• Uso máximo por cliente - quantas vezes cada cliente pode usar o mesmo cupom (default: 1).

Aba Período

• Data de início e Data de fim - opcionais. Sem datas, o cupom vale por tempo indeterminado. Ambas datas iguais valem para o dia inteiro.

Status de cada cupom

A tabela mostra o status calculado automaticamente:

• Ativo - pode ser usado agora.
• Inativo - switch desligado.
• Agendado - data de início ainda não chegou.
• Expirado - passou da data de fim.
• Esgotado - bateu o uso máximo total.

Buscando e gerenciando

A busca filtra por código (digitação com debounce, sem precisar apertar enter). O ícone de lápis edita; o ícone de lixeira desativa o cupom - não exclui de verdade, preservando o histórico de uso nos pedidos.

Como o cupom é aplicado

Quando o cliente digita o código no carrinho ou checkout, o sistema valida 7 condições antes de aceitar: existência, ativo, dentro do período, dentro do limite global, dentro do limite por cliente e atende ao valor mínimo do pedido. A validação acontece de novo no servidor no momento do pagamento - não dá para burlar.

Dúvidas comuns

Posso reutilizar um código que já desativei?
Não no mesmo cupom - em vez disso, edite o cupom original e ative novamente.

O cupom desconta antes ou depois do frete?
Percentual e valor fixo abatem do subtotal (produtos). Cupom de frete grátis zera o frete sem mexer no subtotal.

Onde fica esse menu?
Sidebar: Gestão → Marketing → Cupons.