Описание

В состав Системы входит веб-сервис для взаимодействия скассовым программным обеспечением Заказчика (на базе ПО «Кристалл Сервис Интеграция») вонлайн-режиме. Так же в состав системы входит веб-сервис для взаимодействия сличным кабинетом, для реализации на кассе частичной функциональности ЛичногоКабинета пользователя.

Кассовое ПО, при помощи вызова операции веб-сервиса личного кабинета и системы Manzana Loyalty , должновыполняет следующие операции:

Выдача новой карты (с анкетой/без анкеты);
Замена утерянной/испорченной карты;
Замена старой карты на новую:
- Поиск номера карты по QR -коду из личного кабинета (при замене утерянной карты)
- Поиск номера карты по мобильному телефону (при замене утерянной карты)
Привязка анкеты к уже выданной новой карте;
Поиск идентификатора контакта по QR -коду (при выдаче новой карты клиенту, который ранее зарегистрировался в ЛК)

Так же система Manzana Loyalty позволяет работу с двумя типами чеков: мягкий и фискальный.

Чеки по запросу мягких чеков в Системе не регистрируются.Кассовое программное обеспечение может многократно запрашивать обработкумягкого чека по одной транзакции. Такой тип чеков позволяет узнать для клиентов,предъявивших дисконтную карту или купон, размер скидки и результатыпотенциальной фискальной транзакции, если она будет передана.

Чеки по запросам фискальных чеков регистрируются всистеме. На каждый запрос фискального чека от кассы в системе Manzana Lyoalty создается новый чек.

Кассовое ПО при помощи вызова операции веб-сервиса POS- системы Manzana Loyalty , выполняет следующие операции:

Продажа (с дисконтной картой, с предъявлением купона, с выпуском моментального купона);
Возврат покупки;
Передача сообщения (на слипчек/на дисплей кассира)
Печать персонального предложения (ПП)

Настройка использования

Войдите в настройки процессинга Manzana на сервере SetRetail.
Укажите при необходимости номера касс, на которых должен работать процессинг Manzana. Если номера не указаны, процессинг Manzana работает во всем магазине.
Укажите следующие настройки процессинга:
1. Организация (<orgName> при отправке в Manzana)
2. Партнер (<Organization> при отправке в Manzana)
3. Адрес основного web-сервиса POS
4. Адрес резервного web-сервиса POS (опционально)
5. Адрес основного web-сервиса ЛК
6. Адрес резервного web-сервиса ЛК (опционально)
7. Время ожидания до ответа от web-сервиса POS и ЛК (по умолчанию - 5 сек)
8. Количество попыток подключения к web-сервису POS и ЛК (по умолчанию - 1)
9. Логин (доменное имя пользователя, под которым необходимо авторизоваться на web-сервисе)
10. Пароль (пароль доменного пользователя, под которым необходимо авторизоваться на web-сервисе)
11. Обязательность ввода номера анкеты при продаже новой карты
12. Код товара Дисконтная карта, который будет использован для добавления в чек в сценариях работы с картами
13. Префикс номеров дисконтных карт
14. Префикс номеров купонов Manzana
15. Префикс номеров карт старых программ лояльности
Все указанные настройки успешно применяются на указанных кассах магазина после перегрузки касс

Пример работы. Выдача новой карты Manzana через продажу на кассе

Данный сценарий реализует бизнес-процесс выдачи новых карт покупателям, как с уже заполненной, так и без заполненной анкеты. Выдача карты производится через продажу товара Дисконтная карта в фискальном чеке, при этом карта может быть продана по любой цене, в том числе за 0 руб при 100% скидке на товар.

Сценарий:

1. Кассир добавляет в чек товар Дисконтная карта

2. Касса запрашивает номер карты (разрешен ввод руками, через ридер или сканер)

3. Касса запрашивает номер анкеты клиента (разрешен ввод руками или через сканер)

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

4. После успешного ввода данных касса отправляет запрос в ML для регистрации новой карты

1. Если от ML пришла ошибка, при которой невозможен процесс выдачи карты, касса демонстрирует сообщение об ошибке, полученное из ML. Процесс выдачи карты прерывается, товар Дисконтная карта не добавляется в чек

2. Если от ML пришла ошибка о невозможности выдать карту с указанным номером, касса демонстрирует сообщение об ошибке, полученное из ML. Касса возвращается к п.2

3. Если в течение заданного в настройках тайм-аута касса не получила ответ от ML, касса пытается провести операцию на резервном сервере ML. Если по этой операции ответ также не был получен, касса демонстрирует сообщение об отсутствии связи. Кассир может повторить выполнение операции, в противном случае добавление карты в чек продажи отменяется

5. Если операция выполнена успешно, касса демонстрирует полученное от ML сообщение на экране кассира об успешной продаже карты. Карта добавляется в чек

При наличии 100% скидки карта будет предоставлена покупателю бесплатно. В случае получения карты без покупок финальная стоимость чека будет равна 0.

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

Включение процессинга на кассе

Откройте для редактирования файл /home/tc/storage/crystal-cash/modules/loyalty/ext-loyalty-providers.xml

Изначально файл для работы процессингов лояльности выглядит следующим образом:

Незакомментированная часть означает, что работают процессинги лояльности SetRetail10.

Необходимо закомментировать верхнуюю часть процессингов SetRetail10, а работу внешних процессинов лояльности раскомментировать, тем самым, активировав их.