> For the complete documentation index, see [llms.txt](https://centraldeajuda.tradeinsights.com/bem-vindo-a-trade-insights/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://centraldeajuda.tradeinsights.com/bem-vindo-a-trade-insights/financeiro/cupons.md).

# Cupons

Crie cupons de desconto que o aluno usa no checkout.

Com os cupons você dá desconto na compra dos seus produtos. O aluno digita o código no checkout e o desconto entra na hora.

{% hint style="info" %}
**Onde fica:**

* **Admin novo:Comercial > Cupons**
* **Admin antigo:Financeiro > CuponsPrecisa ativar com o suporte?** Não. Todas as marcas têm cupons.

**Em qual checkout funciona?** Nos dois: **V2** e **V3**.
{% endhint %}

***

## Tipos de cupom

| Tipo          | Para que serve                                                      | Validade                                                            |
| ------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
| **Comum**     | Campanhas, parceiros, promoções. Você escolhe o código e as regras. | Até a data de expiração que você definir (o dia da data ainda vale) |
| **Uso único** | Um desconto para uma pessoa só, com código gerado pela plataforma.  | **2 horas** a partir da criação                                     |

***

## Como criar um cupom comum

### Passo 1: Acessar a tela

Abra **Comercial > Cupons** (admin novo, aba **Comuns**) ou **Financeiro > Cupons** (admin antigo).

### Passo 2: Começar um cupom novo

Clique em **Criar cupom** (admin novo) ou no botão de criar (admin antigo).

### Passo 3: Preencher as opções

| Opção                              | O que faz                                                                                                                               |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Código do cupom**                | O que o aluno vai digitar. Obrigatório e único: se o código já existir, escolha outro. No admin novo, ele é salvo em letras maiúsculas. |
| **Tipo de desconto**               | **Percentual** (%) ou **Valor fixo** (R$).                                                                                              |
| **Valor**                          | O tamanho do desconto. No percentual, precisa ser menor que 100% (para 100%, veja abaixo).                                              |
| **Vincular a um e-mail**           | Opcional. Se preenchido, só a pessoa com esse e-mail consegue usar.                                                                     |
| **Disponível a todos os planos**   | Marcado: vale em qualquer produto. Desmarcado: escolha em quais **Planos** o cupom vale.                                                |
| **Exigir um plano do aluno**       | Opcional. Só quem já tem um plano específico ativo pode usar. Bom para descontos exclusivos para assinantes.                            |
| **Limitar a um uso por aluno**     | Cada pessoa usa o cupom uma vez só.                                                                                                     |
| **Cupom de 100% (produto grátis)** | O produto sai de graça. Veja as regras abaixo.                                                                                          |
| **Limite total de usos**           | Opcional. Depois desse número de compras, o cupom esgota.                                                                               |
| **Data de expiração**              | Obrigatória. O cupom vale até o fim desse dia.                                                                                          |

### Passo 4: Salvar

Clique em **Salvar**. O cupom já fica disponível no checkout.

***

## Cupom de 100% (produto grátis)

Ao marcar **Cupom de 100% (produto grátis)**, a compra é concluída sem pagamento. Ele tem regras próprias:

* O desconto precisa ser **percentual de 100%**.
* **Limitar a um uso por aluno** precisa estar marcado.
* **Limite total de usos** é obrigatório (de 1 a 1.000.000).
* **Não vale em plano de assinatura nem em plano com período de teste.**
* **Não aceita produtos adicionais (order bump).** Se o aluno marcar algum, o checkout pede para remover.

***

## Como criar um cupom de uso único

### Passo 1: Abrir a criação

* **Admin novo:** em **Comercial > Cupons**, abra a aba **Uso único** e clique em **Gerar cupom**.
* **Admin antigo:** em **Financeiro > Cupons**, clique em **Cupom de uso único**.

### Passo 2: Preencher

* Clique em **Gerar código** para a plataforma criar um código aleatório.
* Se quiser, vincule a um e-mail.
* Escolha o tipo e o valor do desconto.
* Escolha se vale em todos os planos ou em planos específicos.

### Passo 3: Criar e enviar

Clique em **Criar cupom**, copie o código e envie para a pessoa.

{% hint style="warning" %}
O cupom de uso único **vale por 2 horas**. Depois que a compra com ele é paga, ele sai de uso automaticamente.
{% endhint %}

Para ver quais códigos de uso único já foram usados, e por quem, clique em **Baixar relatório**. No admin novo, a lista também mostra **Utilizado** ou **Não utilizado**.

***

## Como o aluno usa o cupom

1. No checkout, o aluno abre o campo **Cupom de desconto**.
2. Digita o código e clica em **Aplicar**.
3. O desconto aparece no resumo da compra.

{% hint style="info" %}
**Não existe link com cupom já aplicado.** O aluno sempre digita o código no checkout. Um cupom vinculado a um e-mail também não entra sozinho: a pessoa precisa digitar.
{% endhint %}

No checkout V2, o e-mail precisa estar preenchido antes de aplicar o cupom.

### Como o desconto é calculado

* O desconto vale sobre o **produto mais os produtos adicionais (order bump)** que o aluno marcou.
* No percentual, é a porcentagem desse total.
* No valor fixo, o desconto nunca passa do valor da compra.
* **Em planos recorrentes, o desconto vale só no primeiro pagamento.** As renovações são cobradas pelo valor cheio.

### Mensagens que o aluno pode ver

| Mensagem                                                               | Por quê                                                                              |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Este cupom de desconto não existe.                                     | Código errado, cupom desativado, vencido, de outro plano ou vinculado a outro e-mail |
| Este cupom é exclusivo para assinantes de um plano específico.         | O cupom exige um plano que a pessoa não tem ativo                                    |
| Este cupom não vale para planos de assinatura ou com período de teste. | Cupom de 100% em plano de assinatura ou com teste                                    |
| Este cupom esgotou.                                                    | O limite total de usos foi atingido                                                  |
| Você já usou este cupom.                                               | O cupom é de um uso por aluno e a pessoa já usou                                     |

### O que conta como uso

Contam como uso as compras **pagas**, **renovadas**, **reembolsadas em parte**, **em período de teste** e **contestadas no cartão (chargeback)**.

Não contam: PIX ou boleto ainda não pagos, compras recusadas, canceladas ou reembolsadas por inteiro.

***

## Editar, desativar e arquivar

Na lista de cupons (admin novo):

| Ação                       | O que faz                                                                                                   |
| -------------------------- | ----------------------------------------------------------------------------------------------------------- |
| **Ativar** / **Desativar** | Liga ou desliga o cupom no checkout, sem perder nada                                                        |
| **Editar**                 | Muda as regras do cupom                                                                                     |
| **Arquivar**               | Tira o cupom da lista e do checkout. No admin antigo, essa ação se chama **Deletar**, mas também só arquiva |

{% hint style="info" %}
**Editar um cupom que já foi usado cria uma nova versão.** A versão antiga fica guardada com as vendas que ela teve, e a nova passa a valer no checkout. No admin novo, o botão aparece como **Salvar nova versão**. Os usos das versões antigas continuam contando para **Limitar a um uso por aluno** e **Limite total de usos**.
{% endhint %}

***

## Cupons nos relatórios de vendas

* **Detalhe da venda:** mostra o desconto e o código do cupom usado.
* **Exportação de vendas:** a planilha tem as colunas **Cupom** e **Desconto**, nos dois admins.
* **Lista de cupons (admin novo):** a coluna **Usos** mostra quantas vezes cada cupom foi usado.
* **Cupons de uso único:** use **Baixar relatório** para ver quem usou cada código e em qual venda.
