Каталоги товаров и товарные статьи
Раздел «Товары» содержит две параллельные иерархии:
- Каталоги (для витрины)
- Товарный каталог → Раздел каталога → Товар
Используются для организации отображения товаров (например, в Личном кабинете), привязываются к датам и регионам.
- Классификация (для лояльности)
- Категория → Подкатегория → Группа → Подгруппа → Товар)
Используются в правилах начисления.
Каталог — это именованная коллекция товаров, ограниченная по времени действия и привязанная к регионам присутствия. Позволяет создавать сезонные, региональные или акционные товарные коллекции. Например: «Летний каталог 2024», «Каталог для Москвы», «Новогодняя коллекция».
Поле |
Описание | Обязательное поле |
Редактирование |
Наименование | Наименование каталога товаров. Отображается в мобильном приложении/на сайте. |
Да | Поле доступно для редактирования, заполняется вручную. |
Внешний идентификатор | Уникальное текстовое значение. Используется для интеграции записей с внешними системами. |
Нет | Поле доступно для редактирования, заполняется вручную |
Изображение URL | Параметр передается в ответе на запросы МП и ЛК и используется для отображения картинки каталога. |
Нет | Поле доступно для редактирования, заполняется вручную |
Дата начала |
Дата начала действия каталога товаров |
Нет | Поле доступно для редактирования, заполняется вручную |
Дата окончания |
Дата окончания действия каталога товаров. |
Нет | Поле доступно для редактирования, заполняется вручную |
Описание | Описание каталога товаров, которое будет передаваться в МП/на сайт. |
Нет |
Поле доступно для редактирования, заполняется вручную |
| Зависимости | |||
| Разделы каталога товаров | Каталог содержит один или несколько разделов | ||
| Регионы | Каталог может быть привязан к нескольким регионам | ||

Получить каталоги товаров по региону можно методом GET ProductCatalog/GetAllByRegion
Раздел каталога товаров — подмножество товаров внутри каталога с дополнительным атрибутом порядковой нумерации. Второй уровень иерархии каталога. Структурирует каталог по тематическим блокам. Например, в каталоге «Летний сезон» могут быть разделы «Пляжная коллекция», «Спортивные товары», «Садовый инвентарь».
Поле |
Описание | Обязательное поле |
Редактирование |
Наименование | Наименование коллекции заданий (акции с заданиями). Отображается в личном кабинете. |
Да | Поле доступно для редактирования, заполняется вручную. |
| Номер | Порядковый номер раздела в каталоге | ||
Внешний идентификатор | Уникальное текстовое значение. Используется для интеграции записей с внешними системами. |
Нет | Поле доступно для редактирования, заполняется вручную |
Изображение URL | Параметр передается в ответе на запросы МП и ЛК и используется для отображения картинки. |
Нет | Поле доступно для редактирования, заполняется вручную |
Дата начала |
Дата начала действия раздела каталога товаров |
Нет | Поле доступно для редактирования, заполняется вручную |
Дата окончания |
Дата окончания действия раздела каталога товаров |
Нет | Поле доступно для редактирования, заполняется вручную |
Описание | Описание раздела каталога товаров, которое будет передаваться в МП/на сайт. |
Нет |
Поле доступно для редактирования, заполняется вручную |
| Зависимости |
| ||
| Каталоги товаров | Принадлежность раздела каталогу | ||
| Товары | Товары, принадлежащие разделу каталога | ||

Получить разделы каталога товаров можно методом GET ProductSubcatalog/GetAllByCatalog
Товарная статья - это отдельная сущность для персонализированной привязки товаров к контактам. Имеет собственную группировку (Группы товарных статей) — не зависит от каталога. Работает как персональная подборка товаров клиента.
Товарная статья напрямую не связана с каталогом товаров.
Один и тот же товар (Article) может одновременно:
- Находиться в разделе каталога (отображаться на витрине для всех пользователей региона)
- Быть включённым в товарную статью (находиться в избранном у конкретного клиента)
Получить товарные статьи, добавленные пользователем в избранное можно методом - GET ProductArticle/GetAllByContact
Получить товарные статьи определённой группы товарных статей - GET ProductArticle/GetAllByGroup
Получить товарную статью - GET ProductArticle/Get
Поле |
Описание | Обязательное поле |
Редактирование |
Наименование | Наименование товарной статьи. Отображается в мобильном приложении/на сайте. |
Да | Поле доступно для редактирования, заполняется вручную. |
Внешний идентификатор | Уникальное текстовое значение. Используется для интеграции записей с внешними системами. |
Нет | Поле доступно для редактирования, заполняется вручную |
Изображение URL | Параметр передается в ответе на запросы МП и ЛК и используется для отображения картинки товарной статьи |
Нет | Поле доступно для редактирования, заполняется вручную |
Дата начала |
Дата начала действия товарной статьи |
Нет | Поле доступно для редактирования, заполняется вручную |
Дата окончания |
Дата окончания действия товарной статьи |
Нет | Поле доступно для редактирования, заполняется вручную |
Описание | Описание товарной статьи, которое будет передаваться в МП/на сайт. |
Нет |
Поле доступно для редактирования, заполняется вручную |
| Зависимости | |||
| Товары | Товарная статья может содержать один или несколько товаров | ||
| Группы товарный статей | Несколько товарный статей, объединенных общим признаком | ||
