Перейти к основному содержимому

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

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

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

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

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

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

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

По умолчанию в аккаунте Sailplay создаётся корневая категория, внутри которой можно создавать вложенные категории.

Во всех запросах, помимо авторизационных данных приложения, необходимо передавать:

  • название категории
  • SKU категории

При необходимости для категории можно указать коэффициент конвертации рублей в баллы, передав его в параметре points_rate.

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

  • Создание категории: /reference/basket-categories-add
  • Редактирование категории: /reference/basket-categories-edit
  • Получение списка категорий: /reference/basket-categories-list

Чтобы «сбросить» значение параметра (например, коэффициент конвертации), достаточно передать пустую строку.

Товары​

Методы API для работы с товарами предоставляют те же возможности, что и для категорий:

  • Создание товара: /reference/basket-products-add
  • Редактирование товара: /reference/basket-products-edit
  • Получение списка товаров: /reference/basket-products-list

Основным отличием является необходимость привязки товара к категории — для этого используется параметр category_sku.

Важно

При передаче SKU товаров или категорий в запросах на:

  • создание покупки (/reference/purchases-new)
  • расчёт акций (/reference/marketing-actions-calc)

если они отсутствуют в Sailplay, применяются следующие правила:

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