Справочник API

Товары

Каталог отдаётся одним и тем же эндпоинтом покупателю и интеграции — различается только набор полей. По ключу с правами на товары вы получаете служебные поля: физический остаток без вычета резервов, код маркировки, настройки производства и лимиты продаж. С 16.09.2026 товар может быть заведён не только на размерах, но и на системе атрибутов (Размер, Цвет, Принт — в любой комбинации). Ответ дополнен полями attributes[] (какие атрибуты и значения есть у товара) и variants[] (конкретные комбинации значений со своим остатком) — см. термин «Атрибут и вариант». Поле sizes[] и адресация по sizeId остаются рабочими для товаров на легаси-размере; variantId — рекомендуемый способ для новых интеграций.

GET/products

Список товаров

Каталог бренда с размерами, ценами и остатками.

Доступ:Ключ интеграцииСессия сотрудникаБез авторизацииПраво:manage_products или products.view_production — для служебных полей

Набор полей зависит от прав ключа. Без прав на товары ответ будет таким же, каким его видит покупатель: без служебных полей.

Что важно знать

Поле quantity у размера — доступный остаток, а не физический. Если вы читаете остаток, меняете и пишете обратно, берите physicalQuantity, иначе резервы будут вычитаться повторно при каждом круге.
Признаков «нет в наличии» три, и они означают разное: inStock — ручной флаг, soldout — ручная пометка «продано», а исчерпанный лимит продаж вычисляется сам.
Цены задаются у товара. Поля цены у размера существуют, но платформа их обнуляет при любой записи — посразмерные цены отключены.
attributes[]/variants[] отдаются, только если у товара реально настроены атрибуты в админке — у обычного товара на легаси-размере оба массива пустые, ориентируйтесь на sizes[] как раньше.

Параметры запроса

Параметр	Тип	Обязателен	Описание
`category`	string \| number	нет	Число понимается как идентификатор категории, строка — как её точное название.
`search`	string	нет	Поиск по названию и адресному имени.
`hasDiscount`	true \| false	нет	Только со скидкой либо только без неё.
`collectionId`	string	нет	Товары одной коллекции.
`sortBy`	string	нет	Порядок. Неизвестное значение молча заменяется порядком по умолчанию.name_asc · name_desc · price_asc · price_desc · newest · oldest
`inStock`	true \| false	нет	Ручной флаг наличия. Служебный фильтр — покупателю такого выбора нет.
`soldout`	true \| false	нет	Ручная пометка «продано».
`isDeleted`	true \| false	нет	Показать удалённые товары. Без прав на товары игнорируется.
`brand`	string	нет	Код бренда — только если ключ имеет доступ к нескольким брендам.
`public`	true	нет	То же самое поле, что и у публичного каталога: отсекает скрытые и «только по ссылке» товары. Служебному ключу передавать не обязательно.

Поля ответа

Поле	Тип	Описание
`price`	number	Цена товара.в копейках
`discount`	number	Скидка: сумма или проценты, смотря что указано в discountType.
`sizes[].quantity`	number	Остаток размера УЖЕ за вычетом резервов.
`sizes[].physicalQuantity`	number	Сырой остаток на складе. Только со служебными правами.
`sizes[].chestnyZnak`	string \| null	Код маркировки. Только со служебными правами.
`sizes[].productionThreshold`	number	Порог, ниже которого позиция попадает в очередь производства.
`sizes[].productionBatchSize`	number	Размер производственной партии. Ноль означает «не производить».
`attributes[].name`	string	Название атрибута (Размер, Цвет, Принт…) — оси выбора для UI-переключателей. Не путать с variants[] ниже: attributes[] отвечает "какие есть параметры и значения", variants[] — "какие конкретно комбинации можно купить и с каким остатком". См. термин «Атрибут и вариант».
`attributes[].values[]`	array	Значения атрибута, реально используемые в вариантах этого товара: { id, value }.
`variants[].id`	number	Идентификатор варианта (конкретной покупаемой комбинации значений attributes[] выше) — используйте как variantId в корзине и заказе.
`variants[].availableQuantity`	number	Остаток варианта за вычетом резервов.
`variants[].attributeValueIds`	number[]	Значения атрибутов, образующие этот вариант.
`variants[].attributes[]`	array	То же самое человекочитаемо: { attributeId, attributeName, valueId, value }.
`soldout`	boolean	Ручная пометка «продано».
`popularityRank`	int	Место в рейтинге популярности по числу продаж среди товаров этой выдачи, 1 — самый продаваемый; считается только для списка.

