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

# Criar Cupom

Gera um código promocional. Pode ser de desconto fixo (`FIXED`) ou porcentagem (`PERCENTAGE`).

<ParamField header="Authorization" type="string" required>
  Token de acesso no formato `Bearer <seu_token>`.
</ParamField>

<ParamField body="code" type="string" required>
  Código do cupom (mínimo de 3 caracteres).
</ParamField>

<ParamField body="discount_type" type="string" required>
  Tipo de desconto: `PERCENTAGE` ou `FIXED`.
</ParamField>

<ParamField body="discount_value" type="number" required>
  Valor do desconto. Ex: 10 para 10% ou R\$10.
</ParamField>

<ParamField body="min_order_value" type="number">
  Valor mínimo do pedido para aplicar o cupom.
</ParamField>

<ParamField body="max_uses" type="number">
  Limite máximo de usos do cupom.
</ParamField>

<ParamField body="expires_at" type="string">
  Data de expiração no formato ISO 8601.
</ParamField>

<ParamField body="active" type="boolean" required>
  Status de ativação do cupom.
</ParamField>

<ParamField body="product_ids" type="array" required>
  Lista de IDs (UUID) de produtos válidos para o cupom. Array vazio aplica a todos.
</ParamField>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "uuid-do-cupom",
    "store_id": "uuid-da-loja",
    "code": "PROMO10",
    "discount_type": "PERCENTAGE",
    "discount_value": 10,
    "min_order_value": null,
    "max_uses": null,
    "used_count": 0,
    "expires_at": null,
    "active": true,
    "product_ids": [],
    "created_at": "2024-01-01T00:00:00.000Z",
    "updated_at": "2024-01-01T00:00:00.000Z"
  }
  ```
</ResponseExample>