Каталоги товаров и товарные статьи

Редактировал(а) Татьяна Брыкова 2026/03/12 10:09

Раздел «Товары» содержит две параллельные иерархии:

  • Каталоги (для витрины)
    • Товарный каталог → Раздел каталога → Товар

                     Используются для организации отображения товаров (например, в Личном кабинете), привязываются к датам и регионам.

  • Классификация (для лояльности)
    • Категория → Подкатегория → Группа → Подгруппа → Товар)

                     Используются в правилах начисления.

Каталог — это именованная коллекция товаров, ограниченная по времени действия и привязанная к регионам присутствия. Позволяет создавать сезонные, региональные или акционные товарные коллекции. Например: «Летний каталог 2024», «Каталог для Москвы», «Новогодняя коллекция».

 

Поле

 

Описание

Обязательное поле

 

Редактирование

 

Наименование

Наименование каталога товаров. Отображается в мобильном приложении/на сайте.

 

Да

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

 

Внешний идентификатор

Уникальное текстовое значение. Используется для интеграции записей с внешними системами.

 

Нет

Поле доступно для редактирования, заполняется вручную

 

Изображение URL

Параметр передается в ответе на запросы МП и ЛК и используется для отображения картинки каталога.

 

Нет

Поле доступно для редактирования, заполняется вручную

 

Дата начала 

 

Дата начала действия каталога товаров

 

Нет

Поле доступно для редактирования, заполняется вручную

 

Дата окончания 

 

Дата окончания действия каталога товаров.

 

Нет

Поле доступно для редактирования, заполняется вручную

Описание

Описание каталога товаров, которое будет передаваться в МП/на сайт.

 

Нет

 

Поле доступно для редактирования, заполняется вручную

Зависимости   
Разделы каталога товаров

Каталог содержит один или несколько разделов

РегионыКаталог может быть привязан к нескольким регионам

1773238270765-458.png

Получить каталоги товаров по региону можно методом  GET ProductCatalog/GetAllByRegion

Раздел каталога товаров — подмножество товаров внутри каталога с дополнительным атрибутом порядковой нумерации. Второй уровень иерархии каталога. Структурирует каталог по тематическим блокам. Например, в каталоге «Летний сезон» могут быть разделы «Пляжная коллекция», «Спортивные товары», «Садовый инвентарь».

 

Поле

 

Описание

Обязательное поле

 

Редактирование

 

Наименование

Наименование коллекции заданий (акции с заданиями). Отображается в личном кабинете.

 

Да

Поле доступно для редактирования, заполняется вручную.
НомерПорядковый номер раздела в каталоге  

 

Внешний идентификатор

Уникальное текстовое значение. Используется для интеграции записей с внешними системами.

 

Нет

Поле доступно для редактирования, заполняется вручную

 

Изображение URL

Параметр передается в ответе на запросы МП и ЛК и используется для отображения картинки.

 

Нет

Поле доступно для редактирования, заполняется вручную

 

Дата начала 

 

Дата начала действия раздела каталога товаров

 

Нет

Поле доступно для редактирования, заполняется вручную

 

Дата окончания 

 

Дата окончания действия раздела каталога товаров

 

Нет

Поле доступно для редактирования, заполняется вручную

 

Описание

Описание раздела каталога товаров, которое будет передаваться в МП/на сайт.

 

Нет

 

Поле доступно для редактирования, заполняется вручную

Зависимости

 

  
Каталоги товаровПринадлежность раздела каталогу
ТоварыТовары, принадлежащие разделу каталога

1773239447633-354.png

Получить разделы каталога товаров можно методом GET ProductSubcatalog/GetAllByCatalog

Товарная статья - это отдельная сущность для персонализированной привязки товаров к контактам. Имеет собственную группировку (Группы товарных статей) — не зависит от каталога. Работает как персональная подборка товаров клиента.

Товарная статья напрямую не связана с каталогом товаров.

Один и тот же товар (Article) может одновременно:

  1. Находиться в разделе каталога (отображаться на витрине для всех пользователей региона)
  2. Быть включённым в товарную статью (находиться в избранном у  конкретного клиента)

Получить товарные статьи,  добавленные пользователем в избранное можно методом  - GET ProductArticle/GetAllByContact 

Получить товарные статьи определённой группы товарных статей -  GET ProductArticle/GetAllByGroup

Получить товарную статью - GET ProductArticle/Get

Поле

 

Описание

Обязательное поле

 

Редактирование

 

Наименование

Наименование товарной статьи. Отображается в мобильном приложении/на сайте.

 

Да

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

 

Внешний идентификатор

Уникальное текстовое значение. Используется для интеграции записей с внешними системами.

 

Нет

Поле доступно для редактирования, заполняется вручную

 

Изображение URL

Параметр передается в ответе на запросы МП и ЛК и используется для отображения картинки товарной статьи

 

Нет

Поле доступно для редактирования, заполняется вручную

 

Дата начала 

 

Дата начала действия товарной статьи

 

Нет

Поле доступно для редактирования, заполняется вручную

 

Дата окончания 

 

Дата окончания действия товарной статьи

 

Нет

Поле доступно для редактирования, заполняется вручную

Описание

Описание товарной статьи, которое будет передаваться в МП/на сайт.

 

Нет

 

Поле доступно для редактирования, заполняется вручную

Зависимости   
Товары

Товарная статья может содержать  один или несколько товаров

Группы товарный статейНесколько товарный статей, объединенных общим признаком

1773307956777-645.png