Templates de cupom, campo a campo
Como montar o modelo dos cupons gerados para afiliadas: código com variáveis, desconto, mínimo, validade, regras de uso e geração automática.
O template é o molde dos cupons que a plataforma cria na sua loja para cada afiliada: o formato do código, o desconto e as regras de uso. Nada vem pronto de fábrica. Para chegar, vá em Cupons e clique em Modelos de cupom (ou em Configurações › Cupons › Gerenciar templates).
Passo a passo#
- Em Templates de cupom, clique em Novo template.
- Preencha os campos (explicados abaixo).
- Confira a frase do Resumo no fim do formulário. Ela descreve o cupom em uma linha, por exemplo "Cupom de 10% de desconto, válido por 30 dias a partir da criação, até 100000 usos no total."
- Clique em Salvar template.
Informações básicas#
- Nome do template: só para você reconhecer. Nem quem divulga nem a cliente veem esse nome.
- Para quem é esse cupom? (só ao criar): Padrão: vale para todo mundo do programa ou Só para uma pessoa específica (aí aparece Para quem?). O template de uma pessoa específica vence o padrão para ela.
Código e desconto#
Código do cupom é o que a cliente digita no carrinho. Sai sempre em maiúsculas. Num template Padrão, o código precisa mudar para cada pessoa, então use pelo menos uma destas variáveis:
| Variável | Vira |
|---|---|
{FIRST_NAME_AUTO} | O primeiro nome da pessoa (MARIA). Se já existir, tenta nome + valor do desconto (MARIA10) e depois um número no fim (MARIA102, MARIA103...). |
{AFFILIATE_CODE} | O código da pessoa no programa. |
{RANDOM:4} | 4 letras/números aleatórios (troque o 4 pelo tamanho que quiser). |
{TS:4} | Os últimos dígitos de um número baseado no horário. |
Também dá para usar {FIRST_NAME} (primeiro nome, sem a tentativa extra), {VALUE} (o valor do desconto) e {YEAR} (o ano). Exemplo: {FIRST_NAME_AUTO}10 gera MARIA10.
- Tipo: Percentual ou Valor fixo (R$).
- Como calcular: Valor fixo definido aqui.
- Valor do desconto: o percentual (até 100%) ou o valor em R$.
- Valor mínimo do pedido: Sem mínimo, Valor fixo (em R$) ou Múltiplo do desconto (ex.: 4 = pedido de ao menos 4 vezes o valor do desconto).
Validade e regras#
- Validade: Dias a partir da criação (conta a partir do dia em que o cupom de cada pessoa é criado) ou Datas fixas (Começa em / Termina em, horário de Brasília).
- Quantidade de usos: quantas vezes o cupom pode ser usado no total.
- Uma vez por cliente, Acumula com outras promoções (já vem marcado), Frete grátis, Ignora produtos em promoção (já vem desmarcado: o desconto vale também para produtos em promoção).
Automação#
- Criar cupom automaticamente quando a pessoa ativar a conta: é isso que faz a regra de cupom "Gerar um cupom para cada pessoa" funcionar.
- Template ativo: desmarcado, o template não gera cupons.
- Prioridade (desempate entre templates do mesmo escopo): se houver dois templates padrão ativos, vale o de maior prioridade.
Erros comuns e o que fazer#
| Mensagem | Por quê | O que fazer |
|---|---|---|
"Esse código não tem {RANDOM:4}, {TS:n}, {AFFILIATE_CODE} ou {FIRST_NAME_AUTO}..." | Template padrão com código fixo: todo mundo sairia com o mesmo código. | Inclua uma dessas variáveis no código. |
| "O código "X" já está em uso. Escolha outro." | Já existe um cupom ou template com esse código fixo. | Escolha outro código. |
| "Um desconto percentual não pode passar de 100%." | Valor acima de 100. | Corrija o valor. |
| "Informe a validade em dias (mínimo 1)." | Validade vazia ou zero. | Informe 1 ou mais dias. |
| "Informe a data em que o cupom termina." | Datas fixas sem Termina em. | Preencha a data final. |
| "O fim da validade não pode ser antes do início." | Datas invertidas. | Corrija as datas. |
| "A quantidade de usos deve ser um número inteiro maior que zero." | Quantidade vazia ou zero. | Informe 1 ou mais. |
| "Selecione a pessoa para este template." | Escopo de pessoa específica sem pessoa. | Escolha em Para quem?. |
Perguntas frequentes#
Minha loja é Nuvemshop e o código saiu diferente do que digitei.
A Nuvemshop só aceita letras e números no código. Acentos, espaços e símbolos são removidos.
Como excluo um template?
Abra o template e clique em Excluir template e depois em Confirmar exclusão. Os cupons que ele já criou continuam funcionando.
No painel: /app/cupons/templates