GET/products/{slug}

Карточка товара

Один товар со всеми размерами.

Доступ:Ключ интеграцииСессия сотрудникаБез авторизации

Параметры пути

Параметр	Тип	Обязателен	Описание
`slug`	string	да	Адресное имя товара.

ответ

{
  "id": "123",
  "slug": "futbolka-basic",
  "moySkladId": "abc-123",
  "vitrineArticle": "CSH-001",
  "name": "Футболка Basic",
  "description": "Хлопок 100%",
  "price": 199000,
  "discount": 10,
  "discountType": "percent",
  "images": ["https://cdn.amarix.ru/products/123/1.jpg"],
  "category": { "id": 5, "name": "Футболки", "slug": "futbolki" },
  "sizes": [
    {
      "id": 45,
      "size": "M",
      "quantity": 12,
      "availableQuantity": 12,
      "reservedQuantity": 0,
      "physicalQuantity": 12,
      "chestnyZnak": null,
      "variantId": "v-1",
      "isVisible": true,
      "salesLimitLeft": 5,
      "salesLimit": 50,
      "salesLimitSince": null,
      "salesLimitSold": 0,
      "productionThreshold": 5,
      "productionBatchSize": 10,
      "price": 199000,
      "discount": 10,
      "discountType": "percent"
    }
  ],
  "attributes": [],
  "variants": [],
  "productGroups": [],
  "inStock": true,
  "productionTime": 3,
  "assemblyTime": 1,
  "isDeleted": false,
  "brand": "acme",
  "brandId": 1,
  "material": "Хлопок",
  "care": "Стирка 30°",
  "soldout": false,
  "freeShipping": false,
  "salesLimit": 50,
  "salesLimitReached": false,
  "salesLimitSold": 0,
  "isLinkOnly": false,
  "collectionId": 12,
  "sizeGrid": [],
  "badgeText": "Новинка",
  "badgeColor": "#FF0000",
  "displayOrder": 0,
  "imageMetadata": {},
  "relatedProductIds": []
}

Ошибки

Код	Ответ сервера	Когда возникает	Что делать
404	`{"error":"Товар не найден"}`	Товара нет или он чужого бренда.	—

PUT/products/{id}

Изменить товар

Правка карточки и набора размеров.

Доступ:Ключ интеграцииСессия сотрудникаПраво:manage_products

Если в теле передан ключ sizes, он заменяет набор размеров целиком: размеры, которых нет в списке, будут скрыты. Это не частичное обновление.

Что важно знать

Тело не проходит как есть: сервер отфильтровывает служебные и вычисляемые поля (category, categoryRef, sizes, productGroups, groupId/groupName/groupVariants, soldCount, favoritesCount, popularityRank, createdAt/updatedAt/deletedAt, productionThreshold/productionBatchSize на верхнем уровне, salesLimitSold, salesLimitReached, salesLimitSince) и отдельно обрабатывает salesLimit, brandId, price, discount, images, categoryId, imageMetadata, relatedProductIds. Список bodyParams выше — реально принимаемые поля, а не полный список того, что можно прислать без последствий.
Передача sizes — полная замена. Чтобы поправить один размер, присылайте весь список, иначе остальные пропадут с витрины.
Код маркировки нормализуется до цифр. Ни длина, ни контрольная сумма, ни уникальность не проверяются — следите за корректностью сами.
Изменение остатка через карточку товара попадает в историю движений склада наравне с работой кладовщика.

Параметры пути

Параметр	Тип	Обязателен	Описание
`id`	number	да	Идентификатор товара.

Тело запроса

