Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

ПАО "Сбербанк" предоставляет возможность использовать банковские карты для авторизации участника социальной программы через платежные банковские терминалы, установленные на кассах торговых предприятий для оплаты покупок. Авторизация также может происходить с помощью QR-кода, который предъявляет участник социальной программы. Такой QR-код состоит из фиксированного префикса и шифрованного кода, который должен быть передан в процессинг социальной программы для идентификации ее участника.

Ограничения

...

1. Авторизация участника социальной программы по банковской карте возможна только с помощью кассовой операции, вызываемой вручную (по кнопке) на киосках/КСО и на линейных кассах.

2. Если участник социальной программы был авторизован по банковской карте и оплата покупки будет происходить по банковской карте, то при оплате карту необходимо будет повторно аутентифицировать в банковском терминале.

Как это выглядит на кассовом терминале

...

1. Покупатель добавляет товары в чек.

2. Если покупка оформляется на линейной кассе, то кассир вызывает кассовую операцию Социальная карта, если на киоске/КСО – то покупатель нажимает эту кнопку сам:

Клавиатурная кассаTouch-кассаКиоск/КСО



3. Касса предлагает меню авторизации участника программы лояльности из двух пунктов (по QR-коду/по банковской карте):

Клавиатурная кассаTouch-кассаКиоск/КСО



   3.1. Если выбирается опция по QR-коду, то касса предлагает его ввести (возможно только путём считывания сканером) и самостоятельно выделяет из него шифрованную часть кода карты.

...

5. Касса получает в ответе перечень кодов льгот, которые имеет данный участник программы лояльности и выводит на экран сообщение о том, что социальная карта добавлена в чек:

Клавиатурная кассаTouch-кассаКиоск/КСО



6. Касса рассчитывает скидки, соответствующие полученным категориям льгот, и оставляет в чеке одну с максимальным значением.

...

9. Касса отравляет в социальный процессинг информацию о сумме скидок по социальной программе, предоставленных ее участнику (если они не равны нулю). 

Особенности реализации

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

2. Социальная скидка предоставляется до списания баллов бонусных программ.

3. В чеках с рассчитанными социальными скидками сохраняется код аутентификации участника социальной программы.

4. После оформления чека, касса передает в социальный процессинг информацию о сумме предоставленной скидки, если она не равна 0. Если в момент завершения чека социальный процессинг не доступен, то касса передает данную информацию в отложенном режиме.

5. Код аутентификации участника социальной программы выгружается в составе чека в торговую систему.

6. При возврате товаров участником социальной программы, взаимодействия с социальным процессингом не происходит.

Настройки

На стороне УКМ 5

1. Взаимодействие между кассовой системой и сервисом социального процессинга происходит в открытой сети (Интернет).

  • Используется протокол HTTPS, TLS v1.0/v1.1/v1.2
  • Обмен данными между КС и «Социальным процессингом» инициирует КС с помощью POST запросов.

На кассовом сервере по адресу: Магазин – Типы касс нужно выбрать тип кассы и нажать кнопку Настройки:

Image Added

В конфигурационном файле sale.conf (applications\sale\sale.conf) в блоке UI необходимо выставить значение параметра socialCardEnabled как true, после чего – сохранить файл:

Image Added


2. В этом же файле в блоке BL нужно раскомментировать следующую строку, после чего – сохранить файл:

Блок кода
languagescala
themeRDark
include file("conf/applications/sale/social_processing.conf") 

Image Added

3. После этого, необходимо выполнить настройки в файле social_processing.conf (applications\sale\social_processing.conf):

Блок кода
languagescala
themeRDark
# Настройка взаимодействия с соц.процессингом (социальная карта жителя Камчатки).
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

Для каждой льготы настраивается скидка с механикой Для каждой льготы в кассовой системе настраивается скидка с механикой Оффлайн скидка на перечень товаров:

...

  • коды льгот, полученные от социального процессинга (сервис АО «Расчетные решения»), регистрируются в кассе УКМ 5 как дисконтные карты;
  • в момент расчета скидок, зарегистрированные карты приводят к расчету соответствующих скидок.

...

  • каждая скидка не должна содержать более 50 SKU;
  • общее количество социальных скидок не должно превышать 10.

Особенности реализации:

...

  • .