Обновление уникального акционного предложения каталога

или

Личный кабинет

Обновление уникального акционного предложения каталогаServer-sideAdmin

put/v3/project/{project_id}/admin/unique_catalog_offer/{external_id}

Обновляет уникальное акционное предложение каталога.

SecuritybasicAuth

Request

path Parameters

project_id required	integer ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта. Example: 44056
external_id required	integer External ID акции. Уникальный идентификатор акции в рамках проекта. Example: coupon_44056_1

Request Body schema: application/json

required

object

Default: {"de-DE":"Gutscheintitel","en-US":"Coupon title"}

Название акции. Данный параметр должен содержать пары ключ/значение, где ключ — это локаль в формате "^[a-z]{2}-[A-Z]{2}$", значение — строка.

property name*

additional property

string

items

Array of strings

Список артикулов товаров, которые доступны после использования уникального предложения по каталогу.

Array of objects

Периоды действия акции. Если указано больше одного периода, параметры date_from и date_until становятся обязательными.

Array

date_from required	string <date-time> Дата начала действия указанной акции.
date_until	string or null <date-time> Дата окончания действия указанной акции. Если передано значение `null`, акция является бессрочной. Может быть `null`, только если указан один период действия.

redeem_code_limit

integer or null

Default: 10

Количество погашений по коду.

redeem_total_limit

integer or null

Default: 10

Ограничивает общее количество купонов.

redeem_user_limit

integer or null

Default: 10

Ограничивает общее количество купонов, погашаемых одним пользователем.

Responses

204

Уникальное предложение каталога было успешно обновлено.

401

Данные для базовой аутентификации не переданы или ошибочны. Убедитесь, что использовали базовую аутентификацию и проверьте правильность учетных данных.

404

Купон не найден. Убедитесь, что верно указали external_id.

422

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

Request samples

application/json

{"items": ["elven_sword",
"elven_boots"
],
"name": {"de-DE": "Neujahrsangebot",
"en-US": "New Year Offer"
},
"promotion_periods": [{"date_from": "2020-04-15T18:16:00+05:00",
"date_until": "2020-04-25T18:16:00+05:00"
}
],
"redeem_code_limit": 1,
"redeem_total_limit": 100,
"redeem_user_limit": 1
}

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}