Параметр	Тип	Обязателен	Описание
`name`	string	нет	Название.
`description`	string	нет	Описание.
`price`	int	нет	Цена, в копейках.
`discount`	number	нет	Скидка: сумма или проценты — смотря что в discountType.
`discountType`	string	нет	Тип скидки.percent · amount
`images`	string[]	нет	Ссылки на изображения, по порядку.
`categoryId`	int	нет	Категория товара.
`brandId`	int	нет	Бренд — сменить можно только на доступный этому ключу/сессии.
`material`	string	нет	Материал.
`care`	string	нет	Уход.
`inStock`	boolean	нет	Ручной флаг наличия.
`soldout`	boolean	нет	Ручная пометка «продано».
`freeShipping`	boolean	нет	Бесплатная доставка.
`isLinkOnly`	boolean	нет	Доступен только по прямой ссылке, вне каталога.
`collectionId`	int	нет	Коллекция товара.
`salesLimit`	int	нет	Лимит продаж товара целиком, если задан.
`productionTime`	int	нет	Срок производства, дней.
`assemblyTime`	int	нет	Срок сборки, дней.
`badgeText`	string	нет	Текст бейджа на карточке.
`badgeColor`	string	нет	Цвет бейджа.
`displayOrder`	int	нет	Порядок в каталоге.
`sizes[].id`	int	нет	Идентификатор существующего размера — без него создаётся новый.
`sizes[].size`	string	да	Название размера.
`sizes[].quantity`	int	нет	Физический остаток размера.
`sizes[].chestnyZnak`	string \| null	нет	Код маркировки. Нормализуется до цифр — длина и уникальность не проверяются.
`sizes[].isVisible`	boolean	нет	Показывать ли размер на витрине.
`sizes[].salesLimit`	int \| null	нет	Лимит продаж этого размера.
`sizes[].productionThreshold`	int	нет	Порог, ниже которого размер попадает в очередь производства.
`sizes[].productionBatchSize`	int	нет	Размер производственной партии. Ноль — «не производить».

ответ

{
  "id": "123",
  "slug": "futbolka-basic",
  "moySkladId": "abc-123",
  "vitrineArticle": "CSH-001",
  "name": "Футболка Basic",
  "description": "Хлопок 100%",
  "price": 199000,
  "discount": 10,
  "discountType": "percent",
  "images": ["https://cdn.amarix.ru/products/123/1.jpg"],
  "category": { "id": 5, "name": "Футболки", "slug": "futbolki" },
  "sizes": [
    {
      "id": 45,
      "size": "M",
      "quantity": 12,
      "availableQuantity": 12,
      "reservedQuantity": 0,
      "physicalQuantity": 12,
      "chestnyZnak": null,
      "variantId": "v-1",
      "isVisible": true,
      "salesLimitLeft": 5,
      "salesLimit": 50,
      "salesLimitSince": null,
      "salesLimitSold": 0,
      "productionThreshold": 5,
      "productionBatchSize": 10,
      "price": 199000,
      "discount": 10,
      "discountType": "percent"
    }
  ],
  "attributes": [],
  "variants": [],
  "productGroups": [],
  "inStock": true,
  "productionTime": 3,
  "assemblyTime": 1,
  "isDeleted": false,
  "brand": "acme",
  "brandId": 1,
  "material": "Хлопок",
  "care": "Стирка 30°",
  "soldout": false,
  "freeShipping": false,
  "salesLimit": 50,
  "salesLimitReached": false,
  "salesLimitSold": 0,
  "isLinkOnly": false,
  "collectionId": 12,
  "sizeGrid": [],
  "badgeText": "Новинка",
  "badgeColor": "#FF0000",
  "displayOrder": 0,
  "imageMetadata": {},
  "relatedProductIds": []
}

Ошибки

Код	Ответ сервера	Когда возникает	Что делать
403	`{"error":"Forbidden: Missing permission manage_products"}`	Нет права на изменение товаров.	—
404	`{"error":"Товар не найден"}`	Товара нет или он чужого бренда.	—

GET/products/brands/:brandId/attributes

Справочник атрибутов бренда

Все атрибуты бренда (Размер, Цвет, Принт…) со своими значениями.

Доступ:Ключ интеграцииСессия сотрудника

Атрибут — параметр товара со своим набором значений; см. термин «Атрибут и вариант» в разделе «Термины и понятия». Значения приходят отсортированными по sortOrder — тому же порядку, что задаёт PUT .../values/reorder.

Параметры пути

Параметр	Тип	Обязателен	Описание
`brandId`	number	да	Идентификатор бренда.

Поля ответа

Поле	Тип	Описание
`id`	number	Идентификатор атрибута.
`brandId`	number	Бренд-владелец.
`name`	string	Название атрибута, например «Размер» или «Цвет».
`sortOrder`	number	Порядок среди атрибутов бренда.
`values[].id`	number	Идентификатор значения.
`values[].value`	string	Само значение, например «M» или «Жёлтый».
`values[].sortOrder`	number	Порядок значения внутри атрибута.
`values[].isArchived`	boolean	Архивное значение не предлагается для новых вариантов, но остаётся у уже созданных.

