# Cadastro de Cupom

No painel da EduStore, acesse o menu:  
**CRM → Cupons**

Você verá a listagem de todos os cupons já cadastrados no sistema.  
No canto superior direito da tela, clique no botão 🟢 <span style="color: rgb(45, 194, 107);">**Criar**</span> para adicionar um novo cupom.

##  **Aba “Configurações”**

Após clicar em "<span style="color: rgb(45, 194, 107);">**Criar**</span>", você será direcionado para a aba **Configurações**, onde deverá preencher os campos principais do cupom:

---

### **Código do Cupom**

- **Obrigatório** e **único**.
- Não é possível reutilizar um código já existente, mesmo se o cupom for deletado.
- Isso evita conflitos com cupons já vinculados a pedidos passados.
- Você pode:
    
    
    - Digitar manualmente.
    - Ou clicar em **"Gerar código automaticamente"** para o sistema gerar um código exclusivo.
- Após inserir ou gerar, o sistema validará o código e informará se ele está disponível.

---

### **Limite de Uso**

- Define o número total de utilizações permitidas.
- Exemplo: `1` significa que o cupom só pode ser usado uma única vez.

---

### **Data de Expiração**

- Define até quando o cupom pode ser utilizado.
- Após essa data, ele será desconsiderado automaticamente.
- Pode ser removida usando o botão “X” ao lado do campo.

---

### **Usuário (opcional)**

- Você pode restringir o uso do cupom a um **único usuário**.
- Caso preenchido, somente o usuário selecionado poderá utilizá-lo.
- É possível selecionar da lista ou clicar em **"Criar +"** para cadastrar um novo.

---

### **Afiliado (opcional)**

- Caso você utilize **afiliados** na sua estratégia, pode vincular o cupom a um deles.
- Assim, o sistema poderá rastrear a origem do uso do cupom.
- Também é possível criar um afiliado na hora com o botão **"Criar +"**.

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/Ihcimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/Ihcimage.png)

### **Configuração de Descontos do Cupom**

A plataforma permite controlar com precisão como o desconto será aplicado nos produtos vinculados a um cupom.

####  Tipos de Configuração

- **Cálculo sobre**: define a base do desconto:
    
    
    - `Valor Bruto` → valor total do produto.
    - `Valor Líquido Final` → valor com taxas e ajustes já aplicados.
- **Tipo de Desconto**:
    
    
    - `Percentual (%)` → desconto proporcional ao valor.
    - `Valor Fixo (R$)` → desconto com valor absoluto.
- **Valor do Desconto**:
    
    
    - Para tipo **percentual**, não são aceitos valores acima de `100%`. Caso ocorra, o sistema exibirá uma mensagem de erro.
    - Para tipo **fixo**, o valor não pode ser superior ao valor total do produto. Caso contrário, o erro será sinalizado no momento de salvar.

---

### Desconto Padrão

O **desconto padrão** será aplicado automaticamente **em todos os produtos vinculados ao cupom que não tiverem um valor de desconto configurado individualmente**.

- Ele segue a configuração global da seção **Desconto Padrão**.
- Só será aplicado nos produtos marcados como <span style="color: rgb(45, 194, 107);">**APLICAR**</span>.

---

### [![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/yrVimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/yrVimage.png)

### **Aplicação Global**

A aplicação global serve para ser utilizadas para todos os produtos do tipo escolhido.

> Obs: Caso escolher aplicação global não é possível, fazer a aplicação individual por produto.

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-07/scaled-1680-/d71image.png)](https://wiki.edustore.online/uploads/images/gallery/2025-07/d71image.png)

### **Desconto na Taxa de Matrícula**

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2026-03/scaled-1680-/image.png)](https://wiki.edustore.online/uploads/images/gallery/2026-03/image.png)

O **Desconto na Taxa de Matrícula** funciona da mesma forma que o desconto principal do cupom, porém **aplicado exclusivamente na Taxa de Matrícula**.

Ou seja: você escolhe o **tipo de desconto** (percentual ou valor fixo) e o **valor**, e esse desconto será usado **somente na taxa**, sem alterar o desconto dos produtos do pedido.

### **Aplicação por Produto**

Na tabela de produtos:

- Cada item permite configurar o desconto individualmente (sobrescrevendo o desconto padrão).
- Para que o desconto seja considerado, o botão **Aplicar** deve estar ativado.
- Produtos com <span style="color: rgb(45, 194, 107);">**APLICAR**</span> desabilitado não receberão nenhum desconto, mesmo que o padrão esteja configurado.

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/bDhimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/bDhimage.png)

