Подключение Т-Банка к свóдно по API

После этой настройки свóдно будет каждый день сам подтягивать операции по счетам Т-Банка (Т-Бизнес) и строить из них движение денег, платёжный календарь, казначейство и сверку с бухгалтерией — без выгрузки выписок вручную.

Важно: доступы токена вы выбираете сами. Для учёта хватает чтения: свóдно видит операции и остатки, а менять в банке ничего не может. Если вы платите через казначейство свóдно, добавьте платёжные доступы. Тогда свóдно готовит черновик платёжки, а подписываете его вы сами в Т-Бизнесе. Отозвать доступ можно в любой момент.

Если по ходу что-то непонятно, напишите на support@svodno.ai или в чат кабинета свóдно.

Сколько времени займёт

5–10 минут. Всё делается в двух окнах: кабинет Т-Бизнеса (там вы выпускаете токен) и свóдно (туда вы этот токен вставляете). Программист и помощь банка не нужны.

Шаг 1. Выпустите API-токен в Т-Бизнесе

1. Зайдите в кабинет Т-Бизнеса под пользователем с правами администратора.
2. Откройте раздел «Интеграции» → вкладка «T-API».
3. Нажмите «Выпустить токен».

Шаг 2. Выдайте токену доступы

Раскройте блок «Выберите, к чему будет доступ через API». Набор пунктов зависит от того, как вы работаете.

Только выписка. Хватит двух доступов:

• «Информация о счетах компании»
• «Информация об операциях компании»

Выписка и платежи из казначейства свóдно. К первым двум добавьте в разделе «Платежи» ещё два:

• «Создание черновиков платежей в компании с ИНН … и КПП …»
• «Получение списка статусов платежных документов»

Второй пункт нужен, чтобы свóдно показывала судьбу отправленного документа: ждёт подписи, подписан, исполнен.

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

Шаг 3. Пропишите IP сервера свóдно

Т-Банк по умолчанию принимает запросы токена только с доверенного адреса — так безопаснее. В поле IP-адреса при выпуске токена укажите адрес сервера свóдно:

91.218.112.145

Не хотите привязку к IP? Директор компании может отключить проверку письмом на openapi@tbank.ru (укажите ИНН). После этого перевыпустите токен без привязки к адресу.

Шаг 4. Вставьте токен в свóдно

1. В свóдно откройте «Настройки → Интеграции → Каталог» и выберите категорию «Банки / Платежи».
2. Нажмите карточку «Т-Банк».
3. Заполните три поля: Название (например, «Т-Банк — основной счёт»), API токен (тот, что выпустили на Шаге 1) и ИНН организации или ИП.
4. Нажмите «Подключить».

Что будет дальше

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

Если счетов несколько — свóдно подтянет их все по одному токену. Если счета в разных юрлицах — выпустите токен в каждом и подключите отдельно, свóдно объединит всё в единую картину.

Если токен уже выпущен

Доступы у готового токена не меняются, Т-Банк такого не умеет. Нужен новый токен с полным набором прав. Порядок, при котором загрузка операций не встанет:

1. Выпустите новый токен и отметьте все нужные доступы.
2. Замените токен в свóдно.
3. Проверьте, что счета и операции подтянулись.
4. Отзовите старый токен в кабинете банка.

Отзовёте старый первым, и операции перестанут приходить до момента, пока не вставите новый.