Ошибки

Код	Ответ сервера	Когда возникает	Что делать
400	`{"error":"Некорректный brandId"}`	brandId не число.	—
403	`{"error":"Forbidden"}`	Ключ/сессия не имеют доступа к этому бренду.	—

POST/products/brands/:brandId/attributes

Создать атрибут

Новый атрибут в справочнике бренда — новый параметр выбора для товаров.

Доступ:Ключ интеграцииСессия сотрудникаПраво:manage_products

Параметры пути

Параметр	Тип	Обязателен	Описание
`brandId`	number	да	Идентификатор бренда.

Тело запроса

Параметр	Тип	Обязателен	Описание
`name`	string	да	Название атрибута. Уникально в пределах бренда.

Поля ответа

Поле	Тип	Описание
`id`	number	Идентификатор нового атрибута.
`brandId`	number	Бренд-владелец.
`name`	string	Название атрибута.
`sortOrder`	number	Ставится последним среди атрибутов бренда.

Ошибки

Код	Ответ сервера	Когда возникает	Что делать
400	`{"error":"Название атрибута обязательно"}`	Имя пустое или из одних пробелов.	—
403	`{"error":"Forbidden: Missing permission manage_products"}`	Нет права на изменение товаров.	—

POST/products/attributes/:id/values

Добавить значение атрибута

Новое значение в списке атрибута — например, добавить «XXL» в «Размер».

Доступ:Ключ интеграцииСессия сотрудникаПраво:manage_products

Параметры пути

Параметр	Тип	Обязателен	Описание
`id`	number	да	Идентификатор атрибута.

Тело запроса

Параметр	Тип	Обязателен	Описание
`value`	string	да	Само значение, например «M».

Поля ответа

Поле	Тип	Описание
`id`	number	Идентификатор значения.
`attributeId`	number	Атрибут-владелец.
`value`	string	Значение как передано.
`sortOrder`	number	Для атрибута «Размер» — по естественному порядку (S < M < L < XL…), для остальных — в конец списка.
`isArchived`	boolean	Всегда false у нового значения.

Ошибки

Код	Ответ сервера	Когда возникает	Что делать
400	`{"error":"Значение атрибута обязательно"}`	Значение пустое.	—
409	`{"error":"Значение «S» уже есть в списке","code":"VALUE_EXISTS","existingValueId":42,"existingIsArchived":false}`code: VALUE_EXISTS	Значение с таким текстом уже есть у этого атрибута (уникальность по паре атрибут+значение) — в том числе архивное.	Проверьте existingIsArchived: если true, значение нужно восстановить (PATCH .../archive с archived:false), а не создавать заново.

PUT/products/attributes/:id/values/reorder

Порядок значений атрибута

Задать порядок значений внутри атрибута — например, S, M, L, XL в нужной последовательности.

Доступ:Ключ интеграцииСессия сотрудникаПраво:manage_products

Параметры пути

Параметр	Тип	Обязателен	Описание
`id`	number	да	Идентификатор атрибута.

Тело запроса

Параметр	Тип	Обязателен	Описание
`valueIds`	number[]	да	ПОЛНЫЙ список id значений этого атрибута в желаемом порядке — не только изменившиеся.

Поля ответа

Поле	Тип	Описание
`[].sortOrder`	number	Новый порядковый номер = позиция id в переданном массиве.

Ошибки

Код	Ответ сервера	Когда возникает	Что делать
400	`{"error":"Список значений пуст"}`	valueIds пуст или не массив чисел.	—
400	`{"error":"Часть значений не принадлежит этому атрибуту"}`	В списке есть id значения другого атрибута.	—

DELETE/products/attributes/:id

Удалить атрибут

Полностью убрать атрибут из справочника бренда.

Доступ:Ключ интеграцииСессия сотрудникаПраво:manage_products

Параметры пути

Параметр	Тип	Обязателен	Описание
`id`	number	да	Идентификатор атрибута.

Поля ответа

Поле	Тип	Описание
`ok`	boolean	true при успехе.

Ошибки

Код	Ответ сервера	Когда возникает	Что делать
409	`{"error":"Атрибут используется в 7 вариантах товаров — сначала уберите его с товаров","code":"ATTRIBUTE_IN_USE"}`code: ATTRIBUTE_IN_USE	Хотя бы одно значение атрибута используется в варианте товара.	Сначала удалите/пересоздайте затрагиваемые варианты (DELETE .../variants/:id), либо отвяжите атрибут от товара (DELETE .../products/:id/attributes/:attributeId), затем повторите.

