Актуальную версию документа см. на сайте Министерства цифрового развития, связи и массовых коммуникаций Российской Федерации по адресу https://digital.gov.ru/ru/documents/6186/.
"Методические рекомендации по использованию Единой системы идентификации и аутентификации. Версия 2.84" (приложение 17 к протоколу заседания Подкомиссии по использованию информационных технологий при предоставлении государственных и муниципальных...

Б.12.2 Сервис REST API безусловного добавления сотрудников в организацию

Возможно присоединение к организации только подтвержденных УЗ сотрудников.

Осуществляется поиск присоединяемого сотрудника по СНИЛС (из перечня в теле запроса) с последующей проверкой на совпадение ФИО (из тела запроса и найденной УЗ).

Адрес метода:

URL: esia-rs/api/public/v1/orgs/{org_oid}/invts/force

Входные параметры

На вход сервис должен получать коллекцию объектов, описывающих УЗ пользователей, которых необходимо добавить в организацию без отправки приглашения на e-mail.

Параметры из URL:

org_oid - идентификатор организации, в которую нужно добавлять УЗ пользователей;

Параметры тела запроса:

firstName - имя;

lastName - фамилия;

middleName - отчество;

snils - СНИЛС

По умолчанию, максимальное количество пользователей в одном запросе 100.

HTTP метод: POST

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

POST esia-rs/api/public/v1/orgs/1000000001/invts/force HTTP/1.1

Host: esia-portal1.test.gosuslugi.ru

Authorization: Bearer

eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlciI6MX0eyJleHAiOjE0NDY

yMTU2ND

Content-Type: application/json

Cache-Control: no-cache

[

{

"snils": "000-000-000 01",

"firstName": "Михаил",

"lastName": "Иванов",

"middleName": "Иванович"

},

{

"snils": "000-000-000 01",

"firstName": "Петр",

"lastName": "Петров",

"middleName": "Петрович"

},

{

"snils": "000-000-0 01",

"firstName": "Вадим",

"lastName": "Вадимов",

"middleName": "Вадимович"

},

{

"snils": "000-000-000 99",

"firstName": "Николай",

"lastName": "Николаев",

"middleName": "Николаевич"

}

]

Данные в ответе с результатом будут отсортированы в том же порядке, как и при запросе.

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

{

"message": "Success|Partial success|Fail",

"results": [

{ "snils":"000-000-000 01", "message": "Success"},

{ "snils":"000-000-000 02", "message": "Success"},

{ "snils":"000-000-0 01", "message": "ESIA-036101"},

// ... ответ будет отсортирован в том же порядке, как и при запросе

{ "snils":"000-000-000 99", "message": "Success"}

]

}

Перечень возможных возвращаемых ошибок:

Код

Описание

ESIA-038000

Организация не найдена

ESIA-036101

Некорректный формат СНИЛС

ESIA-036102

Неверная контрольная сумма СНИЛС

ESIA-020002

Пользователь не найден

ESIA-039951

Пользователь уже присоединен к организации

ESIA-039961

Пользователь, учетная запись которого найдена по указанному в запросе СНИЛС, не является сотрудником организации, org_oid которой указан в запросе

Требуемый scope:

org_invts_force?org_oid={p.org_oid}&mode=w

Удаление центра обслуживания Б.12.3 Сервис Rest api получения списка ЦО организации