Товарный справочник

• Товары
  • Идентификаторы товаров
• Подгруппы товаров
• Группы товаров
• Подкатегории товаров
• Категории товаров
  • Округление скидки на выбранную категорию товаров
• Группы списков товаров
• Производители товаров
• Бренды товаров
• Поставщики товаров
• Дополнительные идентификация (характеристика) товаров
  • Применимость Характеристик товаров в Персональной акции
• Товарные операции
• Лимиты товарных операций
• Создание записи товара при регистрации чека
• Учет минимальной расчетной цены
  • Перераспределение скидки между позициями при сумме со скидкой менее МРЦ

  • Регулирование применения МРЦ для товаров по специальной цене

• Интеграция товарного справочника через YML
• Фильтрация по товарным справочникам и справочникам организационной структуры
  • Списки категорий
  • Списки подкатегорий
  • Списки групп
  • Списки подгрупп
  • Списки товаров
  • Списки производителей
  • Списки брендов
  • Списки поставщиков
• Источник данных товарного каталога

Товарный справочник – это совокупность сущностей, объединённых различными связями вокруг карточек товаров. Карточка товара – это название товара и его артикул; также карточка товара содержит различные поля, соответствующие различным свойствам товара. Вокруг товара группируются различные записи. В первую очередь – это записи, определяющие иерархическую структуру, а также дополнительные записи: бренды, производители, партнёры и т.д.

Товарный справочник в системе можно организовать как иерархическим образом, так и с сетевыми связями. Для иерархической организации используются категории, подкатегории, группы и подгруппы товаров. Товар может входить в какую-то одну подгруппу. Подгруппа, соответственно, может входить в одну группу. Группа товаров может входить в одну подкатегорию товаров, которая в свою очередь может входить в одну категорию товаров. Данные связи необязательны. Таким образом, система имеет 5 жёстких уровней иерархии: Товар – Подгруппа – Группа – Подкатегория – Категория. Возможен также 6-й уровень иерархии, но уже не жесткий. Для этого определённые категории можно объединять в списки, и уже список категорий можно использовать как высший уровень иерархии.

Рис. Структура товарного справочника

Для сетевой организации используются списки товаров, подгрупп, групп, подкатегорий и категорий. В отличие от иерархической организации, когда объект нижнего уровня может входить только в один объект более высокого уровня, в сетевой один и тот же объект нижнего уровня может входить в неограниченное число списков.

 Рис. Списки категорий, подкатегорий, групп, подгрупп и товаров

Товары

Товар – это запись в системе, которая является продуктом или услугой, продажа которой осуществляется в магазинах компании или партнёров компании. Для корректной работы системы записи товаров должны быть предварительно созданы в базе данных (или загружены через интеграцию) и только после этого возможно организовывать процессинг чеков.

 Рис. Справочник товаров

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

Запись товара – это карточка товара. Карточка товара содержит следующую информацию:

Система предусматривает режим работы без регистрации товаров в системе, однако в этом случае не будет возможности регистрировать в системе чеки возврата, когда чек возврата ссылается на чек покупки.

Количество полей в карточке товара ограничено: помимо основных полей есть также группа полей дополнительных параметров. Дополнительные параметры – это функциональные поля, используемые как параметры фильтрации, но в системе к ним не привязано никакого конкретного содержания. Их содержание определяется при каждой конкретной локализации системы.

Дополнительных параметров по четыре поля различных типов: целые числа, десятичные, перечислимые типы. И двенадцать полей с типом строчные параметры.

Для примера, одно из числовых полей можно закрепить за размером одежды, если компания или какой-то партнёр ведёт бизнес в сфере fashion.

Внешний вид карточки Товар:

Рис. Карточка товара – Обзор

Рис. Карточка товара – детализация

Все ссылочные элементы: подгруппа, производитель, бренд, партнёр – указываются непосредственно как ссылки в карточке товара. За исключением записей поставщиков. Записи поставщиков связываются с товаром посредством отдельной таблицы, в которой уникальность определяется связкой товар-магазин. Дело в том, что для разных магазинов одни и те же товары могут иметь различных поставщиков.

Уникальность записей товаров

Если программа лояльности коалиционная, то велика вероятность использования одинаковых артикулов товаров в магазинах различных партнёров. Поэтому в системе организована возможность, позволяющая для товаров разных партнёров иметь одинаковые внешние идентификаторы.

Связанные товары

В карточке товара внутри таба "..." находится подтаб "Связанные товары". Здесь располагаются товары, которые должны отображаться в ЛК участника ПЛ как рекомендованные к выбранным товарам. Товары добавляются через поиск или по кнопке «+Добавление нового элемента». Связать товары также возможно через импорт или интеграцию.

В столбцах в представлении связанных товаров отображаются параметры из общих сведений о товаре, статус и дата изменения.

Рис. Подтаб «Связанные товары» в карточке Товара

Идентификаторы товаров

Для обеспечения возможности быстрого и точного поиска товаров в интерфейсе системы предусмотрен  раздел  "Идентификаторы товаров". В нем можно искать товары  по штрих-кодам. Это удобно, например, когда поступает обращение от покупателя с просьбой проверить  товар по ШК, распространялась ли на него акция, в которой он принимал участие.

Рис. Идентификаторы товаров в товарном справочнике

Карточка идентификатора товаров содержит следующую информацию:

Внешний вид карточки Идентификатор товара:

Рис. Карточка "Идентификатора товара"

В карточка товара его идентификаторы можно увидеть в связанном представлении во вкладке "...".

Рис. Идентификаторы товаров с карточке товара.

Подгруппы товаров