PATCH/products/attribute-values/:id/archive

Архивировать / восстановить значение

Скрыть значение от выбора для новых вариантов, не трогая уже существующие.

Доступ:Ключ интеграцииСессия сотрудникаПраво:manage_products

Архивирование — мягкая альтернатива удалению для значений, которые уже используются: архивное значение не предлагается при создании новых вариантов, но варианты, у которых оно уже есть, продолжают работать как прежде.

Параметры пути

Параметр	Тип	Обязателен	Описание
`id`	number	да	Идентификатор значения атрибута.

Тело запроса

Параметр	Тип	Обязателен	Описание
`archived`	boolean	нетпо умолчанию true	false — восстановить ранее заархивированное значение.

Поля ответа

Поле	Тип	Описание
`isArchived`	boolean	Итоговое состояние после запроса.

Ошибки

Код	Ответ сервера	Когда возникает	Что делать
404	`{"error":"Значение не найдено"}`	id не существует или чужого бренда.	—

DELETE/products/attribute-values/:id

Удалить значение атрибута

Физически убрать значение из списка — только если оно нигде не используется.

Доступ:Ключ интеграцииСессия сотрудникаПраво:manage_products

Параметры пути

Параметр	Тип	Обязателен	Описание
`id`	number	да	Идентификатор значения атрибута.

Поля ответа

Поле	Тип	Описание
`ok`	boolean	true при успехе.

Ошибки

Код	Ответ сервера	Когда возникает	Что делать
409	`{"error":"Значение используется в 3 вариантах товаров — архивируйте вместо удаления","code":"ATTRIBUTE_VALUE_IN_USE"}`code: ATTRIBUTE_VALUE_IN_USE	Значение используется хотя бы в одном варианте товара.	Используйте PATCH .../archive вместо удаления.

GET/products/:id/attributes

Атрибуты товара

Какие атрибуты подключены к товару и какие их значения реально используются в вариантах.

Доступ:Ключ интеграцииСессия сотрудникаБез авторизации

Список короче, чем полный справочник бренда: значение атрибута попадает сюда, только если оно реально встречается хотя бы в одном варианте этого товара — заведённые «про запас» значения не показываются.

Параметры пути

Параметр	Тип	Обязателен	Описание
`id`	number	да	Идентификатор товара.

Поля ответа

Поле	Тип	Описание
`id`	number	Идентификатор атрибута.
`name`	string	Название атрибута.
`required`	boolean	Обязателен ли выбор этого атрибута при заказе (задаётся в момент привязки к товару).
`values[]`	array	{ id, value } — только значения, встречающиеся в вариантах этого товара.

POST/products/:id/attributes

Подключить атрибут к товару

Добавить товару ось выбора (например, «Цвет») — до генерации вариантов.

Доступ:Ключ интеграцииСессия сотрудникаПраво:manage_products

Параметры пути

Параметр	Тип	Обязателен	Описание
`id`	number	да	Идентификатор товара.

Тело запроса

Параметр	Тип	Обязателен	Описание
`attributeId`	number	да	Атрибут из справочника бренда.
`required`	boolean	нет	Обязателен ли выбор значения этого атрибута.

Поля ответа

Поле	Тип	Описание
`id`	number	Идентификатор связи.
`productId`	number
`attributeId`	number
`required`	boolean

DELETE/products/:id/attributes/:attributeId

Отключить атрибут от товара

Убрать ось выбора у товара.

Доступ:Ключ интеграцииСессия сотрудникаПраво:manage_products

Параметры пути

Параметр	Тип	Обязателен	Описание
`id`	number	да	Идентификатор товара.
`attributeId`	number	да	Идентификатор атрибута.

Поля ответа

Поле	Тип	Описание
`ok`	boolean	true всегда, даже если связи не было.

GET/products/:id/variants

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

Все комбинации значений атрибутов товара со своим остатком.

Доступ:Ключ интеграцииСессия сотрудникаБез авторизации

Параметры пути

Параметр	Тип	Обязателен	Описание
`id`	number	да	Идентификатор товара.

Поля ответа

