Массовое увольнение/восстановление

PUT 
/api/v1/clients/:clientId/employees/bulkDismissAndRestore

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

--- #### 1. Общие требования к запросу

• Тело HTTP-запроса должно быть задано.
• Параметр clientId должен соответствовать формату UUID.
• Клиент с указанным clientId должен существовать.
• Аутентифицированный пользователь должен принадлежать указанному клиенту. --- #### 2. Требования к правам доступа Пользователь должен обладать правами, достаточными для выполнения операции. ##### 2.1 Увольнение сотрудников Для увольнения сотрудников пользователь должен иметь хотя бы одно из следующих прав:
• Право на уровне пользователя клиента:
• EMPLOYEES_DISMISS
• Право на уровне любого из сотрудников пользователя:
• EMPLOYEES_DISMISS ##### 2.2 Восстановление сотрудников Для восстановления сотрудников пользователь должен иметь хотя бы одно из следующих прав:
• Право на уровне пользователя клиента:
• EMPLOYEES_RESTORE
• Право на уровне любого из сотрудников пользователя:
• EMPLOYEES_RESTORE --- #### 3. Требования к списку сотрудников Поле employees в теле запроса должно быть задано и удовлетворять следующим условиям. ##### 3.1 Ограничения на список
• Список не должен быть пустым.
• Количество элементов в списке — не более 100.
• Должен быть задан хотя бы один идентификатор сотрудника:
• внутренний IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. (id), или
• внешний IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. (externalId)
• В списке не допускается:
• несколько элементов с одинаковым внутренним IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. сотрудника;
• несколько элементов с одинаковой комбинацией:
• внешний IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. сотрудника (externalId) и
• IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юридического лица (legalEntityId). --- #### 4. Лицензионные ограничения
• При успешном прохождении всех проверок операция передаётся на выполнение.
• При нарушении любого из условий запрос считается некорректным и отклоняется с соответствующей ошибкой.

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

• Тело запроса задано.
• IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID.
• Клиент существует по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..
• Пользователь принадлежит заданному клиенту.
• Пользователь имеет право EMPLOYEES_DISMISS на уровне пользователя клиента или на уровне любого из сотрудников пользователя.
• Пользователь имеет право EMPLOYEES_RESTORE на уровне пользователя клиента или на уровне любого из сотрудников пользователя.
• Список данных сотрудников для операции задан корректно: * Список не пустой (проверка аннотацией).
• Список не содержит более 100 элементов (проверка аннотацией).
• Список не содержит null-элементов (проверка аннотацией).
• Список не содержит элементов в которых не задан ни внутренний ни внешний IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. сотрудника.
• Список не содержит элементов с одинаковыми внутренними IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. сотрудников или одинаковыми комбинациями внешних IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. сотрудников и IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юрлиц.
• У тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. должен быть активный пакет лицензий.
• По заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента существует клиент.
• Пользователь, выполняющий операцию, относится к клиенту.
• Проверяет, есть ли у пользователя клиента с заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. заданное право и возвращает кэш наличия прав у пользователя клиента.
• Проверяет, что в данных сотрудников задан либо внутренний IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. либо внешний IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID..
• Среди данных сотрудников нет объектов с повторяющимся внутренним IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..
• Среди данных сотрудников нет объектов с повторяющимся сочетаниями внешних IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID.: * Нет объектов у которых совпадают внешние IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. и не задан ни один IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юрлица.
• Нет объектов у которых совпадают внешние IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. и при этом, у одного из объектов не задан ни один IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юрлица, а у другого задан один из IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юрлица.
• Нет объектов у которых совпадают пара внешнего IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. и IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юрлица.
• Нет объектов у которых совпадают пара внешнего IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. и внешнего IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. юрлица.
• Производит проверку, что у тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. есть активный пакет лицензий.
• Если у тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. никогда ещё не было пакетов лицензий, то проверка пропускается.
• Проверяет, что текущий пользователь относится к заданному клиенту и возвращает пользователя клиента, если он существует.
• Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента, заданный в виде строки, соответствует формату, и возвращает типизированный IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента.
• Проверяет существование клиента по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и возвращает клиента, если он существует.
• Проверяет, что клиент не удален.
• Проверяет, что среди данных сотрудников нет объектов с повторяющимся внутренним IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..
• Нет объектов у которых совпадают внешние IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. и не задан ни один IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юрлица.
• Проверяет что среди данных сотрудников нет объектов у которых совпадают внешние IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. и не задан ни один IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юрлица.
• Проверяет что среди данных сотрудников нет объектов у которых совпадают внешние IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. и при этом, у одного из объектов не задан ни один IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юрлица, а у другого задан один из IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юрлица.
• Проверяет что среди данных сотрудников нет объектов у которых совпадают пара внешнего IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. и IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юрлица.
• Проверяет что среди данных сотрудников нет объектов у которых совпадают пара внешнего IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. и внешнего IDexternalId Внешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. юрлица.

Request

Responses

200

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

400

Ошибка при валидации данных запроса.

401

Запрос не аутенифицирован.

403

Для заданного пользователя доступ к ресурсу запрещен.

429

Превышен разрешенный лимит запросов за период.