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

При настройке в личном кабинете системы лояльности необходимо указать branch_id, в качестве которого используется код магазина (/linuxcash/cash/data/cash.reg).

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

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

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

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

[ABMLoyalty]
; Настройки плагина системы лояльности ABMLoyalty
; Адрес сервера ABMLoyalty
; Значение по умолчанию http://127.0.0.1/ 
;serverUrl = "http://127.0.0.1/"
; Таймаут запроса к серверу ABMLoyalty
; Значение по умолчанию 10
;timeout = 10
; Имя пользователя для авторизации на сервере
; Значение по умолчанию ""
;user = ""
; Пароль пользователя для авторизации на сервере
; Значение по умолчанию ""
;password = ""
; СМС-верификация при списании баллов
; Значение по умолчанию false
;smsVerification = false
; Наименование валюты бонусов
; По умолчанию "BON"
;currencyName = "BON"
; Отношение бонусных единиц к денежным
; Первый параметр - бонусы, второй - деньги
; По умолчанию "1:1"
;bonusRatio="1:1"

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

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

Бонусные программы ABMLoyalty

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

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

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

СМС-верификация

При использовании внешней системы лояльности ABMLoyalty есть возможность использовать SMS-верификацию при списании баллов. Для этого параметру smsVerification в конфигурационном файле (см. Конфигурирование модуля) необходимо задать значение true. При активированной настройке, для оплаты баллами программой запрашивается код, система лояльности направляет смс-сообщение с кодом верификации на номер телефона клиента, к которому привязана карта:

• При вводе верного кода происходит списание бонусов с карты.
• При вводе неверного кода на экран кассира выводится сообщение "Неправильный код". После нажатия "ОК" - окно программы останется в подитоге, кассир может еще раз сделать попытку списать баллы, на телефон придет новый смс-код. 

Добавление карты по номеру телефона

При использовании системы лояльности ABMLoyalty есть возможность добавления карты по номеру телефона. Для этого необходимо:

1. Включить способ ввода "Удаленно" для группы карт (БД Dictionaries таблица Cardgroup поле inputmask = 16).
2. Настроить клавишу "Добавить карту" с командой COMMAND_CARD и параметрами:
   • cardNumberType со значением 1.
   • cardMode со значением 12.

При использовании команды на экране кассы откроется окно для ввода номера телефона, по которому будет произведен поиск карт на сервере системы лояльности ABMLoyalty.

Если к номеру телефона привязана:

• одна карта - она автоматически добавляется в чек.
• две и более карт - на экране кассы откроется диалоговое окно для выбора карты. После подтверждения выбора, карта добавится в чек.

Если при запросе к серверу лояльности ABMLoyalty карта клиента не будет найдена, то на экран кассира выведется ошибка. Сервер системы лояльности возвращает следующие ошибки поиска:

• Пользователь не найден - возникает в случае отсутствия указанного номера телефона на сервере системы лояльности ABMLoyalty.
• Нет карт для телефона <номер_телефона>  - возникает в случае, когда карта для номера телефона отсутствует.

Отношение бонусных и денежных единиц

При использовании внешней системы лояльности ABMLoyalty есть возможность задавать отношение бонусных единиц к денежным при списании и начислении баллов. Для этого параметру bonusRatio в конфигурационном файле (см. Конфигурирование модуля) необходимо задать значение true.

При активированной настройке в диалоге оплаты баллами все суммы отображаются в бонусных баллах. После подтверждения списания баллов на экране кассира суммы оплаты баллами и начисляемых баллов отображаются в денежном эквиваленте. При закрытии чека в БД кассы записываются суммы начисленных и списанных бонусов в денежном эквиваленте.