Поле	Тип	Описание
`id`	number	Идентификатор варианта — используйте как variantId в корзине и заказе.
`sku`	string \| null	Артикул варианта, если задан.
`quantity`	number	Сырой остаток склада.штук
`reservedQuantity`	number	В резерве по неоплаченным заказам.
`availableQuantity`	number	quantity минус reservedQuantity — то, что реально можно продать.
`salesLimit`	number \| null	Лимит продаж, если задан.
`salesLimitSold`	number	Сколько из лимита уже продано с момента salesLimitSince.
`isVisible`	boolean	Показывать ли вариант на витрине.
`chestnyZnak`	string \| null	Код маркировки «Честный знак».
`productionThreshold`	number \| null	Порог для очереди производства.
`productionBatchSize`	number \| null	Размер партии производства.
`attributeValues[]`	array	Значения, образующие вариант: { attributeValue: { id, value, attribute: { id, name } } }.

POST/products/:id/variants

Сгенерировать варианты

Создать варианты по готовому набору комбинаций значений атрибутов.

Доступ:Ключ интеграцииСессия сотрудникаПраво:manage_products

Комбинации приходят уже готовыми с клиента — сервер не строит декартово произведение сам, только создаёт то, что прислали, и молча пропускает комбинации, которые у товара уже есть (по набору attributeValueId, без учёта порядка).

Параметры пути

Параметр	Тип	Обязателен	Описание
`id`	number	да	Идентификатор товара.

Тело запроса

Параметр	Тип	Обязателен	Описание
`combinations`	number[][]	да	Список комбинаций; каждая — массив attributeValueId, образующих один вариант. Например [[10,20],[10,21]] — два варианта с общим значением 10 и разными 20/21.

Поля ответа

Поле	Тип	Описание
`[]`	Variant	Только реально созданные варианты — уже существующие комбинации в ответе не повторяются.

Ошибки

Код	Ответ сервера	Когда возникает	Что делать
400	`{"error":"combinations должен быть непустым массивом"}`	Тело запроса пустое или не массив.	—

POST/products/:id/variants/default

Вариант без атрибутов

Единственный вариант товара, у которого в принципе нет осей выбора (например, для брендов без размерной сетки).

Доступ:Ключ интеграцииСессия сотрудникаПраво:manage_products

Параметры пути

Параметр	Тип	Обязателен	Описание
`id`	number	да	Идентификатор товара.

Поля ответа

Поле	Тип	Описание
`id`	number	Идентификатор варианта — используйте как variantId, даже без атрибутов.

PATCH/products/variants/:id

Изменить вариант

Остаток, видимость, лимит продаж, параметры производства или сама комбинация значений.

Доступ:Ключ интеграцииСессия сотрудникаПраво:manage_products

Параметры пути

Параметр	Тип	Обязателен	Описание
`id`	number	да	Идентификатор варианта.

Тело запроса

Параметр	Тип	Обязателен	Описание
`quantity`	number	нет	Абсолютный остаток. Если у варианта есть онлайн-склад, запись идёт через складской адаптер (резервы не задваиваются) — не пишите остаток напрямую в обход этого поля.
`attributeValueIds`	number[]	нет	Новый набор значений — переставляет вариант на другую комбинацию (например, «Размер: S» → «Размер: M») без удаления и пересоздания.
`isVisible`	boolean	нет	Показывать ли на витрине.
`salesLimit`	number \| null	нет	null снимает лимит. Установка нового значения сбрасывает счётчик проданного (salesLimitSince = сейчас).
`productionThreshold`	number	нет	Порог для очереди производства.
`productionBatchSize`	number	нет	Размер партии. 0 — не производить.
`chestnyZnak`	string \| null	нет	Код маркировки; нецифровые символы отбрасываются автоматически.

Поля ответа

Поле	Тип	Описание
`variant`	Variant	Вариант целиком после применения переданных полей.

Ошибки

Код	Ответ сервера	Когда возникает	Что делать
404	`{"error":"Вариант не найден"}`	Передан attributeValueIds, но variantId не существует.	—
409	`{"error":"У товара уже есть вариант с такой комбинацией значений"}`	attributeValueIds совпадает (без учёта порядка) с уже существующим у этого товара вариантом.	—

DELETE/products/variants/:id

Удалить вариант

Мягкое удаление варианта — как у легаси-размера, не физическая запись.

Доступ:Ключ интеграцииСессия сотрудникаПраво:manage_products

Параметры пути

Параметр	Тип	Обязателен	Описание
`id`	number	да	Идентификатор варианта.

Поля ответа

Поле	Тип	Описание
`ok`	boolean	true при успехе.