Pular para o conteúdo
Português - Brasil
  • Não há sugestões porque o campo de pesquisa está em branco.

Como criar e utilizar Cupons Promocionais

Aprenda a criar cupons de desconto para seus planos e permitir que os clientes apliquem o código no checkout da contratação.

⚠️ Funcionalidade em fase de testes. Sendo liberada gradualmente durante o mês de novembro 2026.

Os Cupons Promocionais permitem criar códigos de desconto que os seus clientes aplicam no checkout ao contratar um plano. Com eles, você pode montar campanhas, oferecer condições especiais a parceiros e acompanhar quantas contratações cada cupom gerou.

 

Neste artigo:

  1. Onde encontrar os cupons
  2. Como criar um cupom
  3. Como ativar o campo de cupom no plano
  4. Como o cliente aplica o cupom no checkout
  5. Como acompanhar os cupons utilizados
  6. Como alterar, inativar ou excluir um cupom
  7. Regras importantes
  8. Limitações atuais

1. Onde encontrar os cupons

Acesse Config. de Vendas → Cupons Promocionais.

A tela lista todos os cupons cadastrados, com as colunas: ID, Status, Código do Cupom, Desconto (R$), Incidência, Planos aplicáveis, Válido a partir de, Expira em, Utilizações e Ações. Use o filtro de status para ver os cupons ativos, inativos ou todos.

💡 A tela tem permissão própria. Se algum usuário da sua equipe não estiver vendo o menu, verifique a permissão em Perfis de Usuários.


2. Como criar um cupom

Clique em Novo cupom e preencha os campos:

Código do Cupom
O código que o cliente vai digitar no checkout (ex.: BEMVINDO10). Aceita letras e números.

  • O sistema converte tudo para maiúsculas automaticamente e ignora espaços.
  • Não é possível cadastrar dois cupons com o mesmo código. O sistema não diferencia maiúsculas de minúsculas, então “promo” e “PROMO” são o mesmo código.

Desconto (R$)
O valor fixo em reais que será abatido da cobrança. Deve ser maior que zero.

Válido a partir de
A data em que o cupom passa a ser aceito. Por padrão, vem preenchida com a data de hoje.

Expira em

  • Nunca (padrão): o cupom não tem data de expiração.
  • Data específica: escolha a data final de validade. Ela não pode ser anterior à data de início.

As datas são inclusivas: o cupom é aceito no dia de início e no dia de expiração.

Incidência

  • Apenas na 1ª ocorrência: o desconto vale só na primeira cobrança do plano contratado.
  • Em todas as ocorrências: o desconto vale em todas as cobranças do plano contratado.

Planos aplicáveis

  • Todos os Planos (padrão): o cupom pode ser usado na contratação de qualquer plano.
  • Um plano específico: o cupom só é aceito na contratação do plano selecionado.

Situação

  • Ativo (padrão): o cupom pode ser usado.
  • Inativo: o cupom não é aceito no checkout.

Clique em Salvar. O cupom passa a aparecer na lista.

⚠️ Se nenhum dos planos aplicáveis ao cupom estiver com o campo de cupom ativado, o sistema salva o cupom normalmente, mas exibe um aviso. Veja o próximo passo.


3. Como ativar o campo de cupom no plano

Para que o cliente consiga digitar o cupom no checkout, ative a opção no plano:

  1. Acesse o cadastro do plano desejado.
  2. Marque a opção Exibir campo de código promocional na contratação.
  3. Salve o plano.

A opção vem desmarcada por padrão, então é preciso ativá-la em cada plano que vai aceitar cupons.


4. Como o cliente aplica o cupom no checkout

Com a opção ativada no plano, o checkout mostra o campo Código promocional na etapa Detalhes da Compra.

  1. O cliente digita o código do cupom.
  2. Clica em Aplicar ou pressiona Enter.
  3. O sistema valida o cupom e exibe o resultado.

Possíveis mensagens:

Mensagem O que significa
Cupom aplicado com sucesso O desconto foi aplicado e já aparece no valor da compra.
Cupom expirado ou inválido O código não existe, está inativo, ainda não começou a valer, já expirou ou não vale para este plano.
O cupom informado não pode ser aplicado a esta compra. Com o desconto, alguma cobrança ficaria com valor zero ou negativo.

