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

Создать узел оргструктуры

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

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

Создаёт узел оргструктуры в режиме редактирования черновика. Для узла типа EMPLOYEE_AS_NODE дополнительно создаёт одно вхождение сотрудника с позицией руководителя. Возвращает обновлённые метаданные структуры, набор затронутых узлов (новый узел и его непосредственный родитель, если задан) и IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. созданного узла.

Для DEPARTMENT название узла берётся из тела запроса. Для EMPLOYEE_AS_NODE фактическое имя узла берётся из названия должности сотрудника; если у сотрудника нет должности — из его ФИО; переименовать узел можно отдельно через обновление узла.

Цепочка предков выше непосредственного родителя не раскрывается — создание пустого узла не меняет счётчики выше по дереву.

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

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

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

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

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

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

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

  • type задан и соответствует одному из допустимых значений.

  • Для DEPARTMENT — name задано и не пустое после trim(); длина не больше 1024 символов.

  • Если externalId задан — уникален среди узлов всех оргструктур клиента.

  • Если parentId задан — узел существует в этой же оргструктуре.

  • Для EMPLOYEE_AS_NODE — employeeId задан; сотрудник существует, принадлежит указанному клиенту, не уволен и подтвердил приглашение в систему.

  • После создания итоговое количество узлов оргструктуры не превышает лимит (по умолчанию 20 000).

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

Request​

Responses​

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