Перейти к основному содержимому

Обновить управленческих руководителей (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

Успешная операция.