Подключение своей организации к СберБизнес

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

Личный кабинет

Подключение своей организации к СберБизнес

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

Перед началом: подключение выполняет сотрудник с доступом к конфигурации организаций и отдельным правом «Sber API: выписка и корреспонденты». В банке нужны полномочия на оформление сервиса. Если в TesLab нет кнопок «Подготовить подключение» и «Обновить состояние», сначала согласуйте с администратором обновление клиента и сервера.

В этой статье

Подготовить сервис в кабинете Сбера

1. Проверить доступ и выбрать набор

У организации должен быть действующий договор дистанционного банковского обслуживания. Открытие кабинета и подписание заявления могут требовать разных полномочий. Заявление подписывает руководитель с подходящим правом подписи либо уполномоченный пользователь. Для передачи подготовки разработчику используйте предусмотренную банком роль, не передавайте ему свою учётную запись.

Для интеграции своей организации обычно выбирают набор «Компаниям». «Холдингам» предназначен для группы компаний, «Платформам» относится к обслуживанию других организаций. Один набор «СберБизнес ID» не предоставляет операции получения выписок. Состав выбранного набора проверьте в перечне Sber API.

2. Найти Sber API и оформить подключение

  1. Войдите в СберБизнес под уполномоченной учётной записью нужной организации.
  2. В левом меню откройте «Все продукты и услуги». В каталоге выберите категорию «Сбербанк API», затем «Sber API».

Переход из меню СберБизнес к Sber API

1. «Все продукты и услуги». 2. Карточка «Sber API» в категории «Сбербанк API».

  1. Нажмите «Подключить» в карточке продукта.

Кнопка подключения Sber API в каталоге банка

1. Начало оформления Sber API.

  1. На шаге «Выбор API» отметьте согласованный набор, для собственной организации проверьте «Компаниям», и нажмите «Продолжить».
  2. На шаге «Создание заявления» проверьте контактные данные и ответственного. Уполномоченный сотрудник проверяет условия, подписывает и отправляет заявление на следующем шаге мастера.
  3. После оформления откройте сервис в кабинете Sber API. Если он ещё не активен, нажмите «Активировать». Для уже оформленного сервиса начните с его карточки, повторное первичное заявление не требуется.

Выбор набора API в мастере подключения банка

1. Набор «Компаниям». 2. Продолжение оформления.

Активация сервиса в кабинете Sber API

1. Активация оформленного сервиса.

Названия и расположение банковских элементов могут меняться. При отличиях сверяйтесь с инструкцией личного кабинета Sber API. Отсутствие кнопки оформления или подписи сначала проверьте с ответственным за банковские полномочия.

3. Подготовить Client ID, Client Secret и Redirect URI

  1. В карточке промышленного сервиса откройте «Параметры промышленного сервиса». Сохраните Client ID и Client Secret в защищённом месте. Не отправляйте их в переписке со скриншотами.
  2. В TesLab откройте сохранённую свою организацию и скопируйте значение «Redirect URI для кабинета Сбера» из блока «СберБизнес». При необходимости нажмите «Обновить состояние».
  3. В настройках сервиса банка укажите этот точный HTTPS-адрес возврата. Он относится к серверу вашей установки TesLab. Не подставляйте адрес приложения, адрес из примера или маску со звёздочкой.
  4. В разрешениях сервиса проверьте операции API v2 для нужных возможностей. Одно наличие параметров в карточке ещё не означает, что все операции разрешены.

Параметры сервиса Sber API: Client ID, Client Secret и адрес возврата

1. Client ID. 2. Client Secret. 3. Redirect URI. Значения на изображении служат примером, используйте параметры своего сервиса.

Для чегоЧто проверить в разрешениях сервиса
Сверка организации и её счетовGET_CLIENT_ACCOUNTS, accounts, inn, orgKpp, orgFullName, openid
Импорт контрагентовGET_CORRESPONDENTS
Импорт выпискиGET_STATEMENT_ACCOUNT и GET_STATEMENT_TRANSACTION

Запрашивайте только необходимые возможности. Не включайте выписки как способ обойти отказ импорта контрагентов. Права банковского пользователя, разрешения сервиса и выбранные в TesLab возможности должны соответствовать друг другу. Описание входа и выдачи токенов: авторизация Sber API.

4. Получить клиентский TLS-контейнер

  1. В карточке сервиса найдите выпуск TLS-сертификата и нажмите «Сгенерировать TLS-сертификат».
  2. Задайте и сохраните пароль контейнера, подтвердите выпуск. Скачайте контейнер PKCS#12 (.p12) с закрытым ключом.
  3. Сохраните цепочку сертификатов. Ответственный за сервер TesLab должен проверить доверенные сертификаты Сбера и Минцифры и доступность банковского API.
  4. Сверьте, что контейнер, Client ID и Client Secret принадлежат одному сервису и одной среде. Тестовый контейнер не подходит для промышленной связи.

Генерация клиентского TLS-сертификата в кабинете Сбера

1. Выпуск TLS-сертификата для выбранного сервиса.

Пароль контейнера и подтверждение выпуска TLS-сертификата

1. Пароль контейнера. 2. Подтверждение выпуска.

Скачивание контейнера TLS и цепочки сертификатов

1. Контейнер с закрытым ключом. 2. Цепочка сертификатов.

Сертификат действует для одного Client ID. По инструкции Сбера срок его действия составляет 12 месяцев, поэтому заранее предусмотрите замену. Клиентский TLS-контейнер отличается от цепочки доверенных сертификатов, HTTPS-сертификата сайта и электронной подписи специалиста. Если сертификат получен через CSR и поддержку банка, перед загрузкой подготовьте PKCS#12 с соответствующим закрытым ключом. Подробности: TLS-сертификат Sber API.

Выбрать свою организацию в TesLab

  1. Откройте «Компания → Конфигурация → Организации» и нужную существующую запись.
  2. Проверьте связанного контрагента, ИНН и актуальный КПП. При подключении TesLab сверяет их со сведениями банка. Для индивидуального предпринимателя сверяется ИНН.
  3. В блоке «СберБизнес» прочитайте состояние и адрес возврата. Для новой связи нажмите «Подключить Sber API».

Блок СберБизнес в карточке своей организации TesLab

1. Подключение Sber API. 2. Точный адрес возврата для настройки сервиса в банке.

Кнопки доступны у сохранённой организации и при отдельном праве Sber API. Возможность редактировать бланки не даёт это право автоматически. Если кнопки нет, проверьте доступ и состояние записи, не создавайте дубликат организации.

Заполнить параметры подключения

  1. Введите Client ID и Client Secret выбранного сервиса. Вставляйте Client ID целиком, без пробелов и округления.
  2. Выберите «Логин и пароль СберБизнес» либо «Банковский USB-токен (на этом компьютере)» согласно способу входа в банк.
  3. Выберите контейнер TLS (.p12) и введите его пароль. Максимальный размер файла составляет 2 МБ. Сертификат должен действовать на дату подключения.
  4. Отметьте «Импорт контрагентов» и/или «Импорт выписки» в пределах подготовленных банковских разрешений.
  5. Нажмите «Подготовить подключение». При ошибке прочитайте сообщение в окне и проверьте параметры. Успешная подготовка пока не означает завершённую связь с банком.

Параметры подключения СберБизнес в TesLab

1. Client ID и Client Secret. 2. Способ входа. 3. Контейнер TLS. 4. Пароль контейнера. 5. Нужные возможности. 6. Подготовка подключения.

Банковский USB-токен означает способ входа через локальное банковское ПО на подготовленном компьютере. Это не access_token из раздела «Мои ключи». Для такого входа используется локальный адрес http://localhost:28016; без настроенного банковского ПО он не откроется. Для первичного подключения используйте подготовленный компьютер с браузером, не рассчитывайте на аппаратный токен внутри мобильного приложения TesLab.

