Skip to main content
Сотрудник — это узел графа оргструктуры. От него идут рёбра к отделу, должности, руководителю, организации, локации и к самому человеку (person). Руководитель — тоже сотрудник, поэтому цепочка manager ведёт дальше по иерархии.

Сотрудник в центре графа, рёбра — внешние ключи карточки

​
Обход через expand

По умолчанию карточка несёт только *_id-ссылки. Чтобы получить связанный объект в том же ответе, перечислите его в expand.
  • Допустимые значения: person, department, job_title, manager. Другое имя — DEVELOPER.INVALID_EXPAND.
  • Разворачивание плоское, на один уровень. Вложенного обхода нет: нельзя запросить руководителя руководителя одним expand.
  • Запятая не разделяет значения — expand=department,manager считается одним именем. Для нескольких объектов повторяйте параметр.
manager — это узкая ссылка ManagerRef: только id и отображаемое имя, без персональных данных руководителя. Чтобы узнать отдел или ИИН руководителя, запросите его как сотрудника — GET /employees/{manager_id} — и разверните нужные связи уже там (в пределах вашего доступа).
Под капотом — HRQL. Граф и списковые фильтры разрешает наш собственный движок запросов HRQL — язык вроде where-условий над оргмоделью. Сами вы HRQL не пишете: публично вы работаете типизированными фильтрами и expand, а HRQL — это то, что делает их обход эффективным. Это внутренний движок, а не часть публичного API.

​
Дальше

Модель сотрудника

Поля карточки и модель доступа.

Статусы и жизненный цикл

Значения EmployeeStatus и переходы.

Пагинация

Фильтры списков и инкрементальная синхронизация.