Добавить самозанятого по реквизитам

/api/v1/self-employed/recipients/add/by-requisites

POST

https://business.tbank.ru/openapi/api/v1/self-employed/recipients/add/by-requisites

Метод для добавления самозанятых по реквизитам.

Запрос асинхронный — его результат можно получить через вызов метода Получить результат добавления самозанятого по реквизитам, передав в нем соответствующий correlationId.

Авторизация

Security

Bearer API Token

RPS

Ограничение — 1 запрос в секунду

Scopes

Выплаты самозанятым → Добавление и получение информации о самозанятых компании с ИНН {inn} и КПП {kpp}

Запрос

Header parameters

X-Request-Id

String<uuid>

Уникальный идентификатор для трассировки запроса. Не влияет на логику исполнения запроса.

Request body schema application/json

Required

correlationId

String<uuid>

Идентификатор, связывающий запрос создания с запросом получения ответа.

Required

recipients

Array of objects ()

Requirements: <= 2000 items

Список самозанятых на добавление.

Required

number

Integer

Идентификатор самозанятого на стороне клиента.

Required

firstName

String

Requirements: <= 100 characters

Имя (кириллица).

Required

lastName

String

Requirements: <= 100 characters

Фамилия (кириллица).

middleName

String

Requirements: <= 100 characters

Отчество (кириллица).

mobileNumber

String

Requirements: <= 50 characters

Номер мобильного телефона.

inn

String

Requirements: <= 50 characters

ИНН.

Required

bankInfo

Object

Данные о счете.

bankBic

String

Requirements: <= 50 characters

БИК банка. По умолчанию — Т-Банк.

Required

accountNumber

String

Requirements: <= 50 characters

Номер счета.

Ответ

200

Успешный запрос

400

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

401

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

403

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

422

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

429

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

500

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

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

Обратиться в поддержку

Получить консультацию по интеграции

Интеграция

Прямая (H2H)Партнерская

Сценарий использования

Работа с самозанятыми

Связанный метод

Получить результат добавления самозанятого по реквизитам

Пример запроса

Payload

cURL

Go

Java

NodeJs

PHP

Python

Content type

application/json

{

"correlationId":

"3fa85f64-5717-4562-b3fc-2c963f66afa6",

"recipients": [

{ ... }

"number":

0,

"firstName":

"string",

"lastName":

"string",

"middleName":

"string",

"mobileNumber":

"string",

"inn":

"string",

"bankInfo": {

"bankBic":

"string",

"accountNumber":

"string"

}

}

]

}

Пример ответа

200

400

401

403

422

429

500

Content type

application/json

{

"correlationId":

"17de62bb-e448-45b1-a670-d71cf0d60785"

}