### **Personalização de Mensagens do Cupom**

A plataforma permite personalizar tanto o texto do e-mail enviado quanto a mensagem exibida ao aplicar o cupom.

Para isso, utilize **palavras-chave dinâmicas**, que serão automaticamente substituídas por informações reais do usuário.  
Essas variáveis podem ser utilizadas em qualquer parte do conteúdo.

#### Palavras-chave disponíveis:

- `{first_name}` → Nome do usuário
- `{discount}` → Valor do desconto aplicado

> Exemplo de uso:  
> **{first\_name}**, parabéns! Você recebeu um desconto de **{discount}**.

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/tNbimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/tNbimage.png)

## **Aba "Produtos"**

Após configurar os dados principais do cupom na aba **"Configurações"**, você poderá acessar a aba **"Produtos"** para definir em quais produtos o cupom será aplicado, e com quais condições.

### Filtros de busca e seleção

No topo da seção de produtos, é possível:

- **Filtrar por tipo de produto**: Curso, Comunidade, Material/Apostila ou Todos.
- **Buscar por nome ou ID** do produto.
- **Selecionar todos** os produtos listados de uma vez.

###  Colunas e Campos Configuráveis

<div class="_tableContainer_16hzy_1" id="bkmrk-campo-descri%C3%A7%C3%A3o-id-%2F"><div class="_tableWrapper_16hzy_14 group flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="1299" data-start="699"><thead data-end="737" data-start="699"><tr data-end="737" data-start="699"><th data-col-size="sm" data-end="724" data-start="699">Campo</th><th data-col-size="lg" data-end="737" data-start="724">Descrição</th></tr></thead><tbody data-end="1299" data-start="776"><tr data-end="838" data-start="776"><td data-col-size="sm" data-end="802" data-start="776">**ID / Tipo / Produto**</td><td data-col-size="lg" data-end="838" data-start="802">Identificação e tipo do produto.</td></tr><tr data-end="963" data-start="839"><td data-col-size="sm" data-end="868" data-start="839">**Cálculo sobre Desconto**</td><td data-col-size="lg" data-end="963" data-start="868">Define se o desconto será aplicado sobre o **valor líquido** ou **valor bruto** do produto.</td></tr><tr data-end="1042" data-start="964"><td data-col-size="sm" data-end="987" data-start="964">**Tipo de Desconto**</td><td data-col-size="lg" data-end="1042" data-start="987">Pode ser **Percentual (%)** ou **Valor fixo (R$)**.</td></tr><tr data-end="1134" data-start="1043"><td data-col-size="sm" data-end="1067" data-start="1043">**Valor de Desconto**</td><td data-col-size="lg" data-end="1134" data-start="1067">Valor numérico do desconto. Validado conforme o tipo escolhido.</td></tr><tr data-end="1299" data-start="1135"><td data-col-size="sm" data-end="1163" data-start="1135">**Aplicar / Não aplicar**</td><td data-col-size="lg" data-end="1299" data-start="1163">Marcação que indica se o cupom deve ou não ser aplicado a este produto. Apenas os produtos com "Aplicar" ativado serão considerados.</td></tr></tbody></table>

