ВведениеLink to Введение

Для работы QR продавца от Сбера необходима лицензия R-Keeper модуль SBP 12 мес ПО. Тип лицензии — лицензия по подписке.

Для версий r_keeper ниже 7.7.0.263 также дополнительно потребуется лицензия R-Keeper модуль XML-интерфейс для Приложения 12 мес ПО или R-Keeper модуль XML-интерфейс для Приложения 1 мес ПО. Тип лицензии — лицензия по подписке.

После того как заявка на лицензию будет подтверждена, в системе лицензирования необходимо сгенерировать активную лицензию.

Для работы с системой требуется r_keeper версии 7.7.0.222
Поддерживаемые операционные системы: windows 7, 8, 8.1, 10, 11

Предварительные настройкиLink to Предварительные настройки

Перед началом настройки QR продавца зарегистрируйте Организацию на портале Сбера:

  1. Оставьте заявку на подключение QR Плати на сайте Сбера
  2. Заполните полученную анкету и отправьте ее по адресу support@ecom.sberbank.ru c отметкой «Продукт: QR.API, регистрация. Организации, API V3.0.0»
  3. В ответ вы получите информацию с присвоенным номером MemberId
  4. В течение 3 дней будет создана Организация. 

Если организация была создана при входе на портал под СберБизнесID, то для дальнейшей настройки вам необходимо обратится к менеджеру Сбера для заключения договора и получения MemberID Организации.

Пока создается организация, настройте r_keeper.

Настройки на стороне r_keeperLink to Настройки на стороне r_keeper

Для корректной настройки и работы СБП нужна версия r_keeper 7.7.0.222+

В этой статье описаны настройки для версии r_keeper 7.7.0.228+. В версии 7.7.0.222  элементы не предустановлены, их необходимо завести вручную.


Предустановленные элементыLink to Предустановленные элементы

Для упрощения настройки СБП в  r_keeper, начиная с версии 7.07.00.228, были добавлены предустановленные элементы для СБП. При необходимости их можно заменить пользовательскими, выполнив соответствующие настройки.

Валюта для оплатыLink to Валюта для оплаты

В справочнике Валюты в группе Платежные карты добавлена валюта Валюта СБП.

Для валюты в секции свойств Ограничения в свойстве Право доступа укажите право Право СБП.

У валюты установлены следующие свойства: 

  • Флаг предоплаты  — выставите Да
  • Автозаполнение — вся сумма 
  • Способ ввода доп.инфо — Currency guid
  • Интерфейс —  Интерфейс СБП
  • Субсчет farcards — 0
    Проверьте, заполнено ли поле Причина внесения, если нет, то установите значение Предоплата СБП.

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


PDS интерфейсLink to PDS интерфейс

В справочник Интерфейсы добавлен интерфейс Интерфейс СБП.

  • В поле Автооплата по субсчетам укажите код валюты Валюта СБП
  • В поле Вывод доступных валют в XML установите значение Суммарно по всем блюдам
  • В поле Вывод нефискальных платежей установите значение Передавать как скидку
  • Выставите флаг Показывать кнопку Отмена.

Скидка-триггерLink to Скидка-триггер

В справочнике Скидки и наценки создан тип скидок СБП. В нем создана скидка СБП с нулевой детализацией. У скидки выставите ограничения: На заказ, На место. Скидка закрыта правом Право СБП.


Mcr-алгоритмыLink to Mcr-алгоритмы

Добавлен новый алгоритм со свойствами:

  • Тип устройств — выбраны все.
  • Тип алгоритма — скрипт
  • Область — интерфейс
  • Объект — интерфейс Интерфейс СБП

В скрипте указан следующий код:

function MCR1002300(DeviceSignal: Integer; DeviceIdent: Integer; var Parameter: String): Boolean;
begin
  Result := Parameter = '{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}';
end;

где вместо {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX} указан guid валюты для СБП


Настройка СБПLink to Настройка СБП

PDS интерфейсLink to PDS интерфейс

В справочнике Кассовые станции и устройства на кассовый сервер ресторана добавьте SBP interface#Х. При необходимости измените значение свойства PDS Server Name на имя сервера СБП, указанное в FARCARDS.INI

В справочнике Интерфейсы найдите интерфейс с наименованием Интерфейс СБП.

В группе свойств Группы свойств (DLL) раскройте ресторан, для которого нужно настроить СБП, и для кассового сервера/серверов выберите интерфейс SBP interface#Х, ранее добавленный во вкладке Устройства.

Сохраните изменения.

