OZON

Модуль логики «OZON» (Ozon Бонус)

Модуль логики для работы Кассира 5 с программой лояльности Ozon Бонус: авторизация клиента по идентификатору (штрихкод карты в мобильном приложении) или по номеру телефона, получение баланса и доступных к начислению и списанию бонусов по чеку, начисление или списание бонусов при оплате, возврат бонусов при возврате чека. Механики программы (размеры начислений и списаний, ограничения по товарам) настраиваются на стороне сервиса Озон, касса получает уже рассчитанные значения.

Файл модуля — OZON.zip → OZON.epf в каталоге LogicalModules. В списке вкладки Модули логики отображается как OZON.

Модуль подключается через Настройка → Касса → Мастер настройки → Выбор модулей логики (см. страницу «Способы подключения модулей логики»). После подключения и перезапуска Кассира 5 его настройки появляются на вкладке Настройка → Модули логики в списке слева.

• Активность — модуль работает, если флаг установлен; если снят — модуль не используется. По умолчанию снят.
• Адрес сервиса — адрес веб-сервиса лояльности Озон (partnerGatewayService), выданный Озон.
• API Ключ — ключ доступа к сервису; генерируется на стороне Озон для конкретной кассы и передаётся во всех запросах.
• Каталог логов — папка, в которую записываются ошибки и лог обмена с сервисом. Если не указан, логирование не ведётся. Логи модуля собирает также менеджер сбора логов: кнопка Логи в нижней части окна Настройка.
• Проверка связи — кнопка проверяет подключение к сервису по указанным адресу и ключу.
• Интервал между отправлениями данных в сервис — пауза в секундах между фоновыми отправками запросов фиксации оплаты, которые не удалось отправить при закрытии чека (см. «Обработка ошибок»); 0 — отправка без задержки.

Работа кассира

Команды модуля находятся в меню Сервис формы регистрации продаж:

• Клиент OZON по айди — открывает форму авторизации с текстом «Сосканируйте айди клиента или введите номер вручную»: штрихкод с мобильного устройства клиента считывается сканером или вводится вручную, затем Ввод. В такой сессии доступно и начисление, и списание бонусов.
• Клиент OZON по номеру телефона — открывает форму «Введите номер телефона»; номер вводится вручную в формате +7XXXXXXXXXX, затем Ввод. В такой сессии по умолчанию доступно только начисление; для списания клиенту отправляется код подтверждения.
• На формах ввода: кнопки цифр, удаление последней цифры, очистка, Отмена — закрыть форму и вернуться в форму регистрации. При успешной авторизации выводится сообщение Авторизация прошла успешно!, при ошибке — сообщение с описанием ошибки.

Авторизацию можно выполнить до набора чека, во время набора или перед оплатой. Далее порядок такой:

1. Кассир нажимает ОПЛАТА. Касса отправляет состав чека в сервис (пречек) и открывает форму накопления или списания бонусов с полями Баланс — текущий баланс клиента, Можно списать — максимальная сумма списания в этом чеке, Будет начислено — сумма начисления по этому чеку.
2. Начислить бонусы — форма закрывается, ранее применённые скидки Озон (если были) отменяются, чек оплачивается как обычно, после печати фискального чека начисление фиксируется в сервисе и печатается слип, возвращённый сервисом.
3. Списать бонусы — бонусы распределяются по позициям чека скидкой из ответа сервиса, затем открывается форма расчёта. При авторизации по телефону перед списанием открывается форма ввода кода подтверждения: клиент сообщает код из СМС, кассир вводит его и нажимает Ввод; при неверном коде выводится ошибка и форма бонусов остаётся открытой. Код отправляется повторно, если прошло больше 60 секунд.
4. Отмена — форма закрывается без операций с бонусами.

Особенности работы

• Клиент передумал списывать — если выбрано «Списать бонусы», а затем кассир снова нажимает ОПЛАТА, режим оплаты бонусами отменяется в сервисе и форма открывается заново; если отмена не прошла, начисление и списание недоступны.
• Отмена чека с авторизованным клиентом — заказ отменяется в сервисе, все операции с бонусами по нему аннулируются; сообщение об ошибке при этом кассиру не выводится.
• Отложенный чек — при откладывании чека заказ отменяется в сервисе, данные авторизации в отложенном чеке не сохраняются; после продолжения чека авторизацию нужно выполнить заново.
• Возврат — при возврате чека, в котором была авторизация, в сервис передаются идентификатор сессии чека продажи и возвращаемые позиции; начисленные или списанные бонусы корректируются на балансе клиента по возвращённым товарам (полный или частичный возврат).
• Сообщение клиенту — если сервис в любом ответе вернул текст для клиента (client_message), касса показывает его кассиру отдельным окном.

Обработка ошибок

• При ошибке пречека или отмены оплаты бонусами выводится описание ошибки и вопрос Повторить запрос к сервису Озон?: Да — запрос повторяется; Нет — выводится сообщение Внимание! Работа с сервисом Озон недоступна, чек закрывается без начисления и списания бонусов.
• При ошибке фиксации оплаты после печати чека кассиру выводится описание ошибки, а запрос сохраняется в базе кассы и отправляется в фоне по очереди с паузой Интервал между отправлениями данных в сервис; после успешной отправки запись удаляется.

Порядок настройки

1. На стороне Озон настроить программу лояльности и получить адрес сервиса и API-ключ для кассы.
2. Подключить модуль через мастер настройки и перезапустить Кассир 5.
3. Заполнить Адрес сервиса, API Ключ, Каталог логов, нажать Проверка связи.
4. Установить флаг Активность, нажать ОК.

См. также:

• Кнопка «Логи». Централизованный сбор логов (описание настроек)