<div class="sticky end-(--thread-content-margin) h-0 self-end select-none"><div class="absolute end-0 flex items-end"><span class="" data-state="closed"><button aria-label="Copiar tabela" class="hover:bg-token-bg-tertiary text-token-text-secondary my-1 rounded-sm p-1 transition-opacity group-[:not(:hover):not(:focus-within)]:pointer-events-none group-[:not(:hover):not(:focus-within)]:opacity-0"><svg class="icon" fill="currentColor" height="20" viewbox="0 0 20 20" width="20" xmlns="http://www.w3.org/2000/svg"><path d="M12.668 10.667C12.668 9.95614 12.668 9.46258 12.6367 9.0791C12.6137 8.79732 12.5758 8.60761 12.5244 8.46387L12.4688 8.33399C12.3148 8.03193 12.0803 7.77885 11.793 7.60254L11.666 7.53125C11.508 7.45087 11.2963 7.39395 10.9209 7.36328C10.5374 7.33197 10.0439 7.33203 9.33301 7.33203H6.5C5.78896 7.33203 5.29563 7.33195 4.91211 7.36328C4.63016 7.38632 4.44065 7.42413 4.29688 7.47559L4.16699 7.53125C3.86488 7.68518 3.61186 7.9196 3.43555 8.20703L3.36524 8.33399C3.28478 8.49198 3.22795 8.70352 3.19727 9.0791C3.16595 9.46259 3.16504 9.95611 3.16504 10.667V13.5C3.16504 14.211 3.16593 14.7044 3.19727 15.0879C3.22797 15.4636 3.28473 15.675 3.36524 15.833L3.43555 15.959C3.61186 16.2466 3.86474 16.4807 4.16699 16.6348L4.29688 16.6914C4.44063 16.7428 4.63025 16.7797 4.91211 16.8027C5.29563 16.8341 5.78896 16.835 6.5 16.835H9.33301C10.0439 16.835 10.5374 16.8341 10.9209 16.8027C11.2965 16.772 11.508 16.7152 11.666 16.6348L11.793 16.5645C12.0804 16.3881 12.3148 16.1351 12.4688 15.833L12.5244 15.7031C12.5759 15.5594 12.6137 15.3698 12.6367 15.0879C12.6681 14.7044 12.668 14.211 12.668 13.5V10.667ZM13.998 12.665C14.4528 12.6634 14.8011 12.6602 15.0879 12.6367C15.4635 12.606 15.675 12.5492 15.833 12.4688L15.959 12.3975C16.2466 12.2211 16.4808 11.9682 16.6348 11.666L16.6914 11.5361C16.7428 11.3924 16.7797 11.2026 16.8027 10.9209C16.8341 10.5374 16.835 10.0439 16.835 9.33301V6.5C16.835 5.78896 16.8341 5.29563 16.8027 4.91211C16.7797 4.63025 16.7428 4.44063 16.6914 4.29688L16.6348 4.16699C16.4807 3.86474 16.2466 3.61186 15.959 3.43555L15.833 3.36524C15.675 3.28473 15.4636 3.22797 15.0879 3.19727C14.7044 3.16593 14.211 3.16504 13.5 3.16504H10.667C9.9561 3.16504 9.46259 3.16595 9.0791 3.19727C8.79739 3.22028 8.6076 3.2572 8.46387 3.30859L8.33399 3.36524C8.03176 3.51923 7.77886 3.75343 7.60254 4.04102L7.53125 4.16699C7.4508 4.32498 7.39397 4.53655 7.36328 4.91211C7.33985 5.19893 7.33562 5.54719 7.33399 6.00195H9.33301C10.022 6.00195 10.5791 6.00131 11.0293 6.03809C11.4873 6.07551 11.8937 6.15471 12.2705 6.34668L12.4883 6.46875C12.984 6.7728 13.3878 7.20854 13.6533 7.72949L13.7197 7.87207C13.8642 8.20859 13.9292 8.56974 13.9619 8.9707C13.9987 9.42092 13.998 9.97799 13.998 10.667V12.665ZM18.165 9.33301C18.165 10.022 18.1657 10.5791 18.1289 11.0293C18.0961 11.4302 18.0311 11.7914 17.8867 12.1279L17.8203 12.2705C17.5549 12.7914 17.1509 13.2272 16.6553 13.5313L16.4365 13.6533C16.0599 13.8452 15.6541 13.9245 15.1963 13.9619C14.8593 13.9895 14.4624 13.9935 13.9951 13.9951C13.9935 14.4624 13.9895 14.8593 13.9619 15.1963C13.9292 15.597 13.864 15.9576 13.7197 16.2939L13.6533 16.4365C13.3878 16.9576 12.9841 17.3941 12.4883 17.6982L12.2705 17.8203C11.8937 18.0123 11.4873 18.0915 11.0293 18.1289C10.5791 18.1657 10.022 18.165 9.33301 18.165H6.5C5.81091 18.165 5.25395 18.1657 4.80371 18.1289C4.40306 18.0962 4.04235 18.031 3.70606 17.8867L3.56348 17.8203C3.04244 17.5548 2.60585 17.151 2.30176 16.6553L2.17969 16.4365C1.98788 16.0599 1.90851 15.6541 1.87109 15.1963C1.83431 14.746 1.83496 14.1891 1.83496 13.5V10.667C1.83496 9.978 1.83432 9.42091 1.87109 8.9707C1.90851 8.5127 1.98772 8.10625 2.17969 7.72949L2.30176 7.51172C2.60586 7.0159 3.04236 6.6122 3.56348 6.34668L3.70606 6.28027C4.04237 6.136 4.40303 6.07083 4.80371 6.03809C5.14051 6.01057 5.53708 6.00551 6.00391 6.00391C6.00551 5.53708 6.01057 5.14051 6.03809 4.80371C6.0755 4.34588 6.15483 3.94012 6.34668 3.56348L6.46875 3.34473C6.77282 2.84912 7.20856 2.44514 7.72949 2.17969L7.87207 2.11328C8.20855 1.96886 8.56979 1.90385 8.9707 1.87109C9.42091 1.83432 9.978 1.83496 10.667 1.83496H13.5C14.1891 1.83496 14.746 1.83431 15.1963 1.87109C15.6541 1.90851 16.0599 1.98788 16.4365 2.17969L16.6553 2.30176C17.151 2.60585 17.5548 3.04244 17.8203 3.56348L17.8867 3.70606C18.031 4.04235 18.0962 4.40306 18.1289 4.80371C18.1657 5.25395 18.165 5.81091 18.165 6.5V9.33301Z"></path></svg></button></span></div></div></div></div>[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/jaqimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/jaqimage.png)

