https://crystals.atlassian.net/browse/SR-8945

https://crystals.atlassian.net/browse/CR-15470

1 Описание
2 Ценность
3 Примеры
- 3.1 Сценарий 1. Идентификация покупателя по QR-коду
- 3.2 Сценарий 2. Идентификация покупателя с применением банковской карты
4 Ограничения и особенности работы
5 Настройка
- 5.1 На сервере
  - 5.1.1 Добавление процессинга
  - 5.1.2 Шаблон кассы
  - 5.1.3 Кассовые механики
    - 5.1.3.1 Служебная акция
    - 5.1.3.2 Акция на предоставление социальной льготы
- 5.2 В базе данных
6 Статьи по теме

Описание

Плагин обеспечивает интеграцию кассовой системы SetRetail 10 с процессингом “Моя выгода” для идентификации покупателей и автоматического применения скидок на основе социальных льгот. Покупатель может быть идентифицирован двумя способами: по QR-коду из мобильного приложения или по банковской карте, подключенной к социальной программе.

Принцип работы

Идентификация покупателя. Кассир или покупатель сканирует QR-код из мобильного приложения системы лояльности “Моя выгода”, либо кассир инициирует считывание банковской карты через терминал. Плагин направляет запрос в процессинг и получает набор кодов социальных льгот, привязанных к карте покупателя.
Применение рекламной акции. При переходе к расчёту плагин проверяет полученные коды льгот и применяет в чеке рекламные акции, условия которых соответствуют этим кодам. Касса пересчитывает итоговую сумму чека с учётом всех применённых акций.
Фиксация транзакции. После регистрации чека плагин передаёт в процессинг информацию о транзакции с указанием содержимого QR-кода или HMAC банковской карты в зависимости от способа идентификации.

Ценность

Удобство получения скидки для покупателя. Достаточно показать QR-код или приложить банковскую карту.
Автоматическое применение льгот. Проверка права на льготу происходит автоматически, без участия кассира.
Гибкая настройка акций. Скидку можно распространить на всех держателей социальной карты или настроить под конкретную льготную категорию. Можно задавать скидку на конкретные товары или на весь чек, ограничивать акцию по магазинам, регионам и срокам действия.
Оптимизация обслуживания. Идентификация покупателя не требует от кассира дополнительных действий и не замедляет процесс обслуживания.

Примеры

Сценарий 1. Идентификация покупателя по QR-коду

Кассир формирует чек → сканирует QR-код из мобильного приложения покупателя.
Плагин направляет запрос в процессинг → получает код льготы.
Касса отображает иконку применения карты.
Кассир переходит к расчету.
Плагин применяет акцию, соответствующую полученному коду льготы.
Касса пересчитывает итоговую сумму с учётом скидки.
Покупатель оплачивает чек любым доступным способом.

Сценарий 2. Идентификация покупателя с применением банковской карты

В чеке есть товары, QR-код из приложения не применялся.
На клавиатурной/сенсорной кассе кассир нажимает функциональную кнопку Социальная карта на терминале (название кнопки настраиваемое), на КСО покупатель нажимает кнопку Социальная карта.
Банковский модуль активирует терминал.
Покупатель прикладывает банковскую карту к терминалу — модуль возвращает плагину HMAC-код карты.
Плагин идентифицирует покупателя в процессинге по HMAC и получает набор кодов социальных льгот.
В чеке отображается значок примененной карты.
При расчёте скидок применяются акции, условия которых совпали с кодами льгот покупателя.
Покупатель оплачивает чек любым доступным способом. При оплате банковской картой карту необходимо приложить к терминалу повторно — первое прикладывание использовалось только для идентификации.
После регистрации чека плагин передаёт в процессинг HMAC карты в качестве подтверждения транзакции.

Ограничения и особенности работы

Функциональность реализована для клавиатурной кассы, Set Touch и Set SCO v.3.
Если покупатель уже идентифицирован по HMAC банковской карты, последующее сканирование QR-кода в том же чеке игнорируется.
Идентификация покупателя по банковской карте поддерживается только при использовании терминала Сбербанка.
При оплате банковской картой покупатель прикладывает карту дважды: первый раз — для получения HMAC (идентификация), второй раз — для списания средств.
В плагине представлен полный на текущий момент перечень категорий льгот, например: пенсионеры, многодетные семьи и т. д. При настройке акций пользователь выбирает категории льгот из фиксированного списка. Количество акций с разными комбинациями кодов льгот не ограничено.

Настройка

На сервере

Добавление процессинга

На сервере SetRetail/SetCentrum перейдите в раздел Интеграция → Внешние процессинги → кликните .

Введите в строке поиска выгода → кликните Внешние процессинги лояльности → установите флажок Плагин интеграции Моя
Выгода → кликните .