Подгруппа – это первая ступень в иерархии товарного справочника. Ссылка на подгруппу проставляется в карточке товара. Один и тот же товар не может входить в две разные подгруппы. Таким образом, отношение товара к подгруппе как N к 1.

Рис. Справочник подгрупп товаров

Карточка подгруппы товаров содержит следующую информацию:

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

Подгруппы можно объединять в списки и использовать при фильтрации в наборах позиций. Данные списки будут относиться к набору как статические списки объектов.

Внешний вид карточки подгруппы товаров:

Рис. Карточка подгруппы товаров

Группы товаров

Группа – это вторая ступень в иерархии товарного справочника. Ссылка на группу проставляется в карточке подгруппы товара. Одна и та же подгруппа товара не может входить в две разные группы. Таким образом, отношение подгруппы к группе как N к 1.

Рис. Справочник групп товаров

Карточка группы товаров содержит следующую информацию:

Группа не является обязательным товарным справочником. Допустимы записи товаров, которые включены в какие-то подгруппы, которые, в свою очередь, не включены в группы. Однако не может быть такого, что группа товаров является обязательной, но подгруппа – нет. Если используются группы товаров, то использование подгрупп становится обязательным.

Группы можно объединять в списки и использовать при фильтрации в наборах позиций. Данные списки будут относиться к набору как статические списки объектов.

Внешний вид карточки группы товаров:

Рис. Карточка группы товаров

Связанная со списком товаров Группа списков добавляется в соответствующее поле в карточке «Списки товаров».

Рис. Карточка «Списки товаров» с выбранным параметром Группа списков

Подкатегории товаров

Подкатегория – это третья ступень в иерархии товарного справочника. Ссылка на подкатегорию проставляется в карточке группы товара. Одна и та же группа товара не может входить в две разные подкатегории. Таким образом, отношение группы к подкатегории как N к 1.

Рис. Справочник подкатегорий товаров

Карточка подкатегории товаров содержит следующую информацию:

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

Подкатегории можно объединять в списки и использовать при фильтрации в наборах позиций. Данные списки будут относиться к набору как статические списки объектов.

Внешний вид карточки подкатегории товаров:

Рис. Карточка подкатегории товара

Категории товаров

Категория – это четвёртая и последняя жёсткая ступень в иерархии товарного справочника. Ссылка на категорию проставляется в карточке подкатегории товара. Одна и та же подкатегория товара не может входить в две разные категории. Таким образом, отношение подкатегории к категории как N к 1.

Рис. Справочник категорий товаров

Карточка категории товаров содержит следующую информацию:

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

Категории можно объединять в списки и использовать при фильтрации в наборах позиций. Данные списки будут относиться к набору как статические списки объектов.

Внешний вид карточки категории товаров:

Рис. Карточка категории товаров

Округление скидки на выбранную категорию товаров

Если к товару применяется дисконтное правило и получается скидка с копейками, но требуется, чтобы скидка была целым значением для определенных категорий товаров, необходимо применять функциональность округления скидки.

Округление скидки возможно только для такого товара, который входит в категорию товаров, отмеченную признаком «Округление скидок до целых чисел для товаров этой категории».

Рис. Признак "Округление скидки" в категории товаров

Например, магазин проводит акцию «Подарки к 8 марта». Клиент покупает коробку конфет, букет тюльпанов и средство для мытья посуды. Конфеты входят в подгруппу «Шоколадные конфеты», подгруппа в группу «Шоколадные конфеты в коробках», группа в подкатегорию и наконец, подкатегория в категорию «Товары для праздника», в которой отмечен признак округления.

На конфеты и цветы сработал скидка по акции. При этом на конфеты скидка получилась 19,99 руб. С учетом признака округления скидка становится 19 руб. Чтобы общая скидка по правилу сохранилась, десятичное значение 0,99 руб. переносится на позиции, к которым применилось тоже самое правило, т.е.  на букет тюльпанов.  На средство для мытья посуды скидка не переносится, т.к. позиция не проходит фильтр по товарам правила.

Если в чеке несколько позиций, которым правило предоставило поощрение, в результате которого образовалась скидка, то копейки перераспределяются на эти товары, которые не относятся к отмеченной категории товаров, пропорционально их стоимости.

Округление с переносом скидки производится только после применения МРЦ, сумм минимальных оплат по позиции и по чеку и перераспределения скидки в случае включенной настройки Loyalty.Processing.Discount.DistributedMCPDiscount. У позиции,  в которую переносится скидка, формируется РА с префиксом из настройки Loyalty.Processing.Soft.DistributedDiscountRuturnAsAttribute.Prefix.

Внешние скидки не округляются и не переносятся на другие позиции. Если в чеке только 1 позиция, округления не происходит.