---

###  Aplicando os Descontos

Você pode aplicar os descontos de duas formas:

1. **Individualmente**, ativando o botão "<span style="color: rgb(45, 194, 107);">**Aplicar**</span>" produto a produto.
2. **Em massa**, utilizando o botão "**<span style="color: rgb(45, 194, 107);">Selecionar Todo</span>**s".

Se preferir, clique em **"<span style="color: rgb(224, 62, 45);">Desmarcar Todos</span>"** para remover a aplicação de todos os produtos.

### Herança do Desconto Padrão

Os produtos marcados como **"<span style="color: rgb(45, 194, 107);">Aplicar</span>"** mas **sem um valor específico de desconto** herdarão o **Desconto Padrão**, definido na aba de configurações do cupom.

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/OSWimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/OSWimage.png)

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/QaUimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/QaUimage.png)

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/2RXimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/2RXimage.png)

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/ZJCimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/ZJCimage.png)

## **Menu de Configuração do Produto –Recorrências, Limitações e Taxa de Matrícula**

Ao aplicar um cupom em um produto, você pode definir **regras personalizadas** para aquele produto de forma individual. Para isso, utilize a engrenagem localizada na coluna **Ações**, ao lado do botão "<span style="color: rgb(45, 194, 107);">**Aplicar**</span>".

Essa configuração será **específica por produto**.

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/LUgimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/LUgimage.png)

---

###  Quando aparece a opção de configurar

Ao clicar na engrenagem, você será direcionado ao menu de **configuração do produto no cupom**. Nele, é possível:

- Visualizar e configurar **condições financeiras** aplicáveis no aba **Recorrências** (como formas de parcelamento);
- Ativar **limitações de meios de pagamento** na aba **Limitações** (cartão, pix, boleto, etc);
- Definir quais **parcelamentos** serão permitidos para o cupom naquele produto.

> 📌 **Observação importante**: O produto só vai estar disponível caso o mesmo tenha financeiro configurado.

---

### **Recorrências**

A aba **Recorrências** permite configurar condições personalizadas de pagamento para o produto selecionado.

A lista de condições é **compartilhada entre todos os produtos com financeiro**, ou seja, ao criar ou editar uma condição, ela estará disponível para todos os produtos elegíveis.

Você pode:

- Criar uma nova condição
- Editar nome, parcelas e valores
- Excluir condições não utilizadas
- Utilizar o botão **"Escolher essa"** para definir qual condição será aplicada ao produto

 Ao clicar em **Parcelamentos de Cartão de Crédito** ou **Parcelamentos de Boleto** , você será direcionado para uma tela onde poderá configurar:

- Quantidade de parcelas permitidas
- Valor de cada parcela conforme a lógica da recorrência

As abas de **cartão** e **boleto** funcionam da mesma forma, mudando apenas o tipo de meio de pagamento configurado.

