> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brindehub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Criando cupons

> Preencha o formulário de cupom com código, tipo, valor, duração e status.

# Criando cupons

Para adicionar um cupom, clique em **Novo cupom** na tabela e preencha o formulário. O processa os dados e cria o cupom.

## Campos do formulário

| Campo              | Descrição                                                                                        |
| ------------------ | ------------------------------------------------------------------------------------------------ |
| **Código**         | Texto obrigatório. Convertido para maiúsculas e sem espaços.                                     |
| **Tipo**           | **Porcentagem**, **Valor fixo** ou **Frete grátis**.                                             |
| **Valor**          | Obrigatório para porcentagem e valor fixo; oculto e zerado para frete grátis.                    |
| **Duração**        | **Limite de usos** ou **Data de expiração**.                                                     |
| **Máximo de usos** | Aparece quando a duração é **Limite de usos**. Deve ser um número positivo.                      |
| **Expira em**      | Aparece quando a duração é **Data de expiração**. Data no formato padrão, validada até 23:59:59. |
| **Ativo**          | Define se o cupom está disponível para uso. Padrão: **Sim**.                                     |

## Regras de validação

* O código deve ser único na loja. Duplicidade retorna "Código de cupom já em uso".
* Para **Porcentagem** e **Valor fixo**, o valor deve ser maior que 0.
* **Frete grátis** sempre envia o valor 0.
* **Máximo de usos** é obrigatório e positivo quando a duração é **Limite de usos**.
* **Expira em** é obrigatória quando a duração é **Data de expiração**.

> **Atenção:**
> Cupons com status **Inativo** não são aplicados em vendas, mesmo que ainda possuam usos restantes ou data futura.

> **Dica:**
> Use códigos curtos e fáceis de digitar, como `BRINDE2026` ou `PRIMEIRA10`.

Voltar para [Cupons](./index).