Продукт "Карта жителя" от АО «Расчетные решения» предназначен для реализации социальных программ в виде различных льгот. Льготы предоставляются в виде скидок на перечень товаров, приобретаемых в розничных магазинах торговых предприятий. Как таковой, сервис АО «Расчетные решения» (далее – социальный процессинг) не рассчитывает сами скидки, а только сообщает (в виде кодов категорий) набор льгот, которые есть у участника социальной программы. Участник социальной программы может иметь одновременно несколько льгот. Перечень товаров, на которые распространяется определенная социальная льгота, определяется торговым предприятием и оформляется в виде скидок кассовой программы. Каждой льготе соответствует отдельная скидка. Скидки представляют собой перечень товаров с размером скидки в виде процента, одинакового для всех товаров одной скидки.
ПАО "Сбербанк" предоставляет возможность использовать банковские карты для авторизации участника социальной программы через платежные банковские терминалы, установленные на кассах торговых предприятий для оплаты покупок. Авторизация также может происходить с помощью QR-кода, который предъявляет участник социальной программы. Такой QR-код состоит из фиксированного префикса и шифрованного кода, который должен быть передан в процессинг социальной программы для идентификации ее участника.
1. Авторизация участника социальной программы по банковской карте возможна только с помощью кассовой операции, вызываемой вручную (по кнопке) на киосках/КСО и на линейных кассах.
2. Если участник социальной программы был авторизован по банковской карте и оплата покупки будет происходить по банковской карте, то при оплате карту необходимо будет повторно аутентифицировать в банковском терминале.
1. Покупатель добавляет товары в чек.
2. Если покупка оформляется на линейной кассе, то кассир вызывает кассовую операцию Социальная карта, если на киоске/КСО – то покупатель нажимает эту кнопку сам:
| Клавиатурная касса | Touch-касса | Киоск/КСО |
|---|---|---|
3. Касса предлагает меню авторизации участника программы лояльности из двух пунктов (по QR-коду/по банковской карте):
| Клавиатурная касса | Touch-касса | Киоск/КСО |
|---|---|---|
3.1. Если выбирается опция по QR-коду, то касса предлагает его ввести (возможно только путём считывания сканером) и самостоятельно выделяет из него шифрованную часть кода карты.
3.2. Если выбирается опция по банковской карте, то касса делает обращение к банковскому терминалу Сбербанка с операцией получения закодированного кода карты.
4. Касса обращается с полученным кодом карты или с шифрованной частью QR-кода в социальный процессинг.
5. Касса получает в ответе перечень кодов льгот, которые имеет данный участник программы лояльности и выводит на экран сообщение о том, что социальная карта добавлена в чек:
| Клавиатурная касса | Touch-касса | Киоск/КСО |
|---|---|---|
6. Касса рассчитывает скидки, соответствующие полученным категориям льгот, и оставляет в чеке одну с максимальным значением.
7. Кассир/покупатель переходит к оплате чека.
8. Если кассир/покупатель выбирает средство оплаты через банковский терминал, то касса/киоск/КСО выполняет штатный сценарий оплаты чека, включая предложение предъявить банковскую карту.
9. Касса отравляет в социальный процессинг информацию о сумме скидок по социальной программе, предоставленных ее участнику (если они не равны нулю).
1. В чеке может быть авторизован только один участник социальной программы. Повторная авторизация участника социальной программы в чеке заменяет предыдущую.
2. Социальная скидка предоставляется до списания баллов бонусных программ.
3. В чеках с рассчитанными социальными скидками сохраняется код аутентификации участника социальной программы.
4. После оформления чека, касса передает в социальный процессинг информацию о сумме предоставленной скидки, если она не равна 0. Если в момент завершения чека социальный процессинг не доступен, то касса передает данную информацию в отложенном режиме.
5. Код аутентификации участника социальной программы выгружается в составе чека в торговую систему.
6. При возврате товаров участником социальной программы, взаимодействия с социальным процессингом не происходит.
1. На кассовом сервере по адресу: Магазин – Типы касс нужно выбрать тип кассы и нажать кнопку Настройки:
В конфигурационном файле sale.conf (applications\sale\sale.conf) в блоке UI необходимо выставить значение параметра socialCardEnabled как true, после чего – сохранить файл:
2. В этом же файле в блоке BL нужно раскомментировать (или добавить, если ее нет) следующую строку, после чего – сохранить файл:
include file("conf/applications/sale/social_processing.conf") |
3. После этого, необходимо выполнить настройки в файле social_processing.conf (applications\sale\social_processing.conf):
# Настройка взаимодействия с соц.процессингом (социальная карта жителя Камчатки).
socialProcessing: {
baseUrl = "https://test-sp-terminal-v4.secgw.ru" # URL шлюза СП
# --- Заголовки запросов к СП ---
x-social-program-key = "socialprogramkey" # Ключ соцпрограммы торгового предприятия
x-merchant-key = "merchantkey" # API-key торгового предприятия
x-shop-id = "001" # Код магазина. Если не указан — внешний id-магазина, затем id-магазина в КС.
timeout = 10 seconds # Таймаут ожидания ответа от СП
include file("conf/misc/social_processing.conf")
} |
Значения перечисленных ниже параметров следует получить у представителей сервиса социального процессинга:
baseUrl – URL-адрес шлюза социального процессинга;
Примечание. Если данный файл отсутствует в иерархическом древе, то его (с указанным выше содержимым) следует разместить по адресу: applications\sale:
4. Для обеспечения возможности авторизации участника социальной программы в чеке по банковской карте, необходимо на кассовом сервере по адресу: Магазин – Кассы выбрать нужную кассу и нажать кнопку Оборудование:
В конфигурационном файле sbrf_lin.conf (hardware\bank\sbrf_lin.conf) нужно раскомментировать (или добавить, если отсутствует) следующую строку, после чего – сохранить файл:
sbPilotKey = "SERT" # Ключ шифрования для команды sb_pilot 104 (формирование HMAC карты жителя). Строка от 3 до 12 символов. |
5. Далее, необходимо вернуться по адресу: Магазин – Типы касс, выбрать тип кассы и нажать кнопку Настройки:
6. В разделе socialProcessing конфигурационного файла offline.conf (services\offline.conf) можно выполнить настройку тайм-аутов взаимодействия кассовой системы с социальным процессингом:
socialProcessing: {
sendLimit = 20 # количество попыток отправки запроса
restRetryErrors = ["200", "90001"] # массив статус-кодов, по которым сервис будет понимать, переотправлять запрос или нет
connectTimeout = 10 seconds # таймаут подключения
readTimeout = 15 seconds # таймаут получения ответа
} |
Примечание. Если раздел socialProcessing отсутствует в файле offline.conf (services\offline.conf), то его (с указанным выше содержимым) следует в нем разместить:
Все выполненные настройки в файле необходимо сохранить.
7. В файле loya.conf (services\marketing\loya.conf) надо указать значение параметра useOffline как true, после чего – сохранить файл:
Для каждой льготы настраивается скидка с механикой Оффлайн скидка на перечень товаров:
Алгоритм расчета скидок:
Ограничения: