О чём раздел
Под управлением персоналом подразумевается:
- Добавление новых Сотрудников
- Обновление данных Сотрудника
- Изменение данных Физлица
- Кадровый перевод Сотрудника (из юрлица в юрлицо)
- Изменение должности/отдела Сотрудника
- Управление ролью Руководитель
- Увольнение и Восстановление Сотрудника
- Управление электронными подписями Сотрудника
- Получение списка Сотрудников
- Общий список
- Список по фильтрам
- Список в виде 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 | |
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
Действия и API-методы | Примечания | |
---|---|---|
1 | 1) Обновление физлица по ID своей системы GDOC PUT /api/v1/clients/:clientId/users/:externalId/externalId или PUT /api/v1/clients/:clientId/users/:clientUserId | Данный шаг сценария позволяет вносить изменения в данные ФЛ:
|
2 | 2) Установка канала уведомления сотрудника как активного GDOC PUT /api/v1/clients/:clientId/users/:clientUserId/notificationChannels/:channelId/activate или DELETE /api/v1/clients/:clientId/users/:clientUserId/notificationChannels/:channelId | Данный шаг сценария позволяет вносить изменения в данные по каналам уведомления. Все подтверждённые каналы уведомления также являются логинами для авторизации. Уведомления отправляются только на активный канал уведомления, активным может быть только один канал. |
Обновление данных Сотрудника
Предусловие
Выполнена первичная передача данных по Сотрудникам из ИС Клиента в HRlink
Действия и API-методы | Примечания | |
---|---|---|
1 | 1) Кадровик обновляет данные сотрудника по ID своей ИС GDOC PUT /api/v1/clients/:clientId/employees/:externalId/externalId или PUT /api/v1/clients/:clientId/employees/:employeeId | Обновление сотрудника позволяет актуализировать такие данных как:
|
Увольнение Сотрудника
Предусловие
Выполнена первичная передача данных по Сотрудникам из ИС Клиента в HRlink
Действия и API-методы | Примечания | |
---|---|---|
1 | 1) Увольнение сотрудника по ID своей ИС GDOC PUT /api/v1/clients/:clientId/employees/:externalId/externalId/dismiss или PUT /api/v1/clients/:clientId/employees/:employeeId/dismiss | Метод увольнения позволяет передать и будущую дату увольнения. |
2 | 2) Удаление роли ADDON 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) Кадровик приглашает сотрудника GDOC POST /api/v1/clients/:clientId/users/invite | После того, как Кадровик инициировал восстановление, сотрудник должен пройти процесс первичного подтверждения учётной записи
|
Перевод Сотрудника
Предусловие
Выполнена первичная передача данных по Сотрудникам из ИС Клиента в 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 |
Поиск документации