Решения

Настройка API Сбербанка для загрузки выписок

19 марта 2025
10 мин.

Нет времени читать?

Отправим материал вам на почту

Статья в разработке

Доступно начиная с релиза 2.8.2.

Содержание

  1. Введение
  2. Настройка на стороне банка
    1. Создание пользователя в СберБизнес
    2. Подключение Sber API
  3. Настройка интеграции в программе
    1. Создание интеграции с банком
    2. Параметры сервиса
    3. Настройка подключения
    4. Авторизация
    5. Загрузка сертификатов
    6. Тест подключения
    7. Настройка регламентного задания
    8. Уведомление о новых платежах

 

Введение

В текущей статье представлено описание подключения и настройки интеграции для загрузки выписок через API Сбербанка. См. основную статью “Автоматическая загрузка банковских выписок”.

Настройка на стороне банка

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

1. Создание пользователя в СберБизнес

Важно! Рекомендуется добавить нового пользователя с ограниченными правами – доступ к сервису будет определяться по данному сотруднику, интеграция будет работать под его правами.

Для создания пользователя потребуются e-mail и телефон.

Шаг 1. Перейдите в личный кабинет

В ЛК в верхнем меню справа откройте профиль пользователя и перейдите в раздел Моя организация → Пользователи и сотрудники:

Автозагрузка выписок - Сбер - Компания в СберБизнес

Нажмите кнопку “Новый сотрудник”:

Автозагрузка выписок - Сбер - Новый сотрудник

Шаг 2. Внесите данные о сотруднике

В разделе “Возможности сотрудника” выберите пункт “Предоставить доступ в интернет-банк”:

Автозагрузка выписок - Сбер - Создание нового сотрудника

Заполните блок “Информация о сотруднике”:

Автозагрузка выписок - Сбер - Создание Сотрудника - Информация

Заполните блок “Документы”:

Автозагрузка выписок - Сбер - Создание Сотрудника - Документы

Нажмите кнопку “Далее”. При этом производится переход на следующую вкладку – “Добавление пользователя”.

Шаг 3. Настройте параметры для доступа в интернет-банк

Заполните следующие параметры:

1) Укажите телефон для входа и электронную почту – эти данные будут использоваться для авторизации. Телефон и почта должны быть ранее не использованными для регистрации пользователей:

Автозагрузка выписок - Сбер - Добавление пользователя

2) Выберите роль пользователя в системе – рекомендуется выбрать роль “Бухгалтер”:

Автозагрузка выписок - Сбер - Добавление пользователя - Выбор роли

Настройте доступ к счетам.

Нажмите кнопку “Далее”.

После настройки информация по созданному пользователю будет иметь следующий вид:

Автозагрузка выписок - Сбер - Настройки пользователя

Шаг 4. Отправьте заявление в банк

На странице с заявлением проверьте все данные. Подпишите заявление с помощью СМС-кода или электронного ключа (токена) и отправьте в банк.

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

2. Подключение Sber API

Перейдите в раздел “Все продукты и услуги” → блок “Сбербанк API”:

Автозагрузка выписок - Сбер - Переход к настройкам API

В ЛК Sber API скопируйте параметры Client_id и Client_secret и сгенерируйте сертификат:

Автозагрузка выписок - Сбер - Сертификаты

Сертификат в формате .p12 необходимо скачать, после из загруженного файла получить приватный ключ и клиентский сертификат. Это можно сделать с помощью утилиты OpenSSL – см. статью “Подключение SberPay QR/Плати QR”. В случае возникновения сложностей, обратитесь в техподдержку 5SYSTEMS.

Полученные приватный ключ и клиентский сертификат необходимо будет загрузить в программу при дальнейшей настройке – см. далее.

Настройка интеграции в программе

1. Создание интеграции с банком

Описание общих настроек подключения загрузки выписок через API для всех банков см. в статье “Автоматическая загрузка банковских выписок”.

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

     ●  Наименование интеграции – заполняется автоматически после выбора обработчика подключения, при необходимости можно изменить;
     ●  Вид интеграции – выбрать “Сбербанк”;
     ●  Обработчик подключения – выбрать обработчик “Сбербанк API Загрузка выписок”;
     ●  Установить галочку “Включено”;
     ●  Записать изменения.

2. Параметры сервиса

На вкладке “Параметры сервиса” необходимо задать параметр “Интеграция с API 5S AUTO” и сохранить изменения – см. в статье “Автоматическая загрузка банковских выписок”.

3. Настройка подключения

На вкладке “Тест подключения” следует перейти к добавлению настройки подключения по кнопке “Методы интеграции → Настройки”:

API Загрузка выписок - Настройки Сбер

Сначала необходимо добавить новую настройку подключения:

API Загрузка выписок - Настройка подключения - Сбер

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

     ●  Наименование – наименование интеграции с API Сбербанка;
     ●  Описание – описание аккаунта;
     ●  ClientId и ClientSecret – параметры из ЛК Sber API, полученные при настройке сервиса на стороне банка – см. выше.

4. Авторизация

Затем требуется пройти авторизацию – для этого следует нажать кнопку “Авторизоваться”, при этом открывается QR-код:

API Загрузка выписок - Авторизация Сбер

Необходимо перейти на страницу авторизации через сканирование QR-кода, либо нажать кнопку “Открыть ссылку в браузере”, либо скопировать ссылку нажатием кнопки “Скопировать” и открыть ее в браузере:

API Загрузка выписок - Авторизация Сбер

Требуется ввести учетные данные ЛК Сбербанка.

В результате устанавливается постоянное подключение к банку, после чего можно запрашивать банковские выписки в автоматическом режиме.

5. Загрузка сертификатов

Для интеграции с API Сбербанка для загрузки выписок необходимо загрузить файлы сертификата и личного ключа, полученные из скачанного в ЛК файла сертификата .p12 на этапе настройки сервиса на стороне банка – см. выше:

API Загрузка выписок - Загрузка сертификатов

После выбора файлов сертификата и ключа нажать кнопку “Загрузить”:

API Загрузка выписок - Сертификаты загружены

6. Тест подключения

После произведенных настроек следует сделать тест подключения – см. в статье “Автоматическая загрузка банковских выписок”.

7. Настройка регламентного задания

Настройка регламентного задания позволяет:

     ●  настроить расписание, по которому будет работать регламентное задание либо запустить вручную при необходимости;
     ●  выбрать один из двух режимов загрузки;
     ●  задать расчетные счета компании, по которым нужно загружать выписки.

Для настройки следует на вкладке “Тест подключения” перейти в Методы интеграции → Настройки регламентного задания – подробнее см. в статье “Автоматическая загрузка банковских выписок”.

8. Уведомление о новых платежах

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

Если не определен документ-основание, то уведомление о загрузке выписки без указания документа будет приходить пользователям со следующими должностями, указанными в сведениях адресации: Бухгалтер, Кассир, Управляющий директор и Финансовый директор. 

Для пользователей следует настроить способы оповещения.

Подробнее см. в статье “Автоматическая загрузка банковских выписок”.

 

кнопка вверх

  • Необязательно:

  • Уточните, пожалуйста, почему: