Skip to main content
PUT
/
{alias}
/
discounts
/
{id}
Atualizar um desconto da loja
curl --request PUT \
  --url https://api.dooki.com.br/v2/{alias}/discounts/{id} \
  --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"
  },
  "restrictions": {
    "include": {
      "brands_ids": [
        1,
        2,
        3
      ],
      "products_ids": [
        5,
        6
      ],
      "categories_ids": [
        10,
        11
      ],
      "collections_ids": [
        20,
        21
      ]
    }
  },
  "end_at": "2025-10-15 23:59:59",
  "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
        ]
      }
    }
  }
}
'
{
  "data": [
    {
      "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"
      }
    }
  ],
  "restrictions": {
    "include": {
      "products_ids": [
        123
      ],
      "brands_ids": [
        123
      ],
      "collections_ids": [
        123
      ],
      "categories_ids": [
        123
      ]
    },
    "include_ids": [
      123
    ]
  },
  "specifications": {
    "data": {
      "cart_usage_limit": 0,
      "get_products_quantity": 1,
      "set_cart_usage_limit": false
    },
    "restrictions": {
      "include": {
        "products_ids": [
          123
        ],
        "brands_ids": [
          123
        ],
        "collections_ids": [
          123
        ],
        "categories_ids": [
          123
        ]
      },
      "include_ids": [
        123
      ]
    }
  }
}

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 atualizar o 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
Maximum string length: 10
Example:

"percent"

​
discount_value
number<float>
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
Maximum string length: 15
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

Exibe detalhes das regras do desconto

​
data
object[]
​
restrictions
object

Restrições gerais para aplicação do desconto.

​
specifications
object

Configurações para aplicação do desconto.