Макет для печати qr на пречекеLink to Макет для печати qr на пречеке

Если вы используете не предустановленную схему печати — то в справочнике Схемы печати выберите используемую схему и добавьте в нее представление документа СБП QR-код из группы Документы CRM > Купон.


HTTPS-серверLink to HTTPS-сервер

Для настройки HTTPS на кассовом сервере:

  1. Перейдите в меню Сервис > Менеджерская станция > Привилегии на объекты
  2. Проверьте наличие привилегии HTTP Access. В новых версиях r_kepeer 7 она предустановлена. Если у вас такой привилегии нет, создайте ее.
  3. На кассовом сервере в разделе HTTP Ограничения для всех свойств установите привилегию HTTP Access. И задайте значение порта HTTP Data Port.

  4. Создайте роль с правами на привилегию HTTP_порт

  5. Добавьте работника для созданной роли, задайте ему пароль. Название и пароль данного работника будут использоваться для авторизации на сервере через HTTPS.

ПравоLink to Право

В справочнике Права добавлено новое право Право СБП

РаботникиLink to Работники

Добавьте право Право СБП в роли работников, использующих СБП, иначе платежи не будут добавляться в r_keeper и будут отменяться на стороне банка.

Настройка предоплатыLink to Настройка предоплаты

Блюдо для нераспределяемой наценкиLink to Блюдо для нераспределяемой наценки

В Меню в группу Предоплаты или Нераспределяемые наценки добавьте блюдо Предоплата СБП (блюдо), установите у него право доступа — Право СБП, которое добавили ранее.

Нераспределяемая наценкаLink to Нераспределяемая наценка

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

Заполните следующие значения: 

  • Тип — Сумма
  • Блюдо наценки — Предоплата СБП (блюдо)  — блюдо, заданное в предыдущем пункте
  • Право доступа — Право СБП

Причина внесения/выдачи денегLink to Причина внесения/выдачи денег

Добавьте в справочник причин внесения/выдачи денег новый элемент.

Заполните следующие поля:

  • Предоплата — Установить флаг
  • Наценка — Предоплата СБП
  • Право доступа — Право СБП
  • Валюта зачета аванса — Фискальный зачет аванса


Настройка мест печати qr-кодовLink to Настройка мест печати qr-кодов

Для настройки нескольких Макетов Печати в справочнике Документы и Макеты добавить столько макетов, сколько нужно вариантов мест печати.

В приведенном примере настроено 3 различных места для печати.

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

У созданных Представлений Документов укажите основной принтер на который необходимо выводить представление / макет.

Настройки на стороне СбераLink to Настройки на стороне Сбера

Регистрация на порталеLink to Регистрация на портале

После получения Организации и MemberId необходимо настроить личный кабинет:

  1. Авторизуйтесь в личном кабинете
  2. Переведите профиль в режим организации. Для этого нажмите на кнопку Мой профиль > Переключиться на другую > Организация — аккаунт ЮЛ
  3. После включения режима организации включите настройку Установить по умолчанию и подтвердите действие.

Готово, организация на стороне Сбера настроена. 

Создание приложенияLink to Создание приложения

Далее необходимо создать приложение и выпустить сертификат. Для этого:

  1. В личном кабинете Сбера выберите нужную организацию
  2. Нажмите на кнопку Приложения > Создать новое приложение
  3. В форме создания приложения введите данные:
    • Название — введите уникальное название среди всех приложений организации
    • Описание — введите назначение приложения
    • OAuth Redirect URI — оставьте поле пустым
    • E-mail — введите электронную почту, на которую будет отправлен сертификат приложения
    • Пароль — пароль для импорта на ПК
    • Подтверждение пароля — введите указанный пароль.
  4. Нажмите на кнопку Создать. 

Готово, приложение и сертификат созданы. Откроется страница с ClientID и ClientSecret — сохраните ClientSecret для дальнейшего использования и загрузите Сертификат.  

Обязательно скопируйте ClientSecret и загрузите Сертификат:

  • ClientSecret показывается один раз. Если секретный ключ потеряется, его невозможно восстановить, можно только сгенерировать новый. 
  • Загрузить Сертификат можно только один раз, сделать это позже будет невозможно. Его можно будет только отозвать или выпустить новый. 

Для импорта сертификата клиента в OC Windows 10:

  1. Откройте загруженный сертификат, дважды нажав по файлу certificate_....p12
  2. Запустится диалог импорта
  3. Выберите Локальный компьютер и нажмите кнопку Далее

  4. Укажите путь расположения файла
  5. Укажите пароль, указанный при создании приложения
  6. В следующем окне выберите:
    1. Place all certificates in the following store
    2. Нажмите Browse
    3. Выберите папку Personal и нажмите OK
    4. Нажмите на кнопку Next
  7. Нажмите кнопку Finish

Готово, сертификат импортирован. 

Для просмотра импортированного сертификата:

  1. Нажмите комбинацию клавиш Win+R
  2. В окне Выполнить ввести certlm.msc

  3. Нажмите ОК
  4. Выберите в появившемся окне Сертификаты > Личное > Сертификаты

  5. В открывшемся списке будет сертификат с именем, совпадающим с вашим ClientId

Начиная с версии 2.4.1.19 в СБП добавлена проверка сертификата сервера Сбербанка.

Для проверки сертификата безопасности сервера Сбербанка:

  1. Установите сертификаты в систему Windows. Gодробное описание на странице https://www.sberbank.com/ru/certificates.

    или
  2. Укажите в конфигураторе путь к файлу, содержащему Доверенные сертификаты:
    1. Скачайте файл с сертификатами с сайта СберБанка: https://developers.sber.ru/docs/ru/sberbusinessapi/certificates?tool=PEM
    2. Укажите скаченный файл в конфигураторе
    3. Нажмите Сохранить настройки

Каждого из пунктов достаточно, чтобы проверка прошла, но лучше выполнять обе настройки, т.к. в случае ошибок при проверке сертификата сервера вся интеграция работать не будет.

Настройка приложенияLink to Настройка приложения

Для подписки приложения на продукт:

  1. Перейдите в каталог продуктов Сбера и найдите продукт Плати QR
  2. Нажмите на кнопку Подключить
    Обратите внимание: если вы не авторизованы или у вас не подписан договор, кнопка Подключить будет недоступна
  3. Выберите тариф — QR-код Продавца SberPay QR и СБП и нажмите на кнопку Далее
  4. Выберите приложение, которое было создано ранее и нажмите на кнопку Далее
  5. Проверьте настройки и нажмите на кнопку Подключить

Готово, продукт Плати QR подключен. Теперь он появился в разделе личного кабинета в Подписки. В разделах Ключи и Сертификаты доступна информация по ClientID и ClientSecret и по статусу сертификата.

Настройка конфигуратора QR продавцаLink to Настройка конфигуратора QR продавца

Из папки SberPayQr farcards запустите приложение SberPayQRConfigurator.exe и выполните следующие настройки:

  1. Заполните на вкладке Настройки поля в блоке СБП, которые выдаются банком:

    1. Идентификатор клиента — MemberId

    2. Идентификатор устройства — IdQr

    3. Идентификатор терминала — Tid

    4. Идентификатор приложения — Client Id

    5. Пароль приложения — Client secret

  2. В блоке Подключение:
    • IP — IP, на котором расположен кассовый сервер
    • Порт — порт, указанный в свойствах кассового сервера в поле HTTP Data Port
    • Пользователь — укажите имя работника с ролью, у которой есть привилегия HTTP-порт
    • Пароль — укажите пароль работника
      После указания данных нажмите на кнопку Проверить подключение. Если все заполнено верно, то вы увидите информационное окно с версией r_keeper, а также разблокируется блок Дополнительно. 
  3. В блоке Дополнительно укажите:
    • Интерфейс Farcards — укажите ранее созданный интерфейс
    • Валюта для оплаты — укажите ранее созданную валюту QR продавца
    • Скидка — укажите ранее созданную валюту QR продавца
    • Причина внесения предоплаты — укажите причину внесения предоплаты
    • Кассир — укажите кассира, который будет работать с плати QR
    • Станция для оплаты — укажите станцию, на которой будет прием платежей с помощью QR продавца

    • Код документа для печати qr-кода — укажите код ранее созданного макета.

      Заполняя настройки в блоке Дополнительно, используйте кнопку с тремя точками для выбора из списка настроенных параметров. При введении настроек вручную данные не будут считаны.

      Все поля обязательны для заполнения. 

  4. Перейдите на вкладку Лицензия:
    1. Укажите Логин Дилера и Пароль
    2. Нажмите на кнопку Проверить лицензию
      • Если лицензия не была приобретена заранее или не активирована, то система выдаст ошибку 
      • Если лицензия найдена, то система сообщит ее данные — название лицензии, ID и дата окончания лицензии
      • Если у вас есть несколько активных лицензий на продукт — применится лицензия с большим сроком действия.
  5. Нажмите на кнопку Сохранить настройки.

Готово, система QR Продавца от Сбера настроена.