Подключение СуперМаг Loya

Общие настройки

Маркетинговое решение для УКМ 5 представлено продуктом СуперМаг Loya в различных вариантах его комплектации. Данное решение является собственной разработкой нашей компании и представляет собой универсальный механизм работы со всеми аспектами маркетинга в индустрии ритейл: от внедрения и мониторинга рекламных акций и бонусных программ до построения сложных кастомизированных алгоритмов и аналитики по ним – и много чего другого.

Настройка работы с LOYA выполняется на кассовом сервере по адресу: Магазин – Типы касс. Нужно выбрать тип кассы и нажать кнопку Настройки:

В каталоге необходимо найти файл marketing.conf (services\marketing\marketing.conf), а также файл loya.conf (services\marketing\loya.conf).

Для того чтобы происходило взаимодействие кассы с сервером LOYA, необходимо в файле конфигурации marketing.conf (services\marketing\marketing.conf) раскомментировать соответствующую строку:

{ include file("conf/services/marketing/loya.conf") }

В файле loya.conf (services\marketing\loya.conf) также необходимо выполнить несколько настроек:

В УКМ 5 реализовано 2 режима высчитывания скидок:

- on-line – акции, которые обрабатывает сервер LOYA, т.е. в процессе оформления чека касса обращается к нему (передаёт содержание чека), сервер LOYA выполняет обработку акции и возвращает кассе результат;

- off-line – акции, которые обрабатываются на кассе без обращения к серверу LOYA.

Для того чтобы касса рассчитывала скидки off-line (вне зависимости от факта дальнейшего обращения к серверу LOYA), необходимо в конфигурационном файле loya.conf (services\marketing\loya.conf) установить параметр useOffline = true.

Для того чтобы касса не обращалась к серверу LOYA в момент оформления чека, необходимо установить следующие параметры:

    - useSaleOnline = false;

    - useRefundOnline = false.

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

Распознавание номеров дисконтных карт описывается в параметрах discountCardBarcodeMasks и discountCardMsrMasks (при вводе их сканером или магнитным считывателем, соответственно).

Карта покупателя может быть введена с помощью сканера или магнитного считывателя. Форматы номеров карт описываются с помощью регулярных выражений в параметрах clientCardbarcodeMasks и clientCardmsrMasks, соответственно.

Распознавание кодов купонов описывается в параметре couponCodeBarcodeMasks. Параметр usePositionCoupons = true включает возможность использования купонов на отдельную позицию.

Регистрация карт покупателей и купонов может происходить в двух режимах:

- в «активном», когда на экране кассы появляется диалог с предложением ввести карту и/или купон;

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

Режим определяется параметрами isCouponDialog и isClientRegDialog.

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

- useRefundOnline: использовать ли онлайн-расчёт при возврате (или достаточно оффлайн-расчета). Параметр рекомендуется активировать при использовании бонусов;

- availabilityScanPeriod: интервал, с которым касса пытается подключиться к серверу LOYA в случае отсутствия связи. По умолчанию, значение составляет 2 минуты: это значит, что раз в 2 минуты (или реже) работа кассы "замедляется". Данный интервал можно увеличить, если становится понятно, что сервер LOYA периодически становится недоступен, и постоянное обращение к нему мешает работе на кассе (как, например, при плохом интернет-соединении);

- usePositionCoupons: параметр обеспечивает корректное распознавание и прием кассой УКМ 5 купонов со скидкой на позицию;

- addBeginToRegExp: параметр, предназначенный для внутреннего использования представителями команды разработки и техподдержки; значение изменять нельзя.

Все остальные параметры будут иметь одинаковое значение для всех касс всех магазинов, кроме параметра merchantId. Он для каждого магазина индивидуален и он должен совпадать со значением Код в справочнике точек продаж в LOYA:

Рекомендуется выгружать точки продаж (магазины) в LOYA из УКМ 5 через конвертер экспорта. В таком случае, Код магазина в УКМ 5 будет гарантированно идентичен Коду точки продаж в LOYA:

При использовании этой схемы выгрузки, параметр merchantId в файле loya.conf (services\marketing\loya.conf) обязательно должен быть закомментирован или отсутствовать, так как только в этом случае, касса УКМ 5 в своих запросах к серверу LOYA будет использовать значение из параметра, указанного в настройках магазина на кассовом сервере УКМ 5 по адресу Магазин – Описание – Интеграция – Id во внешней системе:

