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

Обновить руководителей

PUT 

/api/v1/clients/:clientId/employees/functionalManagers

Описание метода

⚠️ Будьте осторожны!

Методы PUT перезаписывают запись целиком: любые непереданные поля считаются null и затирают данные в БД. Поэтому при обновлении нужно указывать все поля. Метод используется для обновления данных сотрудников в системе. В теле запроса передаются данные обновляемых сотрудников, а также данные управленческих руководителей, которых нужно назначить сотрудникам.

Валидации запроса

  • Тело запроса задано корректно.
  • Клиент существует, не удалён, и к нему относится пользователь, выполняющий операцию.
  • На текущий момент не существует активной задачи массовой синхронизации управленческих руководителей сотрудников.
  • Сотрудники, для которых в теле запроса указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях., существуют.
  • Юрлица, для которых в теле запроса указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях., а для соответствующих сотрудников не указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе, существуют.
  • Юрлица, для которых в теле запроса не указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе, а для соответствующих сотрудников не указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе, существуют.
  • Сотрудники, для которых в теле запроса не указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе, существуют и единственны.
  • Каждый обновляемый сотрудник указан в теле запроса не более одного раза.
  • Ни один из сотрудников, указанных в теле запроса, не уволен, не считая сотрудников, для которых удаляется управленческий руководитель.
  • Для каждого из обновляемых сотрудников
  • если версия данных указана, то она корректна.
  • Пользователь клиента каждого обновляемого сотрудника не совпадает с пользователем клиента нового управленческого руководителя.
  • Пользователь клиента имеет необходимые права для совершения операции.
  • Тело запроса задано.
  • Список обновляемых сотрудников указан и не пуст.
  • Список обновляемых сотрудников содержит не более допустимого числа элементов.
  • Список обновляемых сотрудников не содержит пустых элементов.
  • Для каждого обновляемого сотрудника указан внутренний или внешний IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID..
  • Проверяет, что сотрудники, для которых в теле запроса указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях., существуют.
  • Проверяет, что юрлица, для которых в теле запроса указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях., а для соответствующих сотрудников не указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе, существуют.
  • Проверяет, что юрлица, для которых в теле запроса не указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе, а для соответствующих сотрудников не указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе, существуют.
  • Проверяет, что сотрудники, для которых в теле запроса не указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и указан IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе, существуют и единственны.
  • Проверяет, что каждый обновляемый сотрудник указан в теле запроса не более одного раза.
  • Проверяет, что ни один сотрудников, указанных в теле запроса, не уволен, не считая сотрудников, для которых удаляется управленческий руководитель.
  • Проверяет, что для каждого сотрудника указана корректная версия данных.
  • Проверяет, что пользователь клиента каждого обновляемого сотрудника не совпадает с пользователем клиента управленческого руководителя.
  • Пользователь клиента имеет право EMPLOYEES_UPDATE на уровне пользователя клиента или на уровне сотрудника для выполнения операции.
  • Пользователь клиента имеет права на юрлица обновляемых сотрудников и управленческих руководителей.
  • Пользователь клиента имеет права на отделы обновляемых сотрудников и управленческих руководителей.
  • IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID.
  • По заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента существует клиент.
  • Пользователь, выполняющий операцию, относится к клиенту.
  • Проверяет, что в теле запроса указано не более допустимого числа обновляемых сотрудников.
  • Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. сотрудника указан.
  • Проверяет, что сотрудники существуют по всем заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях., и возвращает список сотрудников.
  • Проверяет существование всех юрлиц клиента по заданному списку IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..
  • Проверяет существование юрлиц по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента и заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе.
  • Проверяет, что по каждому из заданных IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе существует единственный сотрудник.
  • Если юрлицо указано, то существование сотрудника проверяется в заданном юрлице.
  • Если юрлицо не указано, то существование сотрудника проверяется в клиенте с заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..
  • Проверяет, что указанный сотрудник не уволен.
  • Проверяет, что указана корректная версия данных.
  • Проверяет, есть ли у пользователя клиента с заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. заданное право и возвращает кэш наличия прав у пользователя клиента.
  • Проверяет, что текущий пользователь относится к заданному клиенту и возвращает пользователя клиента, если он существует.
  • Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента, заданный в виде строки, соответствует формату, и возвращает типизированный IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента.
  • Проверяет существование клиента по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и возвращает клиента, если он существует.
  • Проверяет, что клиент не удален.
  • Проверяет, что по каждому из заданных IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе существует единственный сотрудник в заданном клиенте.
  • Проверяет, что данный сотрудник работает.
  • Проверяет существование единственного сотрудника с заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе в клиенте с заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..

Request

Responses

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