Skip to main content
POST
/
{alias}
/
discounts
Criar um desconto da loja
curl --request POST \
  --url https://api.dooki.com.br/v2/{alias}/discounts \
  --header 'Content-Type: application/json' \
  --header 'User-Secret-Key: <api-key>' \
  --header 'User-Token: <api-key>' \
  --data '{
  "name": "Promoção de Outubro",
  "discount_method": "percent",
  "discount_value": 20,
  "discount_type": "buy_x_get_y",
  "entry_condition_type": "amount",
  "entry_condition_value": 1,
  "accumulate": false,
  "start_at": {
    "date": "2000-08-17 10:24:24",
    "timezone_type": 3,
    "timezone": "America/Sao_Paulo"
  },
  "end_at": "2025-10-15 23:59:59",
  "restrictions": {
    "include": {
      "brands_ids": [
        1,
        2,
        3
      ],
      "products_ids": [
        5,
        6
      ],
      "categories_ids": [
        10,
        11
      ],
      "collections_ids": [
        20,
        21
      ]
    }
  },
  "specifications": {
    "set_cart_usage_limit": true,
    "cart_usage_limit": 1,
    "get_products_quantity": 1,
    "restrictions": {
      "include": {
        "brands_ids": [
          11
        ],
        "products_ids": [
          51
        ],
        "categories_ids": [
          4
        ],
        "collections_ids": [
          9
        ]
      }
    }
  }
}'
{
  "id": 1520,
  "store_id": 1319250,
  "discount_type_id": 1520,
  "name": "Lucas",
  "entry_condition_type": "amount",
  "entry_condition_value": 10,
  "discount_method": "percent",
  "discount_value": 100,
  "discount_type": "buy_x_get_y",
  "accumulate": false,
  "start_at": {
    "date": "2000-08-17 10:24:24",
    "timezone_type": 3,
    "timezone": "America/Sao_Paulo"
  },
  "end_at": {
    "date": "2000-08-17 10:24:24",
    "timezone_type": 3,
    "timezone": "America/Sao_Paulo"
  },
  "created_at": {
    "date": "2000-08-17 10:24:24",
    "timezone_type": 3,
    "timezone": "America/Sao_Paulo"
  },
  "updated_at": {
    "date": "2000-08-17 10:24:24",
    "timezone_type": 3,
    "timezone": "America/Sao_Paulo"
  }
}

Authorizations

​
User-Token
string
header
required
​
User-Secret-Key
string
header
required

Path Parameters

​
alias
string
required

Alias da loja

Body

application/json

Dados para criação do desconto

​
name
string | null
required

Nome do desconto.

Required string length: 3 - 100
Example:

"Promoção de Outubro"

​
discount_method
enum<string>
required

Método de desconto.

Available options:
percent,
amount
Example:

"percent"

​
discount_value
number
required

Valor do desconto. Se percentual, o máximo é 100.

Required range: x >= 0.01
Example:

20

​
discount_type
enum<string>
required

Tipo do desconto.

Available options:
buy_x_get_y
Example:

"buy_x_get_y"

​
entry_condition_type
enum<string>
required

Tipo de condição para aplicar o desconto.

Available options:
amount,
quantity
Example:

"amount"

​
entry_condition_value
required

Valor mínimo (quantidade de produto ou valor do carrinho) necessário para ativar o desconto.

Required range: x >= 1
Example:

1

​
accumulate
boolean
required

Define se o desconto pode acumular com outras promoções.

Example:

false

​
start_at
object
required
​
restrictions
object
required

Restrições de aplicação do desconto.

​
end_at
object

Data/hora de término. Deve ser posterior ao start_at.

Example:

"2025-10-15 23:59:59"

​
specifications
object

Configurações da promoção escolhida

Response

Detalhes do desconto

Representa os atributos de um Desconto

​
id
integer
Example:

1520

​
store_id
integer
Example:

1319250

​
discount_type_id
integer
Example:

1520

​
name
string
Example:

"Lucas"

​
entry_condition_type
string
Example:

"amount"

​
entry_condition_value
number
Example:

10

​
discount_method
string
Example:

"percent"

​
discount_value
number
Example:

100

​
discount_type
string
Example:

"buy_x_get_y"

​
accumulate
boolean
Example:

false

​
start_at
object
​
end_at
object
​
created_at
object
​
updated_at
object
⌘I