Настройка API Сбербанка для загрузки выписок
Статья в разработке
Доступно начиная с релиза 2.8.2.
Содержание
Введение
В текущей статье представлено описание подключения и настройки интеграции для загрузки выписок через API Сбербанка. См. основную статью “Автоматическая загрузка банковских выписок”.
Настройка на стороне банка
Предварительно для настройки автоматической загрузки банковских выписок через API Сбербанка необходимо быть зарегистрированным в СберБизнес, иметь личный кабинет.
1. Создание пользователя в СберБизнес
Важно! Рекомендуется добавить нового пользователя с ограниченными правами – доступ к сервису будет определяться по данному сотруднику, интеграция будет работать под его правами.
Для создания пользователя потребуются e-mail и телефон.
Шаг 1. Перейдите в личный кабинет
В ЛК в верхнем меню справа откройте профиль пользователя и перейдите в раздел Моя организация → Пользователи и сотрудники:
Нажмите кнопку “Новый сотрудник”:
Шаг 2. Внесите данные о сотруднике
В разделе “Возможности сотрудника” выберите пункт “Предоставить доступ в интернет-банк”:
Заполните блок “Информация о сотруднике”:
Заполните блок “Документы”:
Нажмите кнопку “Далее”. При этом производится переход на следующую вкладку – “Добавление пользователя”.
Шаг 3. Настройте параметры для доступа в интернет-банк
Заполните следующие параметры:
1) Укажите телефон для входа и электронную почту – эти данные будут использоваться для авторизации. Телефон и почта должны быть ранее не использованными для регистрации пользователей:
2) Выберите роль пользователя в системе – рекомендуется выбрать роль “Бухгалтер”:
Настройте доступ к счетам.
Нажмите кнопку “Далее”.
После настройки информация по созданному пользователю будет иметь следующий вид:
Шаг 4. Отправьте заявление в банк
На странице с заявлением проверьте все данные. Подпишите заявление с помощью СМС-кода или электронного ключа (токена) и отправьте в банк.
После проверки заявления на указанную электронную почту поступит письмо, а также СМС-код на указанный номер, после чего можно будет войти в систему.
2. Подключение Sber API
Перейдите в раздел “Все продукты и услуги” → блок “Сбербанк API”:
В ЛК Sber API скопируйте параметры Client_id и Client_secret и сгенерируйте сертификат:
Сертификат в формате .p12 необходимо скачать, после из загруженного файла получить приватный ключ и клиентский сертификат. Это можно сделать с помощью утилиты OpenSSL – см. статью “Подключение SberPay QR/Плати QR”. В случае возникновения сложностей, обратитесь в техподдержку 5SYSTEMS.
Полученные приватный ключ и клиентский сертификат необходимо будет загрузить в программу при дальнейшей настройке – см. далее.
Настройка интеграции в программе
1. Создание интеграции с банком
Описание общих настроек подключения загрузки выписок через API для всех банков см. в статье “Автоматическая загрузка банковских выписок”.
При добавлении новой интеграции со Сбербанком для загрузки выписок следует ввести следующие реквизиты:
● Наименование интеграции – заполняется автоматически после выбора обработчика подключения, при необходимости можно изменить;
● Вид интеграции – выбрать “Сбербанк”;
● Обработчик подключения – выбрать обработчик “Сбербанк API Загрузка выписок”;
● Установить галочку “Включено”;
● Записать изменения.
2. Параметры сервиса
На вкладке “Параметры сервиса” необходимо задать параметр “Интеграция с API 5S AUTO” и сохранить изменения – см. в статье “Автоматическая загрузка банковских выписок”.
3. Настройка подключения
На вкладке “Тест подключения” следует перейти к добавлению настройки подключения по кнопке “Методы интеграции → Настройки”:
Сначала необходимо добавить новую настройку подключения:
Для Сбербанка необходимо задать следующие параметры подключения:
● Наименование – наименование интеграции с API Сбербанка;
● Описание – описание аккаунта;
● ClientId и ClientSecret – параметры из ЛК Sber API, полученные при настройке сервиса на стороне банка – см. выше.
4. Авторизация
Затем требуется пройти авторизацию – для этого следует нажать кнопку “Авторизоваться”, при этом открывается QR-код:
Необходимо перейти на страницу авторизации через сканирование QR-кода, либо нажать кнопку “Открыть ссылку в браузере”, либо скопировать ссылку нажатием кнопки “Скопировать” и открыть ее в браузере:
Требуется ввести учетные данные ЛК Сбербанка.
В результате устанавливается постоянное подключение к банку, после чего можно запрашивать банковские выписки в автоматическом режиме.
5. Загрузка сертификатов
Для интеграции с API Сбербанка для загрузки выписок необходимо загрузить файлы сертификата и личного ключа, полученные из скачанного в ЛК файла сертификата .p12 на этапе настройки сервиса на стороне банка – см. выше:
После выбора файлов сертификата и ключа нажать кнопку “Загрузить”:
6. Тест подключения
После произведенных настроек следует сделать тест подключения – см. в статье “Автоматическая загрузка банковских выписок”.
7. Настройка регламентного задания
Настройка регламентного задания позволяет:
● настроить расписание, по которому будет работать регламентное задание либо запустить вручную при необходимости;
● выбрать один из двух режимов загрузки;
● задать расчетные счета компании, по которым нужно загружать выписки.
Для настройки следует на вкладке “Тест подключения” перейти в Методы интеграции → Настройки регламентного задания – подробнее см. в статье “Автоматическая загрузка банковских выписок”.
8. Уведомление о новых платежах
При включении интеграции автоматически подключается уведомление о загрузке банковской выписки, которое будет приходить в программе автору документа-основания и менеджеру, указанному в документе.
Если не определен документ-основание, то уведомление о загрузке выписки без указания документа будет приходить пользователям со следующими должностями, указанными в сведениях адресации: Бухгалтер, Кассир, Управляющий директор и Финансовый директор.
Для пользователей следует настроить способы оповещения.
Подробнее см. в статье “Автоматическая загрузка банковских выписок”.
-
Необязательно:
-
Уточните, пожалуйста, почему: