Excerpt | |||||
---|---|---|---|---|---|
|
Table of Contents |
---|
Основные сценарии управления персоналом
Примечание
Info |
---|
Пользователем системы HRlink является Физическое Лицо, которое выступает в качестве Сотрудника Компании, в рамках КЭДО. Более подробно об объектах Физлицо и Пользователь можно ознакомиться в разделе → [03. Объекты и связи] Функционал для пользователя определяется:
Управление справочниками описано в разделе → [01. Кадровик. Вспомогательные процессы: Управление структурой и Справочниками] |
Кадровик создаёт учётные записи пользователей и приглашает к подтверждению
Tip | ||
---|---|---|
| ||
В ЛК HRL приглашены Пользователи Клиента, которые смогут воспользоваться КЭДО после подтверждения учётной записи. |
Note | ||
---|---|---|
| ||
Администратор выгрузил справочник юрлиц → [01. Администратор. Базовые настройки справочников] |
1 | API-методы | Примечания | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | 1) Кадровик создает Физ.лицо, для которого будут созданы записи сотрудников | ||||||||||||||||||||
| |||||||||||||||||||||
POST /api/v1/clients/:clientId/users или использовать пакетный метод, для выгрузки отделов 1.1) Создать новую задачу массовой синхронизации данных POST /api/v1/clients/:clientId/bulkDataSyncTasks 1.2) Получить статус задачи массовой синхронизации данных по идентификатору задачи GET /api/v1/clients/:clientId/bulkDataSyncTasks/:taskId Детализация пакетного метода - [4. (МС) Справочник пользователей и сотрудников] | В HRlin Пользователь представлен двумя объектами:
Такая модель позволяет для одного Физического Лица задавать несколько Сотрудников. См схему логических связей В ответ на создание будет возвращен идентификатор clientUserId , который необходим для приглашения.
| ||||||||||||||||||||
2 | 2) Кадровик создает Сотрудника для существующего ФЛ | ||||||||||||||||||||
| |||||||||||||||||||||
POST /api/v1/clients/:clientId/employees |
При создании Сотрудника можно указать Идентификатор Сотрудника в ИС Клиента, через поле externalId, это позволит в дальнейшем использовать внутренний (с точки зрения Клиента) идентификатор для работы с Сотрудниками При создании Сотрудника можно сразу указать роль - Кадровика или роль Руководителя, указав соответствующий идентификатор роли в параметрах. По умолчанию Сотрудник создается без ролей. | ||||||||||||||||||||
3 | 3) Получение полного списка справочника сотрудников | ||||||||||||||||||||
| |||||||||||||||||||||
GET /api/v1/clients/:clientId/employees или
| |||||||||||||||||||||
| |||||||||||||||||||||
POST /api/v1/clients/:clientId/employees/getRegistry Для получения данных по одному сотруднику можно использовать один из следующих вариантов:
| |||||||||||||||||||||
| |||||||||||||||||||||
GET /api/v1/clients/:clientId/users/:snils/snils или
| |||||||||||||||||||||
| |||||||||||||||||||||
GET /api/v1/clients/:clientId/employees/:externalId/externalId или
| |||||||||||||||||||||
| |||||||||||||||||||||
GET /api/v1/clients/:clientId/employees/:employeeId | Получение данных необходимо, т.к. последующий запрос с приглашением выполняется только с использованием идентификаторов HRlink При выполнении цепочки запросов данного сценария, все идентификаторы получаются в ответах на запросы и в этом случае шаг с получением данных также можно пропустить.
| ||||||||||||||||||||
4 | 4) Кадровик приглашает группу сотрудников | ||||||||||||||||||||
| |||||||||||||||||||||
POST /api/v1/clients/:clientId/users/invite | |||||||||||||||||||||
| |||||||||||||||||||||
| |||||||||||||||||||||
POST /api/v1/clients/:clientId/users/ | |||||||||||||||||||||
invitations/ | |||||||||||||||||||||
validate | После того как ФЛ создано и ему добавлены и настроены записи Сотрудников, чтобы Работник мог воспользоваться ЛК, ему требуется направить приглашение. В группе может быть 1 и более сотрудник. При отправке приглашения система проверяет - роли Пользователя и наличие доступных лицензий в соответствии с ролью пользователя. Работник получив приглашение подтвердит свою учётную запись и только после этого сможет использовать ЛК в рамках Кадрового Электронного Документооборота
| ||||||||||||||||||||
5 | 5) Кадровик приглашает группу сотрудников | ||||||||||||||||||||
| |||||||||||||||||||||
POST /api/v1/clients/:clientId/users/invite | |||||||||||||||||||||
Status | |||||||||||||||||||||
subtle | true | ||||||||||||||||||||
colour | Yellow | ||||||||||||||||||||
title | Gdoc | ||||||||||||||||||||
| |||||||||||||||||||||
Note | |||||||||||||||||||||
|
Кадровик обновляет данные ФЛ (канал уведомления) и отправляет приглашение на новый канал
Tip | ||
---|---|---|
| ||
Обеспечить отправку приглашения Сотруднику на другой канал уведомления. |
Действия и API-методы | Примечания | ||||||
---|---|---|---|---|---|---|---|
1 | 1) Кадровик отменяет неподтверждённое приглашение | ||||||
| |||||||
PUT /api/v1/clients/:clientId/users/:clientUserId/invite/deactivate | |||||||
2 | 2) Обновление физлица по ID своей ИС | ||||||
| |||||||
PUT /api/v1/clients/:clientId/users/:externalId/externalId или
| |||||||
| |||||||
PUT /api/v1/clients/:clientId/users/:clientUserId | |||||||
3 | 3) Кадровик приглашает группу сотрудников | ||||||
| |||||||
POST /api/v1/clients/:clientId/users/invite | |||||||
Кадровик
приглашает конкретного сотрудникауправляет ролью Руководитель
Tip | ||
---|---|---|
| ||
Кадровик назначает роль Руководитель сотрудникам, |
POST /api/v1/clients/:clientId/users/:clientUserId/invite
Кадровик управляет ролью Руководитель
Tip | ||
---|---|---|
| ||
Кадровик назначает роль Руководитель сотрудникам, чтобы они в последствии могли подписывать документы от имени компании |
Note | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
Для управления ролями, в ИС Клиента должны быть идентификаторы ролей
GET /api/v1/employeeRoles Управление ролями возможно через несколько способов, но в случае если используются методы обновления или методы назначения/снятия, то необходимы идентификаторы Сотрудников.
|
Вариант 1. Кадровик создает сотрудника с ролью Руководитель
Действия и API-методы | Примечания | |||||
---|---|---|---|---|---|---|
1 | 1) Кадровик при создание Сотрудника на основании Физ.лица задает роль Руководитель | |||||
| ||||||
POST /api/v1/clients/:clientId/ | ||||||
employees |
Вариант 2. Кадровик при обновлении сотрудника назначает роль Руководитель
Действия и API-методы | Примечания | |||||
---|---|---|---|---|---|---|
1 | 1) Кадровик обновляет сотрудника по ID своей ИС | |||||
| ||||||
| ||||||
PUT /api/ | ||||||
v3/clients/:clientId/ | ||||||
employeesByExternalId/: | ||||||
| ||||||
PUT /api/ | ||||||
v3/clients/:clientId/employees/:employeeId |
Вариант 3. Кадровик добавляет/убирает роль Руководитель для Сотрудника
Действия и API-методы | Примечания | ||||||
---|---|---|---|---|---|---|---|
1 | 1) Добавление роли | ||||||
| |||||||
PUT /api/v1/clients/:clientId/employees/:employeeId/roles/add или
| |||||||
| |||||||
PUT /api/v1/clients/:clientId/employees/:employeeId/roles/remove | методы добавления/удаления роли действуют только по идентификатору Сотрудника в HRlink |
Expand | ||||
---|---|---|---|---|
| ||||
PUT /api/v1/clients/:clientId/employees/:employeeId/roles/add Тело запроса
Ответ
|
Expand | ||||
---|---|---|---|---|
| ||||
PUT /api/v1/clients/:clientId/employees/:employeeId/roles/remove Тело запроса
Ответ
|
Сценарии работы Кадровика с уже сформированными данными Сотрудников
Кадровик получает данные Сотрудников
title | Цель сценария |
---|
Сценарии работы Кадровика с уже сформированными данными Сотрудников
Кадровик получает данные Сотрудников
Tip | ||
---|---|---|
| ||
Кадровая система HRlink обогащает данными ИС Клиента:
Также при изменении данных в ИС Клиента, необходимо корректно эти изменения передавать в HRlink:
|
Note | ||
---|---|---|
| ||
Выполнена первичная передача данных по Сотрудникам из ИС Клиента в HRlink |
Определение состояния Учётной записи и наличия ЭП
Кадровая система HRlink обогащает данными ИС Клиента:
- готовность учётной записи сотрудника
- наличие и состояние ЭП у сотрудника
Также при изменении данных в ИС Клиента, необходимо корректно эти изменения передавать в HRlink:
- обновление данных ФЛ
- обновление данных сотрудника
- кадровый перевод (из одного юрлица в другое)
- увольнение сотрудника
Note | ||
---|---|---|
| ||
Выполнена первичная передача данных по Сотрудникам из ИС Клиента в HRlink |
Определение состояния Учётной записи и наличия ЭП
Действия и API-методы | Примечания | 1 | 1) Получение постраничного справочника сотрудников|||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Status | |||||||||||||||||
subtle | true | ||||||||||||||||
colour | Yellow | ||||||||||||||||
title | Gdoc | ||||||||||||||||
Действия и API-методы | Примечания | ||||||||||||||||
1 | 1) Получение постраничного справочника с фильтрацией POST /api/v1/clients/:clientId/employees/getRegistry или
GET /api/v1/clients/:clientId/users/:snils/snils или | ||||||||||||||||
| |||||||||||||||||
| |||||||||||||||||
GET /api/v1/clients/:clientId/ | |||||||||||||||||
employees/: | |||||||||||||||||
externalId/ | |||||||||||||||||
externalId или | |||||||||||||||||
| |||||||||||||||||
| |||||||||||||||||
GET /api/v1/clients/:clientId/employees/: | |||||||||||||||||
Status | |||||||||||||||||
subtle | true | ||||||||||||||||
colour | Yellow | ||||||||||||||||
title | Gdoc | ||||||||||||||||
Expand | |||||||||||||||||
employeeId |
| ||||||||||||||||
|
Обновление данных Физлица
Note | ||
---|---|---|
| ||
Выполнена первичная передача данных по Сотрудникам из ИС Клиента в HRlink |
|
Обновление данных Физлица
Note | ||
---|---|---|
| ||
Выполнена первичная передача данных по Сотрудникам из ИС Клиента в HRlink |
Действия и API-методы | Примечания | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | 1) Обновление физлица по ID своей ИС PUT /api/v1/clients/:clientId/users/:externalId/externalId или
| Действия и API-методы | Примечания | 1 | 1) Обновление физлица по ID своей системы|||||||||||||
Status | |||||||||||||||||
subtle | true | ||||||||||||||||
colour | Yellow | ||||||||||||||||
title | Gdoc | ||||||||||||||||
Status | |||||||||||||||||
subtle | true | ||||||||||||||||
colour | Yellow | title | Gdoc|||||||||||||||
PUT /api/v1/clients/:clientId/users/:clientUserId | Данный шаг сценария позволяет вносить изменения в данные ФЛ:
| ||||||||||||||||
2 | 2) Установка канала уведомления сотрудника как активного | ||||||||||||||||
| |||||||||||||||||
PUT /api/v1/clients/:clientId/users/:clientUserId/notificationChannels/:channelId/activate или
| |||||||||||||||||
| |||||||||||||||||
DELETE /api/v1/clients/:clientId/users/:clientUserId/notificationChannels/:channelId | Данный шаг сценария позволяет вносить изменения в данные по каналам уведомления. Все подтверждённые каналы уведомления также являются логинами для авторизации. Уведомления отправляются только на активный канал уведомления, активным может быть только один канал. |
Обновление данных Сотрудника
Note | ||
---|---|---|
| ||
Выполнена первичная передача данных по Сотрудникам из ИС Клиента в HRlink |
Действия и API-методы | Примечания | |||||
---|---|---|---|---|---|---|
1 | 1) Кадровик обновляет данные сотрудника по ID своей ИС | |||||
| ||||||
PUT /api/ | ||||||
v4/clients/ | ||||||
{clientId}/ | ||||||
employeesByExternalId/{employeeExternalId} или
| ||||||
| ||||||
PUT /api/ | ||||||
v3/clients/:clientId/employees/:employeeId | Обновление сотрудника позволяет актуализировать такие данных как:
|
Увольнение Сотрудника
Note | ||
---|---|---|
| ||
Выполнена первичная передача данных по Сотрудникам из ИС Клиента в HRlink |
Действия и API-методы | Примечания | |||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | 1) Увольнение сотрудника по ID своей ИС | |||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||
PUT /api/v1/clients/:clientId/employees/:externalId/externalId/dismiss или
| ||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||
PUT /api/v1/clients/:clientId/employees/:employeeId/dismiss | Метод увольнения позволяет передать и будущую дату увольнения. | |||||||||||||||||||||||||||||||
2 | 2) Удаление роли | |||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||
PUT /api/v1/clients/:clientId/employees/:employeeId/roles/remove | Увольнение сотрудника с ролью Кадровик не приводит к снятию роли Кадровик, поэтому рекомендуется удалять роль у Сотрудников, которые имеют роль Кадровик.
| |||||||||||||||||||||||||||||||
3 | 3) Кадровик получает реестр документов POST /api/v1/clients/:clientId/documents/hrRegistry 4) Кадровик обновляет черновик документов для исключения увольняемого Сотрудника PUT /api/v1/clients/:clientId/documentGroups или
DELETE /api/v1/clients/:clientId/documents/:documentId | данный набор шагов не является обязательным, но позволяет:
|
Восстановление уволенного Сотрудника
Note | ||
---|---|---|
| ||
|
Действия и API-методы | Примечания | |
---|---|---|
1 | 1) Кадровик |
восстанавливает сотрудника |
|
|
|
PUT /api/v1/clients/:clientId/employees/ |
После того, как Кадровик инициировал восстановление, сотрудник должен пройти процесс первичного подтверждения учётной записи
- HRlink обновляет состояние ФЛ - “ожидает подтверждения”
- HRlink направляет уведомление для подтверждения учётной записи
- Пользователь ввод 4 цифр паспорта
- Пользователь принимает условия работы HRlink
:employeeId/restore или Кадровик восстанавливает сотрудника по идентификатору ИС Клиента PUT /api/v1/clients/:clientId/employeesByExternalId/:employeeExternalId/restore |
|
Перевод Сотрудника
Note | ||
---|---|---|
| ||
Выполнена первичная передача данных по Сотрудникам из ИС Клиента в HRlink |
Действия и API-методы | Примечания | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | 1) Увольнение сотрудника | см. [Увольнение Сотрудника] | ||||||||||
2 | 2) Создание Сотрудника на основании Физлица POST /api/v1/clients/:clientId/employees |
Сценарии работы Кадровика с Электронными подписями
Выпуск УНЭП
Tip | ||
---|---|---|
| ||
Обеспечить сотрудника Электронной Подписью, соответствующей процессам Клиента, для выполнения КЭДО |
Действия и API-методы | Примечания | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | 1) Кадровик создает заявку на выпуск УНЭП POST api/v1/clients/:clientId/users/issue/nqes | Как понять состояние выпуска УНЭП см. [Определение состояния Учётной записи и наличия ЭП] | |||||||||||||||||
2 | 2) Смена канала подписания УНЭП POST api/v1/clients/:clientId/users/:clientUserId/nqesChannelChangeRequests | В случае, если у пользователя с действующим УНЭП требуется сменить канал подписания (куда будет приходить код подписания) - вызывается данный метод. Но только если УНЭП уже выпущен.
|
|
|
Использование иных видов ЭП
Tip | ||
---|---|---|
| ||
Обеспечить сотрудника Электронной Подписью, соответствующей процессам Клиента, для выполнения КЭДО |
Note | ||
---|---|---|
| ||
Для использования ПРР, Служба Внедрения должна включить применение ПЭП Госуслуги для ЮЛ Клиента, на основании запроса |
Действия и API-методы | Примечания | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | 2) Кадровик разрешает применение ПЭП Госуслуги для Пользователя PUT api/v1/clients/:clientId/employees/:employeeId/signings/prr/enable Запрет ПЭП Госуслуги PUT api/v1/clients/:clientId/employees/:employeeId/signings/prr/disable | метод действует только по идентификатору Сотрудника в HRlink Метод работает по идентификатору Сотрудника, но меняет состояние Пользователя.
Сотруднику получившему разрешение на применение ПЭП Госуслуги при первом подписании будет необходимо авторизоваться через ЕСИА | ||||||||||||||||||||
2 | 3) Кадровик разрешает применение УНЭП Госключ для Пользователя PUT /api/v1/clients/:clientId/employees/:employeeId/signings/govkey/enable |
Поиск документации
Livesearch | ||||
---|---|---|---|---|
|