...

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

...

Кассовое ПО Artix поддерживает применение дисконтных и бонусных воздействий системы лояльности Loymax, использование подарочных сертификатов, а также предоставляет возможность отказаться от печати чека.

Anchor
Конфиг Loymax Конфиг Loymax

Конфигурирование модуля Loymax

Активация модуля системы лояльности Loymax определяется параметром loymax, который задается в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/loymax.ini в секции [plugins].

[plugins]
; Система лояльности Loymax
;loymax = off

Настройка плагина системы лояльности Loymax производится в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/loymax.ini в секции [Loymax].

<Params>*=e*

<Params><Param Name="DiscountCode" Value="3" Type="string" /></Params>

[Loymax]
; Настройки плагина системы лояльности Loymax
; Адрес сервера Loymax
; Значение по умолчанию http://localhost.
;serverUrl = "http://localhost"
; Таймаут запроса к серверу Loymax(в секундах)
; Значение по умолчанию 30
;timeout = 30
; Имя пользователя для авторизации на сервере Loymax
; Значение по умолчанию ""
;user = ""
; Пароль пользователя для авторизации на сервере Loymax
; Значение по умолчанию ""
;password = ""
; Логическое имя устройства в системе Loymax
; Значение по умолчанию ""
;deviceLogicalId = ""
; Игнорировать способ ввода при поиске карты
; Значение по умолчанию false
;ignoreCardIdentificationType = false

В зависимости от доступности сервера системы лояльности Loymax операции могут проводиться в режиме online или offline. При этом:

• Запрос информации о карте, запрос скидок и списание бонусных баллов всегда проводится online.
• Возврат начисленных/списанных бонусов всегда производится offline через очередь artix-queue.
• Операции по начислению и отмене начисления производятся online, если бонусный сервер системы лояльности не доступен, то в режиме offline.

; Список способов ввода, для которых будет применяться игнорирование
; Значение по умолчанию "Scanner, Manual, MSR"
;ignoredInputTypes = "Scanner, Manual, MSR"
; Отправлять значение примененной к позиции дополнительной опции товара или значение поля tmc.extendetoptions
; Значение по умолчанию false
;sendExtendedOptions = false
; Тип кассы для передачи в запросах DiscountRequest, CalculateRequest
; По умолчанию offlinePurchase
;typeDelivery = offlinePurchase
; Маска купона Loymax
; По умолчанию любая последовательность символов ".*"
;couponMask = ".*"
; Правило получения штрих-кода из сообщений от сервера для печати в отчетах
; По умолчанию "{(?<type>.*):(?<barcode>.*);Size:(?<size>.*)}"
; Тип type и размер size используются для печати штрих-кода barcode
;barcodeMask = "{(?<type>.*):(?<barcode>.*);Size:(?<size>.*)}"
; Пример определения размера для печати штрих-кода типа type = qr размера size = normal
;qrNormalWidth = 0
;qrNormalHeight = 0

Бонусная программа Loymax

 Для использования системы лояльности Loymax необходимо:

1. Завести группу бонусных карты карт с типом карты Loymax (БД Dictionaries таблица Cardgroup поле cardmode = 11).
2. Активировать модуль системы лояльности Loymax (см.Конфигурирование модуля Loymax).
3. Настроить подключение к серверу системы лояльности (см.Конфигурирование модуля Loymax).
4. Перезапустить кассовую программу.
5. Применить бонусную карту в чеке.

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

...

Продажа

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

Суммирование внутренних и внешних скидок зависит от правил акции в Loymax.

Проверка действительности QR-кода

В кассовом ПО Artix реализована возможность проверки действительности QR-кода при добавлении карты в чек. Возможность проверки задается параметром checkQrLife в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/loymax.ini.

[Loymax]
...

; Проверка действительности динамического QR-кода
; Значение по умолчанию false
checkQrLife = true

Если срок действия сканируемого QR-кода карты истек, то при значении параметра checkQrLife:

• true на экран будет выведен диалог "QR-код недействителен. Попробуйте обновить QR-код и отсканируйте его повторно":
  • при выборе "Отсканировать" карта не будет добавлена в чек, можно отсканировать QR-код повторно,
  • при выборе "Продолжить" карта будет добавлена в чек.
• false карта будет добавлена в чек без проверки срока действия QR-кода.

В кассовом ПО Artix реализована возможность задавать длину значения идентификатора покупателя, при которой QR-код недействителен. Длина задается параметром identifierValueLength в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/loymax.ini.

