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

Получить карточку оргструктуры

GET 
/api/v1/clients/:clientId/orgStructures/:id

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

Возвращает карточку оргструктуры: метаданные структуры и полное дерево элементов плоским списком elements[] (с массивом headEmployees и счётчиком employeesCount на каждом узле). UI строит иерархию по parentId; порядок узлов стабильный — name ASC, id ASC. Сотрудники узлов, кроме руководителей, отдаются отдельным эндпоинтом с пагинацией.

Юридическая оргструктура отдаётся через захардкоженный id 30c73ee0-077f-4080-bc24-099d8ea088f9 — её данные собираются на лету из справочника отделов (client_department), а не хранятся отдельной записью. В дерево Юридической в конце списка elements[] добавляется синтетический корневой узел «Сотрудники без отдела» с фиксированным id 549d1eb3-16b4-4cdd-95f2-66b3671e69c7 — только если у клиента есть хотя бы один активный сотрудник без отдела; при отсутствии таких сотрудников узел не возвращается.

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

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

  • Клиент существует, не удалён, и к нему относится пользователь, выполняющий операцию.

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

  • Оргструктура существует и принадлежит указанному клиенту.

  • Видимость оргструктуры пользователю: пользователь с правом ORG_STRUCTURES_UPDATE видит любую оргструктуру; обычный сотрудник — только опубликованную с типом доступа PUBLIC либо RESTRICTED, в которой он состоит.

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

Request​

Responses​

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