Модуль Золотая корона предназначен для идентификации покупателей посредством считывания карт клиентов на кассе, выполнения операций по начислению и списанию бонусных баллов с использованием технологий внешней системы лояльности Золотая корона, а также использования подарочных сертификатов.
Конфигурирование модуля
Активация модулей внешней системы лояльности Золотая корона задается в конфигурационном файле /linuxcash/cash/conf/ncash.
ini.d/goldcrown.ini
в секции [plugins]
:
- модуль лояльности активируется параметром
goldcrown
; - модуль сертификатов активируется параметром
goldcrowncertificate
.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
goldcrown | строковый |
| Активация модуля лояльности Золотая корона | По умолчанию off |
goldcrowncertificate | строковый |
| Активация модуля сертификатов Золотая корона | По умолчанию off |
[plugins] ; Система лояльности Золотая корона ;goldcrown = off ; Система сертификатов Золотая корона ;goldcrowncertificate = off
Настройка модуля системы лояльности Золотая корона производится в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/goldcrown.ini
в секции [GoldCrown]
.
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
serverUrl | строковый | URL сервера | |
timeout | целочисленный | Таймаут соединения в секундах | По умолчанию 30 секунд |
certificatePassword | строковый | Пароль для сертификата | |
certificatePath | строковый | Путь к сертификату | |
location | строковый | Параметр внешнего сервиса Золотая корона | |
terminal | строковый | Параметр внешнего сервиса Золотая корона | |
partnerId | строковый | Параметр внешнего сервиса Золотая корона |
[GoldCrown] ; URL сервера ;serverUrl = https://localhost ; Таймаут соединения в сек(по умолчанию 30) ;timeout=30 ; Пароль для сертификата ;certificatePassword = 111 ; Путь к сертификату ;certificatePath = /linuxcash/cash/conf/certificate/certificate.pfx ; Параметр инфраструктуры партнера ;location = artix ; Параметр инфраструктуры партнера ;terminal = pos ; Параметр инфраструктуры партнера ;partnerId = 111
Бонусные программы Золотая корона
Для использования системы внешней лояльности Золотая корона необходимо:
- Завести группу бонусных карт с типом карты Золотая корона (БД
Dictionaries
таблицаCardgroup
полеcardmode = 9
). - Активировать модуль лояльности Золотая корона (см.Конфигурирование модуля).
- Настроить подключение к серверу внешней системы лояльности (см.Конфигурирование модуля).
- Перезапустить кассовую программу.
- Применить бонусную карту в чеке.
При добавлении карты в чек кассовая программа обращается к внешней системе лояльности, передает данные документа продажи, получает данные по начислению и списанию бонусов и применяет их в чеке.
При начислении и списании бонусных баллов в БД Documents
таблицу carditem
поле
operationinfo
записываются данные об операциях с бонусами.
{ "earn" : { "995943747699" : { "date" : "20180424140832", "id" : "20180424140832589265238", "source" : 2 } }, "location" : "artix", "partnerId" : "334017", "spend" : { "995943747699" : { "date" : "20180424140824", "id" : "20180424140824936145377", "source" : 2 } }, "terminal" : "pos1" }
В зависимости от доступности сервера внешней системы лояльности Золотая корона операции могут проводиться в режиме online или offline. При этом:
- Запрос информации о карте, запрос скидок и списание бонусных баллов всегда проводится online.
- Отмена и возврат начисленных/списанных бонусов всегда производится offline через очередь
artix-queue
. - Операции по начислению производятся online, если бонусный сервер внешней лояльности не доступен, то в режиме offline.
Подарочные сертификаты Золотая корона
Для использования подарочных сертификатов Золотая корона необходимо:
- Создать группу сертификатов Золотая корона.
- Активировать модуль сертификатов Золотая корона (см.Конфигурирование модуля).
- Настроить подключение к серверу внешней системы лояльности (см.Конфигурирование модуля).
- Настроить способ оплаты сертификатом (тип валюты не может быть "наличные").
- Перезапустить кассовую программу.
Продажа сертификатов
При продаже подарочных сертификатов Золотая корона производится их активация на внешнем сервере лояльности. Для продажи сертификата в утилите администрирования Yuki необходимо на клавишу настроить действие "Сертификат" с командой COMMAND_CERTIFICATE
. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
Оплата сертификатом
Для оплаты покупок в Artix может быть использовано 2 вида подарочных сертификатов Золотая корона:
сертификаты с фиксированным номиналом, для которых при продаже уже определена сумма. Для группы сертификатов необходимо указать маску номеров "^777[0-9]{16}(=[0-9]{17})?$".
- сертификаты со свободным номиналом, для которых сумма сертификата указывается при продаже. Для группы сертификатов необходимо указать маску номеров "^776[0-9]{16}(=[0-9]{17})?$".
При оплате чека сертификатом необходимо выбрать способ оплаты сертификатом и указать номер сертификата, после чего изъять примененный сертификат у покупателя.
В зависимости от доступности сервера внешней системы лояльности Золотая корона операции с подарочными сертификатами могут проводиться в режиме online или offline. При этом:
- Активация подарочного сертификата (начисление) и оплата сертификатом всегда проводятся online.
- Отмена активации и отмена оплаты сертификатом проводятся offline (через artix-queue).
Возврат товара, оплаченного сертификатом
При возврате товара, оплаченного сертификатом, сумма оплаты возвращается на сертификат, выдаваемый взамен потраченному. Для активации нового сертификата в чек возврата необходимо добавить сертификат со свободным номиналом. Сертификат будет активирован на сумму возвращаемого товара.