Описание
Продукт "Карта жителя" от АО «Расчетные решения» предназначен для реализации социальных программ в виде различных льгот. Льготы предоставляются в виде скидок на перечень товаров, приобретаемых в розничных магазинах торговых предприятий. Как таковой, сервис АО «Расчетные решения» (далее – социальный процессинг) не рассчитывает сами скидки, а только сообщает (в виде кодов категорий) набор льгот, которые есть у участника социальной программы. Участник социальной программы может иметь одновременно несколько льгот. Перечень товаров, на которые распространяется определенная социальная льгота, определяется торговым предприятием и оформляется в виде скидок кассовой программы. Каждой льготе соответствует отдельная скидка. Скидки представляют собой перечень товаров с размером скидки в виде процента, одинакового для всех товаров одной скидки.
ПАО "Сбербанк" предоставляет возможность использовать банковские карты для авторизации участника социальной программы через платежные банковские терминалы, установленные на кассах торговых предприятий для оплаты покупок. Авторизация также может происходить с помощью 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. При возврате товаров участником социальной программы, взаимодействия с социальным процессингом не происходит.
Настройки
На стороне УКМ 5
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-адрес шлюза социального процессинга;
- x-social-program-key – ключ соцпрограммы торгового предприятия;
- x-merchant-key – API-key торгового предприятия;
- x-shop-id – код магазина; если он не указан, то используется внешний ID магазина; если и он не указан – то ID магазина в кассовой системе;
- x-terminal-id – номер кассового терминала; если он не указан, то используется GUID кассы.
Скрытый параметр конфигурации для social_processing.conf Добавить его, если изменится префикс для распознования QR карты Жителя:
socialCardQrPrefix = "AORR,"На стороне LOYA
Для каждой льготы настраивается скидка с механикой Оффлайн скидка на перечень товаров:
- в содержании скидки указывается перечень SKU товаров:
- в описании скидки указывается:
- процент скидки:
- режим применения – код дисконтной карты со значением, соответствующим коду льготы:
Алгоритм расчета скидок:
- коды льгот, полученные от социального процессинга (сервис АО «Расчетные решения»), регистрируются в УКМ 5 как дисконтные карты;
- в момент расчета скидок, зарегистрированные карты приводят к расчету соответствующих скидок.
Ограничения:
- каждая скидка не должна содержать более 50 SKU;
- общее количество социальных скидок не должно превышать 10.






