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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возврат

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

Также реализована возможность возврата списанных ранее баллов на другой кассе.

Купоны

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

Для добавления купона в чек необходимо:

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

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

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