Cupons - Criar Cupom

O que é

A página Novo Cupom cria um cupom de desconto a partir de um assistente visual de quatro etapas: Tipo do Cupom, Tipo de Desconto, Configurações e Restrições. Cada etapa é validada antes de liberar o avanço, e só na última o cupom é efetivamente gravado.

O usuário normalmente chega aqui pelo botão Novo Cupom dentro da listagem de cupons em Marketing > Cupons, depois de planejar uma campanha promocional ou ao receber um pedido pontual de desconto para uma excursão. O cupom criado fica imediatamente disponível na listagem e - se o status estiver como ativo e dentro da validade - pode ser usado no checkout.

Como usar

1. Vá em Marketing > Cupons no sidebar e clique em Novo Cupom.

2. Etapa 1 - Tipo do Cupom. Escolha um dos cinco cartões:

   • Cupom Público - código compartilhável para campanhas de marketing.
   • Uso Único - código que só pode ser usado uma vez.
   • Por Cliente - vinculado a um cliente específico.
   • Primeira Compra - válido apenas para clientes sem inscrições anteriores.
   • Indicação - recompensa por indicar amigos. Clique em Próximo.

3. Etapa 2 - Tipo de Desconto. Escolha um dos quatro cartões:

   • Percentual - porcentagem do valor total.
   • Valor Fixo - abate um valor fixo do total.
   • Por Passageiro - valor fixo multiplicado pela quantidade de passageiros.
   • Taxa Grátis - isenção da taxa de serviço. Para qualquer tipo diferente de Taxa Grátis aparece a opção Definir valor máximo de desconto (teto) - marque se quiser limitar o desconto absoluto em cima do percentual. Clique em Próximo.

4. Etapa 3 - Configurações. Preencha:

   • Código do Cupom - opcional. Se deixar vazio, o sistema gera um código aleatório no envio. O botão com ícone de seta circular ao lado do campo também gera um código sob demanda. O valor digitado é salvo em maiúsculas e precisa ser único.
   • Nome do Cupom - obrigatório, identificação interna (ex.: "Promoção de Verão").
   • Descrição - texto livre interno.
   • Valor do Desconto - obrigatório quando o tipo não é Taxa Grátis. Aceita vírgula e cifrão; é convertido para número no servidor.
   • Valor Máximo de Desconto - só aparece se a opção de teto foi marcada na etapa anterior.
   • Limite total de usos - opcional; vazio significa ilimitado.
   • Limite por cliente - opcional; padrão sugerido é 1.
   • Valor mínimo do pedido - opcional; vazio significa sem mínimo.
   • Data de Início - opcional; vazio significa início imediato.
   • Data de Expiração - opcional; vazio significa sem expiração. Clique em Próximo.

5. Etapa 4 - Restrições. Configure:

   • Restrições de Excursões - escolha entre Todas as excursões, Apenas excursões selecionadas (multi-select de excursões permitidas) ou Excluir excursões selecionadas (multi-select de excursões bloqueadas).
   • Apenas primeira compra - checkbox que restringe o cupom a clientes sem inscrições anteriores.
   • Ativar Cupom - toggle verde no final do formulário. Quando ligado, o cupom já pode ser usado.

6. Clique em Criar Cupom (botão verde no rodapé). O sistema valida campos obrigatórios, gera o código automaticamente se necessário e redireciona para a página de detalhes do cupom recém-criado.

Casos especiais

Código vazio: geração automática

Se o campo Código do Cupom for enviado vazio, o servidor chama CupomCodeGenerator::generate() e cria um código aleatório com 8 caracteres. Útil para cupons de uso único em volume ou quando o nome da campanha é genérico.

Tipo de desconto "Taxa Grátis"

Quando Tipo de Desconto é Taxa Grátis, os campos Valor do Desconto e Valor Máximo de Desconto somem da tela. O servidor ainda exige valor_desconto numérico maior ou igual a zero - o formulário envia 0 automaticamente nesse caso.

Limite por cliente versus limite total

O Limite total de usos controla quantas vezes o cupom pode ser usado somando todos os clientes; o Limite por cliente controla quantas vezes o mesmo cliente pode usar. Para cupons públicos de campanha, o padrão recomendado é Limite por cliente = 1 e Limite total maior ou vazio.

Restrições combinadas com tipo "Primeira Compra"

Se na etapa 1 foi escolhido Primeira Compra, marcar também Apenas primeira compra na etapa 4 é redundante mas não causa erro. A regra mais restritiva prevalece.

Erros comuns e como resolver

• "O nome do cupom é obrigatório." - Causa: campo Nome do Cupom vazio na etapa 3. Solução: preencha um nome interno antes de avançar.
• "O valor do desconto é obrigatório." - Causa: tipo de desconto diferente de Taxa Grátis sem Valor do Desconto preenchido. Solução: informe o valor numérico (use vírgula para decimais).
• "O valor do desconto deve ser maior que zero." - Causa: digitou 0 ou um valor negativo. Solução: informe valor positivo.
• "A data de expiração deve ser igual ou posterior à data de início."
  • Causa: Data de Expiração anterior à Data de Início. Solução: ajuste a janela de validade.
• "Este código já está em uso." - Causa: o Código do Cupom informado já existe em outro cupom da sua empresa. Solução: escolha outro código ou deixe vazio para gerar automaticamente.
• "Selecione o tipo do cupom." / "Selecione o tipo de desconto."
  • Causa: o formulário foi enviado sem completar uma das etapas iniciais. Solução: volte e selecione um cartão em cada etapa.

Onde encontrar

• URL: /admin/marketing/cupons/create
• Caminho no menu: Marketing > Cupons > Novo Cupom
• Permissão necessária: criar os cupons
• Módulo necessário: nenhum

Veja também

• Cupons de Desconto
• Editar Cupom