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

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

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


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

| Для чего | Что проверить в разрешениях сервиса |
|---|---|
| Сверка организации и её счетов | GET_CLIENT_ACCOUNTS, accounts, inn, orgKpp, orgFullName, openid |
| Импорт контрагентов | GET_CORRESPONDENTS |
| Импорт выписки | GET_STATEMENT_ACCOUNT и GET_STATEMENT_TRANSACTION |
Запрашивайте только необходимые возможности. Не включайте выписки как способ обойти отказ импорта контрагентов. Права банковского пользователя, разрешения сервиса и выбранные в TesLab возможности должны соответствовать друг другу. Описание входа и выдачи токенов: авторизация Sber API.
4. Получить клиентский TLS-контейнер
- В карточке сервиса найдите выпуск TLS-сертификата и нажмите «Сгенерировать TLS-сертификат».
- Задайте и сохраните пароль контейнера, подтвердите выпуск. Скачайте контейнер PKCS#12 (.p12) с закрытым ключом.
- Сохраните цепочку сертификатов. Ответственный за сервер TesLab должен проверить доверенные сертификаты Сбера и Минцифры и доступность банковского API.
- Сверьте, что контейнер, Client ID и Client Secret принадлежат одному сервису и одной среде. Тестовый контейнер не подходит для промышленной связи.



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

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

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

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

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

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