...
Маркетинговое решение для УКМ 5 представлено продуктом СуперМаг Loya в различных вариантах его комплектации. Данное решение является собственной разработкой нашей компании и представляет собой универсальный механизм работы со всеми аспектами маркетинга в индустрии ритейл: от внедрения и мониторинга рекламных акций и бонусных программ до построения сложных кастомизированных алгоритмов и аналитики по ним – и много чего другого.
Настройка работы с LOYA выполняется на кассовом сервере по адресу: Магазин – Типы касс. Нужно выбрать тип кассы и нажать кнопку Настройки:
В каталоге необходимо найти файл marketing.conf (services\marketing\marketing.conf), а также файл loya.conf (services\marketing\loya.conf).
...
- availabilityScanPeriod: интервал, с которым касса пытается подключиться к серверу LOYA в случае отсутствия связи. По умолчанию, значение составляет 2 минуты: это значит, что раз в 2 минуты (или реже) работа кассы "замедляется". Данный интервал можно увеличить, если становится понятно, что сервер LOYA периодически становится недоступен, и постоянное обращение к нему мешает работе на кассе (как, например, при плохом Интернет-соединении);
- usePositionCoupons: параметр обеспечивает корректное распознавание и прием кассой УКМ 5 купонов со скидкой на позицию;
- useBonusesByPhone: в значении true (значение по умолчанию), параметр запрещает вызывать окно списания бонусов, если клиент зарегистрирован в чеке по номеру телефона: Якорь nobonuswind nobonuswind
При использовании данного параметра в значении true, также необходимо задать значение параметра useBonusesByPhoneMessage;
- useBonusesByPhoneMessage: параметр, связанный с параметром useBonusesByPhone: содержит текст кастомного сообщения для кассира/покупателя на киоске или КСО во время регистрации клиента в чеке по номеру телефона, которое возникает на экране только при условии, что useBonusesByPhone = true:
Текст, заключенный в параметре useBonusesByPhoneMessage и, соответственно, выводимый на экран кассы/киоска/КСО, может содержать HTML-теги, такие как <br> – перенос строки или <b>Text</b> – текст жирным шрифтом. Теги учитываются при подсчёте символов строки (максимальное количество символов – 100);
- zeroBonusByDefault: если значение параметра установлено как true, то в диалоговом окне LOYA с предложением списать бонусы по умолчанию будет отображаться ноль; при значении false, по умолчанию в данном окне будет отображаться вся сумма бонусов, доступная для УПЛ к списанию. Якорь zerobydef zerobydef
- cascadeVerificationSendSmsTimeout: тайм-аут (в секундах), по истечении которого кассир сможет инициировать отправку на номер клиента SMS с проверочным кодом (например, если не сработал звонок); параметр используется при использовании включенной на стороне LOYA каскадной верификации номера телефона при регистрации нового УПЛ или списании бонусов свыше установленного порога; Якорь timeout timeout
- cascadeVerificationAttemptsCount: количество попыток ввода корректного проверочного кода; параметр используется при использовании включенной на стороне LOYA каскадной верификации номера телефона при регистрации нового УПЛ или списании бонусов свыше установленного порога; Якорь attempts attempts
- addBeginToRegExp: параметр, предназначенный для внутреннего использования представителями команды разработки и техподдержки; значение изменять нельзя.Все остальные параметры будут иметь одинаковое значение для всех касс всех магазинов, кроме параметра merchantId. Он для каждого магазина индивидуален и он должен совпадать со значением
Для корректного взаимодействия внешней системы с кассовой системой и системой лояльности, необходимо обеспечить идентичность значения внешнего идентификатора магазина во всех этих системах. В кассовой системе это значение отражено в параметре Id во внешней системе на кассовом сервере УКМ 5 по адресу Магазин – Описание (подраздел Интеграция): Якорь unifiedcode unifiedcode
В LOYA это значение параметра Код в справочнике точек продаж в LOYA:
Рекомендуется выгружать точки продаж (магазины) в LOYA из УКМ 5 через конвертер экспорта. В таком случае, Код магазина в УКМ 5 будет гарантированно идентичен Коду точки продаж в LOYA:
При использовании этой схемы выгрузки, параметр merchantId в Во внешней системе это номер магазина, присвоенный ему в этой системе.
Есть два способа обеспечить идентичность данного значения во всех трёх системах:
1. Выставить значение соответствующих параметров во всех системах вручную.
2. Обратиться к команде техподдержки УКМ 5 с просьбой настроить конвертер импорта так, чтобы корректное значение параметра передавалось из внешней системы в УКМ 5 автоматически. При этом, в файле loya.conf (services\marketing\loya.conf) обязательно должен быть закомментирован или отсутствовать, так как только в этом случае, касса УКМ 5 в своих запросах к серверу LOYA будет использовать значение из параметра, указанного в настройках магазина на кассовом сервере УКМ 5 по адресу Магазин – Описание – Интеграция – Id во внешней системе:
Другими словами, если в поле Код в справочнике точек продаж в LOYA записывать такое же значение, как и в УКМ 5 в настройках магазина Id во внешней системе, то параметр merchantId вообще не надо указывать. А это значит, что файл loya.conf можно копировать из одного магазина в другой и ничего в нем не править. нужно указать параметр useExternalCode в значении true, а параметр merchantId закомментировать:
Настройки в loya.conf следует сохранить.
Рекомендуется выгружать точки продаж (магазины) в LOYA из УКМ 5 через конвертер экспорта.
Для упрощения интеграции кассы с системой лояльности, также необходимо произвести выгрузку справочников товаров из УКМ 5 в LOYA. При расчете скидок на товары и группы товаров, LOYA использует справочники товаров, загруженные с кассы, в связи с чем их загрузку в LOYA следует производить до начала пользования системой. Экспорт товаров из УКМ 5 в LOYA производит команда внедрения УКМ 5 в рамках предпроектной подготовки. Якорь export export
На стороне LOYA за процесс загрузки товаров из УКМ 5 отвечают блоки Справочники. Товары и Справочники. Категории товаров в API-документации LOYA (для версии 1.60).
Якорьregwindow regwindow
Текст и опции в окне регистрации УПЛ
regwindow | |
regwindow |
...
Настройка кнопки вызова меню регистрации карты лояльности для клавиатурной кассы производится на кассовом сервере по адресу: Магазин – Кассы, где нужно выбрать необходимую кассу и нажать кнопку Оборудование:
В появившемся иерархическом древе в конфигурационном файле keyboard_layout (hardware/\keyboard_layout/\keyboardLayout.conf) нужно посмотреть, какой тип клавиатуры используется (он должен быть раскомментирован в общем списке):
В конфигурационный файл с раскладкой актуальной клавиатуры по адресу: hardware\keyboard_layout\файл актуальной раскладки необходимо добавить следующий фрагмент, после чего нажать кнопку Сохранить:
...
1. На кассовом сервере по адресу: Магазин – Типы касс нужно выбрать тип кассы и нажать кнопку Настройки:
В конфигурационном файле loya.conf (conf\services\marketing\loya.conf) необходимо указать параметр isClientCardManualEnter = true, после чего сохранить настройки.:
Якорьcert cert
Подарочные сертификаты
cert | |
cert |
...
1. По адресу: Магазин – Типы касс нужно выбрать тип кассы и нажать кнопку Настройки:
2. В появившемся иерархическом древе необходимо создать папку с названием giftcertificate по адресу: services/\giftcertificate и разместить в ней файлы giftcertificate.conf и loya.conf.:
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. Чтобы :
5. В файле giftcertificate.conf (services\giftcertificate\giftcertificate.conf) необходимо закомментировать параметр giftcertificateSku (если он там присутствует) и обязательно указать правильный код локации в параметре locationCode. Код локации для каждого магазина индивидуален; он должен совпадать со значением Код в справочнике точек продаж в LOYA:
Чтобы задать таймаут повторной отправки запроса на регистрацию подарочного сертификата при недоступности сервера, нужно в файле giftcertificate.conf (conf\services\giftcertificate\giftcertificate.conf) указать соответствующее значение N для параметра requestRepeatTimeout, где N – число в секундах.:
6. Для отображения в чеке перечня проданных сертификатов, необходимо заменить файл receiptRebuilder_condensed.js (confapplications\applicationssale\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.:
Кнопка появляется в режиме Продажа:
...
9. Появление кнопки проверки баланса подарочного сертификата также предполагает наличие в разделе ui конфигурационного файла sale.conf (applications\sale\sale.conf) параметра useCertificate = true. : Якорь useCertificate useCertificate
На клавиатурной кассе, вызов функции проверки баланса подарочного осуществляется нажатием специально запрограммированной клавиши. Настройка клавиши осуществляется на кассовом сервере по адресу: Магазин – Кассы, где нужно выбрать необходимую кассу и нажать кнопку Оборудование:
В появившемся иерархическом древе в конфигурационном файле keyboard_layout (hardware/\keyboard_layout/\keyboardLayout.conf) нужно посмотреть, какой тип клавиатуры используется (он должен быть раскомментирован в общем списке):
В конфигурационный файл с раскладкой актуальной клавиатуры по адресу: hardware\keyboard_layout\файл актуальной раскладки необходимо добавить следующий фрагмент, после чего нажать кнопку Сохранить:
...
1. Функция применения промо-кода активируется на кассовом сервере УКМ 5 по адресу: Магазин – Типы касс, где нужно выбрать тип кассы и нажать кнопку Настройки:
В разделе ui конфигурационного файла sale.conf (applications/\sale/\sale.conf) необходимо активировать функцию применения промо-кода, выставив следующее значение параметра:параметра usePromoCode=true.:
Изменения в конфигурационном файле необходимо сохранить.
...
В открывшемся иерархическом древе необходимо в группе keyboard_layout найти конфигурационный файл, содержащий настройки актуально используемой клавиатуры (например, hardware/\keyboard_layout/\stdpcKeyboardLayout.conf). В данный файл нужно добавить следующий фрагмент:
...