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

...

Настройка работы с 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:

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

Image Removed

Image Removed

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

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

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

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

Image Removed

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

Image Added

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

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

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

Якорь
regwindow regwindow

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

...

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

Якорь
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, после чего сохранить настройки.:

Image Added

Якорь
cert cert

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

...

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

Image RemovedImage Added

2. В появившемся иерархическом древе необходимо создать папку с названием giftcertificate по адресу: 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. Чтобы :

Image Added

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

Image Added

Image Added

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

Image Added

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

Image Added

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

Image Added

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

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

Image Added

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

Image Added

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

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

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

...

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

Image RemovedImage Added

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

Image Added

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

...

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

...