Категории номенклатуры
API категорий — дерево категорий, создание и изменение, удаление, изображение категории.
Ключ, формат запросов и ответов — в статье Общие правила API.
Список категорий
GET /api/productcategories — все категории сразу, без страниц, в порядке дерева.
| Параметр | Значение |
|---|---|
order | Сортировка внутри уровня: title (по умолчанию) или id, с DESC — обратный порядок |
| Поле | Значение |
|---|---|
id | ИД категории |
parent_id | ИД родительской категории (0 — верхний уровень) |
depth | Глубина вложенности |
parent_category | true, если у категории есть подкатегории |
title, description | Название и описание |
vat_type, vat | НДС по умолчанию для новых товаров категории |
color, icon, img | Цвет, значок и изображение |
online, yamarket | Показывать в интернет-магазине, выгружать в Яндекс.Маркет |
kiosk_noshow | Скрыть в режиме киоска |
kassa_no_show, kassa_no_show_stores | Склады, на кассах которых категория скрыта |
product_count | Количество товаров в категории |
markercategories, parent_markercategories | Метки категории и её родителя |
ozoncategory_id_1, ozoncategory_id_2, ozoncategory_id_3, ozontype_id | Категория и тип OZON |
date_update, date_delete | Время изменения и признак удаления |
Создание и изменение
POST /api/productcategories — создать, POST /api/productcategories/<ИД> — изменить. Тело — JSON.
| Поле | Значение |
|---|---|
title* | Название |
vat_type*, vat* | НДС по умолчанию для товаров категории |
parent_id | ИД родительской категории (0 — верхний уровень) |
description | Описание |
color | Цвет: #rrggbb или transparent |
kassa_no_show | Массив ИД складов, на кассах которых категория скрыта |
online, yamarket | Показывать в интернет-магазине, выгружать в Яндекс.Маркет (1 — да, 0 — нет) |
kiosk_noshow | 1 — скрыть категорию в режиме киоска, 0 — показывать |
{"parent_id": 0, "title": "Напитки", "vat_type": 0, "vat": 0, "color": "transparent", "online": 1}Ответ: id — ИД категории. Поля со звёздочкой сервер не проверяет — заполняйте их сами, иначе категория сохранится без названия или НДС.
Удаление
DELETE /api/productcategories/<ИД> — удалить категорию (как кнопка Удалить в ЛК).
Изображение категории
Загрузка: POST /api/productcategories/imgs, форма multipart/form-data: id — ИД категории, img — файл. У категории одно изображение, новое заменяет старое.
Удаление: DELETE /api/productcategories/imgs, тело JSON {"id": 1}.