Создать сотрудников для ESOP

POST

https://secured-openapi.tbank.ru/api/v1/esop/employees

Метод принимает список сотрудников для создания в программе ESOP и возвращает список созданных сотрудников с их ID.

Авторизация

Security

Bearer API Token

MTLS-сертификат

RPS

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

Scopes

ESOP → Работа с API системы ESOP

Запрос

Header parameters

X-Request-Id

String<uuid>

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

Request body schema application/json

Required

employees

Array of objects ()

Requirements: <= 2000 items

Данные сотрудника.

integrationId

String<string>

Requirements: non-empty and <= 36 characters

Идентификатор сотрудника в системе клиента.

Required

firstName

String<string>

Имя сотрудника.

Required

lastName

String<string>

Фамилия сотрудника.

middleName

String<string>

Отчество сотрудника.

birthDate

String<date>

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

passportSeries

String<string>

Серия паспорта сотрудника.

passportNumber

String<string>

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

hostCountryCode

String<string>

Default: 643

ISO 3166-1 код страны.

Required

phoneNumber

String<string>

Номер телефона сотрудника.

String<string>

Электронная почта сотрудника. Стандарты — RFC 5321, RFC 5322.

defaultBrokerAccountId

String<string>

Requirements: non-empty and <= 36 characters

Номер брокерского счета сотрудника.

Required

isRuResident

Boolean

Default:

Сотрудник является резидентом РФ.

Ответ

200

400

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

401

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

403

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

422

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

429

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

500

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

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

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