История страницы

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

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

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

Image RemovedImage Added

В каталоге необходимо найти файл 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") }

...

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

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

Image Added

При использовании данного параметра в значении true, также необходимо задать значение параметера useBonusesByPhoneMessage;

- useBonusesByPhoneMessage: параметр, связанный с параметром useBonusesByPhone: содержит текст кастомного сообщения для кассира/покупателя на киоске или КСО во время регистрации клиента в чеке по номеру телефона, которое возникает на экране только при условии, что useBonusesByPhone = true:

Image Added

Текст, заключенный в параметре useBonusesByPhoneMessage и, соответственно, выводимый на экран кассы/киоска/КСО, может содержать HTML-теги, такие как <br> – перенос строки или <b>Text</b> – текст жирным шрифтом. Теги учитываются при подсчёте символов строки (максимальное количество символов – 100);

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

Image Added

В LOYA это значение параметра Код в справочнике точек продаж в LOYA:

Image Modified

Во внешней системе это номер магазина, присвоенный ему в этой системе.

Есть два способа обеспечить идентичность данного значения во всех трёх системах:

1. Выставить значение соответствующих параметров во всех системах вручную.

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

Image Added

Настройки в loya.conf следует сохранить.

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

Image Removed

Image Removed

При использовании этой схемы выгрузки, параметр merchantId в

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

Якорь
regwindow regwindow

Текст и опции в окне регистрации УПЛ

На кассовом сервере можно настроить текст заголовка и список действий, выводимые в окне регистрации клиента LOYA в чеке:

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

Image Removed

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

Image Added

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

Якорь
buttonreg buttonreg

Кнопка регистрации карты для клавиатурной кассы

Настройка кнопки вызова меню регистрации карты лояльности для клавиатурной кассы производится на кассовом сервере по адресу: Магазин – Кассы, где нужно выбрать необходимую кассу и нажать кнопку Оборудование:

Image Added

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

Image Added

В конфигурационный файл с раскладкой актуальной клавиатуры по адресу: hardware\keyboard_layout\файл актуальной раскладки необходимо добавить следующий фрагмент, после чего нажать кнопку Сохранить:

{
 code : 117, // F6
 type : "UIAction",
 params : "MarketingOperations" # F6 - Вызов кассовой функции "Регистрация покупателя" 
}

Якорь
hand hand

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

...

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

Image RemovedImage Added

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

Якорь
cert cert

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

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

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

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

Image Added

2. В появившемся иерархическом древе необходимо создать папку с названием services/giftcertificate и разместить в ней файлы giftcertificate.conf и loya.conf:

Image Added

3. Если в папке services присутствует файл giftcertificate.conf (conf\services\giftcertificate.conf), то его следует удалить.

4. В файле mintukm (\mintukm.conf) необходимо найти строку { include file("conf/services/giftcertificate.conf") }, заменить ее на { include file("conf/services/giftcertificate/giftcertificate.conf") } и раскомментировать.

5. В файле giftcertificate.conf (conf\services\giftcertificate\giftcertificate.conf) необходимо закомментировать параметр giftcertificateSku и обязательно указать правильный код локации в параметре locationCode. Код локации для каждого магазина индивидуален; он должен совпадать со значением Код в справочнике точек продаж в LOYA:

Image Added

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

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

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

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

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

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

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

Image Added

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

Image Added

В конфигурационный файл с раскладкой актуальной клавиатуры по адресу: hardware\keyboard_layout\файл актуальной раскладки необходимо добавить следующий фрагмент, после чего нажать кнопку Сохранить:

{
 code : 117, // F6
 type : "UIAction",
 params : "CheckCertificateBalance" # F6 - Проверка баланса ПС 
}

На touch-кассе кнопка проверки баланса подарочного сертификата выводится автоматически – при условии наличия параметра useCertificate = true:

Image Added

Якорь
referal referal

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

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

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

Image Added

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

usePromoCode=true.

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

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

Image Added

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

Image Added

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

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

Image Added

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