История страницы

...

Продукт "Карта жителя" от АО «Расчетные решения» предназначен для реализации социальных программ в виде различных льгот. Льготы Льготы предоставляются в виде скидок на перечень товаров, приобретаемых в розничных магазинах торговых предприятий. Как таковой, сервис АО «Расчетные решения» (далее – социальный процессинг) не рассчитывает сами скидки, а только сообщает (в виде кодов категорий) набор льгот, которые есть у участника социальной программы. Участник социальной программы может иметь одновременно несколько льгот. Перечень товаров, на которые распространяется определенная социальная льгота, определяется торговым предприятием и оформляется в виде скидок кассовой программы. Каждой льготе соответствует отдельная скидка. Скидки представляют собой перечень товаров с размером скидки в виде процента, одинакового для всех товаров одной скидки.

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

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

в содержании скидки указывается перечень SKU
в описании скидки указывается:
процент скидки
режим применения – код дисконтной карты со значением, соответствующим коду льготы.

Алгоритм расчета скидок:

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

Ограничения:

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

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

...

Ограничения

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

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

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

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

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

Image Added

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

Image Added

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

Image Added

3.2. Если выбирается опция по банковской карте, то касса делает обращение к банковскому терминалу Сбербанка с операцией получения закодированного кода карты:

Image Added

4. Касса обращается с полученным кодом карты или с шифрованной частью QR-кода в социальный процессинг.

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

Image Added

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

Image Added

7. Кассир/покупатель переходит к оплате чека.

8. Если кассир/покупатель выбирает средство оплаты через банковский терминал, то касса/киоск/КСО выполняет штатный сценарий оплаты чека, включая предложение предъявить банковскую карту.

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

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

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

...

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

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

3. В чеках

...

с рассчитанными социальными скидками

...

сохраняется код аутентификации

...

участника социальной программы.

4. После оформления чека

...

, касса передает в социальный процессинг информацию о сумме предоставленной скидки, если она не равна 0.

...

Если в момент завершения чека

...

социальный процессинг не доступен, то

...

касса передает данную информацию в отложенном режиме.

...

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

6. При возврате товаров

...

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

...

социальным процессингом не происходит.

Ограничения

...

Настройки

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

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

Image Added

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

Image Added

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

Блок кода

language	scala
theme	RDark

include file("conf/applications/sale/social_processing.conf")

Image Added

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

Блок кода

language	scala
theme	RDark

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

Примечание. Если данный файл отсутствует в иерархическом древе, то его (с указанным выше содержимым) следует разместить по адресу: applications\sale:

Image Added

4. Для обеспечения возможности авторизации участника социальной программы в чеке по банковской карте, необходимо на кассовом сервере по адресу: Магазин – Кассы выбрать нужную кассу и нажать кнопку Оборудование:

Image Added

В конфигурационном файле sbrf_lin.conf (hardware\bank\sbrf_lin.conf) нужно раскомментировать (или добавить, если отсутствует) следующую строку, после чего – сохранить файл:

Блок кода

language	scala
theme	RDark

sbPilotKey = "SERT" # Ключ шифрования для команды sb_pilot 104 (формирование HMAC карты жителя). Строка от 3 до 12 символов.

5. Далее, необходимо вернуться по адресу: Магазин – Типы касс, выбрать тип кассы и нажать кнопку Настройки:

Image Added

6. В разделе socialProcessing конфигурационного файла offline.conf (services\offline.conf) можно выполнить настройку тайм-аутов взаимодействия кассовой системы с социальным процессингом:

Блок кода

language	scala
theme	RDark

socialProcessing: {
          sendLimit = 20 # количество попыток отправки запроса
          restRetryErrors = ["200", "90001"] # массив статус-кодов, по которым сервис будет понимать, переотправлять запрос или нет
          connectTimeout = 10 seconds  # таймаут подключения
          readTimeout = 15 seconds     # таймаут получения ответа
        }

Примечание. Если раздел socialProcessing отсутствует в файле offline.conf (services\offline.conf), то его (с указанным выше содержимым) следует в нем разместить:

Image Added

Все выполненные настройки в файле необходимо сохранить.

7. В файле loya.conf (services\marketing\loya.conf) надо указать значение параметра useOffline как true, после чего – сохранить файл:

Image Added

На стороне LOYA

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

в содержании скидки указывается перечень SKU товаров:

Image Added

в описании скидки указывается:
процент скидки:

Image Added

режим применения – код дисконтной карты со значением, соответствующим коду льготы:

Image Added

Алгоритм расчета скидок:

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

Ограничения:

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

...

.

Дерево страниц

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

Старая версия 2

Новая версия Текущий

Ключ

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

Ограничения

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

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

Настройки

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

На стороне LOYA