...

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

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

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

[plugins]
;manzana2019 = off

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

...

[plugins]
;manzana2019 = off

[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 операции могут проводиться в режиме online или offline. При этом:

• добавление карты производится:
  
  • online, если сервер системы лояльности доступен;
  • offline, если сервер системы лояльности не доступен. При добавлении карты в чек на экран будет выведено предупреждение "Нет связи с сервером. Баллы будут начислены позднее", после закрытия предупреждения карта будет добавлена в чек. Списание бонусных баллов невозможно. При попытке оплатить чек бонусными баллами на экран будет выведено предупреждение "На карте нет баллов для оплаты". Операции по начислению будут произведены через очередь artix-queue;
• применение скидок и списание бонусных баллов всегда производятся online;
• операции по начислению и отмене начисления производятся:
  • online, если сервер системы лояльности доступен;
  • offline через очередь artix-queue, если сервер системы лояльности не доступен.

...

Бонусная программа Manzana2019

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

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

...

Продажа

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

При добавлении карты проверяется ее статус. Если карта клиента имеет статус 3 или 6 (БД Documents таблица Carditem), то при добавлении такой карты на экран будет выведено предупреждение "Система лояльности: Обслуживание карты невозможно по статусу карты", карта не будет добавлена в чек.

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

При переходе в подитог отправляется запрос на получение информации о дисконте, бонусных баллах для списания/начисления, на Обращение к серверу для получения скидки, для получения суммы доступных баллов выполняется автоматически при переходе в подытог. Полученные скидки автоматически применяются к чеку. На экран будет выведен диалог "Система лояльности" с полем для ввода количества баллов для оплаты. При отказе от операции списания баллов повторно вызвать диалог "Система лояльности" можно по нажатию клавиши "Оплатить бонусами".Полученный от сервера системы лояльности дисконт будет применен к товарным позициям в чекеКассир может ввести сумму бонусов для оплаты, либо отказаться от операции.

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

Идентификация клиента

Если в чек добавлена карта с признаком идентификации клиента, то при переходе в подитог подытог на экран будет выведен диалог с идентификацией для идентификации клиента (ФИО клиента и текст сообщения для идентификации клиента, указываемый в параметре clientIdentificationText). Для прохождения идентификации покупатель должен предоставить документ, удостоверяющий личность:

• если идентификация пройдена, то осуществляется переход в подитог подытог для получения скидки и списания баллов, в БД Documents в таблицу Carditem будет записана следующая информация: extendedoptions = "одобрено", cardstatus  cardstatus = 1;
• если идентификация не пройдена, то карта удаляется из чека, в БД Documents в таблицу Carditem будет записана следующая информация: extendedoptions = "отклонено", cardstatus  cardstatus = 3.

При добавлении карты с признаком идентификации клиента в чек на На адрес, указанный в настройках настройках identificationIp и identificationPort, отправляется udp-сообщение:

• с данными чека и

...

• карты при добавлении карты с признаком идентификации клиента в чек,
• с результатом идентификации клиента при подтверждении или отклонении карты

...

• .

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

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

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

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

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

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

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

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

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

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

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

...

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

...

1. Добавить в чек карту лояльности Manzana2019.
2. Нажать клавишу "Добавить купон" Открыть диалог по кнопке с командой COMMAND_COUPON_ADD. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
3. В появившемся диалоге "Купоны" нажать клавишу "Добавить (Ins)" и ввести номер купона в поле ввода.Для перехода в режим формирования документа закройте диалог, нажав клавишу "Закрыть (Esc)". Купоны не отображаются добавить купон.

Скидка по купону применяется автоматически при переходе в подитогподытог:

• если в чеке имеются неактивные купоны, то на экран будет выведен диалог "Удаление неактивных купонов". Неактивные купоны можно удалить с помощью клавиши "Удалить (Del)" или "Удалить неактивные и продолжить (Esc)"необходимо удалить;
• если в чеке все купоны активны, то на экран будет выведен диалог "Система лояльности" для оплаты чека баллами.

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

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

• добавление карты производится online. Если сервер системы лояльности недоступен, то offline. При добавлении карты в чек на экран будет выведено предупреждение "Нет связи с сервером. Баллы будут начислены позднее", после закрытия предупреждения карта будет добавлена в чек. Списание бонусных баллов невозможно. При попытке оплатить чек бонусными баллами на экран будет выведено предупреждение "На карте нет баллов для оплаты". Операции по начислению будут произведены через очередь Artix-Queue;
• запрос скидок и списание бонусных баллов всегда производятся online;
• операции по начислению и отмене начисления производятся online. Если сервер системы лояльности недоступен, то в режиме offline через очередь Artix-Queue.