Обновление промокода

Deprecated

Обновляет промокод по уникальному идентификатору.

Request

PATCH

https://api.kit.yandex.net/v1/promocodes/{id}

Body

application/json
{
  "code": "HELLO5",
  "title": "Скидка 5% на все товары",
  "discount_value": {
    "value": "10.00",
    "type": "PERCENT"
  },
  "promocode_dates": {
    "start_date": "2025-01-01T00:00:00Z",
    "end_date": "2025-01-01T00:00:00Z"
  },
  "status": "ACTIVE",
  "binding_mode": "ALL_VARIANTS",
  "minimum_order_amount": "1000.00",
  "max_usage": 100,
  "max_discount_amount": "1000",
  "one_time_use": true,
  "first_order_only": true,
  "show_in_pdp": true
}

Name

Description

binding_mode

Type: PromocodeBindingMode

Режим применения промокода. Применим только для промокодов типа PRODUCTS:

  • ALL_VARIANTS — промокод применяется ко всем товарам магазина.
  • SELECTED_VARIANTS — промокод применяется к выбранным товарам.
  • SELECTED_CATEGORIES_COLLECTIONS — промокод применяется к товарам из выбранных категорий и коллекций.

Enum: ALL_VARIANTS, SELECTED_VARIANTS, SELECTED_CATEGORIES_COLLECTIONS

code

Type: string

Код промокода.

Example: HELLO5

discount_value

Type: DiscountValue

Информация о значении скидки и о типе скидки.

Example
{
  "value": "10.00",
  "type": "PERCENT"
}

first_order_only

Type: boolean

Можно ли использовать промокод только для первого заказа.

Default: false

max_discount_amount

Type: string<decimal> | null

Максимальная сумма скидки по промокоду (поле опционально). Не передавайте ключ, чтобы не менять значение (null — без ограничения на сумму скидки).

Example: 1000

max_usage

Type: integer | null

Максимальное количество использований промокода (поле опционально). Не передавайте ключ, чтобы не менять значение (null — без ограничения на количество использований).

minimum_order_amount

Type: string<decimal>

Минимальная сумма заказа для использования промокода.

Default: 0.00

Example: 1000.00

one_time_use

Type: boolean

Можно ли использовать промокод только один раз.

Default: false

promocode_dates

Type: PromocodeDates

Example
{
  "start_date": "2025-01-01T00:00:00Z",
  "end_date": "2025-01-01T00:00:00Z"
}

show_in_pdp

Type: boolean

Показывать ли промокод на странице товара.

Default: false

status

Type: PromocodeStatus

Статус промокода:

  • ACTIVE — активный.
  • INACTIVE — неактивный.

Enum: ACTIVE, INACTIVE

title

Type: string

Название промокода.

Example: Скидка 5% на все товары

DiscountValue

Информация о значении скидки и о типе скидки.

Name

Description

type

Type: string

Тип скидки:

  • PERCENT — скидка в процентах от цены товара.
  • VALUE — скидка в абсолютном значении (в рублях).

Enum: PERCENT, VALUE

value

Type: string<decimal>

  • Для типа PERCENT — значение от 0 до 100 (например, 10.5).

  • Для типа VALUE — сумма в рублях (например, 500.00).

Example: 10.00
Example
{
  "value": "10.00",
  "type": "PERCENT"
}

PromocodeDates

Name

Description

start_date

Type: string<date-time>

Дата начала действия промокода.

Example: 2025-01-01T00:00:00Z

end_date

Type: string<date-time>

Дата окончания действия промокода. Если не указана, то промокод действует бесконечно.

Example: 2025-01-01T00:00:00Z
Example
{
  "start_date": "2025-01-01T00:00:00Z",
  "end_date": "2025-01-01T00:00:00Z"
}

PromocodeStatus

Статус промокода:

  • ACTIVE — активный.
  • INACTIVE — неактивный.

Type: string

Enum: ACTIVE, INACTIVE

PromocodeBindingMode

Режим применения промокода. Применим только для промокодов типа PRODUCTS:

  • ALL_VARIANTS — промокод применяется ко всем товарам магазина.
  • SELECTED_VARIANTS — промокод применяется к выбранным товарам.
  • SELECTED_CATEGORIES_COLLECTIONS — промокод применяется к товарам из выбранных категорий и коллекций.

Type: string

Enum: ALL_VARIANTS, SELECTED_VARIANTS, SELECTED_CATEGORIES_COLLECTIONS