[Loymax]
...

; Длина значения идентификатора покупателя, при которой QR-код недействителен
; Значение по умолчанию 16
; identifierValueLength = 16

Если QR-код карты сформирован при отсутствии связи и его длина задана в identifierValueLength, то при добавлении карты в чек на экран будет выведен диалог "QR-код недействителен. Попробуйте обновить QR-код и отсканируйте его повторно". Если настройка checkQrLife или ignoreCardIdentificationType отключена, то диалог выведен не будет.

Обработка зашифрованных номеров карт Loymax

В кассовом ПО Artix реализована возможность при получении данных из динамического QR-кода использовать декодер для обработки зашифрованных значений номеров карт Loymax, а также даты и времени. Данное поведение регулируется параметрами enable, dateTimeFormat, timeDeltaLimit, removeSymbols в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/loymax.ini в секции [Loymax.Decoder1].

Возможность использования декодера определяется параметром enable:

• при значении true номер карты будет расшифрован, если карта с расшифрованным номером найдена, то она добавляется в чек,
• при значении false будет осуществлен поиск карты для добавления в чек по незашифрованному номеру.

Для корректной обработки необходимо задать параметры dateTimeFormat и removeSymbols в соответствии со значениями, использованными при генерации зашифрованных номеров на стороне системы лояльности Loymax.

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

[Loymax.Decoder1]
; Использовать Decoder1 для обработки номеров карт Loymax
; Значение по умолчанию false
;enable = false

; Формат даты и времени в номере формата Decoder1
; Значение по умолчанию "yyyyMMddhhmmss"
;dateTimeFormat = "yyyyMMddhhmmss"

; Допустимая величина отклонения времени из номера в формате Decoder1 от текущего времени (в минутах)
; Значение по умолчанию 60
;timeDeltaLimit = 60

; Список позиций символов для удаления перед декодированием номера
; Значение по умолчанию "2, 7, 16, 24, 29"
;removeSymbols = "2, 7, 16, 24, 29"

Отправка чека на адрес покупателя

Для отправки чека на адрес покупателя необходимо активировать плагин customerAddress в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/customeraddress.ini в секции [plugins]. Подробнее о настройке плагина можно прочитать в разделе "Отправка чека на адрес покупателя".

Поведение на кассе при значении параметров inputAddress и printCheck по умолчанию:

• Если в карточке клиента в системе лояльности Loymax указан e-mail и установлен признак отказа от печати бумажного чека, то при закрытии чека на экран будет выведено сообщение "Чек будет отправлен на email покупателя", чек не будет распечатан на ФР.
• Если в карточке клиента в системе лояльности Loymax указан e-mail, но не установлен признак отказа от печати бумажного чека, то для отправки чека необходимо подтвердить e-mail при добавлении адреса покупателя в чек по клавише "Добавить адрес покупателя" с командой COMMAND_CUSTOMER_ADDRESS_ADD.

Списание баллов

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

Настройками сервера системы лояльности Loymax может быть предусмотрен запрос кода подтверждения при оплате чека бонусными баллами, ПИН-код отправляется на номер телефона покупателя.

Начисление баллов

Начисление баллов происходит на стороне сервера системы лояльности Loymax после закрытия чека.

Возврат

В системе лояльности предусмотрена возможность возврата списанных ранее баллов.

Купоны Loymax

Кассовое ПО Artix предоставляет возможность работы с купонами Loymax.

Выдача купонов

Акции на выдачу купона создаются и редактируются на сервере системы лояльности Loymax. При закрытии чека печатается купон со штрих-кодом, полученным от сервера. Купон печатается по шаблону loymax.xml, который находится в каталоге /linuxcash/cash/reports/. Правило получения штрих-кода от сервера и размер его печати задается в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/loymax.ini.

Применение купонов

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

Добавление купона в чек осуществляется несколькими способами:

• вручную с клавиатуры,
• сканированием штрих-кода,
• по кнопке "Добавить купон" с командой COMMAND_COUPON_ADD. О настройке действий подробнее можно прочитать в разделе "Настройка действий".

Для распознавания номера/штрих-кода купона на кассе должно быть настроено правило разбора по штрих-коду, которое задается в конфигурационном файле /linuxcash/cash/conf/bcode.ini.

В данном примере цифры "99" являются префиксом купонов, на что указывают символы "cccccccccccc".

