# Cupons

## Cupons de Desconto — Guia de Uso

### Visão Geral

A página de **Cupons de Desconto** permite criar e gerenciar códigos promocionais que os clientes podem aplicar ao fazer um pedido.

> **Atenção:** Não é possível editar ou excluir cupons enquanto a loja estiver aberta. Feche a loja para gerenciar cupons.

***

### Lista de Cupons

Os cupons são exibidos em cards com as seguintes informações:

* **Nome** e **Código** do cupom
* **Desconto** — valor percentual ou fixo
* **Compra mínima** — se configurada
* **Usos** — quantidade usada em relação ao limite total (ex: `3 / 10`)
* **Status** — badge colorido indicando a situação atual

| Status   | Significado                        |
| -------- | ---------------------------------- |
| Ativo    | Cupom válido e disponível para uso |
| Inativo  | Cupom desativado manualmente       |
| Expirado | Data de validade ultrapassada      |

***

### Criar um Cupom

{% stepper %}
{% step %}

### **Clique em "Criar Cupom" no canto superior direito ou no botão no meio da tela se for a primeira vez que cria um cupom**

<figure><img src="/files/RMd1IE9lVWGtS1dqmR0O" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### O painel lateral será aberto à direita da tela

<figure><img src="/files/r1jrwGywdZogj4GbajAX" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Preencha os campos e clique em "Criar"**

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

***

### Editar um Cupom

{% stepper %}
{% step %}

### **No card do cupom desejado, clique em "Editar"**

<figure><img src="/files/pF9Swmlz9ONLaIST5gje" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### O painel lateral abrirá com os dados já preenchidos

<figure><img src="/files/Y5eE6cGv7uWU5MQPnWVJ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/GS4yD1GyUpDPXQdbP0N3" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Faça as alterações e clique em "Atualizar"**

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

***

### Campos do Formulário

#### Informações Básicas

| Campo         | Obrigatório | Descrição                                                                                          |
| ------------- | ----------- | -------------------------------------------------------------------------------------------------- |
| Nome do Cupom | Sim         | Nome interno para identificação (ex: `Promoção de Natal`)                                          |
| Código        | Sim         | Código que o cliente digita no pedido (ex: `PROMO10`) — convertido automaticamente para maiúsculas |
| Descrição     | Não         | Texto explicativo opcional (máximo 255 caracteres)                                                 |

***

#### Tipo e Valor do Desconto

| Campo    | Obrigatório | Descrição                                   |
| -------- | ----------- | ------------------------------------------- |
| Tipo     | Sim         | **Percentual** (%) ou **Valor Fixo** (R$)   |
| Desconto | Sim         | Valor do desconto conforme o tipo escolhido |

* **Percentual** — entre 1% e 100%
* **Valor Fixo** — entre R$ 0,01 e R$ 99.999,99

***

#### Restrições de Valor (apenas para cupons Percentuais)

| Campo                | Descrição                                                                         |
| -------------------- | --------------------------------------------------------------------------------- |
| Compra Mínima (R$)   | Valor mínimo do pedido para o cupom ser aplicado. Deixe em `0` para sem restrição |
| Desconto Máximo (R$) | Teto do desconto em R$, independente do percentual. Deixe em `0` para sem limite  |

Exemplo: cupom de 50% com desconto máximo de R$ 30,00 → em um pedido de R$ 100,00, o desconto aplicado será R$ 30,00 (não R$ 50,00).

***

#### Limites de Uso

| Campo                | Descrição                                                                        |
| -------------------- | -------------------------------------------------------------------------------- |
| Limite de Usos Total | Total de vezes que o cupom pode ser usado por todos os clientes. `0` = ilimitado |
| Limite por Cliente   | Quantas vezes o mesmo cliente pode usar o cupom (mínimo: 1)                      |

***

#### Validade

| Campo              | Descrição                                            |
| ------------------ | ---------------------------------------------------- |
| Válido A Partir De | Data e hora em que o cupom começa a valer (opcional) |
| Válido Até         | Data e hora em que o cupom expira (opcional)         |

* As datas não podem ser anteriores a hoje
* A data **"Válido Até"** não pode ser anterior à data **"Válido A Partir De"**
* Deixe os campos vazios para cupom sem prazo de validade

***

#### Status

Marque ou desmarque a opção **"Cupom ativo"** para ativar ou desativar o cupom manualmente. Um cupom desativado não pode ser usado pelo cliente, mesmo dentro do prazo de validade.

***

### Excluir um Cupom

{% stepper %}
{% step %}

### No card do cupom, clique no ícone de lixeira

<figure><img src="/files/aJJP3ZsDCCJbqUueYmWl" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Um modal de confirmação será exibido

<figure><img src="/files/KpwYPe7Doijw3wRJqtN8" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Confirme para excluir permanentemente

<figure><img src="/files/491L1dBu3qv7895hilci" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

> A exclusão é irreversível.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://traga-ja.gitbook.io/traga-ja/marketing/cupons.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.