Работа с товарами и категориями

Корзина товаров и категории товаров

Для удобства интеграции и дальнейшей работы с программой лояльности в Sailplay API реализованы механизмы для загрузки и управления товарной номенклатурой, позволяющие перенести структуру товаров, организованную внутри вашей системы.

В качестве основного идентификатора при работе с товарами необходимо передавать параметр "SKU" - идентификатор, использующийся в вашей системе товарооборота.

Для каждой категории / товара можно указать:

• Идентификатор (SKU) (обязательный)
• Наименование товара / категории товаров
• Коэффициент конвертации рублей в баллы за покупку этого товара / покупку товара из данной категории

Категории товаров

По умолчанию в аккаунте Sailplay создается корневая категория, внутри которой можно создать вложенные категории. Во всех запросах помимо авторизационных данных приложения необходимо передавать наименование (название) и SKU категории. При необходимости для категории можно указать процент конвертации рублей в баллы, передав его в параметре "points_rate".
Чтобы создать категорию внутри уже существующей, необходимо передать в запросе SKU "родителя" в параметре "parent_sku".

При необходимости наименование и процент конвертации (но не SKU) категории могут быть изменены. Чтобы "сбросить" значение параметра (например коэффициент конвертации) достаточно передать в нем пустую строку.

Получение списка категорий товаров осуществляется запросом к методу api/v2/basket/categories/list/. Для получения списка вложенных категорий необходимо дополнительно передать SKU родительской категории в параметре "parent_sku".

Товары

В контексте работы с товарами методы API предоставляют те же возможности, что и при работе с категориями (создание, редактирование, получение списка товаров). Основным отличием является привязка товара к определенной категории путем указания ее SKU в параметре "category_sku".

❗️

Важно!

При передаче в запросах на создание покупки или расчет акций в составе корзины SKU товаров / категорий, которые не были добавлены в Sailplay ранее, к ним будут применены следующие правила обработки:

• Если товара с данным SKU нет в базе данных Sailplay - они создаются автоматически (без названия и остальных атрибутов).
• Если для данного товара нет специального коэффициента конвертации, проверяется есть ли коэффициент конвертации для данной категории, если и его нет - используется стандартный, указанный в настройках аккаунта.
• Если в массиве передан один и тот же товар несколько раз - их суммы предварительно складываются.