Создать черновики анкет сотрудников

/api/v1/salary/employees/create

POST

https://business.tbank.ru/openapi/api/v1/salary/employees/create

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

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

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

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

Required

correlationId

String<uuid>

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

employees

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

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

email

String

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

latinFirstName

String

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

latinLastName

String

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

phones

Array of objects ()

Телефон — обязательно укажите мобильный телефон.

Required

type

String (PhoneType)

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

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

Required

number

String

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

addresses

Array of objects ()

Адреса — обязательно укажите адреса жительства, регистрации и работы.

Required

type

String (AddressType)

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 (DocumentType)

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

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

Required

serial

String

Серия.

number

String

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

Required

date

String<date>

Дата.

Required

organization

String

Кем выдан.

division

String

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

expireDate

String<date>

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

Required

jobInfo

Object (CreateJobInfo)

Информация о работе.

Required

position

String

Должность.

Ответ

200

OK

400

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

401

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

403

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

422

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

429

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

500

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

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

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

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

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

Payload

cURL

Go

Java

NodeJs

PHP

Python

Content type

application/json

Гражданин РФ

Иностранный гражданин

Гражданин РФ + Иностранный гражданин

Гражданин РФ

{

"correlationId":

"cf99df08-0829-4614-8da3-0e440fd23fe0",

"employees": [

{ ... }

"number":

1,

"firstName":

"Иван",

"lastName":

"Иванов",

"middleName":

"Иванович",

"birthDate":

"1967-12-25",

"birthPlace":

"Санкт-Петербург",

"citizenship":

"Санкт-Петербург",

"email":

"example@example.com",

"latinFirstName":

"Ivan",

"latinLastName":

"Ivanov",

"phones": [

{

"type":

"Мобильный",

"number":

"+72565121024"

}

],

"addresses": [

{ ... },

"type":

"Работы",

"country":

"Россия",

"postalCode":

"123123",

"state":

"Санкт-Петербург",

"city":

"Санкт-Петербург",

"district":

"Санкт-Петербург",

"settlement":

"Санкт-Петербург",

"street":

"ул. Херсонская",

"house":

"12",

"building":

"1",

"construction":

"1",

"apartment":

"512"

},

{ ... },

"type":

"Жительства",

"country":

"Россия",

"postalCode":

"123123",

"state":

"Санкт-Петербург",

"city":

"Санкт-Петербург",

"district":

"Санкт-Петербург",

"settlement":

"Санкт-Петербург",

"street":

"ул. Таллинская",

"house":

"4",

"building":

"8",

"construction":

"16",

"apartment":

"20"

},

{ ... }

"type":

"Жительства",

"country":

"РОССИЯ",

"postalCode":

"123123",

"state":

"Санкт-Петербург",

"city":

"Санкт-Петербург",

"district":

"Санкт-Петербург",

"settlement":

"Санкт-Петербург",

"street":

"ул. Таллинская",

"house":

"4",

"building":

"8",

"construction":

"16",

"apartment":

"20"

}

],

"documents": [

{ ... }

"type":

"Паспорт",

"serial":

"1234",

"number":

"123456",

"date":

"2015-05-09",

"organization":

"ФМС",

"division":

"123-123",

"expireDate":

"2025-05-09"

}

],

"jobInfo": {

"position":

"программист"

}

}

]

}

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

200

400

401

403

422

429

500

Content type

application/json

{

"correlationId":

"cf99df08-0829-4614-8da3-0e440fd23fe0"

}