Реализованная интеграция с системой Manzana2019 может не поддерживать определенные функции системы или иметь особенности их реализации. Следует уточнять полноту интеграции в соответствии с функциональными требованиями к системе лояльности. |
Кассовое ПО Artix поддерживает применение дисконтных и бонусных воздействий, применение купонов системы лояльности Manzana2019, а также идентификацию клиентов и отправку данных об идентификации клиента.
Активация модуля системы лояльности Manzana2019 определяется параметром manzana2019
, который задается в конфигурационном файле /linuxcash/cash/conf/ncash.
ini.d/manzana2019.ini
в секции [plugins]
.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
manzana2019 | строковый |
| Активация модуля системы лояльности Manzana2019 | По умолчанию off |
[plugins] ;manzana2019 = off |
Настройка плагина системы лояльности Manzana2019 производится в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/manzana2019.ini
в секции [Manzana2019]
.
Наименование | Тип данных | Описание | Примечания |
---|---|---|---|
url | строковый | Адрес сервера Manzana2019 | По умолчанию http://localhost |
timeout | целочисленный | Таймаут запроса к серверу системы лояльности Manzana2019 | По умолчанию 15 секунд |
user | строковый | Имя пользователя для авторизации на сервере Manzana2019 | |
password | строковый | Пароль пользователя для авторизации на сервере Manzana2019 | |
organization | строковый | Партнер | |
businessUnit | строковый | Идентификатор магазина в CRM | |
pos | строковый | Идентификатор POS в CRM | |
orgName | строковый | Организация CRM | |
clientIdentificationText | строковый | Текст сообщения для идентификации клиента | |
identificationIp | строковый | IP для отправки данных об идентификации клиента | По умолчанию 127.0.0.1 |
identificationPort | целочисленный | Порт для отправки данных об идентификации клиента | По умолчанию 80 |
[Manzana2019] ; Настройки плагина системы лояльности Manzana2019 ; Адрес сервера Manzana2019 ; Значение по умолчанию http://localhost ;url = "http://localhost" ; Таймаут запроса к серверу Manzana2019(в секундах) ; Значение по умолчанию 15 ;timeout = 15 ; Имя пользователя для авторизации на сервере Manzana2019 ; Значение по умолчанию "" ;user = "" ; Пароль пользователя для авторизации на сервере Manzana2019 ; Значение по умолчанию "" ;password = "" ; Партнер ; Значение по умолчанию "" ;organization = "" ; Идентификатор магазина в CRM ; Значение по умолчанию "" ;businessUnit = "" ; Идентификатор POS в CRM ; Значение по умолчанию "" ;pos = "" ; Организация CRM ; Значение по умолчанию "" ;orgName = "" ; Текст сообщения для идентификации клиента ; Значение по умолчанию "" ;clientIdentificationText = "" ; Ip для отправки данных об идентификации клиента ; Значение по умолчанию "127.0.0.1" ;identificationIp = "127.0.0.1" ; Порт для отправки данных об идентификации клиента ; Значение по умолчанию 80 ;identificationPort = 80 |
Для использования системы лояльности Manzana2019 необходимо:
Dictionaries
таблица Cardgroup
поле cardmode = 19
).Для получения скидки, для начисления и списания баллов с бонусной карты необходимо добавить карту системы лояльности Manzana2019 в чек.
При добавлении карты проверяется ее статус. Если карта клиента имеет статус 3 или 6, то на экран будет выведено предупреждение "Система лояльности: Обслуживание карты невозможно по статусу карты", карта не будет добавлена в чек.
При просмотре информации о карте будут отображены данные клиента, если они указаны в карте покупателя.
Обращение к серверу для получения скидки, для получения суммы доступных баллов выполняется автоматически при переходе в подытог. Полученные скидки автоматически применяются к чеку. На экран будет выведен диалог "Система лояльности" с полем для ввода количества баллов для оплаты. Кассир может ввести сумму бонусов для оплаты, либо отказаться от операции.
При закрытии чека может быть напечатана информация для покупателя.
Если в чек добавлена карта с признаком идентификации клиента, то при переходе в подытог на экран будет выведен диалог для идентификации клиента (ФИО клиента и текст сообщения для идентификации клиента, указываемый в параметре clientIdentificationText
). Для прохождения идентификации покупатель должен предоставить документ, удостоверяющий личность:
Documents
в таблицу Carditem
будет записана следующая информация: extendedoptions = "одобрено"
, cardstatus = 1
;Documents
в таблицу Carditem
будет записана следующая информация: extendedoptions = "отклонено"
, cardstatus = 3
.На адрес, указанный в настройках identificationIp
и identificationPort
, отправляется udp-сообщение:
Списание баллов выполняется по инициативе кассира. Потраченные баллы фиксируются в кассовой программе как скидка на чек. Для списания можно использовать все доступные баллы.
В кассовом ПО Artix реализована возможность списания баллов с запросом кода подтверждения на сервере системы лояльности Manzana2019. Данное поведение определяется параметрами useConfirmation
и noConfirmationBonusLimit
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/manzana2019.ini
в секции [Manzana2019]
.
Параметр useConfirmation
определяет необходимость использования кода подтверждения при списании баллов:
true
код подтверждения будет запрошен при списании баллов,false
код подтверждения при списании баллов запрошен не будет. Значение по умолчанию.Параметр noConfirmationBonusLimit
определяет максимальное количество бонусных баллов, которые будут списаны без запроса кода подтверждения:
noConfirmationBonusLimit
, то на сервер будет отправлен запрос на получение кода подтверждения. Если полученный в ответе от сервера код подтверждения был введен корректно, то баллы будут списаны. При вводе некорректного кода подтверждения на экран будет выведена ошибка «Некорректный проверочный код. Замените карту в чеке или удалите карту из чека», баллы списаны не будут. При отмене ввода кода баллы также не будут списаны;noConfirmationBonusLimit
, то баллы будут списаны без подтверждения.Наименование | Тип данных | Возможные значения | Описание | Примечания | |
---|---|---|---|---|---|
useConfirmation | логический |
| Использовать код подтверждения при списании баллов | По умолчанию | |
noConfirmationBonusLimit | вещественный | Максимальное количество бонусных баллов для списания без запроса кода подтверждения | По умолчанию -
|
[Manzana2019] ... ; Использовать код подтверждения при списании баллов ; Значение по умолчанию false ;useConfirmation = false ; Максимальное количество бонусных баллов для списания без запроса кода подтверждения ; Если значение настройки меньше нуля, то без ограничения ; Значение по умолчанию -1.0 ;noConfirmationBonusLimit = -1.0 |
Начисление баллов происходит на стороне сервера системы лояльности Manzana2019 после закрытия чека.
В системе лояльности предусмотрена возможность возврата списанных ранее баллов. Возврат осуществляется при закрытии чека возврата по чеку продажи, в котором была оплата бонусными баллами.
Также реализована возможность возврата списанных ранее баллов на другой кассе.
При использовании системы лояльности Manzana2019 возможно получение скидки по купону. В одном чеке продажи может быть применено несколько купонов.
Для добавления купона в чек необходимо:
COMMAND_COUPON_ADD
. О настройке действий подробнее можно прочитать в разделе "Настройка действий".Купоны не будут отображаться в документе. |
Скидка по купону применяется автоматически при переходе в подытог:
В зависимости от доступности сервера системы лояльности Manzana2019 операции могут производиться в режиме online или offline. При этом: