Создать черновики анкет самозанятых

POST

https://business.tbank.ru/openapi/api/v1/self-employed/recipients/create

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

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

Чтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/recipients/manage — Добавление и получение информации о самозанятых компании с ИНН {inn} и КПП {kpp}.

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

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

Required

correlationId

String<uuid>

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

recipients

Array of objects ()

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

Required

number

Integer<int32>

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

Required

firstName

String

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

Required

lastName

String

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

middleName

String

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

Required

birthDate

String<date>

Дата рождения.

Required

birthPlace

String

Место рождения.

Required

citizenship

String

Гражданство.

String

Электронная почта.

latinFirstName

String

Имя (латиница).

latinLastName

String

Фамилия (латиница).

phones

Array of objects ()

Мобильный телефон.

Required

type

String (CreatePhoneType)

Requirements: [Мобильный, По месту жительства, Рабочий]

Тип телефона.

Required

number

String

Номер телефона.

addresses

Array of objects ()

Адреса места жительства и регистрации.

Required

type

String (CreateAddressType)

Requirements: [Жительства, Регистрации]

Тип адреса.

country

String

Страна.

Required

postalCode

String

Индекс.

Required

state

String

Регион.

city

String

Город.

district

String

Район.

settlement

String

Населённый пункт.

street

String

Улица.

house

String

Дом.

building

String

Здание.

construction

String

Корпус.

apartment

String

Квартира.

documents

Array of objects ()

Для граждан РФ укажите данные паспорта.

Для иностранных граждан укажите:

Один из основных документов — «Иностранный паспорт», «Загр. паспорт иностранного гр.», «Служебный/официальный паспорт», «Дипломатический паспорт».
Один из миграционных документов — «Миграционная карта», «Разр. на временное проживание», «Вид на жительство».

Required

type

String (CreateDocumentType)

Requirements: [Паспорт, Иностранный паспорт, Загр. паспорт иностранного гр., Служебный/официальный паспорт, Дипломатический паспорт, Миграционная карта, Разр. на временное проживание, Виза, Вид на жительство]

Тип документа.

Required

serial

String

Серия.

number

String

Номер документа.

Required

date

String<date>

Дата.

Required

organization

String

Кем выдан.

division

String

Код подразделения.

expireDate

String<date>

Дата истечения.

registrationInfo

Object (CreateSelfEmployedRegistrationInfo)

Если значение передано, Т-Банк поставит исполнителя на учёт как самозанятого. Функция доступна клиентам, которые получили от исполнителей согласие на регистрацию.

Required

oktmo

String

ОКТМО.

Required

activityCodes

Array

Коды активностей.

Ответ

200

400

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

401

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

403

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

422

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

429

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

500

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

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

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

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