О чём раздел
Под управлением персоналом подразумевается:
- Добавление новых Сотрудников
- Обновление данных Сотрудника
- Изменение данных Физлица
- Кадровый перевод Сотрудника (из юрлица в юрлицо)
- Изменение должности/отдела Сотрудника
- Управление ролью Руководитель
- Увольнение и Восстановление Сотрудника
- Управление электронными подписями Сотрудника
- Получение списка Сотрудников
- Общий список
- Список по фильтрам
- Список в виде XLS файла
Основные сценарии управления персоналом
Примечание
Пользователем системы HRlink является Физическое Лицо, которое выступает в качестве Сотрудника Компании, в рамках КЭДО.
Более подробно об объектах Физлицо и Пользователь можно ознакомиться в разделе → [03. Объекты и связи]
Функционал для пользователя определяется:
ролью (Администратор, Кадровик, Сотрудник, Руководитель)
доступными видами ЭП (УКЭП, УНЭП, ПЭП Госуслуги)
Данными Сотрудника
ЮЛ, в котором оформлено ФЛ
Отдел, к которому относится Сотрудник
- Должность, которую занимает Сотрудник
Управление справочниками описано в разделе → [01. Кадровик. Вспомогательные процессы: Управление структурой и Справочниками]
Кадровик создаёт учётные записи пользователей и приглашает к подтверждению
Цель сценария
В ЛК HRL приглашены Пользователи Клиента, которые смогут воспользоваться КЭДО после подтверждения учётной записи.
Предусловие
Администратор выгрузил справочник юрлиц → [01. Администратор. Базовые настройки справочников]
1 | API-методы | Примечания |
---|---|---|
1 | 1) Кадровик создает Физ.лицо, для которого будут созданы записи сотрудников GDOC POST /api/v1/clients/:clientId/users или использовать пакетный метод, для выгрузки отделов 1.1) Создать новую задачу массовой синхронизации данных REDOC POST /api/v1/clients/:clientId/bulkDataSyncTasks 1.2) Получить статус задачи массовой синхронизации данных по идентификатору задачи REDOC GET /api/v1/clients/:clientId/bulkDataSyncTasks/:taskId | В HRlin Пользователь представлен двумя объектами:
Такая модель позволяет для одного Физического Лица задавать несколько Сотрудников. См схему логических связей В ответ на создание будет возвращен идентификатор clientUserId , который необходим для приглашения. Если справочник Сотрудников имеет большое количество сотрудников, то его создание и обновление может быть осуществлено с помощью метода пакетной выгрузки.
После создания задачи на пакетную выгрузку для контроля состояния выполнения пакетной выгрузки необходимо обращаться к задаче и определять её статус, поэтому здесь представлена цепочка из двух методов. |
2 | 2) Кадровик создает Сотрудника для существующего ФЛ GDOC POST /api/v1/clients/:clientId/employees | Если использован пакетный метод, то данный шаг можно пропустить. При создании Сотрудника можно указать Идентификатор Сотрудника в ИС Клиента, через поле externalId, это позволит в дальнейшем использовать внутренний (с точки зрения Клиента) идентификатор для работы с Сотрудниками При создании Сотрудника можно сразу указать роль - Кадровика или роль Руководителя, указав соответствующий идентификатор роли в параметрах. По умолчанию Сотрудник создается без ролей. |
3 | 3) Получение полного списка справочника сотрудников GDOC 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) Кадровик приглашает группу сотрудников GDOC POST /api/v1/clients/:clientId/users/invite или POST /api/v1/clients/:clientId/users/:clientUserId/invite | После того как ФЛ создано и ему добавлены и настроены записи Сотрудников, чтобы Работник мог воспользоваться ЛК, ему требуется направить приглашение. В группе может быть 1 и более сотрудник. При отправке приглашения система проверяет - роли Пользователя и наличие доступных лицензий в соответствии с ролью пользователя. Работник получив приглашение подтвердит свою учётную запись и только после этого сможет использовать ЛК в рамках Кадрового Электронного Документооборота При приглашении можно задать какие электронные подписи должны быть доступны Сотруднику. Это позволит будет пропустить сценарии с выпуском электронной подписи. |
5 | 5) Кадровик приглашает группу сотрудников GDOC POST /api/v1/clients/:clientId/users/invite или POST /api/v1/clients/:clientId/users/:clientUserId/invite | В случае, если Сотрудник пропустил уведомление о необходимости подтверждения учётной записи - можно направить повторное приглашение. |
Кадровик обновляет данные ФЛ (канал уведомления) и отправляет приглашение на новый канал
Цель сценария
Обеспечить отправку приглашения Сотруднику на другой канал уведомления.
Действия и API-методы | Примечания | |
---|---|---|
1 | 1) Кадровик отменяет неподтверждённое приглашение GDOC PUT /api/v1/clients/:clientId/users/:clientUserId/invite/deactivate | На момент составления описания данные методы не оформлены в API-документации |
2 | 2) Обновление физлица по ID своей ИС GDOC PUT /api/v1/clients/:clientId/users/:externalId/externalId или PUT /api/v1/clients/:clientId/users/:clientUserId | |
3 | 3) Кадровик приглашает группу сотрудников GDOC POST /api/v1/clients/:clientId/users/invite или POST /api/v1/clients/:clientId/users/:clientUserId/invite |
Кадровик управляет ролью Руководитель
Цель сценария
Кадровик назначает роль Руководитель сотрудникам, чтобы они в последствии могли подписывать документы от имени компании
Предусловие
Для управления ролями, в ИС Клиента должны быть идентификаторы ролей
GET /api/v1/employeeRoles
Управление ролями возможно через несколько способов, но в случае если используются методы обновления или методы назначения/снятия, то необходимы идентификаторы Сотрудников.
POST /api/v1/clients/:clientId/employees/getRegistry
для методов добавления/снятия используются только идентификаторы Сотрудников в HRlink
Вариант 1. Кадровик создает сотрудника с ролью Руководитель
Действия и API-методы | Примечания | |
---|---|---|
1 | 1) Кадровик при создание Сотрудника на основании Физ.лица задает роль Руководитель GDOC POST /api/v1/clients/:clientId/employees |
Вариант 2. Кадровик при обновлении сотрудника назначает роль Руководитель
Действия и API-методы | Примечания | |
---|---|---|
1 | 1) Кадровик обновляет сотрудника по ID своей ИС GDOC PUT /api/v1/clients/:clientId/employees/:externalId/externalId или PUT /api/v1/clients/:clientId/employees/:employeeId |
Вариант 3. Кадровик добавляет/убирает роль Руководитель для Сотрудника
Действия и API-методы | Примечания | |
---|---|---|
1 | 1) Добавление роли ADDON PUT /api/v1/clients/:clientId/employees/:employeeId/roles/add или
PUT /api/v1/clients/:clientId/employees/:employeeId/roles/remove | методы добавления/удаления роли действуют только по идентификатору Сотрудника в HRlink |
Сценарии работы Кадровика с уже сформированными данными Сотрудников
Кадровик получает данные Сотрудников
Цель сценария
Кадровая система HRlink обогащает данными ИС Клиента:
- готовность учётной записи сотрудника
- наличие и состояние ЭП у сотрудника
Также при изменении данных в ИС Клиента, необходимо корректно эти изменения передавать в HRlink:
- обновление данных ФЛ
- обновление данных сотрудника
- кадровый перевод (из одного юрлица в другое)
- увольнение сотрудника
Предусловие
Выполнена первичная передача данных по Сотрудникам из ИС Клиента в HRlink
Определение состояния Учётной записи и наличия ЭП
Действия и API-методы | Примечания | |
---|---|---|
1 | 1) Получение постраничного справочника сотрудников GDOC POST /api/v1/clients/:clientId/employees/getRegistry или Получение данных физлица по номеру СНИЛС GDOC GET /api/v1/clients/:clientId/users/:snils/snils или Получение данных сотрудника по ID своей ИС GDOC GET /api/v1/clients/:clientId/employees/:externalId/externalId или GET /api/v1/clients/:clientId/employees/:employeeId | методы добавления/удаления роли действуют только по идентификатору Сотрудника в HRlink |
Обновление данных Физлица
Предусловие
Выполнена первичная передача данных по Сотрудникам из ИС Клиента в HRlink
Действия и API-методы | Примечания | |
---|---|---|
1 | 1) Обновление физлица по ID своей системы PUT /api/v1/clients/:clientId/users/:externalId/externalId или 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 | Данный шаг сценария позволяет вносить изменения в данные по каналам уведомления |
Обновление данных Сотрудника
Увольнение Сотрудника
Перевод Сотрудника
Пользовательский Сценарий | Действия и API-методы | Примечания |
---|---|---|
2. Кадровик обновляет данные ФизлицаЦель - обновление таких данных как:
| 1) Обновление физлица по ID своей системы PUT /api/v1/clients/:clientId/users/:externalId/externalId или PUT /api/v1/clients/:clientId/users/:clientUserId | Данный шаг сценария позволяет вносить изменения в данные ФЛ:
|
2) Установка канала уведомления сотрудника как активного PUT /api/v1/clients/:clientId/users/:clientUserId/notificationChannels/:channelId/activate или DELETE /api/v1/clients/:clientId/users/:clientUserId/notificationChannels/:channelId | Данный шаг сценария позволяет вносить изменения в данные по каналам уведомления | |
3. Кадровик обновляет данные СотрудникаЦель - обновление таких данных как:
| 1) Кадровик обновляет данные сотрудника по ID своей ИС PUT /api/v1/clients/:clientId/employees/:externalId/externalId или PUT /api/v1/clients/:clientId/employees/:employeeId | |
4. Кадровик присваивает почту/телефон от одного Сотрудника - другому сотруднику для приглашенияЦель - в случае использования корпоративных телефонов, почтовых адресов, которые могут передаваться от одного сотрудника к другому | 1) Удаление канала уведомления Пользователя DELETE /api/v1/clients/:clientId/users/:clientUserId/notificationChannels/:channelId | Удаление подтверждённого канала уведомление приведёт к освобождению занимаемого логина, что позволит использовать его для другого работника. |
2) Обновление физлица по ID своей ИС PUT /api/v1/clients/:clientId/users/:externalId/externalId | ||
5. Кадровик увольняет СотрудникаЦель - прекращение деятельности работника в занимаемой должности | 1) Увольнение сотрудника по ID своей ИС PUT /api/v1/clients/:clientId/employees/:externalId/externalId/dismiss или PUT /api/v1/clients/:clientId/employees/:employeeId/dismiss | В случае если после увольнения у Физлица не остается действующих Сотрудников, то система HRlink блокирует для пользователя доступ в ЛК Данная последовательность методов не является обязательным порядком. Это предложение, как можно организовать процесс увольнения, при котором производится чистка реестра документов от черновиков с уволены ми сотрудниками
|
2) Удаление роли PUT /api/v1/clients/:clientId/employees/:employeeId/roles/remove | ||
3) Кадровик получает реестр документов POST /api/v1/clients/:clientId/documents/hrRegistry 4) Кадровик обновляет черновик документов для исключения увольняемого Сотрудника PUT /api/v1/clients/:clientId/documentGroups или DELETE /api/v1/clients/:clientId/documents/:documentId |
Сценарии работы Кадровика с Электронными подписями
Цель сценариев - Обеспечить сотрудника Электронной Подписью, соответствующей процессам Клиента, для выполнения КЭДО
Пользовательский Сценарий | Действия и API-методы | Примечания |
---|---|---|
1. Кадровик подключает Пользователю ПЭП Госуслуги для работы с Документами/ЗаявлениямиПредусловие - Служба Внедрения включила применение ПЭП Госуслуги для ЮЛ Клиента, на основании запроса | 1) Кадровик разрешает применение ПЭП Госуслуги для Пользователя PUT api/v1/clients/:clientId/employees/:employeeId/signings/prr/enable На момент составления описания данный метод не оформлен в API-документации | метод действует только по идентификатору Сотрудника в HRlink Метод работает по идентификатору Сотрудника, но меняет состояние Пользователя.
Сотруднику получившему разрешение на применение ПЭП Госуслуги при первом подписании будет необходимо авторизоваться через ЕСИА |
2. Кадровик деактивирует способ подписания ПЭП Госуслуги для ПользователяПредусловие - для вызова метода запрета нужны идентификаторы Сотрудников. СМ. получение данных сотрудников. | 1) Запрет ПЭП Госуслуги PUT api/v1/clients/:clientId/employees/:employeeId/signings/prr/disable На момент составления описания данный метод не оформлен в API-документации | метод действует только по идентификатору Сотрудника в HRlink |
3. Кадровик выпускает Пользователю УНЭП для подписанияПредусловие - Пользователь - создан, данные ФЛ (паспорт) переданы | 1) Кадровик создает заявку на выпуск УНЭП POST api/v1/clients/:clientId/users/issue/nqes На момент составления описания данный метод не оформлен в 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 |
2) Получение полного списка справочника сотрудников GET /api/v1/clients/:clientId/employees или Получение данных сотрудника по ID своей ИС GET /api/v1/clients/:clientId/employees/:externalId/externalId или GET /api/v1/clients/:clientId/employees/:employeeId | в поле lastNQESIssueRequest можно получить информацию о состоянии заявки на УНЭП В случае отклонения заявки Сотрудником, Кадровик получит уведомление | |
4. Кадровик разрешает пользователю подписание УНЭП ГосключПредусловие - разрешение происходит только по идентификатору Пользователя в системе HRL, поэтому необходимо, чтобы у Кадровика был данный идентификатор. Можно получить: метод получения полного списка справочника сотрудников GET /api/v1/clients/:clientId/employees метод получения данных сотрудника по ID своей системы GET /api/v1/clients/:clientId/employees/:externalId/externalId метод получения данных физлица по номеру СНИЛС GET /api/v1/clients/:clientId/users/:snils/snils | 1) Кадровик разрешает применение УНЭП Госключ для Пользователя PUT /api/v1/clients/:clientId/employees/:employeeId/signings/govkey/enable На момент составления описания данный метод не оформлен в API-документации | метод действует только по идентификатору Сотрудника в HRlink Сотруднику получившему разрешение на применение ПЭП Госуслуги при первом подписании будет необходимо авторизоваться через ЕСИА |
Следующий раздел
03. Кадровик. Основные процессы: Формирование Документооборота
Поиск документации