Товары

Управление товарами в каталоге.

Товар - это минимальная единица ассортимента, которая может быть продана покупателю. У товара есть цена, наличие на складе и другие параметры. Продукт - это абстрактная сущность, которая объединяет один или несколько товаров, с одинаковыми категориями.

Варианты товаров

Продукт может содержать несколько вариантов (товаров). Например, футболка одной модели может иметь варианты с разными размерами и цветами. Чтобы создать несколько вариантов в одном продукте, создайте товары с одинаковым product_id.

Управление группировкой товаров

Чтобы добавить несколько товаров в один продукт:

  1. Добавьте хотя бы один товар в продукт.
  2. Задайте для товара все группирующие характеристики продукта. Без них товар не добавится в продукт.
  3. Настройте группирующие характеристики продукта — это делается через метод обновления продукта.

Примечание

  • После добавления товара в продукт нельзя удалить значения группирующих характеристик.
  • В продукте не может быть двух товаров с полностью одинаковыми значениями группирующих характеристик.

Разделяющие характеристики

Для продукта можно настроить разделяющие характеристики (splitting_characteristics) — они нужны, чтобы разделить товары продукта на отдельные карточки в каталоге.

Правила работы с разделяющими характеристиками:

  • разделяющие характеристики должны быть одновременно и группирующими характеристиками продукта;
  • товары разделяются на карточки по уникальным значениям этих характеристик.

Мультикатегории

При создании и обновлении продукта его можно привязать к одной или нескольким категориям (параметр category_ids).

Правила работы с категориями:

  1. В ответах API (Product.category_ids) отображаются только активные (неархивированные) категории продукта.

  2. Продукт с товарами в статусах PUBLISHED или HIDDEN должен иметь хотя бы одну категорию. При обновлении продукта передача пустого параметра category_ids приведет к отклонению запроса.

  3. При обновлении category_ids список привязок категорий продукта полностью заменяется на переданный:

    • архивированные категории привязываются к продукту, но остаются в статусе ARCHIVED и не отображаются в Product.category_ids в ответах API;
    • передача архивированного ID не разархивирует категорию;
    • после запроса POST /v1/categories/{id}/unarchive ранее привязанная архивированная категория появится в Product.category_ids.

  4. Если у продукта с неархивными товарами остались только архивированные категории, их можно восстановить при разархивации товара с помощью запроса POST /v1/variants/{id}/unarchive.

Endpoints

Предыдущая
Получение файла по ID
Следующая
Получение списка продуктов