Управление товарами в магазине
Типы и статусы категорий магазина
Справочник по типам и статусам (для категорий и товаров магазина. Используются в API /v1/shop/category/* (параметр status в запросах) и в сущности ShopCategory.
Статусы категории (ShopCategoryStatus)
| ID | Константа | RU | EN | Описание |
|---|---|---|---|---|
| 0 | ARCHIVE | В архиве | Archived | Категория/товар в архиве. Не отображается в активном каталоге, можно восстановить через «Разархивировать». |
| 1 | ACTIVE | Активный | Active | Обычное состояние: категория видна и доступна для покупок (с учётом настроек видимости). |
| 2 | HIDE | Скрытый | Hidden | Скрыт из выдачи (например, временно снят с продажи без переноса в архив). |
Типы категории/товара (ShopCategoryType)
| ID | Константа | Название (RU) | Описание |
|---|---|---|---|
| 0 | CATEGORY | Подкатегория | Только контейнер для вложенных категорий или товаров, сам по себе не товар. |
| 1 | UNIQUE | Уникальный товар | Товар с уникальными строками (каждая строка продаётся один раз). Подходит для ключей, промокодов и т.п. |
| 2 | NON_UNIQUE | Неуникальный товар | Один и тот же товар можно продавать многократно (лимит или без лимита). |
| 3 | FILE | Неуникальный файл | Товар — файл, доступный многократно (одно и то же содержимое для всех покупателей). |
| 4 | FILES | Уникальные файлы | Товар — набор файлов, у каждого покупателя свой набор (лимит/без лимита, один или несколько файлов). |
| 5 | API_FEEDBACK | API | Товар обрабатывается через внешний API (BOT-T API, Magnit, Pigfarm, другой бот и т.д.). |
| 6 | PRESENT | Подарок | Выдача подарка: по одной строке или все строки сразу. |
| 7 | CART | Товар для корзины | Товар в магазине с корзиной (количество, калькулятор, подтверждение заказа и т.п.). |
| 8 | SERVICE | Услуга | Товар как услуга (без физической выдачи, логика на стороне бота/интеграций). |
| 9 | PRESENT_FILE | Подарок файлами | Подарок в виде файла(ов). |
Подтипы (субтипы) по типам
- UNIQUE: не проверять уникальность / проверять уникальность / проверять даже в проданных заказах.
- NON_UNIQUE: лимитное количество / безлимитное количество.
- FILES: лимит / без лимита / лимит с несколькими файлами / без лимита с несколькими файлами.
- API_FEEDBACK: работа с API BOT-T / Magnit / Pigfarm / перепродажа с другого бота.
- PRESENT: выдавать поштучно / выдавать все строки сразу.
Использование в API
- В запросах к
CategoryController(например,index,count) массивstatusзадаёт фильтр по статусам: передавайте значения0,1,2(или константыShopCategoryStatus::ARCHIVE,ACTIVE,HIDE). - Поле
typeв ответах (например, вShopCategoryDto) — числовой идентификатор типа категории/товара из таблицы выше. - Поле
statusв ответах — числовой идентификатор статуса (0 — архив, 1 — активный, 2 — скрытый).