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 | ||
---|---|---|
| ||
Выполнена первичная передача данных по Сотрудникам из ИС Клиента в HRlink
|
Действия и API-методы | Примечания | |
---|---|---|
1 |
Пользовательский Сценарий | Действия и API-методы | Примечания |
---|
Сценарии работы Кадровика с Электронными подписями
Цель сценариев - Обеспечить сотрудника Электронной Подписью, соответствующей процессам Клиента, для выполнения КЭДО
1) Кадровик восстанавливает сотрудника PUT / |
Пользовательский Сценарий
Действия и API-методы
Примечания
1. Кадровик подключает Пользователю ПЭП Госуслуги для работы с Документами/Заявлениями
Предусловие - Служба Внедрения включила применение ПЭП Госуслуги для ЮЛ Клиента, на основании запроса
1) Кадровик разрешает применение ПЭП Госуслуги для Пользователя
PUTapi/v1/clients/:clientId/employees/:employeeId/ |
На момент составления описания данный метод не оформлен в API-документации
метод действует только по идентификатору Сотрудника в HRlink
Метод работает по идентификатору Сотрудника, но меняет состояние Пользователя.
Т.е. если, к примеру, у Пользователя есть три сотрудника, то при включении права подписи одному из Сотрудников, включает право подписи для всех Сотрудников.
Сотруднику получившему разрешение на применение ПЭП Госуслуги при первом подписании будет необходимо авторизоваться через ЕСИА
restore или Кадровик восстанавливает сотрудника по идентификатору ИС Клиента PUT /api/v1/clients/:clientId/employeesByExternalId/:employeeExternalId/restore |
|
2. Кадровик деактивирует способ подписания ПЭП Госуслуги для Пользователя
Предусловие - для вызова метода запрета нужны идентификаторы Сотрудников. СМ. получение данных сотрудников.
1) Запрет ПЭП Госуслуги
PUT
|
|
Перевод Сотрудника
Note | ||
---|---|---|
| ||
Выполнена первичная передача данных по Сотрудникам из ИС Клиента в HRlink |
Действия и API-методы | Примечания | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
1 | 1) Увольнение сотрудника | см. [Увольнение Сотрудника] | |||||||||
2 | 2) Создание Сотрудника на основании Физлица POST / |
На момент составления описания данный метод не оформлен в API-документации
метод действует только по идентификатору Сотрудника в HRlink
3. Кадровик выпускает Пользователю УНЭП для подписания
Предусловие - Пользователь - создан, данные ФЛ (паспорт) переданы
1) Кадровик создает заявку на выпуск УНЭП
POSTapi/v1/clients/:clientId/ |
На момент составления описания данный метод не оформлен в API-документации
Пример метода можно посмотреть - https://hr-link.atlassian.net/wiki/spaces/HRLIN/pages/666075304/04.#4.-%D0%92%D1%8B%D0%BF%D1%83%D1%81%D0%BA-%D0%A3%D0%9D%D0%AD%D0%9F
employees |
Сценарии работы Кадровика с Электронными подписями
Выпуск УНЭП
Tip | ||
---|---|---|
| ||
Обеспечить сотрудника Электронной Подписью, соответствующей процессам Клиента, для выполнения КЭДО |
Действия и API-методы | Примечания | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
1 | 1) Кадровик создает заявку на выпуск УНЭП POST |
2) Получение полного списка справочника сотрудников
GET /GET /api/v1/clients/:clientId |
или
Получение данных сотрудника по ID своей ИС
GET /api/v1/clients/:clientId/employees/:externalId/externalId
или
/users/issue/nqes | Как понять состояние выпуска УНЭП см. [Определение состояния Учётной записи и наличия ЭП] | ||||||||||
2 | 2) Смена канала подписания УНЭП POST |
api/v1/clients/:clientId/ |
users/:clientUserId/nqesChannelChangeRequests | В случае |
, если у пользователя с действующим УНЭП требуется сменить канал подписания (куда будет приходить код подписания) - вызывается данный метод. Но только если УНЭП уже выпущен.
|
Использование иных видов ЭП
Tip | ||
---|---|---|
| ||
Обеспечить сотрудника Электронной Подписью, соответствующей процессам Клиента, для выполнения КЭДО |
Note | ||
---|---|---|
| ||
Для использования ПРР, Служба Внедрения должна включить применение ПЭП Госуслуги для ЮЛ Клиента, на основании запроса |
Действия и API-методы | Примечания | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
1 | 2) Кадровик разрешает применение ПЭП Госуслуги для Пользователя PUT |
4. Кадровик разрешает пользователю подписание УНЭП Госключ
Предусловие - разрешение происходит только по идентификатору Пользователя в системе HRL, поэтому необходимо, чтобы у Кадровика был данный идентификатор. Можно получить:
метод получения полного списка справочника сотрудников
GET /api/v1/clients/:clientId |
метод получения данных сотрудника по ID своей системы
/employees/:employeeId/signings/prr/enable Запрет ПЭП Госуслуги PUT |
api/v1/clients/:clientId/employees/: |
метод получения данных физлица по номеру СНИЛС
GET /api/v1/clients/:clientId/users/:snils/snils
employeeId/signings/prr/disable | метод действует только по идентификатору Сотрудника в HRlink Метод работает по идентификатору Сотрудника, но меняет состояние Пользователя.
Сотруднику получившему разрешение на применение ПЭП Госуслуги при первом подписании будет необходимо авторизоваться через ЕСИА |
2 | 3) |
Кадровик разрешает применение УНЭП Госключ для Пользователя PUT /api/v1/clients/:clientId/employees/:employeeId/signings/govkey/ |
На момент составления описания данный метод не оформлен в API-документации
метод действует только по идентификатору Сотрудника в HRlink
Сотруднику получившему разрешение на применение ПЭП Госуслуги при первом подписании будет необходимо авторизоваться через ЕСИАenable |
Поиск документации
Livesearch | ||||
---|---|---|---|---|
|