Cadastro de desconto / cupom

A campanha define o desconto: quanto abate, sobre o que incide, quando vale e quantas vezes pode ser usada.

Onde fica

Menu lateral → Descontos → Novo.

discounts.manage para a campanha; discounts.generate_codes sensível para gerar códigos.

Campo	Obrigatório	Descrição	Formato ou exemplo	Observações
Nome	sim	Identifica a campanha nas listagens e relatórios.	“Black Friday 20%”	Aparece no relatório de uso de cupons.
Status	sim	Se a campanha participa do cálculo.	Ativo · Inativo	Inativo interrompe a campanha sem apagar o histórico.
Descrição	não	Explicação interna.	Texto livre	—

Campo	Obrigatório	Descrição	Opções	Observações
Sabor	sim	Se o cliente digita um código ou o desconto aplica sozinho.	Cupom (com código) · Sem código	Dica da própria tela: “Cupom usa códigos (1:N); sem código aplica automaticamente.”
Tipo	sim	Forma de cálculo do abatimento.	Percentual (%) · Valor fixo (R$) · Preço fixo (R$ no item)	Dica da tela: “Preço fixo força o valor do item (só escopo de item).”
Percentual / Valor	sim	Quanto abate.	`20` ou `50.00`	O rótulo muda conforme o tipo escolhido.
Teto de abatimento (R$)	não	Limite máximo de desconto por aplicação.	Valor em reais	Vazio = sem teto. Vale para percentual e valor fixo.
Escopo	sim	Sobre o que o desconto incide.	Carrinho inteiro · Atração · Passaporte · Produto	“Preço fixo” é proibido no carrinho inteiro.
Alvo	sim (se escopo ≠ carrinho)	Qual atração, passaporte ou produto recebe o desconto.	Seleção	Só aparece quando o escopo é de item.

Campo	Obrigatório	Descrição	Em branco significa
Valor mínimo do pedido	não	Elegível só acima deste total.	Sem mínimo
Prioridade	não	Maior prioridade aplica primeiro na cascata.	Ordem padrão
Início (validade)	não	Quando a campanha começa a valer.	Sem data de início
Fim (validade)	não	Quando a campanha deixa de valer.	Sem data de fim
Uso total	não	Somatório de usos de todos os códigos.	Ilimitado
Usos por CPF	não	Quantas vezes o mesmo CPF pode usar a campanha.	Ilimitado

Trocar de “Cupom” para “Sem código” descarta os limites

O formulário avisa em destaque amarelo: ao salvar como Sem código, os limites de uso total e por CPF da campanha são descartados.

A campanha passa a valer conforme a validade e as condições configuradas.
Se for do sabor cupom, você pode gerar os códigos (permissão específica). Os códigos são gerados pelo sistema, sem caracteres ambíguos, e são únicos por empresa.
Cada uso confirmado gera um resgate, visível em Descontos → Resgates.

Marque a campanha como Inativa ou defina a data de fim. Os resgates já registrados permanecem para efeito de relatório e conferência.