---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.2
alternate:
  - https://yandex.ru/dev/kit/ru/openapi/Tovary/index.md
  - href: ru/openapi/Tovary/index.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/kit/ru/llms.txt

# Товары

<!-- markdownlint-disable-file -->

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

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

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

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

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

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

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

{% note info %}

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

{% endnote %}

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

Для продукта можно настроить разделяющие характеристики (`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

- [Получение списка продуктов](https://yandex.ru/dev/kit/ru/openapi/Tovary/GetProducts.md)
- [Создание нового продукта](https://yandex.ru/dev/kit/ru/openapi/Tovary/CreateProduct.md)
- [Получение продукта по ID](https://yandex.ru/dev/kit/ru/openapi/Tovary/GetProductById.md)
- [Обновление продукта](https://yandex.ru/dev/kit/ru/openapi/Tovary/UpdateProduct.md)
- [Получение списка похожих карточек товара.](https://yandex.ru/dev/kit/ru/openapi/Tovary/GetSimilarProductCardIDs.md)
- [Добавление похожих карточек товара](https://yandex.ru/dev/kit/ru/openapi/Tovary/AddSimilarProductCards.md)
- [Удаление похожих карточек товара](https://yandex.ru/dev/kit/ru/openapi/Tovary/DeleteSimilarProductCards.md)
- [Получение списка товаров](https://yandex.ru/dev/kit/ru/openapi/Tovary/GetVariants.md)
- [Создание нового товара](https://yandex.ru/dev/kit/ru/openapi/Tovary/CreateVariant.md)
- [Получение товара по ID](https://yandex.ru/dev/kit/ru/openapi/Tovary/GetVariantById.md)
- [Безвозвратное удаление архивного товара](https://yandex.ru/dev/kit/ru/openapi/Tovary/DeleteVariant.md)
- [Обновление товара](https://yandex.ru/dev/kit/ru/openapi/Tovary/UpdateVariant.md)
- [Архивирование товара](https://yandex.ru/dev/kit/ru/openapi/Tovary/ArchiveVariant.md)
- [Восстановление товара из архива](https://yandex.ru/dev/kit/ru/openapi/Tovary/UnarchiveVariant.md)
- [Получение внешних идентификаторов товара](https://yandex.ru/dev/kit/ru/openapi/Tovary/GetVariantExternalIDs.md)
- [Установка внешнего идентификатора](https://yandex.ru/dev/kit/ru/openapi/Tovary/SetVariantExternalID.md)
- [Удаление внешнего идентификатора](https://yandex.ru/dev/kit/ru/openapi/Tovary/DeleteVariantExternalID.md)
- [Получение документов товара](https://yandex.ru/dev/kit/ru/openapi/Tovary/GetVariantAttachments.md)
- [Прикрепление документа к товару](https://yandex.ru/dev/kit/ru/openapi/Tovary/CreateVariantAttachment.md)
- [Открепление документа от товара](https://yandex.ru/dev/kit/ru/openapi/Tovary/DeleteVariantAttachment.md)
- [Обновление документа товара](https://yandex.ru/dev/kit/ru/openapi/Tovary/UpdateVariantAttachment.md)
- [Массовое обновление остатков](https://yandex.ru/dev/kit/ru/openapi/Tovary/BulkUpdateStocks.md)
- [Массовое обновление цен](https://yandex.ru/dev/kit/ru/openapi/Tovary/BulkUpdatePrices.md)