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