Справочник API

Товары

Каталог отдаётся одним и тем же эндпоинтом покупателю и интеграции — различается только набор полей. По ключу с правами на товары вы получаете служебные поля: физический остаток без вычета резервов, код маркировки, настройки производства и лимиты продаж.

GET/products

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

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

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

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

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

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

Поля ответа

Поле	Тип	Описание
`price`	number	Цена товара.в копейках
`discount`	number	Скидка: сумма или проценты, смотря что указано в discountType.
`sizes[].quantity`	number	Остаток размера УЖЕ за вычетом резервов.
`sizes[].physicalQuantity`	number	Сырой остаток на складе. Только со служебными правами.
`sizes[].chestnyZnak`	string \| null	Код маркировки. Только со служебными правами.
`sizes[].productionThreshold`	number	Порог, ниже которого позиция попадает в очередь производства.
`sizes[].productionBatchSize`	number	Размер производственной партии. Ноль означает «не производить».
`soldout`	boolean	Ручная пометка «продано».

Ошибки

Код	Ответ сервера	Когда возникает	Что делать
403	`{"error":"Forbidden: brand not allowed"}`	Запрошен товар чужого бренда по идентификатору.	—

GET/products/{slug}

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

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

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

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

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

Ошибки

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

PUT/products/{id}

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

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

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

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

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

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

Ошибки

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