Другими словами, если в поле Код в справочнике точек продаж в LOYA записывать такое же значение, как и в УКМ 5 в настройках магазина Id во внешней системе, то параметр merchantId вообще не надо указывать. А это значит, что файл loya.conf можно копировать из одного магазина в другой и ничего в нем не править.

Для упрощения интеграции кассы с системой лояльности, также необходимо произвести выгрузку справочников товаров из УКМ 5 в LOYA. При расчете скидок на товары и группы товаров, LOYA использует справочники товаров, загруженные с кассы, в связи с чем их загрузку в LOYA следует производить до начала пользования системой. Экспорт товаров из УКМ 5 в LOYA производит команде техподдержки УКМ 5 в рамках предпроектной подготовки.

На стороне LOYA за процесс загрузки товаров из УКМ 5 отвечают блоки Справочники. Товары и Справочники. Категории товаров в API-документации LOYA (для версии 1.60).

Ручной ввод номера карты лояльности

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

1. На кассовом сервере по адресу: Магазин – Типы касс нужно выбрать тип кассы и нажать кнопку Настройки:

В конфигурационном файле loya.conf (conf\services\marketing\loya.conf) необходимо указать параметр isClientCardManualEnter = true, после чего сохранить настройки.

Подарочные сертификаты

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

На кассовом сервере УКМ 5 необходимо выполнить следующие настройки:

1. По адресу: Магазин – Типы касс нужно выбрать тип кассы и нажать кнопку Настройки:

2. В появившемся иерархическом древе необходимо в файле sale.conf (applications\sale\sale.conf) добавить в раздел bl параметр giftCertificateSKU = "N", где N обозначает SKU позиции подарочного сертификата из базы данных.

3. Чтобы задать таймаут повторной отправки запроса на регистрацию подарочного сертификата при недоступности сервера, нужно в файле giftcertificate.conf (conf\services\giftcertificate.conf) добавить параметр requestRepeatTimeout = N, где N – число в секундах.

4. Для отображения в чеке перечня проданных сертификатов, необходимо заменить файл receiptRebuilder_condensed.js (conf\applications\scripts\receiptRebuilder_condensed.js) на этот.

5. Чтобы обеспечить выведение остатка на балансе сертификата в чек, необходимо разместить файл receiptRebuilder_condensed.js по адресу: conf\applications\sale\scripts\receiptRebuilder_condensed.js и убедиться в том, что именно он указан в настройках в файле sale.conf (applications\sale\sale.conf):

receiptRebuilderEngine = conf/applications/sale/scripts/receiptRebuilder_condensed.js

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

6. Чтобы настроить кнопку вызова функции Продажа сертификата, необходимо в разделе ui конфигурационного файла sale.conf (applications\sale\sale.conf) добавить параметр useCertificate = true.

Кнопка появляется в режиме Продажа:

Реферальные промо-коды

Настройки, необходимые для работы с промо-кодами реферальной программы LOYA, выполняются в несколько этапов.

1. Функция применения промо-кода активируется на кассовом сервере УКМ 5 по адресу: Магазин – Типы касс, где нужно выбрать тип кассы и нажать кнопку Настройки:

В разделе ui конфигурационного файла sale.conf (applications/sale/sale.conf) необходимо активировать функцию применения промо-кода, выставив следующее значение параметра:

usePromoCode=true.

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

2. На клавиатурной кассе необходимо настроить кнопку ввода номера промо-кода. Настройка производится на кассовом сервере УКМ 5 по адресу: Магазин – Кассы, где нужно выбрать соответствующую кассу, нажав на ее название:

На открывшейся странице нужно выбрать опцию Оборудование:

В открывшемся иерархическом древе необходимо в группе keyboard_layout найти конфигурационный файл, содержащий настройки актуально используемой клавиатуры (например, hardware/keyboard_layout/stdpcKeyboardLayout.conf). В данный файл нужно добавить следующий фрагмент: 

{
  code : 117, // F6
  type : "UIAction",
  params : "PromoCode"   # F6 - Вызов кассовой функции "Применить промо-код"
}

Выполненные настройки следует сохранить.