Кассовое ПО Artix поддерживает применение дисконтных и бонусных воздействий, применение и печать купонов системы лояльности Manzana Loyalty Online.

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

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

[plugins]
manzanaloyaltyonline = off

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

[ManzanaLoyaltyOnline]
; Настройки плагина системы лояльности ManzanaLoyaltyOnline

; Адрес сервера ManzanaLoyaltyOnline
; Значение по умолчанию http://localhost
;url = "http://localhost"

; Таймаут запроса к серверу ManzanaLoyaltyOnline(в секундах)
; Значение по умолчанию 15
;timeout = 15

; Имя пользователя для авторизации на сервере ManzanaLoyaltyOnline
; Значение по умолчанию ""
;user = ""

; Пароль пользователя для авторизации на сервере ManzanaLoyaltyOnline
; Значение по умолчанию ""
;password = ""

; Внешний идентификатор партнёра CRM
; Значение по умолчанию ""
;organization = ""

; Внешний идентификатор магазина CRM
; Значение по умолчанию ""
;businessUnit = ""

; Внешний идентификатор терминала CRM
; Значение по умолчанию ""
;pos = ""

; Название организации CRM
; Значение по умолчанию ""
;orgName = ""
...
; Список ключей расширенного атрибута для отображения в интерфейсе
; Значение по умолчанию ""
; cardTypeExtendedAttribute = "" 

Для передачи кода магазина и кода кассы необходимо для полей businessUnit и pos задать следующие маски:

businessUnit = "%(document.shopCode[s])"
pos = "%(document.cashCode[s])"

Бонусная программа Manzana Loyalty Online

Для использования системы лояльности Manzana Loyalty Online необходимо:

1. Завести группу карт с типом карты Manzana Loyalty Online (БД Dictionaries таблица Cardgroup  поле cardmode = 23).

2. Активировать модуль системы лояльности Manzana Loyalty Online (см. Конфигурирование модуля Manzana Loyalty Online).

   Для корректной работы модули систем лояльности Manzana и Manzana2019 должны быть отключены.

3. Настроить подключение к серверу системы лояльности Manzana Loyalty Online (см. Конфигурирование модуля Manzana Loyalty Online).
4. Перезапустить кассовую программу.
5. Добавить карту системы лояльности Manzana Loyalty Online в чек.

Продажа

Для получения скидки, для начисления и списания баллов с бонусной карты необходимо добавить карту системы лояльности Manzana Loyalty Online в чек.

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

При закрытии чека может быть напечатана информация для покупателя.

В кассовом ПО Artix реализована возможность передавать в чеке продажи индекс дополнительной цены, который задается параметром indexForMinRetailPrice в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/manzanaloyaltyonline.ini в секции [ManzanaLoyaltyOnline].

[ManzanaLoyaltyOnline]
... 
; Индекс дополнительной цены, которая передается как минимальная розничная цена
; Значение по умолчанию -1
;indexForMinRetailPrice = -1 
...

Информация о карте покупателя

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

В кассовом ПО реализована возможность отображения расширенного атрибута карты в пользовательском интерфейсе. Для этого необходимо задать параметр cardTypeExtendedAttribute в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/manzanaloyaltyonline.ini в секции [ManzanaLoyaltyOnline].

[ManzanaLoyaltyOnline]
...
; Список ключей расширенного атрибута для отображения в интерфейсе
; Значение по умолчанию ""
; cardTypeExtendedAttribute = "" 

Если у карты указан расширенный атрибут, то при выводе информации о карте он будет отображен в поле клиента.

Техническая карта

В кассовом ПО Artix реализована возможность закрытия чеков продажи без добавления в чек карты клиента Manzana Loyalty Online. Для каждого чека продажи на кассе при переходе в подытог добавляется техническая карта с названием Manzana Loyalty Online Technical и автоматически сгенерированным номером. Номер технической карты передается на сервер системы лояльности.

Способ генерации определяется параметрами technicalCardPrefix и technicalCardSuffixLength в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/manzanaloyaltyonline.ini в секции [ManzanaLoyaltyOnline]. Номер технической карты генерируется в формате: <technicalCardPrefix><сгенерированное случайным образом число с количеством знаков, равным technicalCardSuffixLength>.

[ManzanaLoyaltyOnline]
... 
; Префикс номера технической карты
; Значение по умолчанию "375"
;technicalCardPrefix = "375"

; Длина суффикса номера технической карты
; Значение по умолчанию 4
;technicalCardSuffixLength = 4

Возможность задавать название технической карты определяется параметром technicalCardName в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/manzanaloyaltyonline.ini в секции [ManzanaLoyaltyOnline]:

[ManzanaLoyaltyOnline]
...
; Наименование технической карты
; Значение по умолчанию "Manzana Loyalty Online Technical" 
;technicalCardName = "Manzana Loyalty Online Technical" 

Передача признаков позиции

В кассовом ПО Artix реализована передача признаков позиции, для этого в конфигурационный файл /linuxcash/cash/conf/ncash.ini.d/manzanaloyaltyonline.ini необходимо добавить секцию [ManzanaLoyaltyOnline.ExtendedAttributes.<название_признака>] со следующими параметрами:

[ManzanaLoyaltyOnline.ExtendedAttributes.indexPrice]
key = "Индексная цена 10" 
value = "%(indexPrice10.price[d])"
key2 = "Индексная цена 11" 
value2 = "%(indexPrice11.price[d])"

Начисление баллов

Отправка чека на адрес покупателя

Для отправки чека на адрес покупателя необходимо активировать плагин customerAddress в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/customeraddress.ini в секции [plugins]. Подробнее о настройке плагина можно прочитать в разделе "Отправка чека на адрес покупателя".

