Модификаторы товаров
Модификаторы позволяют привязать к товарам дополнительные опции, которые могут влиять на стоимость товара.
Модификаторы делятся на одиночные и групповые. Одиночные модификаторы всегда являются опциональными (необязательными для выбора). Групповые содержат несколько значений и могут быть обязательными.
Примером одиночного модификатора может быть опция подарочной упаковки. Групповым модификатором может быть выбор толщины теста для пиццы.
Используемые структуры
Модификатор
{
"id": "92b01917-5a92-4ae0-9683-575460b749a2",
"store_id": "8ffdea45-ca27-46fb-9e65-80abd8fdced8",
"modifiers_group_id": null,
"name": "Подарочная упаковка",
"display_name": "Подарочная упаковка",
"price": {
"value": 50000,
"short": "500",
"trimmed": "500",
"full": "500₽",
"currency": {
"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"created_at": {
"timezone": "Asia\/Irkutsk",
"datetime_utc": "2021-02-09 05:58:48",
"datetime": "2021-02-09 13:58:48",
"datetime_at": "09.02.2021 в 13:58",
"date": "09.02.2021",
"diff": "1 месяц назад",
"timestamp": 1612850328
},
"updated_at": {
"timezone": "Asia\/Irkutsk",
"datetime_utc": "2021-02-09 05:58:48",
"datetime": "2021-02-09 13:58:48",
"datetime_at": "09.02.2021 в 13:58",
"date": "09.02.2021",
"diff": "1 месяц назад",
"timestamp": 1612850328
}
}
Группа модификаторов
{
"id": "92b01945-d43e-427b-b7fe-4742da28dcf4",
"store_id": "8ffdea45-ca27-46fb-9e65-80abd8fdced8",
"name": "Доп. гарантия",
"display_name": "Доп. гарантия",
"created_at": {
"timezone": "Asia\/Irkutsk",
"datetime_utc": "2021-02-09 05:59:19",
"datetime": "2021-02-09 13:59:19",
"datetime_at": "09.02.2021 в 13:59",
"date": "09.02.2021",
"diff": "1 месяц назад",
"timestamp": 1612850359
},
"updated_at": {
"timezone": "Asia\/Irkutsk",
"datetime_utc": "2021-02-09 05:59:19",
"datetime": "2021-02-09 13:59:19",
"datetime_at": "09.02.2021 в 13:59",
"date": "09.02.2021",
"diff": "1 месяц назад",
"timestamp": 1612850359
},
"modifiers": [
{
"id": "92b01945-df0f-43c4-9a86-a7d565d5230a",
"store_id": "8ffdea45-ca27-46fb-9e65-80abd8fdced8",
"modifiers_group_id": "92b01945-d43e-427b-b7fe-4742da28dcf4",
"name": "1 год",
"display_name": "1 год",
"price": {
"value": 100000,
"short": "1 000",
"trimmed": "1000",
"full": "1 000₽",
"currency": {
"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"created_at": {
"timezone": "Asia\/Irkutsk",
"datetime_utc": "2021-02-09 05:59:19",
"datetime": "2021-02-09 13:59:19",
"datetime_at": "09.02.2021 в 13:59",
"date": "09.02.2021",
"diff": "1 месяц назад",
"timestamp": 1612850359
},
"updated_at": {
"timezone": "Asia\/Irkutsk",
"datetime_utc": "2021-02-09 05:59:19",
"datetime": "2021-02-09 13:59:19",
"datetime_at": "09.02.2021 в 13:59",
"date": "09.02.2021",
"diff": "1 месяц назад",
"timestamp": 1612850359
}
},
{
"id": "92b01945-dfe4-4f24-bc5f-e4dd928a0c8e",
"store_id": "8ffdea45-ca27-46fb-9e65-80abd8fdced8",
"modifiers_group_id": "92b01945-d43e-427b-b7fe-4742da28dcf4",
"name": "2 года",
"display_name": "2 года",
"price": {
"value": 200000,
"short": "2 000",
"trimmed": "2000",
"full": "2 000₽",
"currency": {
"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"created_at": {
"timezone": "Asia\/Irkutsk",
"datetime_utc": "2021-02-09 05:59:19",
"datetime": "2021-02-09 13:59:19",
"datetime_at": "09.02.2021 в 13:59",
"date": "09.02.2021",
"diff": "1 месяц назад",
"timestamp": 1612850359
},
"updated_at": {
"timezone": "Asia\/Irkutsk",
"datetime_utc": "2021-02-09 05:59:19",
"datetime": "2021-02-09 13:59:19",
"datetime_at": "09.02.2021 в 13:59",
"date": "09.02.2021",
"diff": "1 месяц назад",
"timestamp": 1612850359
}
},
{
"id": "92b01945-e0b1-4872-8745-e53cb8c147e3",
"store_id": "8ffdea45-ca27-46fb-9e65-80abd8fdced8",
"modifiers_group_id": "92b01945-d43e-427b-b7fe-4742da28dcf4",
"name": "5 лет",
"display_name": "5 лет",
"price": {
"value": 300000,
"short": "3 000",
"trimmed": "3000",
"full": "3 000₽",
"currency": {
"code": "RUB",
"name": "Российский рубль",
"thousands_separator": " ",
"decimals_separator": ".",
"prefix": "",
"suffix": "₽",
"symbol": "₽"
}
},
"created_at": {
"timezone": "Asia\/Irkutsk",
"datetime_utc": "2021-02-09 05:59:19",
"datetime": "2021-02-09 13:59:19",
"datetime_at": "09.02.2021 в 13:59",
"date": "09.02.2021",
"diff": "1 месяц назад",
"timestamp": 1612850359
},
"updated_at": {
"timezone": "Asia\/Irkutsk",
"datetime_utc": "2021-02-09 05:59:19",
"datetime": "2021-02-09 13:59:19",
"datetime_at": "09.02.2021 в 13:59",
"date": "09.02.2021",
"diff": "1 месяц назад",
"timestamp": 1612850359
}
}
]
}
Методы
Одиночные модификаторы
Создание модификатора
Список модификаторов
Просмотр модификатора
Редактирование модификатора
Удаление модификатора
Групповые модификаторы
Создание группы модификаторов
Каждым элементом поля modifiers
должен быть объект со следующими полями:
Список групповых модификаторов
Просмотр групповых модификаторов
Редактирование групповых модификаторов
Каждым элементом поля modifiers
должен быть объект со следующими полями:
Существующие модификаторы (те, у которых имеется поле id
) будут обновлены, новые будут созданы,
отсутствующие (те, которые были созданы ранее, но отсутствуют в поле modifiers
) будут удалены.
Удаление группы модификаторов
Работа с заказами
При работе с заказами вам может потребоваться API
пересчёта стоимости товара с выбранными модификаторами,
а так же передача модификаторов (поле modifiers
) в API
добавления и
удаления товаров из заказа.