Xsolla-logo

Обновление акции со скидкамиServer-sideAdmin

put/v2/project/{project_id}/admin/promotion/{promotion_id}/item

Обновляет акцию.

Примечание

Новые данные заменят старые. Если вы хотите обновить только часть акции, вам также следует передать в запросе все необходимые данные.

Акция дает скидку (%) на товары. Скидка будет применена ко всем ценам на указанные товары.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.

Example: 44056
promotion_id
required
integer

ID акции. Уникальный идентификатор акции в рамках проекта.

Example: 111425
Request Body schema: application/json

Объект с данными акции.

required
Array of objects
Array
sku
required
string
Default: "elven_sword"

Артикул товара.

required
object
percent
required
string

Процент скидки. Цена товара будет уменьшена с использованием значения, рассчитанного с использованием этого процента, а затем округлена до 2 знаков после запятой.

required
object

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

property name*
additional property
string
Array of type = string (objects) or Array of type = date (objects) or Array of type = number (objects)
One of:

Условия, которые сравниваются со значениями пользовательских атрибутов. Чтобы действие вступило в силу, все условия должны быть выполнены.

[ 1 .. 100 ] items
Array ([ 1 .. 100 ] items)
attribute
required
string [ 1 .. 255 ] characters ^[-_.\\d\\w]+$

Код атрибута пользователя.

operator
required
string

Тип операции, выполняемой по условию. Для типа атрибута string.

Enum: Description
eq

Равно

ne

Не равно

value
required
string <= 255 characters

Значение условия, с которым будет сравниваться значение атрибута пользователя. Тип зависит от типа атрибута.

type
required
string

Тип атрибута пользователя.

Value: "string"
can_be_missing
boolean

Считается ли условие выполненным, если этот атрибут отсутствует в атрибутах пользователя. Передайте true, чтобы показывать товар пользователям, у которых нет этого атрибута. Пользователи у которых атрибут есть, но значение не совпадает с указанным в условии, не увидят товар.false — пользователи у которых атрибут есть, но значение не совпадает с указанным в условии, или атрибута нет, не увидят товар.

date_end
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

Дата, когда ваша акция будет завершена. Может быть null.

date_start
string or null <date-time>
Default: "2020-04-15T18:16:00+05:00"

Дата, когда начнется ваша акция.

object

Ограничения акции.

per_user
integer or null

Ограничение количества использований акций отдельным пользователем.

object or null

Период обновления установленный ограничений.

interval_type = daily (object) or interval_type = weekly (object) or interval_type = monthly (object)
One of:

Ежедневное обновления пользовательских ограничений.

interval_type
required
string

Период обновления ограничений.

Value: "daily"
time
required
string((0[0-9]|1[0-9]|2[0-3]):00:00)(\+|-)(0[0-9]|1...

Время обновления ограничений в желаемом часовом поясе (округление до часов).

object or null

Условие применения акции к товарам, чьи цены находятся в указанном ценовом диапазоне. В объекте price_range_condition необходимо передать значение хотя бы для одного из параметров: lower_limit или upper_limit.
Если вы указали перечень товаров в объекте items, акция применяется только к товарам из этого объекта в указанном ценовом диапазоне.
Чтобы условие применения акции распространялось на все товары, в объекте items передайте значение null.

lower_limit
required
string or null

Нижняя граница ценового диапазона для применения акции. Если значение lower_limit указано, акция будет применяться только для товаров, цена которых больше этого значения или равна ему. Значение цены должно быть указано в валюте по умолчанию.
Пример: "10.0000"

upper_limit
required
string or null

Верхний предел диапазона цен для применения акции. Если этот параметр upper_limit установлен, акции будут распространяться только на товары, цена которых меньше или равна этому значению. Значение цены должно быть указано в валюте по умолчанию.
Пример: "20.0000"

Responses
204

Акция успешно обновлена.

401

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

404

Акция не найдена. Убедитесь, что верно указали promotion_id.

422

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

Request samples
application/json
{
  • "attribute_conditions": [
    ],
  • "date_end": "2020-04-25T18:16:00+05:00",
  • "date_start": "2020-04-15T18:16:00+05:00",
  • "discount": {
    },
  • "items": null,
  • "name": {
    }
}
Response samples
application/json
{
  • "errorCode": 1020,
  • "errorMessage": "[0401-1020]: Error in Authentication method occurred",
  • "statusCode": 401
}