Начиная с версии 4.6.237 реализован механизм передачи признаков позиции. Начиная с версии 4.6.238 реализована возможность отображения расширенного атрибута карты в пользовательском интерфейсе. |
Реализованная интеграция с системой Manzana Loyalty Online может не поддерживать определенные функции системы или иметь особенности их реализации. Следует уточнять полноту интеграции в соответствии с функциональными требованиями к системе лояльности. |
Кассовое ПО Artix поддерживает применение дисконтных и бонусных воздействий, применение и печать купонов системы лояльности Manzana Loyalty Online.
Активация модуля ManzanaLoyaltyOnline определяется параметром manzanaloyaltyonline
, который задается в конфигурационном файле /linuxcash/cash/conf/ncash.
ini.d/manzanaloyaltyonline.ini
в секции [plugins]
.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
manzanaloyaltyonline | строковый |
| Активация модуля системы лояльности ManzanaLoyaltyOnline | По умолчанию off |
[plugins] manzanaloyaltyonline = off |
Настройка плагина системы лояльности Manzana Loyalty Online производится в конфигурационном файле /linuxcash/cash/conf/ncash.
ini.d/manzanaloyaltyonline.ini
в секции [ManzanaLoyaltyOnline]
.
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
url | строковый | Адрес сервера ManzanaLoyaltyOnline | Значение по умолчанию
http://localhost
|
timeout | целочисленный | Таймаут запроса к серверу ManzanaLoyaltyOnline (в секундах) | Значение по умолчанию 15 секунд
|
user | строковый | Имя пользователя для авторизации на сервере ManzanaLoyaltyOnline | |
password | строковый | Пароль пользователя для авторизации на сервере ManzanaLoyaltyOnline | |
organization | строковый | Внешний идентификатор партнера CRM | |
businessUnit | строковый | Внешний идентификатор магазина CRM | |
pos | строковый | Внешний идентификатор терминала CRM | |
orgName | строковый | Название организации CRM |
[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 необходимо:
Dictionaries
таблица Cardgroup
поле cardmode = 23
).Активировать модуль системы лояльности Manzana Loyalty Online (см. Конфигурирование модуля Manzana Loyalty Online).
Для корректной работы модули систем лояльности Manzana и Manzana2019 должны быть отключены. |
Для получения скидки, для начисления и списания баллов с бонусной карты необходимо добавить карту системы лояльности Manzana Loyalty Online в чек.
Обращение к серверу для получения скидки и суммы доступных баллов выполняется автоматически при переходе в подытог. Полученные скидки автоматически применяются к чеку.
При закрытии чека может быть напечатана информация для покупателя.
В кассовом ПО Artix реализована возможность передавать в чеке продажи индекс дополнительной цены, который задается параметром indexForMinRetailPrice
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/manzanaloyaltyonline.ini
в секции [ManzanaLoyaltyOnline]
.
|
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
indexForMinRetailPrice | числовой | Индекс дополнительной цены, которая передается как минимальная розничная цена | По умолчанию |
[ManzanaLoyaltyOnline] ... ; Индекс дополнительной цены, которая передается как минимальная розничная цена ; Значение по умолчанию -1 ;indexForMinRetailPrice = -1 ... |
При просмотре информации о карте будут отображены данные клиента, если они указаны в карте покупателя.
В кассовом ПО реализована возможность отображения расширенного атрибута карты в пользовательском интерфейсе. Для этого необходимо задать параметр cardTypeExtendedAttribute
в конфигурационном файле /linuxcash/cash/conf/ncash.
ini.d/manzanaloyaltyonline.ini
в секции [ManzanaLoyaltyOnline]
.
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
cardTypeExtendedAttribute | строковый | Список ключей расширенного атрибута для отображения в интерфейсе | Ключи в списке необходимо указать через запятую |
[ManzanaLoyaltyOnline] ... ; Список ключей расширенного атрибута для отображения в интерфейсе ; Значение по умолчанию "" ; cardTypeExtendedAttribute = "" |
Если у карты указан расширенный атрибут, то при выводе информации о карте он будет отображен в поле клиента.
В кассовом ПО Artix реализована возможность при просмотре информации отображать тип карты в поле "Клиент". Для этого необходимо в настройках плагина переводов заменить текст "Клиент" на "Тип карты" в режиме формирования, в подытоге, в режиме закрытого документа. |
В кассовом ПО Artix реализована возможность закрытия чеков продажи без добавления в чек карты клиента Manzana Loyalty Online. Для каждого чека продажи на кассе при переходе в подытог добавляется техническая карта с названием Manzana Loyalty Online Technical и автоматически сгенерированным номером. Номер технической карты передается на сервер системы лояльности.
Списание баллов с технической карты невозможно. |
Способ генерации определяется параметрами technicalCardPrefix
и technicalCardSuffixLength
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/manzanaloyaltyonline.ini
в секции [ManzanaLoyaltyOnline]
. Номер технической карты генерируется в формате: <technicalCardPrefix><сгенерированное случайным образом число с количеством знаков, равным technicalCardSuffixLength>
.
Наименование | Тип данных | Описание | Примечания | |
---|---|---|---|---|
technicalCardPrefix | строковый | Префикс номера технической карты | По умолчанию " | |
technicalCardSuffixLength | целочисленный | Длина суффикса номера технической карты | По умолчанию
|
[ManzanaLoyaltyOnline] ... ; Префикс номера технической карты ; Значение по умолчанию "375" ;technicalCardPrefix = "375" ; Длина суффикса номера технической карты ; Значение по умолчанию 4 ;technicalCardSuffixLength = 4 |
Возможность задавать название технической карты определяется параметром technicalCardName
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/manzanaloyaltyonline.ini
в секции [ManzanaLoyaltyOnline]
:
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
technicalCardName | строковый | Наименование технической карты | По умолчанию "Manzana Loyalty Online Technical " |
[ManzanaLoyaltyOnline] ... ; Наименование технической карты ; Значение по умолчанию "Manzana Loyalty Online Technical" ;technicalCardName = "Manzana Loyalty Online Technical" |
В кассовом ПО Artix реализована передача признаков позиции, для этого в конфигурационный файл /linuxcash/cash/conf/ncash.ini.d/manzanaloyaltyonline.ini
необходимо добавить секцию [ManzanaLoyaltyOnline.ExtendedAttributes.<название_признака>]
со следующими параметрами:
Наименование | Тип данных | Описание |
---|---|---|
key | строковый | Название передаваемого признака позиции |
value | строковый | Значение признака, задаваемое макроподстановкой |
[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
, то баллы будут списаны без подтверждения.Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
useConfirmation | логический |
| Использовать код подтверждения при списании баллов | По умолчанию |
noConfirmationBonusLimit | вещественный | Максимальное количество бонусных баллов для списания без запроса кода подтверждения | По умолчанию - |
[ManzanaLoyaltyOnline] ... ; Использовать код подтверждения при списании баллов ; По умолчанию false ;useConfirmation = false ; Максимальное количество бонусных баллов для списания без запроса кода подтверждения ; -1.0 - без ограничения ; По умолчанию -1.0; ;noConfirmationBonusLimit = -1.0 |
Начисление баллов происходит на стороне сервера системы лояльности Manzana Loyalty Online после закрытия чека.
В системе лояльности предусмотрена возможность возврата списанных ранее баллов при закрытии чека возврата по чеку продажи.
В системе лояльности предусмотрена возможность возврата списанных ранее баллов при закрытии чека аннулирования.
Если при отправке запроса на сервер системы лояльности во время закрытия чека возврата по чеку продажи или чека аннулирования возникнет ошибка, то чек закроется, но возврат списанных баллов не будет произведен. |
При использовании системы лояльности Manzana Loyalty Online возможно получение скидки по купону. В одном чеке продажи может быть применено несколько купонов.
Добавление купона в чек осуществляется несколькими способами:
COMMAND_COUPON_ADD
. О настройке действий подробнее можно прочитать в разделе "Настройка действий".Для распознавания номера/штрих-кода купона на кассе должно быть настроено правило разбора по штрих-коду, которое задается в конфигурационном файле /linuxcash/cash/conf/bcode.ini
.
santan*=cccccccccccc |
В данном примере "santan" является префиксом купонов, на что указывают символы "cccccccccccc".
При закрытии чека могут быть напечатаны купоны. Купоны печатаются по шаблону manzanaloyaltyonline_coupon.xml
, который находится в каталоге
/linuxcash/cash/reports/
.
В кассовом ПО Artix реализована возможность указания разделителя сообщений для купонов Manzana Loyalty Online. Для этого необходимо настроить параметр couponMessageDelimeter
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/manzanaloyaltyonline.ini
в секции [ManzanaLoyaltyOnline]
.
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
couponMessageDelimeter | строковый | Разделитель сообщений для купонов | По умолчанию |
[ManzanaLoyaltyOnline] ... ; Разделитель сообщений для купонов ; Значение по умолчанию "\u2013\u2013" (––) ;couponMessageDelimeter = "\u2013\u2013" ... |
При использовании системы лояльности Manzana Loyalty Online возможно получение скидки на товары в обмен на электронные фишки. Скидка предоставляется на определенное количество товара в позиции чека. Использование фишек производится в рамках фишечных акций, которые создаются на стороне системы лояльности.
Для получения скидок в обмен на фишки необходимо добавить в чек продажи:
Если при переходе в подытог на карте достаточно фишек для получения скидки, то будет выведен диалог "Использовать фишки?":
В кассовом ПО Artix реализована возможность указания признака фишечной акции Manzana Loyalty Online. Для этого необходимо настроить параметр stickersActionMarker
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/manzanaloyaltyonline.ini
в секции [ManzanaLoyaltyOnline]
.
Наименование | Тип данных | Описание | Примечания | |
---|---|---|---|---|
stickersActionMarker | строковый | Признак фишечной акции | По умолчанию " Значение параметра задается в соответствии с настройками сервера системы лояльности Manzana Loyalty Online
|
[ManzanaLoyaltyOnline] ... ; Признак фишечной акции ; Значение по умолчанию "Interchange" ;stickersActionMarker = "Interchange" ... |
Списание фишек выполняется по инициативе кассира. Потраченные фишки фиксируются в кассовой программе как скидка на чек.
Если фишек недостаточно для применения скидок по всем позициям, то скидка применяется к позициям с наибольшей выгодой для клиента:
Пример 1: У клиента 10 фишек. Товар А – 7 фишек = скидка 7 рублей Скидка предоставляется на товары А и С. Пример 2: У клиента 9 фишек. Товар А – 6 фишек = скидка 5 рублей Скидка предоставляется на товары В и С. |
Начисление фишек происходит на стороне сервера системы лояльности Manzana Loyalty Online после закрытия чека.
В системе лояльности предусмотрена возможность возврата списанных ранее фишек при закрытии чека возврата по чеку продажи.
В зависимости от доступности сервера системы лояльности операции могут производиться в режиме online или offline. При этом:
Добавление карты производится online. Если сервер системы лояльности недоступен, то offline. При добавлении карты в чек на экран будет выведено предупреждение "Нет связи с сервером. Возможные операции с баллами будут выполнены позднее", после закрытия предупреждения карта будет добавлена в чек.
Релизовано как для карты клиента, так и для технической карты. |