Обновить управленческих руководителей (v2)
PUT/api/v2/clients/:clientId/employees/functionalManagers
Описание метода
⚠️ Будьте осторожны!
Метод перезаписывает список управленческих руководителей сотрудника целиком: управленческие руководители, не переданные в запросе, удаляются.
В отличие от версии 1 (employeeUpdateFunctionalManagerIdsForEmployees), метод позволяет назначить сотруднику несколько управленческих руководителей одновременно — каждый со своим видом (label).
Валидации запроса
- Тело запроса задано.
- Список обновляемых сотрудников указан, не пуст и содержит не более 1000 элементов.
- Для каждого обновляемого сотрудника и каждого управленческого руководителя указан внутренний или внешний IDexternalIdВнешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID..
- Виды управленческих руководителей (
label) не повторяются в пределах одного сотрудника. - Клиент существует, не удалён, и к нему относится пользователь, выполняющий операцию.
- На текущий момент не существует активной задачи массовой синхронизации управленческих руководителей сотрудников версии 1 или версии 2.
- Сотрудники и управленческие руководители, для которых указан IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях., существуют.
- Юрлица, указанные по IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. или по внешнему IDexternalIdВнешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID., существуют.
- Сотрудники, указанные по внешнему IDexternalIdВнешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID., существуют и единственны в пределах юрлица.
- Каждый обновляемый сотрудник указан в теле запроса не более одного раза.
- Ни один из сотрудников и управленческих руководителей, указанных в теле запроса, не уволен, не считая случая удаления управленческого руководителя.
- Версия данных каждого сотрудника, если указана, корректна.
- Пользователь клиента обновляемого сотрудника не совпадает с пользователем клиента ни одного из его управленческих руководителей.
- Пользователь клиента имеет право
EMPLOYEES_UPDATEна уровне пользователя клиента или на уровне сотрудника для выполнения операции. - Пользователь клиента имеет права на юрлица и отделы обновляемых сотрудников и их управленческих руководителей.
- IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID.
- По заданному IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента существует клиент.
- Пользователь, выполняющий операцию, относится к клиенту.
Request
Responses
- 200
- 400
- 401
- 403
- 429
Успешная операция.
Ошибка при валидации данных запроса.
Запрос не аутенифицирован.
Для заданного пользователя доступ к ресурсу запрещен.
Превышен разрешенный лимит запросов за период.