Excerpt

Info

Только пользователь с ролью Администратор может управлять Кадровиками.

Под управлением понимаем - назначение и снятие роли Кадрового специалиста

Table of Contents

Управление персоналом

Tip

title	Цель сценариев

Сотрудник с ролью Кадровый специалист отвечает за управление кадровыми процессами.

Кадровые специалисты имеют большой доступ к информации, поэтому важно ограничить возможность назначения роли Кадровик.

Подготовительный этап

API-методы

Примечания

1

1)

Администратор получает список ролей сотрудников

Status


subtle	true
colour	Yellow
title	Gdoc

GET /api/v1/employeeRoles

Справочник ролей это список идентификаторов роли с названием роли.

Так как это редко обновляемый справочник, то нет потребности запрашивать его каждый раз, если организовано хранение этого справочника на стороне Клиента

2

2) Получение полного списка справочника сотрудников

Status


subtle	true
colour	Yellow
title	Gdoc

GET /api/v1/clients/:clientId/employees

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

происходит создание сотрудника сразу с указанием роли Кадровик
происходит обновление данных сотрудника по идентификатору сотрудника в ИС Клиента (externalId)

Note

title	Предусловие

Если назначение/снятие роли будет происходить через методы добавления/снятия роли, то данный метод будет нужен, так как эти методы работают только с применением идентификаторов HRlink

Управление ролью Кадровик

Вариант 1. Создание Сотрудника с указанием роли Кадровика

API-методы

Примечания

1

1)

Администратор при создание Сотрудника на основании Физ.лица задает роль Кадровик

Status


subtle	true
colour	Yellow
title	Gdoc

POST /api/v1/clients/:clientId/employees

в документации нет описания полей и не указано поле отвечающее за табельный номер. Подробности в пояснении к методу

Expand

title	Пояснение к методу

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

:clientId - передается идентификатор клиента

Тело запроса

Markdown

```
{
    "clientUserId": "524de044-bcb4-4f4e-8a5c-cbf8048d4642",
    "clientUserExternalId": "71",
    "legalEntityId": "6950bb5b-8623-4321-93fc-1f11bc02c1c0",
    "legalEntityExternalId": "62",
    "departmentId": "134df774-77c6-4c00-bc20-7b974be6963e",
    "departmentExternalId": "52",
    "positionId": "e17de0b3-ec18-40b9-bd66-aad1f20e7faf",
    "positionExternalId": "42",
    "externalId": "С-1",
    "roleIds":
    [
        "222040ae-d476-4efe-a69a-bfcc68436767",
        "3c7e0a71-1737-4e63-bbd7-807a776fa752"
    ],
    "number": "105-56-FD"
    "tags":
    [
        "someTag1",
        "someTag2"
    ]
}
```

clientUserId - Идентификатор Пользователя в системе HRlink. Обязательный.
- clientUserExternalId - Идентификатор Пользователя в ИС Клиента (если заданы оба, то будет использован только HRlink)
legalEntityId - Идентификатор Юрлица в системе HRlink. Обязательный
- legalEntityExternalId - Идентификатор Юрлица в ИС Клиента (если заданы оба, то будет использован только HRlink)
departmentId - Идентификатор Отдела в системе HRlink.
- departmentExternalId - Идентификатор Отдела в ИС Клиента (если заданы оба, то будет использован только HRlink)
positionId - Идентификатор Должности в системе HRlink.
- positionExternalId - Идентификатор Должности в ИС Клиента (если заданы оба, то будет использован только HRlink)
externalId - идентификатор Сотрудника в ИС Клиента. Проверка на уникальность
roleIds - Перечень ролей назначаемых Сотруднику Пользователя при создании - передается списком
- Кадровик может назначать роль Руководителя и Делопроизводителя
- Администратор - Кадровика, Делопроизводителя и Руководителя
number - табельный номер
tags - метки/теги к Сотруднику у Пользователя, например: город, центр затрат, признак дистанционный/удалённый и т.д.

Вариант 2. Добавление роли через внесение изменений в данные Сотрудника

1

API-методы

Примечания

2

1)

Кадровик обновляет сотрудника по ID своей ИС

Status


subtle	true
colour	Yellow
title	Gdoc

PUT /api/v1/clients/:clientId/employees/:externalId/externalId

или

Кадровик обновляет сотрудника по ID HRL
Status
subtle true
colour Yellow
title Gdoc

PUT /api/v1/clients/:clientId/employees/:employeeId

в документации нет описания полей и не указано поле отвечающее за табельный номер. Подробности в пояснении к методу

Expand

title	Пояснение к методу

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

:clientId - передается идентификатор клиента

Тело запроса

Markdown

```
{
    "departmentId": "134df774-77c6-4c00-bc20-7b974be6963e",
    "departmentExternalId": "52",
    "positionId": "e17de0b3-ec18-40b9-bd66-aad1f20e7faf",
    "positionExternalId": "42",
    "externalId": "С-1",
    "roleIds":
    [
        "222040ae-d476-4efe-a69a-bfcc68436767",
        "3c7e0a71-1737-4e63-bbd7-807a776fa752"
    ],
    "number": "105-56-FD"
    "tags":
    [
        "someTag1",
        "someTag2"
    ]
}
```

departmentId - Идентификатор Отдела в системе HRlink.
- departmentExternalId - Идентификатор Отдела в ИС Клиента (если заданы оба, то будет использован только HRlink)
positionId - Идентификатор Должности в системе HRlink.
- positionExternalId - Идентификатор Должности в ИС Клиента (если заданы оба, то будет использован только HRlink)
externalId - идентификатор Сотрудника в ИС Клиента. Проверка на уникальность
roleIds - Перечень ролей назначаемых Сотруднику Пользователя при создании - передается списком
- Кадровик может назначать роль Руководителя и Делопроизводителя
- Администратор - Кадровика, Делопроизводителя и Руководителя
number - табельный номер
tags - метки/теги к Сотруднику у Пользователя, например: город, центр затрат, признак дистанционный/удалённый и т.д.

Вариант 3. Управление ролью Кадровик через отдельные методы Добавления и Снятия роли

API-методы

Примечания

1

1) Добавление роли

Status

subtle	true
colour	Green
title	redoc

PUT /api/v1/clients/:clientId/employees/:employeeId/roles/add

или

Удаление роли
Status
subtle true
colour Green
title redoc

PUT /api/v1/clients/:clientId/employees/:employeeId/roles/remove

данные методы работают только с указанием идентификатора сотрудника в HRlink, выше в блоке [Подготовительный этап] указано как получить данные по Сотрудникам

Предыдущий раздел

01. Администратор. Базовые настройки справочников

Следующий раздел

03. Администратор. Настройка областей видимости для Кадровика

Поиск документации

Livesearch

spaceKey	WIKI
size	large

Page tree

Versions Compared

Old Version 4

New Version 5

Key

Управление персоналом

Подготовительный этап

Управление ролью Кадровик

Вариант 1. Создание Сотрудника с указанием роли Кадровика

Вариант 2. Добавление роли через внесение изменений в данные Сотрудника

Вариант 3. Управление ролью Кадровик через отдельные методы Добавления и Снятия роли

Предыдущий раздел

Следующий раздел

Page tree

Page History

Versions Compared

Old Version 4

New Version 5

Key

Управление персоналом

Подготовительный этап

Управление ролью Кадровик

Вариант 1. Создание Сотрудника с указанием роли Кадровика

Вариант 2. Добавление роли через внесение изменений в данные Сотрудника

Вариант 3. Управление ролью Кадровик через отдельные методы Добавления и Снятия роли

Предыдущий раздел

Следующий раздел