Подключение Т-Банка к свóдно по 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. Отзовите старый токен в кабинете банка.

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