Детальная информация о применении дисконтных правил и размере начисленных скидок записывается в БД в таблицу детализации скидок. В ней хранится информация и о размере скидок по примененным правилам начисления («тип скидки» = «1» (Внутренняя скидка), и дополнительно указывается размер перенесенных скидок («тип скидки» = «2» (Перенос скидки). Для позиций, к которым применилась внешняя скидка, «Тип» скидки = 0.

При возврате товара, помеченного признаком округления скидки, скидка, предоставленная на этот товар, округляется до целого числа в меньшую сторону. При возврате конфет, покупателю вернется стоимость конфет минус скидка 19 руб.

Аналогично работает возврат при включенной настройке Loyalty.Processing.Discount.RoundMCPDiscount.

Группы списков товаров

Для настройки персонального предложения на список товаров в Товарном справочнике системы предусмотрен подраздел в «Товарах» - «Группы списков товаров».

Параметры настройки Группы списков товаров

В настроенную Группу добавляются списки товаров через поиск имеющихся в системе «Списков товаров», либо создается новый список через + «Добавление нового элемента» => + «Создать список товаров». Тут же находится таб со связанной настройкой персональных акций.

 Рис. Группа списков товаров с записями Списков товаров

Производители товаров

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

Рис. Справочник производителей товаров

Карточка Производителя содержит следующую информацию:

Производитель - не обязательный атрибут карточки товара. Записи производителей можно объединять в списки и использовать при фильтрации в наборах позиций. Непосредственно фильтрацию по отдельным записям производителей можно организовать в значениях персональных акций.

Внешний вид карточки Производителя:

Рис. Карточка производителя товаров

Бренды товаров

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

Рис. Справочник брендов товаров

Карточка Бренда содержит следующую информацию:

Бренд - не обязательный атрибут карточки товара. Записи брендов можно объединять в списки и использовать при фильтрации в наборах позиций. Непосредственно фильтрацию по отдельным записям брендов можно организовать в значениях персональных акций.

Внешний вид карточки Бренд:

Рис. Карточка бренда товаров

Поставщики товаров

Запись товара непосредственно не связана с записью поставщика. В системе реализована возможность указывать поставщика для товара в конкретном магазине. В одном каком-то магазине один и тот же товар не может иметь разных поставщиков – только одного. В разных магазинах один и тот же товар может иметь разных поставщиков.

Поставщики – это записи, которые являются фактическими поставщиками конкретных товаров в конкретный магазин.

Рис. Справочник поставщиков товаров

Карточка поставщика содержит следующие поля:

Записи поставщиков можно объединять в списки и использовать при фильтрации по наборам позиций.

Рис. Справочник списков поставщиков товаров

Привязка товара к поставщику осуществляется через таблицу Связи с поставщиками.

Рис. Привязка поставщика к товару

Карточка этой связи содержит следующие поля:

Внешний вид карточки связи с поставщиком:

Рис. Карточка связи товара с поставщиком

Дополнительные идентификация (характеристика) товаров

С каждой записью товара может быть связано дополнительно несколько значений дополнительных идентификаторов (идентификационных кодов). Например, в качестве дополнительного идентификатора может выступать некоторый штрих-код товара, идентифицирующий конкретный товар, как и артикул этого товара. Для конкретного товара дополнительный идентификатор уникален в рамках определённого партнёра программы лояльности.

Рис. Справочники дополнительных характеристик товара

Дополнительный идентификационный код передаётся в запросе из внешних систем (например, от кассового ПО POS-терминала) в том же самом теге, что и артикул (внешний идентификатор) товара. В зависимости от системной настройки Loyalty.Processing.Article.Identification (для партнёра эта настройка указывается через расширенный атрибут партнера) переданное значение рассматривается либо как артикул товара, либо как дополнительный идентификационный код.

Определённый товар записывается в базу данных с фактически найденным артикулом.

В ответе по чеку передаётся в теге артикула позиции тоже самое значение, что было передано в запросе чека.

Карточка Характеристика товара содержит следующую информацию:

Внешний вид карточки Характеристика товара:

Рис. Карточка дополнительных характеристик товара

Применимость Характеристик товаров в Персональной акции

В персональной акции участнику ПЛ могут предлагаться не только рекомендованные товары, отбираемые по истории его покупок, но и группы товаров, соответствующие определенным характеристикам предпочитаемых товаров, например, аналоги от других производителей, товары, идентичные по цвету, стране происхождения или принадлежащие к товарам для животных и т.п..

В интерфейсе системы в Товарном справочнике «Характеристики» у товара — это группы аналогичных товаров, загружаемых в справочник Характеристика 1 через API вместе с товарным справочником.

Рис. Расположение сущности «Характеристики 1» в меню системы.

Для того чтобы настроить персональную акцию с рекомендованными товарами с соответствующей им группой аналогичных товаров с общей Характеристикой, необходимо в разделе Персональная акция => Персональное предложение => Фильтры => Характеристика 1 указать ссылку на справочник с группой товаров.

При настройке персонального предложения может быть выбран только 1 фильтр.

Рис. Параметр «Характеристика 1» в Персональном предложении

 Рис. Характеристика 1 с кодом аналогов, используемая в настройке Персонального предложения в Персональной акции

В данном примере, группа товаров аналогов соответствует «Коду аналогов» - КА-002012. Если в настройке персонального предложения присутствует ссылка на Характеристику 1, то правило персональной акции будет распространяться на все товары аналоги с таким кодом, т.е. на товар «Дюшес» объемом 0,5 л. от всех производителей.

В рекомендованные товары и персональные предложения параметры товаров из Характеристики 1 выводятся посредством методов API для интеграции с МП и ЛК на сайте (см описание по ссылке):

GET PersonalCampaign/GetAllByContact

GET RecommendedProduct/GetAllByContact

POST RecommendedProduct/Create

GET PersonalCampaign/GetAllByCard,

GET PersonalCampaign/Get

Записи рекомендованных товаров и персональных предложения грузятся из аналитики, из которой передается ID Характеристики, а в ответе на запрос передается ID.ExternalId. Наименование и ссылка на картинку выводится из карточки Характеристики.

Системные/партнерские настройки для персональных предложений и рекомендованных товаров (см. описание по ссылке ):

Loyalty.PCValue.Recommended.useEA.ServicedbyRecommendationSystem

Loyalty.PCValueDefaultSetting.Recommended

Loyalty.Processing.PCValue.Recommended.Elected.ExternalID.Prefix

Loyalty.Processing.PCValue.Recommended.QuantitativeProductLimit

Товарные операции

Товарные операции – это обработка чеков и хранение чеков в системе. Поступающий в систему чек проверяется на корректность: если чек прошёл процедуры проверки, то он подпадает под обработку правилами системы. Правила могут быть настроены таким образом, что под их обработку попадают не все чеки, а какие-то определённые: за это отвечают настраиваемые процедуры фильтрации чеков. Организовать фильтрацию можно по большинству параметров чека и конкретных товарных позиций.

Проверка на корректность – это проверка чека на согласованность его собственных параметров. В систему не могут попасть, например, чеки, у которых сумма по всем позициям отличается от общей суммы чека. Также не регистрируются чеки, дата которых не соответствует действительным временным характеристикам (например, выписанные 40 числа 20 месяца), сумма со скидкой отличается более чем на 5 процентов от суммы чека, к которой применена указанная в самом чеке скидка. Проверяются также номера позиций, если номер позиции чека состоит более чем из 50-ти символов – такие чеки также не попадут в систему. Также в систему не попадут чеки, сумма платежей по которым отличается от суммы со скидкой самого чека. Также не будут зарегистрированы чеки, по которым совершается покупка по несуществующей карте лояльности или предъявлена карта лояльности, находящаяся на дату чека в статусе Заблокирована или Завершена. Однако, если совершается покупка без предъявления карты лояльности или по какой-то недействительной (карте лояльности посторонней системы), система позволяет сохранять такие чеки в отдельной базе данных (необходима предварительная настройка).

Если чек не прошёл процедуры проверки корректности, то оператору POS-терминала выдаётся ответ с кодом ошибки и её описание. На основании полученной информации, оператор корректирует чек в пределах своей компетенции или принимает решение о продаже продукции по данному чеку без регистрации в базе данных программы лояльности.

Лимиты товарных операций

В системе есть возможность ограничить количество товарных операций. Товарные операции могут быть ограничены за одни сутки: с 00:00 до 24:00. При этом независимо друг от друга ограничивается:

• Количество покупок в день (количество зарегистрированных чеков);
• Общая сумма покупок (либо полная сумма покупок, либо сумма покупок со скидкой);
• Количество операций с начислением бонусных баллов (количество чеков, по которым произошло начисление бонусных баллов);
• Общая сумма начисленных бонусных баллов;
• Количество операций со списанием ранее начисленных бонусных баллов (количество чеков, по которым произошло списание бонусных баллов);
• Общая сумма, оплаченная бонусными баллами.

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

Ограничения независимо могут быть применены: для операций по отдельной карте, для операций по отдельной карте в определённом магазине, для операций по определённой карте во всех магазинах определённого партнёра, для операций по всем картам в определённом магазине, для операций по всем картам во всех магазинах определённого партнёра.

Если необходимо установить ограничения глобально, не привязываясь к магазинам и партнёрам, то нужно установить лимиты в системных настройках (начало названия настроек по лимитам Loyalty.Processing.Limits).

Для работы лимитов на уровне партнера необходимо включить системную настройку Loyalty.Processing.Limits.Partner.AllowLimits. Для установки ограничений на уровне партнера в карточке партнера есть вкладка «Лимиты». Если настройка Loyalty.Processing.Limits.Partner.Priority активирована (установлена в значении y, Y или 1), то лимиты операций задаются в карточках партнёров, в противном случае задаются как глобальные в системных настройках.

Для установки ограничений на уровне магазина в карточке магазина есть вкладка «Лимиты». Если настройка Loyalty.Processing.Limits.Shop.Priority активирована (установлена в значении y, Y или 1), то лимиты операций задаются в карточках магазинов, в противном случае задаются как глобальные в системных настройках.

Важно! Для работы лимитов необходимо включить системную настройку функциональности лимитов Loyalty.Processing.Limits.AllowLimits.

Важно! Если поля или настройки лимитов заполнены пустыми значениями, это означает, что товарные операции не ограничиваются, соответствующего лимита нет.

Важно! Операции по карте ограничиваются только глобально, то есть нельзя установить для каждой карты персональный лимит операций.

Есть возможность ограничивать процессинговые лимиты для карт с определённым типом. Для этого необходимо включить системную настройку Loyalty.Processing.CardTypeLimits.AllowLimits и в типе карт установить необходимое значение в поле «Применять процессинговые лимиты».

Есть возможность установить суточный лимит общих начислений баллов в рамках отдельной кампании программы лояльности по одной карте. При этом учитываются только баллы, начисленные по чеку. Для этого необходимо включить системную настройку Loyalty.Processing.Limits.Campaign.AllowLimits и в кампании установить необходимое значение в поле «Дневной лимит начисления бонусных баллов для карты».

Создание записи товара при регистрации чека

При обработке фискального чека есть возможность создавать запись товара, которого нет в системе на момент регистрации чека.

По умолчанию данная функциональность недоступна. Включается установкой партнёрской/системной настройки Loyalty.Processing.Item.NotFoundArticle.Create.TurnOn в одно из значений: 1, y или Y.

Запись товара будет создана, если в базе данных системы нет товара с внешним идентификатором, равным артикулу товара в запросе чека, или такой товар есть, но относится к иному партнёру, не совпадающему с партнёром, в магазине которого регистрируется чек.

При создании записи товара будут заполнены значения:

• Внешнего идентификатора товара
• Партнёра товара
• Название товара
• Значение МРЦ

Внешний идентификатор товара заполняется значением артикула позиции отсутствующего товара. Партнёр товара заполняется ссылкой на партнёра, в магазине которого зарегистрирован чек. Название товара заполняется префиксом и значением артикула, в качестве префикса используется значение партнёрской/системной настройки Loyalty.Processing.Item.NotFoundArticle.Create.NamePrefix. Значение МРЦ заполняется значением партнёрской/системной настройки Loyalty.Processing.Item.NotFoundArticle.Create.MCP.

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

Но правила, которые используют исключаемую фильтрацию, как раз могут примениться. Если на исключаемую фильтрацию завязаны какие-то критические процессы начисления, например, не начислять баллы на стоимость табачной продукции, то в этом случае лучше заведомо создать какую-то отдельную ветвь каталога, которая до уровня подгруппы будет исключена из всех правил начисления. При этом товар создавать заведомо включённым в исключаемую подгруппу.

Товар при создании включается в подгруппу, внешний идентификатор которой задан значением партнёрской/системной настройки: Loyalty.Processing.Item.NotFoundArticle.Create.ProductSubGroup. Важно, чтобы данная подгруппа относилась к тому же партнёру, для которого создаётся партнёрская настройка, автоматической проверки такой связи не предусмотрено. Также следует иметь в виду, что товар создаётся по событию фискального чека. При обработке мягкого чека товар ещё неизвестен, дисконтные правила с исключаемой фильтрацией по элементам товарного каталога будут применяться.

Учет минимальной расчетной цены

В системе есть возможность указать для каждого товара значение параметра минимальной расчётной цены (МРЦ). Этот параметр определяет минимальную стоимость, которая обязательно должна быть оплачена денежными средствами за одну единицу товара.

Рис. Поле МРЦ в карточке товара

Например, если товар продаётся по цене 100 рублей, по нему установлена минимальная расчётная цена как 70 рублей. Действует правило, которое предоставляет скидку 40 процентов. В этом случае, после применения данного правила по данному товару будет предоставлена скидка только 30%.

Функциональность МРЦ включается партнерской/системной настройкой Loyalty.Processing.WriteOff.MinCalcPriceArticle (партнерская настройка указывается через расширенный атрибут партнера).

В системе есть 4 способа установки МРЦ:

• В карточке товара. Значение МРЦ устанавливается в самой записи товара.
• Передача в запросе чека. В системе есть возможность передавать значение параметра МРЦ в запросе чека и обрабатывать его аналогично параметру МРЦ в карточке товара.

Применимость МРЦ из карточки товара или из запроса в чеке определяется партнерской/системной настройкой Loyalty.Processing.CalcMethod.ExternalMinCalcPriceArticle (партнерская настройка указывается через расширенный атрибут партнера).

• Глобальная МРЦ на каждую позицию. Можно задать глобальное значение вычитаемой суммы для позиций чека, даже если их артикулы не заведены в системе. Данное значение устанавливается в партнерской/системной настройке Loyalty.Processing.WriteOff.AvoidChequeItemSum (партнерская настройка указывается через расширенный атрибут партнера) и вычитается для всех без исключения позиций. Использование глобальной настройки не отключаемо, если оно проставлено, то будет всегда применяться ко всем чекам, у которых есть позиции. Если одновременно заданы МРЦ по товарам и глобальная сумма вычитания по позиции, то по каждой позиции будет применяться МРЦ как максимальное из глобальной и МРЦ*кол-во товара по позиции. Следует иметь в виду, что значение денежных единиц, которое указано в настройке Loyalty.Processing.WriteOff.AvoidChequeItemSum, будет вычитаться из суммы позиции, без учёта количества товаров в этой позиции. На это необходимо обратить внимание, если возможна продажа одинаковых товаров в разных позициях чека.
• Глобальная МРЦ на чек без позиций. Можно задать глобальное значение вычитаемой суммы для чека без позиций. Если данное значение установлено как какое-то неотрицательное число, то по каждому чеку это значение должно быть оплачено денежными единицами. Данное значение устанавливается в партнерской/системной настройке Loyalty.Processing.WriteOff.AvoidChequeSum (партнерская настройка указывается через расширенный атрибут партнера).

Система некорректно работает, если есть МРЦ и одновременно есть ограничение по правилу списания в случае, если ограничение таково, что заходит в область МРЦ. После редактирования МРЦ при возвратах возможна ошибка 80000, если МРЦ отредактирована после покупки в большую сторону. МРЦ по позициям не следует устанавливать меньше 1 денежной единицы валюты (рублей, долларов, евро и т.д.). Если установить МРЦ в мелких денежных единицах (копейки, центы и т.д.), то возможны ошибки при округлении в случае, когда количество в позиции чека меньше 1.

Перераспределение скидки между позициями при сумме со скидкой менее МРЦ

Возможности системы позволяют перераспределять остаток скидки, образованный разностью между суммой со скидкой позиции и МРЦ, на другие позиции чека, к которым применено это же дисконтное правило, пропорционально их стоимости и при их наличии. Если других позиций нет, то, несмотря на меньшее значение суммы со скидкой, устанавливается МРЦ.

Функциональность работает только при включенном значении настройки: Loyalty.Processing.Discount.DistributedMCPDiscount.

Рассмотрим пример. В чеке 5 позиций, на каждую позицию применилось одно или несколько дисконтных правил. Если у позиции есть МРЦ необходимо распределить не предоставленную часть скидки по правилам, пропорционально той скидке, которая должна была бы быть предоставлена в отсутствии МРЦ.

Позиция 1 – количество 7 шт., стоимость 777 руб., скидка 62.16 рублей, сумма со скидкой 714.84 руб., МРЦ 108 руб. На позицию применилось 3 правила:

Правило 1 скидка 2% 15.54 руб

Правило 2 скидка 3% 23.31 руб

Правило 3 скидка 3% 23.31 руб

 С учетом МРЦ общая сумма со скидкой по позиции не может быть меньше 756 руб., то есть общая скидка не может быть меньше 21 рубля. Таким образом, непредоставленная скидка=41.16 руб.

С учетом непредоставленной скидки ставки правил пересчитываются:

Правило 1 скидка = 15.54 руб, не предоставленная скидка = (41.16*15.54)/62.16 = 10.29, фактически предоставленная скидка = 5.25 руб, фактическая ставка 0.676%

Правило 2 скидка = 23.31 руб, не предоставленная скидка = (41.16*23.31)/62.16 = 15.44, фактически предоставленная скидка = 7.87, фактическая ставка = 1.013%

Правило 3 скидка = 23.31 руб, не предоставленная скидка = (41.16*23.31)/62.16 = 15.43, фактически предоставленная скидка = 7.88, фактическая ставка = 1.014%

По правилу 3, предоставляющему самую большую скидку, нераспределённая скидка уменьшена на копейку, чтобы было совпадение с распределяемой величиной.

Эти же правила применились и на другие позиции:

Позиция 2, кол-во = 1, сумма 1000, МРЦ = 0

Правило 1, скидка 2%, сумма скидки 20 руб

Позиция 3, кол-во = 1, сумма 1000, МРЦ = 0

Правило 1, скидка 2%, сумма скидки 20 руб

Правило 2, скидка 3%, сумма скидки 30 руб

Позиция 4, кол-во = 1, сумма 2000, МРЦ = 0

Правило 2, скидка 3%, сумма скидки 60 руб

Правило 3, скидка 3%, сумма скидки 60 руб

Позиция 5, кол-во = 1, сумма 3000, МРЦ = 2904

Правило 3, скидка 3%, сумма скидки 90 руб

К каждой позиции необходимо добавить непредоставленную скидку по примененному к этой позиции правилу. По правилу 1, необходимо распределить скидку в размере 10.29 руб. Правило 1 применяется ещё к позиции 2 и позиции 3. Правило даёт по данным позициям одинаковую скидку в 20 руб. На каждую позицию в рамках правила необходимо добавить (20*10.29)/40 =5.15 руб, по позиции 3 добавляется скидка на 1 коп. меньше 5.14 руб.

Аналогично распределяется скидка по Правилу 2. Не  предоставленная скидка равна 15.44 руб.  По позиции 3 дополнительная скидка будет (30*15.44)/90 = 5.15 руб., по позиции 4 дополнительная скидка будет (60*15.44)/90 = 10.29 руб.

По правилу 3 не предоставленная скидка=15.43 руб. Добавочные скидки по позиции 4 = (15.43*60)/150 = 6.17 руб., по позиции 5 = (15.43*90)/150 = 9.26 руб. Однако по позиции 5 с учетом  МРЦ 2904 руб. и скидки в 90 руб, может быть добавлено максимум 6 рублей скидки.

Получаем в итоге окончательный расчёт предоставленных скидок:

Позиция 1, кол-во = 7, Сумма = 777, МРЦ = 108, скидка = 21, ставка = 2.703%

Правило 1 фактическая скидка = 5.25, фактическая ставка = 0.676%

Правило 2 фактическая скидка = 7.87, фактическая ставка = 1.013%

Правило 3 фактическая скидка = 7.88, фактическая ставка = 1.014%

Позиция 2, кол-во = 1, сумма 1000, МРЦ = 0, скидка = 25.15, ставка = 2.515%

Правило 1, фактическая скидка = 20 + 5.15, фактическая ставка = 2.515%

Позиция 3, кол-во = 1, сумма 1000, МРЦ = 0, скидка = 60.29, ставка = 6.029%

Правило 1, фактическая скидка = 20 + 5.14, фактическая ставка = 2.514%

Правило 2, фактическая скидка = 30 + 5.15, фактическая ставка = 5.515%

Позиция 4, кол-во = 1, сумма 2000, МРЦ = 0, скидка = 136.46, ставка = 6.823%

Правило 2, фактическая скидка = 60 + 10.29, фактическая ставка = 3.515%

Правило 3, фактическая скидка = 60 + 6.17, фактическая ставка = 3.309%

Позиция 5, кол-во = 1, сумма 3000, МРЦ = 2904, скидка = 96, ставка = 3.200%

Правило 3, фактическая скидка = 90 + 6, фактическая ставка = 3.200%

После перераспределения скидок осуществляется проверка, не превзошла ли скидка установленного значения по лимитам, ограничению максимальным процентом скидки от суммы и максимальным значением суммы скидки. Если по какому-то правилу был достигнут лимит скидки, то распределённая скидка уменьшается до значения лимита.

Если по какой-то позиции применилось хотя бы одно правило фиксированной цены – распределение скидки на данную позицию не происходит.

По каждой позиции, на которую перенесена скидка, для каждого правила в ответе на запрос чека формируется РА с префиксом из настройки Loyalty.Processing.Soft.DistributedDiscountRuturnAsAttribute.Prefix. Если включена настройка Loyalty.Processing.Soft.DiscountRuleRuturnAsAttribute.ReturnJson, то значение атрибута будет выглядеть так для позиции, на которую перенесена часть скидки:

<ExtendedAttribute>

               <Key>DistributedDisc_Правило</Key>

               <Value>{"N":"D3","D":60.80" }</Value>

</ExtendedAttribute>

где:

DistributedDisc_ это префикс из партнерской настройки и внешний идентификатор дисконтного правила.

N – уникальный в рамках чека и правила номер атрибута внутри чека. Числовое значение из 2-х символов из цифр и латинских букв.

D – (дискаунт) величина перенесенной скидки по правилу. В зависимости от настройки Loyalty.Processing.Soft.DiscountRuleRuturnAsAttribute.DiscountType данное значение формируется или как % (значение настройки 0) или как значение (значение настройки 1). Если формируется как значение, необходимо учесть настройку Loyalty.Processing.Answer.DiscountDetailAsAttribute.DecimalScale.

В таблице детализации скидок в БД в позиции записывается информация и о размере скидок по примененным правилам начисления, и дополнительно указывается размер перенесенных скидок.

Пример: скидка на позицию по правилу 7 руб., 4р МРЦ, 3 руб. необходимо перераспределить, 4 руб. остается и записывается в таблицу для данной позиции. Тип скидки=1.  Для позиций,  к которым применилось правило и на которые будет перенесена скидка,  будет создано две записи:  скидка по правилу 7руб (тип скидки=1.,  перенесенная скидка 1,33руб.( тип скидки=2).

Интеграция товарного справочника через YML

Существует возможность загружать товарный справочник в систему посредством файла в формате YML (Yandex Market Language - частный случай XML, специализированный под товарные площадки, онлайн-магазины).

Рис. Справочник интеграций YML

Для настройки интеграции YML предназначена соответствующая карточка, которая содержит следующую информацию:

Внешний вид карточки Настройка интеграции YML:

Рис. Карточка интеграции YML

Для установки маппинга полей интеграции (для соответствия конкретного элемента в файле YML с конкретным полем определённой сущности товарного справочника в системе) предназначена соответствующая карточка, которая содержит следующую информацию:

Внешний вид карточки Маппинг полей для интеграции YML:

Рис. Карточка маппинга интеграции YML

Для каждого поля нужно создавать отдельную запись маппинга. Настройка интеграции YML можно связать с неограниченным числом записей маппинга. 1 поле = 1 запись маппинга.

Файл YML с товарным справочником может быть обработан сервисом интеграции через FTP. Для этого в карточке настройки интеграции YML задаётся адрес FTP и параметры доступа к нему (логин, пароль). Также в настройке требуется указать название файла на FTP, которое должно быть в формате Partner_датазагрузки.xml, например, «DemoPartner_20200815.xml» (кодировка файла должна быть UTF-8). Если загрузка YML происходит на постоянной основе (ежедневно), то вместо «датазагрузки» необходимо указать [date], например, «DemoPartner_[date].xml». YML-файл на FTP обрабатывается сервисом интеграции согласно установленному расписанию в сущности «Расписание периодического задания» (доступно для редактирования только пользователю с ролью системного администратора).

Параметром записи товарного справочника, определяющим необходимость создания или изменения записи в системе, является внешний идентификатор записи (поле pl_externalid). Т.е. если в YML-файле содержится запись товарного справочника с внешним идентификатором, который уже есть в системе, то тогда эта запись обновляется в системе при обработке YML, иначе создаётся в системе. При этом создаются или изменяются только те записи товарного справочника, которые присутствуют в файле, оставляя остальные имеющиеся в системе без изменений.

Процесс обработки файла YML сопровождается логированием. Просмотреть лог возможно в базе данных Log. Период хранения лога истории загрузок YML задаётся в системной настройке Integration.YML.LogStorageDays.

Порядок действий для настройки интеграции товарного справочника через YML-файл посредством FTP, а также шаблон маппинга полей интеграции можно посмотреть в соответствующей статье базы знаний на портале обучения.

Фильтрация по товарным справочникам и справочникам организационной структуры

Практически по всем связанным с товаром атрибутам можно организовать отбор чеков или их позиций на применимость к ним правил программы лояльности.

После того как произведена проверка чека на корректность его собственных параметров, к чеку применяются процедуры фильтрации. Процедуры фильтрации ограничивают применимость к чеку или к отдельной позиции чека правил, предоставляющих поощрения, и правил, позволяющих оплатить данный чек начисленными ранее бонусными баллами.

Фильтрация по товарным справочникам – это фильтрация по параметрам чека. Для осуществления фильтрации в системе должны быть заведены записи наборов. В этих записях указываются диапазоны допустимых параметров. Наборы могут быть включаемыми и исключаемыми. В случае включаемой фильтрации под обработку правилом подпадут те чеки и/или их позиции, параметры которых укладываются в диапазон параметров набора, который связан с правилом как включаемый. В случае исключаемой фильтрации, наоборот, под правило подпадут те чеки и/или их позиции, параметры которых не укладываются в указанные в наборе диапазоны. Фильтрация может быть организована по общим параметрам чека и по параметрам отдельной позиции чека. Не следует путать товар и позицию чека. Позиция чека – это товар в каком-то количестве с суммовыми показателями: ценой и стоимостью, равной цене, умноженной на количество.

Помимо динамической фильтрации, когда задаются диапазоны допустимых параметров, в системе предусмотрена статическая фильтрация, когда заранее определяется, что правило будет действовать в конкретных магазинах или применяться к конкретным товарам. Для этого служат списки записей. Списки записей не могут быть непосредственно отнесены к правилу, они соотносятся с правилом через набор. В самом наборе списки могут использоваться и как включаемые, и как исключаемые.

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

Если, например, к кампании относится какой-то включаемый список магазинов, то все правила начисления этой кампании будут применены только в тех магазинах, которые входят в этот список. Аналогично и для партнёров. Если к кампании относится включаемый список товаров, то все позиционные правила начисления этой кампании будут применяться только к тем позициям чека, товары которых входят в этот список.

Списки категорий

Список категорий товаров – это постоянная совокупность записей категорий. Когда правило обрабатывает позицию чека, по артикулу товара в чеке производится сопоставление артикула с записью товара в системе, и если данная запись товара входит через всё дерево иерархии в какую-то категорию товаров, то можно посредством соотнесения списка категорий организовать применение (или неприменение) правила к данной позиции чека. Следует отметить, что прямой связи товара и категории в системе нет: товар и категория связаны через подгруппу, группу и подкатегорию товаров. Непосредственно списки категорий используются для фильтрации позиций чека в персональной акции.

Рис. Справочник списков категорий товара

Список категорий содержит следующую информацию:

Внешний вид карточки Списка категорий товаров:

Рис. Карточка списка категорий товара

Списки подкатегорий

Список подкатегорий товаров – это постоянная совокупность записей подкатегорий. Когда правило обрабатывает позицию чека, по артикулу товара в чеке производится сопоставление артикула с записью товара в системе, и если данная запись товара входит через всё дерево иерархии в какую-то подкатегорию товаров, то можно посредством соотнесения списка подкатегорий организовать применение (или неприменение) правила к данной позиции чека. Следует отметить, что прямой связи товара и подкатегории в системе нет: товар и подкатегория связаны через подгруппу и группу товаров. Непосредственно списки подкатегорий используются для фильтрации позиций чека в персональной акции.

Рис. Справочник списков подкатегорий товара

Список подкатегорий содержит следующую информацию:

Внешний вид карточки Списка подкатегорий товаров:

Рис. Карточка списка подкатегорий товара

Списки групп

Список групп товаров – это постоянная совокупность записей групп. Когда правило обрабатывает позицию чека, по артикулу товара в чеке производится сопоставление артикула с записью товара в системе, и если данная запись товара входит в какую-то группу товаров, то можно посредством соотнесения списка групп организовать применение (или неприменение) правила к данной позиции чека. Следует отметить, что прямой связи товара и группы в системе нет: товар и группа связаны через подгруппу товаров.

Рис. Справочник списков групп товаров

Список групп содержит следующую информацию:

Внешний вид карточки Списки групп:

Рис. Карточка списка групп товаров

Списки подгрупп

Список подгрупп товаров – это постоянная совокупность записей подгрупп. Когда правило обрабатывает позицию чека, по артикулу товара в чеке производится сопоставление артикула с записью товара в системе, и если данная запись товара входит в какую-то подгруппу товаров, то можно посредством соотнесения списка подгрупп организовать применение (или неприменение) правила к данной позиции чека.

Рис. Справочник списков подгрупп товаров

Список подгрупп содержит следующую информацию:

Внешний вид карточки Списки подгрупп:

Рис. Карточка списка подгрупп товаров

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

Список товаров – это постоянная совокупность записей товаров. Когда правило обрабатывает позицию чека, по артикулу товара в чеке производится сопоставление артикула с записью товара в системе, и если данная запись товара входит в какой-то список товаров, соотнесённый с набором позиций, то можно организовать применение (или неприменение) правила к данной позиции чека.

Рис. Справочник списков товаров

Список товаров содержит следующую информацию:

Внешний вид карточки Список товаров:

Рис. Карточка списка товаров

Списки производителей

Список производителей – это постоянная совокупность записей производителей товаров. Когда правило обрабатывает позицию чека, по артикулу товара в чеке производится сопоставление артикула с записью товара в системе, и если данная запись товара относится к какому-то производителю, то можно посредством соотнесения списка производителей с набором позиций организовать применение (или неприменение) правила к данной позиции чека.

Рис. Справочник списков производителей товаров

Список производителей содержит следующую информацию:

Внешний вид карточки Список производителей:

Рис. Карточка списка производителей товаров

Списки брендов

Список брендов товаров – это постоянная совокупность записей брендов. Когда правило обрабатывает позицию чека, по артикулу товара в чеке производится сопоставление артикула с записью товара в системе, и если данная запись товара относится к какому-то бренду, то можно посредством соотнесения списка брендов организовать применение (или неприменение) правила к данной позиции чека.

Списки брендов можно загружать вручную и по интеграции, аналогично другим объектам модуля ML Online через ML API (см. подробнее в описании API для интеграции с учетной системой)

Рис. Справочник списков брендов товаров

Список брендов содержит следующую информацию:

Внешний вид карточки Список брендов:

Рис. Карточка списка брендов товаров

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

Список поставщиков – это постоянная совокупность записей поставщиков товаров. Когда правило обрабатывает позицию чека, по артикулу товара в чеке производится сопоставление артикула с записью товара в системе, и если данная запись товара относится к какому-то поставщику в магазине, где выписывается данный чек, то можно посредством соотнесения списка поставщиков с набором позиций организовать применение (или неприменение) правила к данной позиции чека.

Рис. Справочник списков поставщиков товаров

Список поставщиков содержит следующую информацию:

Внешний вид карточки Список поставщиков:

Рис. Карточка списка поставщиков товаров

Источник данных товарного каталога

Для того, чтобы можно было понять, к какому товарному справочнику партнёра относится тот или иной товар/категория товаров и т.д. и использовать это в аналитике, в интерфейсе заведена сущность и поле «Источник данных». В текущей версии фильтрация по источнику данных для правил программы лояльности не предусмотрена. Поле носит информационный характер.

Сущность «Источник данных» располагается в разделе меню «Настройки».

Карточка сущности «Источник данных» содержит следующие параметры:

Возможность указать Источник данных присутствует во всех элементах товарного каталога:

•          Список категорий товаров

•          Список подкатегорий товаров

•          Список групп товаров

•          Список подгрупп товаров

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

•          Группа списков товаров

•          Список брендов

•          Список производителей

•          Список поставщиков

•          Категория товаров

•          Подкатегория товаров

•          Группа товаров

•          Подгруппа товаров

•          Товар

•          Бренд

•          Производитель

•          Поставщик

•          Характеристика товара 1

•          Характеристика товара 2

•          Характеристика товара 3

•          Характеристика товара 4

Рис. Источник данных в товаре (детализация)

Товарный справочник загружается через сервис ML API, отслеживать и редактировать его можно через интерфейс лояльности.

 Рис. Источник данных для товарного справочника