Перейти к основному содержимому

Отправить запрос на подключение самозанятого к Т-Банку

/api/v1/self-employed/taxpayers/{inn}/bind

POST

https://secured-openapi.tbank.ru/api/v1/self-employed/taxpayers/{inn}/bind

Метод для отправки запроса самозанятому на подключение к Т-Банку.

⚠️ Вызовы метода платные. Чтобы ознакомиться с тарифами, напишите на smz_fns_team@tinkoff.ru.

Самозанятый получит уведомление в сервисе «Мой налог». Если он его примет, Т-Банк сможет проверять его статус, формировать чеки и выполнять другие операции от его имени в налоговой.

Успешный ответ на вызов метода не гарантирует, что подключение самозанятого завершится успешно. Вызов метода инициирует процесс подключения, который может завершиться с ошибкой — например, из-за недоступности сервисов ФНС. В таком случае метод Получить статус самозанятого возвращает INTERNAL_ERROR в поле reason объекта application, и попытку подключения самозанятого нужно повторить.

Чтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/taxpayers/bindПривязка самозанятых к Т-Банку.

Ограничение на использование метода — 1 запрос в секунду.

Авторизация

Security

Bearer API Token

Запрос

Path parameters

Required

inn

String

Requirements: Value must match regular expression ^(\d{12})$

ИНН

Header parameters

Required

Idempotency-Key

String<uuid>

Ключ идемпотентности. Подробнее.

Request body schema application/json

Required

firstName

String

Имя самозанятого.

Required

lastName

String

Фамилия самозанятого.

middleName

String

Отчество самозанятого.

Required

phoneNumber

String

Requirements: Value must match regular expression ^((\+[0-9])([0-9]){6,14})$

Номер телефона самозанятого.

Ответ

200

OK

400

Некорректный запрос

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Loading...

openapi@tinkoff.ru

АО «Тинькофф Банк» использует файлы «cookie», с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.