> For the complete documentation index, see [llms.txt](https://vertte-app.gitbook.io/ajuda/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vertte-app.gitbook.io/ajuda/secoes-lojistas/markdown.md).

# Cupons

## 🏷️ Cupons na Vertte

Gerencie e vincule cupons criados na sua plataforma de e‑commerce aos afiliados da sua rede Vertte.

<figure><img src="/files/uWuR9T0GeaWSFj50S172" alt=""><figcaption><p>Visão Geral da seção <strong>Cupons</strong></p></figcaption></figure>

***

### O que você precisa saber

* Os cupons **não são criados na Vertte**.
* Você deve **criar o cupom na sua plataforma de e‑commerce** (Loja Integrada, Nuvemshop, Shopify etc.).
* Na Vertte, você apenas **busca e vincula** cupons já existentes.
* Se o cupom for deletado na sua loja, ele **continua visível e vinculado** na Vertte e o histórico é mantido.

***

### Como vincular cupons aos afiliados

{% stepper %}
{% step %}

### Acesse a seção de Cupons

Clique na opção **Cupons** no menu lateral da Vertte.

{% endstep %}

{% step %}

### Veja os cupons já vinculados

Na parte superior da tela, você verá os cupons que já foram vinculados a afiliados.

Exemplo:

```
Cupom: 10OFF  
💰 Comissão: 10%  
📧 Afiliado: fernanda@vertte.com
```

<figure><img src="/files/sX3UTvYp1sEKXO91stRu" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Busque por um novo cupom

Use o campo **Buscar cupom** para localizar cupons ativos:

⚠️ A busca **diferencia letras maiúsculas e minúsculas**\
Digite o código do cupom exatamente como ele foi criado.

Se o cupom for encontrado:

* Ele será exibido com os detalhes.
* Você poderá **visualizar a vinculação a um afiliado** e sua **comissão**.

Se o cupom **não for encontrado**:

* Verifique se ele realmente foi criado na sua plataforma de e‑commerce.
* Corrija erros de digitação, especialmente com letras maiúsculas/minúsculas.
  {% endstep %}

{% step %}

### Como vincular um cupom

Depois de buscar e localizar um cupom ativo da sua plataforma de e‑commerce:

1. Clique no ícone de 🔗 ao lado do cupom desejado.
2. Um modal será exibido com as informações do cupom:
   * Código
   * Tipo e valor de desconto
3. No campo **Afiliado**, selecione o afiliado ao qual deseja vincular o cupom.
4. Defina o valor da comissão para esse cupom (%).
   * A Vertte já sugere a **comissão padrão do seu e‑commerce**, mas você pode ajustar conforme necessário.
5. Clique em **Vincular cupom.**

<figure><img src="/files/w3XIu69zIP2Fgk2ayWLy" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Como desvincular um cupom

Se precisar remover o vínculo de um cupom com um afiliado:

1. Acesse a seção **Cupons vinculados**.
2. Clique no botão de edição ao lado do cupom.
3. Um modal aparecerá com os dados do vínculo atual:
   * Afiliado vinculado
   * Comissão definida
4. Clique em **Desvincular cupom** para confirmar a ação.

{% hint style="danger" %}
Isso **não apaga o cupom da loja**, apenas desfaz o vínculo com o afiliado na Vertte.
{% endhint %}

<figure><img src="/files/aQW1zjOVJGHoUqMYviXc" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

### Boas práticas ao usar cupons com afiliados

**Padronize os nomes dos cupons**\
Use códigos fáceis de lembrar e relacionados ao nome do afiliado (ex: `DESCONTOLUANA`), facilitando a rastreabilidade.

**Mantenha os cupons ativos e válidos**\
Sempre confira se o cupom está com validade ativa na sua plataforma de e‑commerce antes de vincular na Vertte.

**Evite reutilizar cupons para campanhas diferentes**\
Isso ajuda a manter o histórico de vendas por afiliado mais limpo e preciso.

**Acompanhe o desempenho dos cupons vinculados**\
Use os dados de uso de cupom na Vertte para entender quais afiliados estão performando melhor.

**Comunique o afiliado após o vínculo**\
Informe ao afiliado que o cupom já está ativo e vinculado, assim ele já pode começar a divulgar.

***

### Pontos importantes

✅ O cupom precisa estar **ativo e criado na sua loja virtual**.\
❌ **Não é possível criar cupons diretamente pela Vertte,** a criação sempre acontece na sua plataforma de e‑commerce.\
📌 Mesmo que você **exclua um cupom na loja**, ele permanece vinculado na Vertte para fins de acompanhamento e histórico.

⚠️ **Atenção:** Por se tratar de uma integração com sua plataforma de e‑commerce, em algumas soluções é necessário possuir uma **conta ativa com plano pago** para utilizar os recursos de API.

🛒 Plataformas com exigência de plano pago para uso via API:

* **Loja Integrada**

{% hint style="warning" %}
Estamos trabalhando para oferecer novas integrações em breve.
{% endhint %}

***

### 💬 Dúvidas Frequentes

1. **Posso criar um cupom direto pela Vertte?**\
   Não. Os cupons precisam ser criados na sua plataforma de e‑commerce (Loja Integrada, Nuvemshop, etc.). A Vertte apenas busca e vincula.
2. **O que acontece se eu deletar o cupom na minha loja virtual?**\
   O vínculo com o afiliado permanece ativo na Vertte, mesmo que o cupom tenha sido removido da loja.
3. **Meu cupom não aparece na busca. E agora?**\
   Verifique se ele foi criado corretamente na plataforma de e‑commerce e se está ativo. A busca diferencia letras maiúsculas e minúsculas.
4. **Posso vincular o mesmo cupom para mais de um afiliado?**\
   Não. Cada cupom pode estar vinculado a apenas **um afiliado por vez**.
5. **Consigo mudar a comissão de um cupom depois de vinculado?**\
   Por enquanto, não é possível editar a comissão após o vínculo. É necessário desvincular e vincular novamente com o novo valor.