Cupons - Editar Cupom

O que é

A página Editar Cupom carrega um cupom já cadastrado e exibe um formulário único - sem etapas - com todos os campos editáveis agrupados em cinco blocos: Informações Básicas, Limites de Uso, Período de Validade, Restrições e Status do Cupom. Ao salvar, o controller aplica um PUT direto na rota /admin/marketing/cupons/{id} e redireciona para a página de detalhes do cupom.

O usuário costuma chegar aqui pelo botão Editar na listagem de cupons, após Duplicar um cupom (o sistema redireciona automaticamente para a edição da cópia) ou para pausar uma promoção alterando apenas o toggle de status. Diferente do assistente de criação, aqui todos os campos ficam visíveis ao mesmo tempo, facilitando ajustes pontuais como estender a validade ou trocar o valor do desconto.

Como usar

1. Vá em Marketing > Cupons no sidebar e localize o cupom desejado na listagem.
2. Clique em Editar no rodapé do cartão do cupom (ou em Editar dentro do dropdown de três pontinhos).
3. No bloco Informações Básicas, ajuste o que for necessário:
   • Código do Cupom - texto livre, salvo em maiúsculas. Deixar vazio não regenera o código: o servidor mantém o código original do cupom nesse caso.
   • Nome do Cupom - obrigatório, identificação interna.
   • Descrição - texto livre interno (até 1000 caracteres).
   • Tipo do Cupom - alterne entre Publico, Uso Único, Por Cliente, Primeira Compra ou Indicacao.
   • Tipo de Desconto - alterne entre Percentual, Valor Fixo, Por Passageiro ou Taxa Gratis. O símbolo ao lado do campo de valor muda automaticamente entre % e R$ conforme a escolha.
   • Valor do Desconto - aceita vírgula e cifrão; é convertido para número no servidor.
   • Valor Máximo de Desconto - opcional. Vazio significa sem teto.
4. No bloco Limites de Uso, ajuste:
   • Limite total de usos - vazio significa ilimitado.
   • Limite por cliente - quantas vezes o mesmo cliente pode aplicar.
   • Valor mínimo do pedido - vazio significa sem mínimo.
5. No bloco Período de Validade, ajuste Data de Início e Data de Expiração (datepickers com hora). Vazio em Início significa início imediato; vazio em Expiração significa sem expiração.
6. No bloco Restrições, edite as Excursões Permitidas no multi-select (vazio = todas as excursões liberadas) e marque/desmarque Apenas primeira compra se quiser restringir a clientes sem inscrições anteriores.
7. No bloco Status do Cupom, use o toggle verde para ativar ou desativar o cupom. Inativo bloqueia novas aplicações mas preserva o histórico de usos.
8. Clique em Salvar Alteracoes no rodapé. O sistema valida, atualiza o cupom e redireciona para a página de detalhes com a mensagem "Cupom atualizado com sucesso!".

Casos especiais

Código vazio mantém o atual

Se você apagar o conteúdo de Código do Cupom e salvar, o servidor remove o campo do array de update (unset($dados['codigo'])) e preserva o código original do cupom. Não há geração automática de novo código na edição, ao contrário da criação. Para trocar o código, digite o novo valor explicitamente.

Trocar o código de um cupom já divulgado

Tecnicamente é possível alterar o Código do Cupom a qualquer momento, e a unicidade é validada ignorando o próprio cupom (Rule::unique com ignore($cupomId)). Na prática, evite trocar códigos já compartilhados em campanhas: clientes com o código antigo recebem "Cupom inválido" no checkout. Se precisar trocar, comunique a mudança ou crie um cupom novo.

Pausar um cupom sem perder configurações

Para suspender temporariamente uma promoção, basta desligar o toggle do bloco Status do Cupom e clicar em Salvar Alteracoes. O cupom continua na listagem com filtro Inativos e pode ser religado a qualquer momento sem perder regras, limites ou histórico de usos.

Cupons de lote (cupom-pai)

Ao editar o cupom-pai de um lote, as alterações de Tipo de Desconto, Valor do Desconto, validade e restrições afetam apenas o registro do pai - os cupons filhos individuais já gerados não são atualizados em massa por esta página. Para ativar/desativar todos os filhos de uma vez, use o Ativar/Desativar no dropdown da listagem (que replica o status para os filhos).

Tipo de desconto "Taxa Gratis"

Diferente da criação, o formulário de edição não esconde os campos de valor quando o tipo é Taxa Gratis - o campo continua visível com o símbolo R$. Preencha Valor do Desconto como 0 ou mantenha o valor existente; o servidor aceita qualquer numérico maior ou igual a zero.

Erros comuns e como resolver

• "O nome do cupom é obrigatório." - Causa: campo Nome do Cupom apagado. Solução: preencha um nome interno antes de salvar.
• "O valor do desconto é obrigatório." - Causa: campo Valor do Desconto vazio com tipo de desconto diferente de Taxa Gratis. Solução: informe o valor numérico (use vírgula para decimais).
• "O valor do desconto deve ser maior que zero." - Causa: digitou um valor negativo. Solução: informe valor positivo (ou 0 para taxa grátis).
• "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: você trocou o Código do Cupom para um valor que já existe em outro cupom da sua empresa. Solução: escolha outro código ou volte a deixar o campo com o código original.
• "Selecione o tipo do cupom." / "Selecione o tipo de desconto."
  • Causa: o select foi limpo antes de salvar. Solução: escolha uma opção em cada select e tente novamente.

Onde encontrar

• URL: /admin/marketing/cupons/{id}/edit
• Caminho no menu: Marketing > Cupons > cartão do cupom > Editar
• Permissão necessária: editar os cupons
• Módulo necessário: nenhum

Veja também

• Cupons - Listagem
• Cupons - Criar Cupom