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

Получить страницу сотрудников, доступных для добавления в узел оргструктуры

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

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

Возвращает страницу сотрудников клиента, которых можно добавить в указанный узел оргструктуры — используется диалогом «Добавить сотрудника в узел». В выдачу попадают активные сотрудники клиента, не состоящие в выбранном узле ни в одной позиции, отфильтрованные по необязательным positionIds, legalEntityIds и departmentIds. Сортировка по ФИО и пагинация выполняются на стороне ekd-ididВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..

При positionType=HEAD_MANAGER выдача дополнительно ограничивается сотрудниками, подтвердившими приглашение в систему — чтобы фронт не показывал в списке кандидатов на роль руководителя тех, кого заведомо нельзя назначить. При positionType=EMPLOYEE фильтр подтверждения не применяется — в выдаче возможны неподтверждённые сотрудники, отличаемые по полю confirmed=false.

Поле existsInElements каждого кандидата содержит список узлов этой же оргструктуры, в которых сотрудник уже состоит (сам узел запроса исключён по построению).

Поиск (search) применяется только к ФИО — поиск по названию должности или отдела не поддержан.

Метод не работает для Юридической оргструктуры.

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

  • Тело запроса задано; positionType задан.

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

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

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

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

  • Элементы positionIds, legalEntityIds, departmentIds, если заданы, не содержат null.

  • limit и offset не отрицательны; превышение максимального значения пагинации недопустимо.

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

Request​

Responses​

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