Реализованная интеграция с системой Loymax может не поддерживать определенные функции системы или иметь особенности их реализации. Следует уточнять полноту интеграции в соответствии с функциональными требованиями к системе лояльности. |
Начиная с версии 4.6.176 реализована отправка чеков на сервер лояльности Loymax без применения карты системы лояльности. |
Начиная с версии 4.6.197 реализована передача кассовых скидок в систему лояльности Loymax (необходимо настроить "Предоставление внешней/кассовой скидки" на стороне системы лояльности Loymax). |
Начиная с версии 4.6.212 реализована передача купонов в систему лояльности Loymax. |
Кассовое ПО Artix поддерживает применение дисконтных и бонусных воздействий системы лояльности Loymax, использование подарочных сертификатов, а также предоставляет возможность отказаться от печати чека.
Активация модуля системы лояльности Loymax определяется параметром loymax
, который задается в конфигурационном файле /linuxcash/cash/conf/ncash.
ini.d/loymax.ini
в секции [plugins]
.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
loymax | строковый |
| Активация модуля системы лояльности Loymax | По умолчанию off |
[plugins] ; Система лояльности Loymax ;loymax = off |
Настройка плагина системы лояльности Loymax производится в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/loymax.ini
в секции [Loymax]
.
Наименование | Тип данных | Возможные значения | Описание | Примечания | |
---|---|---|---|---|---|
serverUrl | строковый | Адрес сервера системы лояльности Loymax | По умолчанию localhost | ||
timeout | целочисленный | Таймаут запроса к серверу системы лояльности Loymax | По умолчанию 30 секунд | ||
user | строковый | Имя пользователя для авторизации в системе лояльности Loymax | |||
password | строковый | Пароль пользователя для авторизации в системе лояльности Loymax | |||
deviceLogicalId | строковый | Логическое имя устройства в системе лояльности Loymax | |||
ignoreCardIdentificationType | логический |
| Игнорировать способ ввода при поиске карты | При значении
При значении По умолчанию | |
ignoredInputTypes | строковый |
| Список способов ввода, для которых будет применяться игнорирование | Способ ввода:
По умолчанию " | |
sendExtendedOptions | логический |
| Отправлять значение поля tmc.extendetoptions | При значении
По умолчанию | |
typeDelivery | строковый | Тип кассы для передачи в запросах DiscountRequest, CalculateRequest | По умолчанию | ||
couponMask | строковый | Маска купона Loymax | По умолчанию любая последовательность символов " | ||
barcodeMask | строковый | Правило получения штрих-кода из сообщений от сервера для печати в отчетах | По умолчанию " Тип | ||
qrNormalWidth | целочисленный | Определение размера для печати штрих-кода типа type = qr размера size = normal | По умолчанию:
|
[Loymax] ; Настройки плагина системы лояльности Loymax ; Адрес сервера Loymax ; Значение по умолчанию http://localhost. ;serverUrl = "http://localhost" ; Таймаут запроса к серверу Loymax(в секундах) ; Значение по умолчанию 30 ;timeout = 30 ; Имя пользователя для авторизации на сервере Loymax ; Значение по умолчанию "" ;user = "" ; Пароль пользователя для авторизации на сервере Loymax ; Значение по умолчанию "" ;password = "" ; Логическое имя устройства в системе Loymax ; Значение по умолчанию "" ;deviceLogicalId = "" ; Игнорировать способ ввода при поиске карты ; Значение по умолчанию false ;ignoreCardIdentificationType = false ; Список способов ввода, для которых будет применяться игнорирование ; Значение по умолчанию "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 необходимо:
Dictionaries
таблица Cardgroup
поле cardmode = 11
).Для получения скидки, для начисления и списания баллов с бонусной карты необходимо добавить карту системы лояльности Loymax в чек. Обращение к серверу для получения скидки выполняется автоматически при переходе в подытог, для получения суммы доступных баллов обращение к серверу выполняется при оплате баллами. Полученные скидки автоматически применяются к чеку.
Суммирование внутренних и внешних скидок зависит от правил акции в Loymax.
В системе лояльности Loymax отсутствует контроль минимальных цен, поэтому скидка всегда будет предоставляться без их учета. |
В кассовом ПО Artix реализована возможность проверки действительности QR-кода при добавлении карты в чек. Возможность проверки задается параметром checkQrLife
в конфигурационном файле /linuxcash/cash/conf/ncash.
ini.d/loymax.ini
.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
checkQrLife | логический |
| Проверка действительности динамического QR-кода | По умолчанию false |
[Loymax] ... ; Проверка действительности динамического QR-кода ; Значение по умолчанию false checkQrLife = true |
Если срок действия сканируемого QR-кода карты истек, то при значении параметра checkQrLife
:
true
на экран будет выведен диалог "QR-код недействителен. Попробуйте обновить QR-код и отсканируйте его повторно":false
карта будет добавлена в чек без проверки срока действия QR-кода.В кассовом ПО Artix реализована возможность задавать длину значения идентификатора покупателя, при которой QR-код недействителен. Длина задается параметром identifierValueLength
в конфигурационном файле /linuxcash/cash/conf/ncash.
ini.d/loymax.ini
.
Наименование | Тип данных | Описание | Примечания | |
---|---|---|---|---|
identifierValueLength | целочисленный | Длина значения идентификатора покупателя, при которой QR-код недействителен | По умолчанию
|
[Loymax] ... ; Длина значения идентификатора покупателя, при которой QR-код недействителен ; Значение по умолчанию 16 ; identifierValueLength = 16 |
Если QR-код карты сформирован при отсутствии связи и его длина задана в identifierValueLength
, то при добавлении карты в чек на экран будет выведен диалог "QR-код недействителен. Попробуйте обновить QR-код и отсканируйте его повторно". Если настройка checkQrLife
или ignoreCardIdentificationType
отключена, то диалог выведен не будет.
Для отправки чека на адрес покупателя необходимо активировать плагин customerAddress
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/customeraddress.ini
в секции [plugins]
. Подробнее о настройке плагина можно прочитать в разделе "Отправка чека на адрес покупателя".
Поведение на кассе при значении параметров inputAddress
и printCheck
по умолчанию:
COMMAND_CUSTOMER_ADDRESS_ADD
.Списание баллов выполняется по инициативе кассира. Потраченные баллы фиксируются в кассовой программе как скидка на чек. Для списания можно использовать все доступные баллы.
Настройками сервера системы лояльности 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 |
В данном примере цифры "99" являются префиксом купонов, на что указывают символы "cccccccccccc".
В кассовом ПО Artix реализована возможность задавать номера купонов через маску. Маски купонов задаются через параметр couponMask
в конфигурационном файле /linuxcash/cash/conf/ncash.
ini.d/loymax.ini
.
[Loymax] |
Префиксы, указанные в bcode.ini
должны соответствовать префиксам или маскам в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/loymax.ini
.
Если префиксы в конфигурационных файлах не совпадают, то кассовое ПО не распознает вводимый номер как купон Loymax.
При добавлении купона в чек проверяется его валидность. В случае, если купон не валиден, купон не будет добавлен в чек.
Скидка по купону применяется автоматически при переходе в подытог.
Кассовое ПО Artix предоставляет возможность работы с подарочными сертификатами Loymax.
При этом сертификаты других систем лояльностей (внешних и внутренних) должны быть отключены, иначе работа с сертификатами Loymax невозможна. |
Для использования подарочных сертификатов требуется:
Dictionaries
таблице Certificate
. Обязательные для заполнения поля:code
– код группы сертификатов (указать значение loymax
),name
– название (отображается как наименование позиции),tmccode
– код товара при добавлении в чек,deptcode
– отдел,vatcode
– налог,paymentobject
– признак предмета расчета.Для добавления сертификата в чек при продаже или оплате будет выведен диалог ввода номера сертификата. После ввода номера сертификата проверяется разрешен ли ввод с текущего устройства (сканер штрих-кода, ридер карт, вручную). Если данный способ ввода разрешен, то сертификат будет добавлен в чек, иначе – сертификат не будет добавлен в чек.
Возможна продажа только одноразовых подарочных сертификатов (карт), т.е. оплатить чек сертификатом можно только один раз.
Добавление сертификата в чек осуществляется по кнопке "Сертификат" с командой COMMAND_CERTIFICATE
. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
В кассовом ПО Artix реализована возможность ограничения продажи сертификата в чеке с другими товарами, определяется параметром separateCertificateSale
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/loymax.ini
:
true
запрещена продажа сертификатов в чеке с другими товарами:false
разрешена продажа сертификатов в чеке с другими товарами.Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
separateCertificateSale | логический |
| Продажа сертификата только отдельным чеком | По умолчанию false |
[Loymax] ... ; Продажа сертификата только отдельным чеком ; по умолчанию false ; separateCertificateSale = false |
Сторнирование подарочных сертификатов, добавленных в чек продажи, осуществляется аналогично удалению товарных позиций.
Возврат подарочных сертификатов осуществляется только по чеку продажи. Вернуть подарочный сертификат можно только в том случае, если по нему не было списания.
Начиная с версии 4.6.208 реализована возможность частичной оплаты чека подарочным сертификатом. |
Для оплаты чека продажи сертификатом необходимо в утилите администрирования Yuki добавить валюту "Оплата сертификатом Loymax". О настройке валют подробнее можно прочитать в разделе "Валюты".
Оплату чека можно произвести несколькими сертификатами.
В кассовом ПО Artix реализована возможность частичной оплаты чека подарочным сертификатом, определяется параметром allowPartialCertificateSpend
в конфигурационном файле /linuxcash/cash/conf/ncash.ini
в секции [Check]
:
true
частичная оплата чека подарочным сертификатом разрешена,false
частичная оплата чека подарочным сертификатом запрещена, на экран будет выведена ошибка "Допускается только требуемая сумма".Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
allowPartialCertificateSpend | логический |
| Разрешить использовать часть cуммы с сертификата при оплате | По умолчанию false |
[Check] ... ; Разрешить использовать часть cуммы с сертификата при оплате ; По умолчанию false ;allowPartialCertificateSpend = false |
При возврате товара, оплаченного сертификатом, производится возврат наличными.
Просмотр информации о сертификате осуществляется по кнопке "Получить информацию по сертификату" с командой COMMAND_CERTIFICATE_INFO
. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
По нажатию клавиши на экран будет выведен диалог для ввода номера сертификата. После ввода номера сертификата на экран будет выведена информация о сертификате. Информация о сертификате может быть запрошена независимо от того, продан сертификат или нет.
Вне зависимости от наличия карты в чеке продажи при переходе в подытог на сервер лояльности Loymax будет отправлен запрос для получения скидок. Полученные скидки автоматически применяются к чеку.
При закрытии чека продажи информация о данном чеке будет отправлена на сервер системы лояльности Loymax.
В зависимости от доступности сервера системы лояльности Loymax операции могут производиться в режиме online или offline. При этом:
Если сразу после проведения операции начисления offline выполнить возврат по чеку offline, то начисления будут произведены, но возврат не выполнится. |