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.

Atualizado em 14/11/2026

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).

Lista de templates de cupom
Crie o template de cupom · com narração

Passo a passo#

  1. Em Templates de cupom, clique em Novo template.
  2. Preencha os campos (explicados abaixo).
  3. 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."
  4. Clique em Salvar template.
Formulário de novo template de cupom com o resumo

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ávelVira
{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#

MensagemPor 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

Este artigo ajudou?

Não resolveu?

Fale com a gente. A mensagem já vai com a tela e o artigo, para agilizar o atendimento.

Leia também