> 📌 **Observação importante:** As opções de parcelamento disponíveis nessa configuração se referem **exclusivamente aos meios de pagamento do tipo *Cartão de Crédito Recorrente* e *Boleto Recorrente***. É por meio dessas opções que você define a quantidade de parcelas e seus respectivos valores em cada modalidade.

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/conimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/conimage.png)

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/kQ7image.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/kQ7image.png)

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/jeLimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/jeLimage.png)

> 📌 **Observação importante:** Após salvar o cupom, as condições não podem ser alteradas, sendo possível apenas serem visualizadas.

### [![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/49ximage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/49ximage.png)

###  **Limitação de Meios de Pagamento e Parcelas**

Com essa funcionalidade, você pode escolher:

- **Quais meios de pagamento serão aceitos** ao utilizar o cupom no produto (ex: Cartão, Pix, 2 Cartões, Boleto Parcelado, etc).
- **Quantas parcelas são permitidas** para cada meio de pagamento (ex: Cartão Recorrente: 1x, 2x, 3x).

📌 **Exemplo**:

- Cartão Recorrente: permitido até 4x.
- Boleto: até 3x.
- Pix: sem limitação (todas permitidas).

- [![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/Mecimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/Mecimage.png)

À medida que as parcelas são adicionadas, elas são exibidas logo acima, organizadas no campo <span style="color: rgb(224, 62, 45);">**limitações**</span>.

---

###  Como remover meios de pagamentos ou parcelas

- Para remover **um meio de pagamento inteiro**, clique no botão de lixeira (vermelho) ao lado direito.
- Para remover **uma parcela específica**, clique no "x" ao lado do valor desejado (no selo azul).
    
    [![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/Wxqimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/Wxqimage.png)

### **Salvando a configuração do Produto** 

Após definir as limitações de meios de pagamento e as parcelas permitidas para o produto, clique no botão verde **"<span style="color: rgb(45, 194, 107);">Salvar Configurações</span>"** no canto inferior direito da tela.

Se todas as informações estiverem corretas, será exibida a mensagem:  
✅ **<span style="color: rgb(45, 194, 107);">Produto configurado com sucesso!</span>**

> ⚠️ Importante: as limitações ainda podem ser editadas enquanto o cupom **não for salvo**. Após salvar o cupom, as condições de parcelamento e os meios de pagamento configurados **não poderão mais ser alterados**.

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/gdEimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/gdEimage.png)

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/Vqgimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/Vqgimage.png)

### **Taxa de Matrícula**

Dentro do cupom, na aba **Produtos**, clique na **engrenagem** do produto desejado.  
No menu de configuração do produto, abra a aba **“Taxa de Matrícula”** (como na imagem).

Aqui você define um desconto **somente para a Taxa de Matrícula** desse produto.  
Ele **não altera** o desconto do cupom nos itens (curso/livro/comunidade). É um desconto separado, exclusivo da taxa.

- **Tipo de desconto**: escolha se será **Percentagem (%)** ou **Valor fixo (R$)**
- **Valor do desconto**: informe o valor conforme o tipo escolhido
    
    
    - Se for **%**, o limite é **0 a 100**
    - Se for **R$**, não pode ser maior que o valor da própria taxa

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2026-03/scaled-1680-/Qrfimage.png)](https://wiki.edustore.online/uploads/images/gallery/2026-03/Qrfimage.png)

### **Salvando/ Atualizando / Deletando o Cupom** 

Após preencher todas as informações do cupom, clique em <span style="color: rgb(45, 194, 107);">**Salvar**</span> para concluir o cadastro.

Caso deseje alterar um cupom existente, utilize o botão <span style="color: rgb(53, 152, 219);">**Editar**</span> (ícone azul de lápis) na listagem de cupons. Após realizar as edições, clique em <span style="color: rgb(45, 194, 107);">**Atualizar**</span>.

Se precisar excluir um cupom, clique no botão <span style="color: rgb(224, 62, 45);">**Deletar**</span> (ícone vermelho de lixeira) correspondente ao cupom desejado na listagem.

> ⚠️ **Atenção**: após salvar, se o cupom possuir condição de parcelamento, ela **não poderá mais ser alterada**. Isso garante a consistência das regras aplicadas no momento da criação.

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/wdGimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/wdGimage.png)

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/pLdimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/pLdimage.png)

[![image.png](https://wiki.edustore.online/uploads/images/gallery/2025-06/scaled-1680-/79nimage.png)](https://wiki.edustore.online/uploads/images/gallery/2025-06/79nimage.png)

###