Модификаторы товаров

Модификаторы позволяют привязать к товарам дополнительные опции, которые могут влиять на стоимость товара.

Модификаторы делятся на одиночные и групповые. Одиночные модификаторы всегда являются опциональными (необязательными для выбора). Групповые содержат несколько значений и могут быть обязательными.

Примером одиночного модификатора может быть опция подарочной упаковки. Групповым модификатором может быть выбор толщины теста для пиццы.

Используемые структуры

Модификатор

{
    "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": "₽"
        }
    },
    "sku": null,
    "created_at": {
        "timezone": "Asia\/Irkutsk",
        "datetime_utc": "2021-02-09 08:58:48",
        "datetime": "2021-02-09 16:58:48",
        "datetime_at": "09.02.2021 в 16:58",
        "date": "09.02.2021",
        "diff": "1 год назад",
        "timestamp": 1612861128,
        "iso_utc": "2021-02-09T08:58:48+00:00",
        "iso": "2021-02-09T16:58:48+08:00"
    },
    "updated_at": {
        "timezone": "Asia\/Irkutsk",
        "datetime_utc": "2021-02-09 08:58:48",
        "datetime": "2021-02-09 16:58:48",
        "datetime_at": "09.02.2021 в 16:58",
        "date": "09.02.2021",
        "diff": "1 год назад",
        "timestamp": 1612861128,
        "iso_utc": "2021-02-09T08:58:48+00:00",
        "iso": "2021-02-09T16:58:48+08:00"
    }
}

Группа модификаторов

{
    "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 08:59:19",
        "datetime": "2021-02-09 16:59:19",
        "datetime_at": "09.02.2021 в 16:59",
        "date": "09.02.2021",
        "diff": "1 год назад",
        "timestamp": 1612861159,
        "iso_utc": "2021-02-09T08:59:19+00:00",
        "iso": "2021-02-09T16:59:19+08:00"
    },
    "updated_at": {
        "timezone": "Asia\/Irkutsk",
        "datetime_utc": "2021-02-09 08:59:19",
        "datetime": "2021-02-09 16:59:19",
        "datetime_at": "09.02.2021 в 16:59",
        "date": "09.02.2021",
        "diff": "1 год назад",
        "timestamp": 1612861159,
        "iso_utc": "2021-02-09T08:59:19+00:00",
        "iso": "2021-02-09T16:59:19+08:00"
    },
    "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": "₽"
                }
            },
            "sku": null,
            "created_at": {
                "timezone": "Asia\/Irkutsk",
                "datetime_utc": "2021-02-09 08:59:19",
                "datetime": "2021-02-09 16:59:19",
                "datetime_at": "09.02.2021 в 16:59",
                "date": "09.02.2021",
                "diff": "1 год назад",
                "timestamp": 1612861159,
                "iso_utc": "2021-02-09T08:59:19+00:00",
                "iso": "2021-02-09T16:59:19+08:00"
            },
            "updated_at": {
                "timezone": "Asia\/Irkutsk",
                "datetime_utc": "2021-02-09 08:59:19",
                "datetime": "2021-02-09 16:59:19",
                "datetime_at": "09.02.2021 в 16:59",
                "date": "09.02.2021",
                "diff": "1 год назад",
                "timestamp": 1612861159,
                "iso_utc": "2021-02-09T08:59:19+00:00",
                "iso": "2021-02-09T16:59:19+08:00"
            }
        },
        {
            "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": "₽"
                }
            },
            "sku": null,
            "created_at": {
                "timezone": "Asia\/Irkutsk",
                "datetime_utc": "2021-02-09 08:59:19",
                "datetime": "2021-02-09 16:59:19",
                "datetime_at": "09.02.2021 в 16:59",
                "date": "09.02.2021",
                "diff": "1 год назад",
                "timestamp": 1612861159,
                "iso_utc": "2021-02-09T08:59:19+00:00",
                "iso": "2021-02-09T16:59:19+08:00"
            },
            "updated_at": {
                "timezone": "Asia\/Irkutsk",
                "datetime_utc": "2021-02-09 08:59:19",
                "datetime": "2021-02-09 16:59:19",
                "datetime_at": "09.02.2021 в 16:59",
                "date": "09.02.2021",
                "diff": "1 год назад",
                "timestamp": 1612861159,
                "iso_utc": "2021-02-09T08:59:19+00:00",
                "iso": "2021-02-09T16:59:19+08:00"
            }
        },
        {
            "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": "₽"
                }
            },
            "sku": null,
            "created_at": {
                "timezone": "Asia\/Irkutsk",
                "datetime_utc": "2021-02-09 08:59:19",
                "datetime": "2021-02-09 16:59:19",
                "datetime_at": "09.02.2021 в 16:59",
                "date": "09.02.2021",
                "diff": "1 год назад",
                "timestamp": 1612861159,
                "iso_utc": "2021-02-09T08:59:19+00:00",
                "iso": "2021-02-09T16:59:19+08:00"
            },
            "updated_at": {
                "timezone": "Asia\/Irkutsk",
                "datetime_utc": "2021-02-09 08:59:19",
                "datetime": "2021-02-09 16:59:19",
                "datetime_at": "09.02.2021 в 16:59",
                "date": "09.02.2021",
                "diff": "1 год назад",
                "timestamp": 1612861159,
                "iso_utc": "2021-02-09T08:59:19+00:00",
                "iso": "2021-02-09T16:59:19+08:00"
            }
        }
    ]
}

Методы

Одиночные модификаторы

Создание модификатора

Список модификаторов

Просмотр модификатора

Редактирование модификатора

Удаление модификатора

Групповые модификаторы

Создание группы модификаторов

Каждым элементом поля modifiers должен быть объект со следующими полями:

Список групповых модификаторов

Просмотр групповых модификаторов

Редактирование групповых модификаторов

Каждым элементом поля modifiers должен быть объект со следующими полями:

Существующие модификаторы (те, у которых имеется поле id) будут обновлены, новые будут созданы, отсутствующие (те, которые были созданы ранее, но отсутствуют в поле modifiers) будут удалены.

Удаление группы модификаторов

Работа с заказами

При работе с заказами вам может потребоваться API пересчёта стоимости товара с выбранными модификаторами, а так же передача модификаторов (поле modifiers) в API добавления и удаления товаров из заказа.