Responses

200 OK

Промокод успешно обновлен.

Body

application/json
{
  "id": "019b21d9-c5d9-777d-80bd-d67c664bc6d9",
  "code": "HELLO5",
  "title": "Скидка 5% на все товары",
  "discount_value": {
    "value": "10.00",
    "type": "PERCENT"
  },
  "minimum_order_amount": "1000.00",
  "max_usage": 100,
  "max_discount_amount": "1000",
  "one_time_use": true,
  "first_order_only": true,
  "promocode_dates": {
    "start_date": "2025-01-01T00:00:00Z",
    "end_date": "2025-01-01T00:00:00Z"
  },
  "binding_mode": "ALL_VARIANTS",
  "status": "ACTIVE",
  "usage_count": 100,
  "created_at": "2020-01-01T00:00:00Z",
  "updated_at": "2020-01-01T00:00:00Z",
  "type": "ORDER",
  "show_in_pdp": true
}

Name

Description

code

Type: string

Код промокода.

Example: HELLO5

created_at

Type: string<date-time>

Дата создания промокода.

Example: 2020-01-01T00:00:00Z

discount_value

Type: DiscountValue

Информация о значении скидки и о типе скидки.

Example
{
  "value": "10.00",
  "type": "PERCENT"
}

first_order_only

Type: boolean

Можно ли использовать промокод только для первого заказа.

id

Type: PromocodeID

Идентификатор промокода.

Example: 019b21d9-c5d9-777d-80bd-d67c664bc6d9

one_time_use

Type: boolean

Можно ли использовать промокод только один раз.

promocode_dates

Type: PromocodeDates

Example
{
  "start_date": "2025-01-01T00:00:00Z",
  "end_date": "2025-01-01T00:00:00Z"
}

status

Type: PromocodeStatus

Статус промокода:

  • ACTIVE — активный.
  • INACTIVE — неактивный.

Enum: ACTIVE, INACTIVE

title

Type: string

Название промокода.

Example: Скидка 5% на все товары

type

Type: PromocodeType

Тип промокода:

  • ORDER — промокод на заказ.
  • PRODUCTS — промокод на товары.

Enum: ORDER, PRODUCTS

updated_at

Type: string<date-time>

Дата обновления промокода.

Example: 2020-01-01T00:00:00Z

usage_count

Type: integer

Количество использований промокода.

binding_mode

Type: PromocodeBindingMode

Режим применения промокода. Применим только для промокодов типа PRODUCTS:

  • ALL_VARIANTS — промокод применяется ко всем товарам магазина.
  • SELECTED_VARIANTS — промокод применяется к выбранным товарам.
  • SELECTED_CATEGORIES_COLLECTIONS — промокод применяется к товарам из выбранных категорий и коллекций.

Enum: ALL_VARIANTS, SELECTED_VARIANTS, SELECTED_CATEGORIES_COLLECTIONS

max_discount_amount

Type: string<decimal>

Максимальная сумма скидки по промокоду.

Example: 1000

max_usage

Type: integer

Максимальное количество использований промокода.

minimum_order_amount

Type: string<decimal>

Минимальная сумма заказа для использования промокода.

Example: 1000.00

show_in_pdp

Type: boolean

Показывать ли промокод на странице товара. Применим только для промокодов типа PRODUCTS.

PromocodeID

Идентификатор промокода.

Type: string<uuid>

Example: 019b21d9-c5d9-777d-80bd-d67c664bc6d9

PromocodeType

Тип промокода:

  • ORDER — промокод на заказ.
  • PRODUCTS — промокод на товары.

Type: string

Enum: ORDER, PRODUCTS

400 Bad Request

Некорректный запрос.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

401 Unauthorized

Не авторизован.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

404 Not Found

Ресурс не найден.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

500 Internal Server Error

Внутренняя ошибка сервера.

Body

application/json
{
  "code": "VALIDATION_ERROR",
  "message": "Invalid input",
  "trace_id": "00000000000000000000000000000000"
}

Name

Description

code

Type: string

Example: VALIDATION_ERROR

message

Type: string

Example: Invalid input

trace_id

Type: string

Уникальный идентификатор запроса для отладки.

Example: 00000000000000000000000000000000

No longer supported, please use an alternative and newer version.

Предыдущая
Получение промокода по уникальному идентификатору
Следующая
Получение списка промокодов