Кликните по строке с названием процессинга.

Установите настройки на вкладке ОБЩИЕ → нажмите .

Настройка	Описание

Настройка	Описание
Адрес сервиса *	Адрес подключения к процессингу. Уточняйте у представителя АО “Расчетные решения”.
Ключ социальной программы для торговых предприятий *	Ключ социальной программы для торговых предприятий. Выдаётся на организацию представителем АО “Расчетные решения”.
API-key торгового предприятия *	API-key торгового предприятия. Выдаётся на организацию представителем АО “Расчетные решения”.
Таймаут соединения, в секундах *	Таймаут соединения с процессингом в секундах.
Таймаут ожидания ответа, в секундах *	Таймаут ожидания ответа с процессингом в секундах.
Идентификатор QRC *	Префикс QR-кода, по которому плагин распознаёт, что отсканированный код относится к системе лояльности “Моя выгода”. Уточняется у представителя АО “Расчетные решения”. На момент выхода статьи актуальное значение по умолчанию: AORR,
Фиксированный номер карты, при сканировании которой, запустится процесс считывания социальной карты с терминала *	Служебный номер, при сканировании которого касса активирует терминал для считывания банковской карты покупателя с целью получения социальных признаков (кодов социальных льгот). Внутренний технический параметр плагина.

Шаблон кассы

Клавиатурная касса

Перейдите в раздел Кассовый модуль → Шаблоны касс → кликните по требуемому шаблону.

Перейдите на вкладку ИНТЕРФЕЙС → нажмите РЕДАКТИРОВАТЬ КОНФИГУРАЦИЮ → нажмите + для добавления новой кнопки меню → выберите значение Товар → в поле Товар введите значение, которое указано в настройке плагина Фиксированный номер карты, при сканировании которой, запустится процесс считывания социальной карты с терминала * (в данном примере, это 5999321) → введите произвольное название кнопки → нажмите ПРИМЕНИТЬ → нажмите ПРИМЕНИТЬ → перезагрузите кассовый модуль.

Set Touch

Перейдите в раздел Кассовый модуль → Настройки интерфейса → Функциональное меню Touch кассы.

Нажмите + для добавления плитки → установите параметры:

Функция: выберите значение Добавить товар;
Название для кассира: введите любое название;
Изображение: выберите любое изображение;
Введите ШК, артикул или наименование: введите значение, которое указано в настройке плагина Фиксированный номер карты, при сканировании которой, запустится процесс считывания социальной карты с терминала *), в данном примере, это 5999321.

Нажмите СОЗДАТЬ → нажмите .
Перезагрузите кассовый модуль.

Set SCO v.3

В разделе Кассовый модуль → Шаблоны касс → [Шаблон кассы] → перейдите на вкладку ПРОЦЕСС ТОРГОВЛИ → НАСТРОЙКИ → введите в поисковую строку социальная для ускорения поиска → кликните на вкладку Дополнительные настройки → установите флажок Социальная карта.
Появятся дополнительные параметры: установите флажок Отображение кнопки “Социальная карта” → в поле № карты\купона введите значение, которое указано в настройке плагина Фиксированный номер карты, при сканировании которой, запустится процесс считывания социальной карты с терминала * → снимите флажок Вызывать консультанта для подтверждения → нажмите кнопку → перезагрузите кассовый модуль.

Кассовые механики

Служебная акция

Перейдите в раздел Инструменты лояльности → Кассовые механики → кликните .

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

Установите результат Скидка → Внешняя система лояльности → в поле Внешняя система выберите Плагин лояльности Моя Выгода → нажмите .

Нажмите кнопку .

Акция на предоставление социальной льготы

Ключевая особенность настройки: установите условие Определяет внешняя система → Плагин условия Моя выгода. Остальные параметры такой акции могут быть любые – в соответствии с вашими бизнес-процессами.

Перейдите в раздел Инструменты лояльности → Кассовые механики → кликните .

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

Установите условие ОБЩИЕ ПРАВИЛА → Определяет внешняя система → выберите Плагин условия Моя выгода → установите флажок напротив требуемых социальных признаков.

Выберите принцип учёта признаков:
- Любой из выбранных признаков – акция сработает, если совпадает хотя бы один из указанных признаков;
- Все выбранные признаки – акция сработает, только если совпадают все признаки из указанных.
Кликните .

Перейдите к редактированию результата по кнопке .

Установите любой результат, например Скидка → Скидка на чек в размере 10%.

Нажмите кнопку .

В базе данных

Для работы функциональности идентификации по банковской карте выполните скрипт в базе данных кассы catalog. В результате выполнения скрипта для настройки sberbank.config.hmac.id будет выставлено значение SERT.

SetRetail10 ◾️ Плагин лояльности "Моя выгода"