Завершить вход в банк

  1. После подтверждённой подготовки нажмите «Перейти в банк». Откроется отдельная вкладка.
  2. Войдите согласованным способом. Проверьте организацию и запрашиваемые возможности, завершите банковское подтверждение.
  3. Дождитесь страницы с сообщением об успешном подключении. Вернитесь в карточку организации TesLab, закройте окно подготовки и нажмите «Обновить состояние».

Переход из TesLab к завершению авторизации в банке

1. Переход к банковскому подтверждению подготовленной попытки.

Попытка действует 15 минут и используется один раз. Если срок истёк, вход отменён либо страница вернулась с ошибкой, обновите состояние и подготовьте новую попытку. Не обновляйте многократно старую страницу возврата и не передавайте её URL другим людям. Действующая связь заменяется только после успешного получения токенов и совпадения реквизитов организации.

Проверить состояние и разрешённые операции

Состояние «Сохранено. Доступ к банку сейчас не проверялся» подтверждает наличие сохранённой связи и действующий срок токена. Чтение карточки не выполняет запрос в банк и не подтверждает доступность API, срок TLS-сертификата или право каждой операции. Сообщение об истёкшем токене означает, что его обновление потребуется при запросе.

Сохранённая связь СберБизнес и действия в карточке TesLab

1. Обновление локального состояния. 2. Локальное отключение.

  1. Согласуйте с ответственным первую загрузку нужного вида данных.
  2. Перед запуском проверьте все организации с подключённым Sber API. Команды импорта обходят подключённые организации с соответствующими разрешениями, а не только открытую карточку.
  3. Сверьте организацию, период и результат с банком. Импорт выписок может создавать банковские строки и запускать распределение оплат. Импорт контрагентов также записывает данные.

Успех импорта контрагентов не подтверждает право получать выписки. Плановая загрузка выписок работает на сервере по расписанию, в том числе на 1-й и 31-й минутах часа при штатно запущенном cron. Поэтому подключение согласуйте до включения рабочих загрузок. Подробный порядок, результаты и обработка отказов: выписки Сбер и автоматическая загрузка из писем. Получение банковских писем по IMAP настраивается отдельно.

Обновить параметры или отключить связь

Для замены секрета, контейнера или возможностей нажмите «Новое подключение» и пройдите подготовку и вход заново. До успешного завершения новая попытка не заменяет действующую связь. Если банковский доступ уже отозван или ключ просрочен, сохранение прежней настройки не восстанавливает доступ само по себе.

«Отключить Sber API» требует подтверждения. После операции нажмите «Обновить состояние» и убедитесь, что связь отключена. Удаляются локальные реквизиты связи и незавершённые попытки для организации. Ранее импортированные данные остаются. Отключение в TesLab не закрывает сервис банка и не отзывает банковские разрешения: при необходимости сделайте это отдельно в СберБизнес.

СитуацияЧто проверить
Не удаётся подготовить подключениеClient ID, Secret, нужный PKCS#12, пароль, срок сертификата, хотя бы одну возможность и совпадение среды.
Банк не принимает адрес возвратаТочное значение Redirect URI из TesLab, HTTPS и публичную доступность сервера. Не подбирайте маску наугад.
ИНН или КПП не совпалиВыбранную организацию в обеих системах и актуальные реквизиты связанного контрагента. Не обходите отказ реквизитами другого лица.
Не открывается вход через USB-токенРаботу локального банковского ПО и адреса localhost:28016 на том же компьютере.
Была связь, теперь банк отказываетСрок TLS, актуальность Client Secret, банковские полномочия и разрешения конкретной операции. Передайте ответственному время и текст отказа без секретов и URL возврата.
Не получено подтверждение записи или отключенияЗакройте окно и обновите состояние. Не повторяйте действие вслепую. При повторном отказе обратитесь к администратору.
Загрузка прошла без новых данныхОрганизацию, счета, период, выбранную возможность и результат импорта. Не считайте пустой результат доказательством успешной новой связи.

Официальные материалы Сбера