Заголовки запроса
string
required
API токен сервисного пользователя в формате Bearer. Получите токен в панели администратора школы. Формат:
Bearer YOUR_TOKEN.string
required
Уникальный идентификатор продавца в системе. Используется для разграничения доступа между разными продавцами.
string
required
Уникальный идентификатор школы в системе. Определяет контекст выполнения операции.
Руководитель департамента привязывается к активному трудоустройству сотрудника. У департамента может быть
несколько руководителей, но только один из них — основной (
isPrimary).Назначить руководителя
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