Если при значении параметров inputAddress и printCheck по умолчанию в карточке клиента указан e-mail и установлен признак отказа от печати бумажного чека, то при закрытии чека на экран будет выведено сообщение "Чек будет отправлен на email покупателя", чек не будет распечатан на ФР.

Списание баллов

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

В кассовом ПО Artix реализована возможность списания баллов с запросом кода подтверждения на сервере системы лояльности Manzana Loyalty Online. Данное поведение определяется параметрами useConfirmation и noConfirmationBonusLimit в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/manzanaloyaltyonline.ini в секции [ManzanaLoyaltyOnline].

Параметр useConfirmation определяет необходимость использования кода подтверждения при списании баллов:

• при значении true код подтверждения будет запрошен при списании баллов,
• при значении false код подтверждения при списании баллов запрошен не будет. Значение по умолчанию.

Параметр noConfirmationBonusLimit определяет максимальное количество бонусных баллов, которые будут списаны без запроса кода подтверждения:

• если количество бонусных баллов > noConfirmationBonusLimit, то на сервер будет отправлен запрос на получение кода подтверждения, после успешного выполнения запроса и ввода корректного кода подтверждения баллы будут списаны. При вводе некорректного кода подтверждения на экран будет выведена ошибка "Неверный код подтверждения", баллы списаны не будут;
• если количество бонусных баллов <= noConfirmationBonusLimit, то баллы будут списаны без подтверждения.

[ManzanaLoyaltyOnline]
...
; Использовать код подтверждения при списании баллов 
; По умолчанию false
;useConfirmation = false

; Максимальное количество бонусных баллов для списания без запроса кода подтверждения
; -1.0 - без ограничения
; По умолчанию -1.0;
;noConfirmationBonusLimit = -1.0

Начисление баллов

Начисление баллов происходит на стороне сервера системы лояльности Manzana Loyalty Online после закрытия чека.

Возврат

В системе лояльности предусмотрена возможность возврата списанных ранее баллов при закрытии чека возврата по чеку продажи.

Аннулирование

В системе лояльности предусмотрена возможность возврата списанных ранее баллов при закрытии чека аннулирования.

Купоны Manzana Loyalty Online

При использовании системы лояльности Manzana Loyalty Online возможно получение скидки по купону. В одном чеке продажи может быть применено несколько купонов.

Добавление купона в чек осуществляется несколькими способами:

• вручную с клавиатуры,
• сканированием штрих-кода,
• по кнопке "Добавить купон" с командой COMMAND_COUPON_ADD. О настройке действий подробнее можно прочитать в разделе "Настройка действий".

Для распознавания номера/штрих-кода купона на кассе должно быть настроено правило разбора по штрих-коду, которое задается в конфигурационном файле /linuxcash/cash/conf/bcode.ini.

В данном примере "santan" является префиксом купонов, на что указывают символы "cccccccccccc".

Печать купонов

При закрытии чека могут быть напечатаны купоны. Купоны печатаются по шаблону manzanaloyaltyonline_coupon.xml, который находится в каталоге /linuxcash/cash/reports/.

В кассовом ПО Artix реализована возможность указания разделителя сообщений для купонов Manzana Loyalty Online. Для этого необходимо настроить параметр couponMessageDelimeter в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/manzanaloyaltyonline.ini в секции [ManzanaLoyaltyOnline]. 

[ManzanaLoyaltyOnline]
...
; Разделитель сообщений для купонов
; Значение по умолчанию "\u2013\u2013" (––)
;couponMessageDelimeter = "\u2013\u2013"
...

Электронные фишки

При использовании системы лояльности Manzana Loyalty Online возможно получение скидки на товары в обмен на электронные фишки. Скидка предоставляется на определенное количество товара в позиции чека. Использование фишек производится в рамках фишечных акций, которые создаются на стороне системы лояльности.

Продажа

Для получения скидок в обмен на фишки необходимо добавить в чек продажи:

• товары, участвующие в фишечной акции,
• карту Manzana Loyalty Online.

Если при переходе в подытог на карте достаточно фишек для получения скидки, то будет выведен диалог "Использовать фишки?":

• при подтверждении будет применена скидка на товары, участвующие в фишечной акции, будут списаны фишки,
• при отмене скидка не будет применена, фишки списаны не будут.

В кассовом ПО Artix реализована возможность указания признака фишечной акции Manzana Loyalty Online. Для этого необходимо настроить параметр stickersActionMarker в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/manzanaloyaltyonline.ini в секции [ManzanaLoyaltyOnline]. 

[ManzanaLoyaltyOnline]
... 
; Признак фишечной акции
; Значение по умолчанию "Interchange"
;stickersActionMarker = "Interchange"
...

Списание фишек

Списание фишек выполняется по инициативе кассира. Потраченные фишки фиксируются в кассовой программе как скидка на чек.

Если фишек недостаточно для применения скидок по всем позициям, то скидка применяется к позициям с наибольшей выгодой для клиента:

Начисление фишек

Начисление фишек происходит на стороне сервера системы лояльности Manzana Loyalty Online после закрытия чека.

Возврат

В системе лояльности предусмотрена возможность возврата списанных ранее фишек при закрытии чека возврата по чеку продажи.

Режимы работы

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

• Добавление карты производится online. Если сервер системы лояльности недоступен, то offline. При добавлении карты в чек на экран будет выведено предупреждение "Нет связи с сервером. Возможные операции с баллами будут выполнены позднее", после закрытия предупреждения карта будет добавлена в чек.

  Релизовано как для карты клиента, так и для технической карты.

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