В кассовом ПО Artix реализована возможность задавать номера купонов через маску. Маски купонов задаются через параметр couponMask в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/loymax.ini.

[Loymax]
...
; Маска купона Loymax
; По умолчанию любая последовательность символов ".*" 
couponMask = ".*" 

Префиксы, указанные в bcode.ini должны соответствовать префиксам или маскам в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/loymax.ini.

Если префиксы в конфигурационных файлах не совпадают, то кассовое ПО не распознает вводимый номер как купон Loymax.

При добавлении купона в чек проверяется его валидность. В случае, если купон не валиден, купон не будет добавлен в чек.

Скидка по купону применяется автоматически при переходе в подытог.

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

Кассовое ПО Artix предоставляет возможность работы с подарочными сертификатами Loymax.

Для использования подарочных сертификатов требуется:

1. Активировать модуль системы лояльности Loymax (см.Конфигурирование модуля Loymax).
2. Настроить  подключение к серверу системы лояльности (см.Конфигурирование модуля Loymax).
3. Заполнить справочники сертификатов в БД Dictionaries таблице Certificate. Обязательные для заполнения поля:
   • code – код группы сертификатов (указать значение loymax),
   • name – название (отображается как наименование позиции),
   • tmccode – код товара при добавлении в чек,
   • deptcode – отдел,
   • vatcode – налог,
   • paymentobject – признак предмета расчета.

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

Продажа подарочных сертификатов

Возможна продажа только одноразовых подарочных сертификатов (карт), т.е. оплатить чек сертификатом можно только один раз.

Добавление сертификата в чек осуществляется по кнопке "Сертификат" с командой COMMAND_CERTIFICATE. О настройке действий подробнее можно прочитать в разделе "Настройка действий".

Продажа сертификата только отдельным чеком

В кассовом ПО Artix реализована возможность ограничения продажи сертификата в чеке с другими товарами, определяется параметром separateCertificateSale в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/loymax.ini:

• при значении true запрещена продажа сертификатов в чеке с другими товарами:
  • при попытке добавить сертификат в чек, содержащий товары, на экран будет выведено сообщение "Продажа сертификата разрешена только отдельным чеком",
  • при попытке добавить товары в чек, содержащий сертификат, на экран будет выведено сообщение "Запрещено добавление товаров в чек с сертификатом".
• при значении false разрешена продажа сертификатов в чеке с другими товарами.

[Loymax]
...
; Продажа сертификата только отдельным чеком
; по умолчанию false
; separateCertificateSale = false

Сторнирование подарочных сертификатов

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

Возврат подарочных сертификатов

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

Оплата подарочным сертификатом

Для оплаты чека продажи сертификатом необходимо в утилите администрирования Yuki добавить валюту "Оплата сертификатом Loymax". О настройке валют подробнее можно прочитать в разделе "Валюты".

Оплату чека можно произвести несколькими сертификатами.

Частичная оплата чека подарочным сертификатом

В кассовом ПО Artix реализована возможность частичной оплаты чека подарочным сертификатом, определяется параметром allowPartialCertificateSpend в конфигурационном файле /linuxcash/cash/conf/ncash.ini в секции [Check]:

• при значении true частичная оплата чека подарочным сертификатом разрешена,
• при значении false частичная оплата чека подарочным сертификатом запрещена, на экран будет выведена ошибка "Допускается только требуемая сумма".

[Check]
...
; Разрешить использовать часть cуммы с сертификата при оплате
; По умолчанию false
;allowPartialCertificateSpend = false

Возврат товара, оплаченного сертификатом

При возврате товара, оплаченного сертификатом, производится возврат наличными.

Просмотр информации о сертификате

Просмотр информации о сертификате осуществляется по кнопке "Получить информацию по сертификату" с командой COMMAND_CERTIFICATE_INFO. О настройке действий подробнее можно прочитать в разделе "Настройка действий".

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

Запрос скидок в чеке продажи

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

Отправка чеков

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

Режимы работы

В зависимости от доступности сервера системы лояльности Loymax операции могут производиться в режиме online или offline. При этом:

• запрос информации о карте, запрос скидок и списание бонусных баллов всегда производятся online,
• возврат начисленных/списанных бонусов и возврат сертификата всегда производятся offline через очередь Artix-Queue,
• операции по начислению и отмене начисления производятся online. Если сервер системы лояльности недоступен, то в режиме offline через очередь Artix-Queue.