Модуль CardLab предназначен для идентификации покупателей посредством считывания карт клиентов на кассе, выполнения операций по начислению и списанию бонусных баллов с использованием технологий CardLab.
Для использования модуля необходимо установить пакет artix-queue.
Конфигурирование модуля
Активация модуля внешней системы лояльности CardLab определяется параметром cardlab
, который задается в конфигурационном файле /linuxcash/cash/conf/ncash.
ini.d/cardlab.ini
в секции [plugins]
.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
cardlab | строковый |
| Активация модуля системы лояльности CardLab | По умолчанию off |
[plugins] ; Система лояльности CardLab ;casrdlab = off
Настройка плагина системы лояльности CardLab производится в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/cardlab.ini
в секции [CardLab]
.
Наименование | Тип данных | Описание |
---|---|---|
serverUrl | строковый | Адрес сервера, на котором развернута система лояльности CardLab |
login | строковый | Логин для подключения к серверу CardLab |
password | строковый | Пароль для подключения к серверу CardLab |
[CardLab] ; URL сервера ;serverUrl = localhost ; Логин для подключения к серверу ;login = ; Пароль для подключения к серверу ;password =
Принцип работы системы лояльности
Операции по получению информации о карте, начислению, списанию и возврату бонусных баллов, а также отмена текущих транзакций проводятся в режиме online.
При отсутствии связи с сервером начисление бонусных баллов может быть проведено в режиме offline. В этом случае при добавлении карты в чек на экран кассира будет выведено предупреждение "Нет связи с сервером. Доступно только начисление баллов". При попытке оплатить чек бонусными баллами при отсутствии связи на экран кассира выводится предупреждение "На карте нет баллов для оплаты". После закрытия чека бонусные баллы для начисления записываются в БД Queues
в таблицу Message
. После восстановления связи бонусы за покупку начисляются на карту, запись из таблицы удаляется.
При возврате чека начисленные баллы списываются, бонусные баллы которыми была совершена оплата покупки не восстанавливаются. Списание начисленных баллов при возврате выполняется и в режиме online, и в режиме offline.
После успешной операции по начислению бонусных баллов при покупке и списанию при возврате в БД Documents
в таблицу carditem
в поле document
записывается полученный от сервера CardLab номер транзакции, на основании которого осуществляются обратные операции.