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

Добавить сотрудников в узел оргструктуры

POST 
/api/v1/clients/:clientId/orgStructures/:id/elements/:elementId/employees

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

Массово добавляет сотрудников клиента в указанный узел оргструктуры в общей для всех позиции (HEAD_MANAGER либо EMPLOYEE). Поле должности создаваемой записи заполняется текущей должностью сотрудника; если у сотрудника нет должности — null. Возвращает обновлённые метаданные структуры и затронутые узлы (сам узел + предки до корня) с пересчитанными счётчиками.

Для HEAD_MANAGER действует мягкий лимит 10 руководителей на узел типа DEPARTMENT. Для узла типа EMPLOYEE_AS_NODE добавление HEAD_MANAGER запрещено — у такого узла ровно один руководитель, заданный при создании; обычных сотрудников добавлять можно.

Для HEAD_MANAGER дополнительно проверяется подтверждение приглашения в систему у всех добавляемых: если хотя бы один не подтвердил — операция отклоняется. Для EMPLOYEE проверка не применяется — неподтверждённые сотрудники добавляются без ошибки.

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

  • Тело запроса задано; employeeIds не пуст, элементы не null.

  • IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID; клиент существует, не удалён, к нему относится пользователь, выполняющий операцию.

  • У пользователя клиента есть право ORG_STRUCTURES_UPDATE.

  • IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. оргструктуры соответствует формату UUID; оргструктура существует, принадлежит клиенту, не является Юридической, находится в статусе DRAFT.

  • Если version задана — совпадает с актуальной версией оргструктуры в БД.

  • Режим редактирования оргструктуры свободен либо захвачен инициатором операции.

  • IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. узла соответствует формату UUID; узел существует в указанной оргструктуре.

  • positionType задан.

  • Все сотрудники существуют в тенантеTenantЭкземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов., принадлежат клиенту и активны (не уволены).

  • Ни один из добавляемых сотрудников не состоит в узле в любой позиции.

  • Добавление HEAD_MANAGER в узел типа EMPLOYEE_AS_NODE запрещено.

  • При positionType=HEAD_MANAGER — после добавления не более 10 руководителей в узле; все добавляемые подтвердили приглашение в систему.

  • Функционал оргструктур включён в настройках клиента.

Request​

Responses​

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