Обновить руководителей
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
- 200
- 400
- 401
- 403
- 429
Успешная операция.
Ошибка при валидации данных запроса.
Запрос не аутенифицирован.
Для заданного пользователя доступ к ресурсу запрещен.
Превышен разрешенный лимит запросов за период.