Skip to main content

Заголовки запроса

string
required
API токен сервисного пользователя в формате Bearer. Получите токен в панели администратора школы. Формат: Bearer YOUR_TOKEN.
string
required
Уникальный идентификатор продавца в системе. Используется для разграничения доступа между разными продавцами.
string
required
Уникальный идентификатор школы в системе. Определяет контекст выполнения операции.
Руководитель департамента привязывается к активному трудоустройству сотрудника. У департамента может быть несколько руководителей, но только один из них — основной (isPrimary).
Все эндпоинты модуля staff доступны только для школ сегмента Corporate. Для остальных сегментов запрос вернёт ошибку 403 Forbidden.

Назначить руководителя

Требуется аутентификация и право StaffManage. Эндпоинт работает как upsert: если руководитель для пары департамент + трудоустройство уже назначен — обновляются флаг isPrimary и extId, иначе создаётся новая запись. У департамента может быть только один основной руководитель: при isPrimary=true предыдущий основной руководитель департамента автоматически понижается (флаг isPrimary у него сбрасывается в false). Департамент и трудоустройство должны принадлежать школе, трудоустройство должно быть активным — иначе вернутся ошибки StaffDepartmentNotFound / StaffEmploymentNotFound. Департамент и трудоустройство можно указывать как по числовому ID, так и по внешнему идентификатору: в каждой из пар departmentId/departmentExtId и employmentId/employmentExtId передаётся ровно одно поле.

Параметры запроса

integer
ID департамента. Департамент должен принадлежать школе. Обязателен, если не передан departmentExtId.
string
Внешний идентификатор департамента (extId). Альтернатива departmentId — передаётся ровно одно поле из пары.
integer
ID активного трудоустройства сотрудника, который назначается руководителем. Обязателен, если не передан employmentExtId.
string
Внешний идентификатор трудоустройства (extId). Альтернатива employmentId — передаётся ровно одно поле из пары.
string
Внешний идентификатор записи руководителя из системы клиента (CRM/1C). От 1 до 50 символов, не может содержать / и пробельные символы — значение используется в путях ext/{extId}. Должен быть уникальным в рамках школы среди неудалённых записей, иначе вернётся ошибка StaffDepartmentManagerExtIdIsNotUniq.
boolean
Назначить сотрудника основным руководителем департамента. По умолчанию false. При true предыдущий основной руководитель автоматически перестаёт быть основным.

Снять руководителя

Требуется аутентификация и право StaffManage. Удаляет запись руководителя департамента (мягкое удаление). После снятия основного руководителя департамент остаётся без основного руководителя, пока не будет назначен новый.

Параметры запроса

integer
required
ID записи руководителя департамента (поле id из ответа на назначение).

Ответ

integer
required
Количество удалённых записей (1 при успешном снятии руководителя).

Снять руководителя по extId

Требуется аутентификация и право StaffManage. Аналог снятия по managerId, но запись руководителя ищется по внешнему идентификатору (extId) в рамках школы. Удаляет запись руководителя департамента (мягкое удаление). Если запись с указанным extId не найдена среди неудалённых записей школы — вернётся ошибка StaffDepartmentManagerNotFound.

Параметры запроса

string
required
Внешний идентификатор записи руководителя департамента (extId). Значение в пути должно быть URL-encoded.

Ответ

integer
required
Количество удалённых записей (1 при успешном снятии руководителя).

Требования к правам доступа

Модуль staff доступен только для школ сегмента Corporate. Для назначения и снятия руководителей департаментов требуется право StaffManage.
Сервисный пользователь должен быть аутентифицирован по токену и иметь соответствующие права доступа к указанной школе.

Обновлено: 2026-07-08 04:48 UTC