Quando o cupom é aplicado, o desconto aparece na lista de itens da compra como uma linha com valor negativo, chamada “Desconto cupom [CÓDIGO]”, e o preço é atualizado.

Bom saber:

  • O campo é opcional. O cliente pode contratar sem cupom.
  • Só é possível usar um cupom por contratação.
  • Se o cliente apagar ou alterar o código depois de aplicado, o desconto é removido. Para aplicar um novo código, é preciso clicar em “Aplicar” de novo.
  • Se o cliente mudar quantidades ou valores flexíveis e o total deixar de ser positivo, o desconto é removido automaticamente.
  • O cupom é validado de novo ao finalizar a contratação. Se ele tiver sido inativado ou expirado nesse meio-tempo, a contratação não é concluída.

5. Como acompanhar os cupons utilizados

Coluna “Utilizações”
Na tela de Cupons Promocionais, mostra quantos planos contratados foram feitos com cada cupom, incluindo contratos que depois foram cancelados ou inativados. As cobranças geradas a partir desses contratos não são contadas de novo.

Coluna “Cupom aplicado”
Aparece nas listas de Vendas → Planos Contratados e Vendas → Cobranças Emitidas e mostra o código usado na contratação.

⚠️ Atenção: essa coluna indica que o contrato foi feito com o cupom, não que a cobrança tem desconto. Em cupons de incidência “Apenas na 1ª ocorrência”, o código continua aparecendo nas cobranças seguintes, mas elas já não têm o desconto.


6. Como alterar, inativar ou excluir um cupom

Na coluna Ações de cada cupom, você encontra:

  • Duplicar: abre um novo cupom com os mesmos dados do original, só sem o código. É útil para criar variações de uma campanha.
  • Alterar: edita os dados do cupom.
  • Excluir: remove o cupom. Disponível apenas para cupons que nunca foram utilizados.
  • Histórico: mostra as alterações feitas no cupom.

Também é possível ativar ou inativar o cupom direto na lista, pela coluna Status.

Cupom já utilizado:

  • Não pode ser excluído. Para tirá-lo de circulação, inative-o.
  • O código não pode ser alterado.

7. Regras importantes

Alterações valem só para novas contratações
Se você alterar o valor do desconto, inativar, excluir ou deixar o cupom expirar, os contratos já feitos com ele não mudam.

⚠️ Em cupons com incidência “Em todas as ocorrências”, o desconto continua nas cobranças seguintes dos contratos existentes mesmo que o cupom seja inativado. Para remover o desconto de um cliente específico, altere os itens do plano contratado dele.

Depois da contratação

  • Apenas na 1ª ocorrência: a linha de desconto sai do contrato depois da primeira cobrança.
  • Em todas as ocorrências: a linha de desconto fica no contrato e entra no cálculo do MRR e nos relatórios como item recorrente negativo.
  • Em planos com item “apenas na 1ª ocorrência em cobrança separada” (como uma taxa de adesão), o desconto de 1ª ocorrência vai para a primeira cobrança regular, não para a cobrança separada.

Área do Cliente
O assinante vê a linha do desconto na Área do Cliente, mas não pode alterá-la nem removê-la, mesmo em planos que permitem alterar itens.

Reajuste
O reajuste do plano contratado aplica o mesmo percentual a todos os itens, incluindo o desconto do cupom. Por exemplo, um desconto de R$ 2,00 com reajuste de 10% passa a ser R$ 2,20.

Nota fiscal (NFS-e)
A linha do cupom aparece na discriminação com valor negativo, e o valor dos serviços é o total líquido.


8. Limitações atuais

Nesta primeira versão, ainda não é possível:

  • Criar desconto em percentual (apenas valor fixo em reais).
  • Limitar a quantidade de usos de um cupom.
  • Limitar o uso a uma vez por cliente.
  • Aplicar mais de um cupom na mesma contratação.
  • Aplicar cupom pela Área do Cliente ou pela tela de Vendas (apenas pelo checkout).
  • Gerar um relatório específico de utilização de cupons.
  • Criar ou aplicar cupons pela API. Na API v2, o campo “cupom_aplicado” das vendas está disponível apenas para leitura.

Ficou com alguma dúvida? Fale com o nosso time de atendimento.