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

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

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

• модуль лояльности активируется параметром goldcrown;
• модуль сертификатов активируется параметром goldcrowncertificate.

[plugins]
; Система лояльности Золотая корона
;goldcrown = off
; Система сертификатов Золотая корона
;goldcrowncertificate = off

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

[GoldCrown]

; URL сервера
;serverUrl = https://localhost

; Таймаут соединения в сек(по умолчанию 30)
;timeout=30

; Пароль для сертификата
;certificatePassword = 111

; Путь к сертификату
;certificatePath = /linuxcash/cash/conf/certificate/certificate.pfx

; Параметр инфраструктуры партнера
;location = artix

; Параметр инфраструктуры партнера
;terminal = pos

; Параметр инфраструктуры партнера
;partnerId = 111

Бонусные программы Золотая корона

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

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

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

При начислении и списании бонусных баллов в БД 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.

Подарочные сертификаты Золотая корона

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

1. Создать группу сертификатов Золотая корона.
2. Активировать модуль сертификатов Золотая корона (см.Конфигурирование модуля).
3. Настроить подключение к серверу внешней системы лояльности (см.Конфигурирование модуля).
4. Настроить способ оплаты сертификатом (тип валюты не может быть "наличные").
5. Перезапустить кассовую программу.

Продажа сертификатов

При продаже подарочных сертификатов Золотая корона производится их активация на внешнем сервере лояльности. Для продажи сертификата в утилите администрирования 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).

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

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