Трудоустройства

curl --location 'https://api.exode.biz/saas/v2/staff/employment/list?take=10&activeOnly=true' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const axios = require('axios');

const listEmployments = async () => {
  const { data } = await axios.get('https://api.exode.biz/saas/v2/staff/employment/list', {
    params: { take: 10, activeOnly: true },
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload.items);
};

listEmployments();

{
  "success": true,
  "code": 200,
  "payload": {
    "page": 1,
    "count": 4,
    "pages": 1,
    "isFirst": true,
    "isLast": true,
    "items": [
      {
        "id": 9,
        "createdAt": "2026-07-02T11:15:47.312Z",
        "updatedAt": "2026-07-02T11:15:47.312Z",
        "archivedAt": null,
        "schoolId": 198,
        "userId": 1683,
        "positionId": 4,
        "departmentId": 4,
        "extId": "emp-1683",
        "startAt": "2026-07-02T11:15:47.316Z",
        "finishAt": null,
        "status": "Active",
        "kind": "Main",
        "type": "FullTime",
        "rate": 1
      },
      {
        "id": 8,
        "createdAt": "2026-07-02T11:15:47.295Z",
        "updatedAt": "2026-07-02T11:15:47.312Z",
        "archivedAt": null,
        "schoolId": 198,
        "userId": 1683,
        "positionId": 3,
        "departmentId": 4,
        "extId": "emp-1683",
        "startAt": "2026-07-02T11:15:47.299Z",
        "finishAt": "2026-07-02T11:15:47.316Z",
        "status": "Terminated",
        "kind": "Main",
        "type": "FullTime",
        "rate": 1
      }
    ],
    "next": {
      "skip": 0,
      "take": 10,
      "page": 1
    },
    "prev": {
      "skip": 0,
      "take": 10,
      "page": 1
    }
  }
}

{
  "code": 403,
  "success": false,
  "cause": "Forbidden",
  "error": "Доступ к ресурсу ограничен",
  "message": "Доступ к ресурсу ограничен"
}

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

string

required

API токен сервисного пользователя в формате Bearer. Получите токен в панели администратора школы. Формат: Bearer YOUR_TOKEN.

string

required

Уникальный идентификатор продавца в системе. Используется для разграничения доступа между разными продавцами.

string

required

Уникальный идентификатор школы в системе. Определяет контекст выполнения операции.

Трудоустройство (employment) связывает пользователя школы с департаментом и, опционально, должностью. У сотрудника может быть несколько записей трудоустройства в истории, но только одна активная для конкретной пары департамент + должность. Должность можно не указывать — тогда сотрудник числится в департаменте без должности, и активная запись такого типа уникальна по паре департамент + пользователь. У записи также фиксируются условия занятости: вид (kind), тип (type) и ставка (rate).

Все эндпоинты модуля staff доступны только для школ сегмента Corporate. Для остальных сегментов запрос вернёт ошибку 403 Forbidden.

Перевод (transfer) и повышение (promote) не изменяют текущую запись, а закрывают её (finishAt, статус Terminated) и создают новую активную запись в целевом департаменте либо с новой должностью. Условия занятости (kind, type, rate) и внешний идентификатор extId переносятся в новую запись без изменений. В ответе возвращается именно новая запись трудоустройства.

У трудоустройства может быть внешний идентификатор extId — ID записи в системе клиента (например, HR-системе). От 1 до 50 символов, без / и пробелов. Уникален в рамках школы среди открытых (не завершённых) трудоустройств: при переводе или повышении extId переносится на новую активную запись (закрытая сохраняет копию). По extId доступны отдельные роуты ext/{extId}/transfer, ext/{extId}/promote и ext/{extId}/terminate.

Список трудоустройств

GET /saas/v2/staff/employment/list

Требуется аутентификация и право StaffView.

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

Параметры-массивы передаются повторением параметра в строке запроса: userIds=1&userIds=2&userIds=3.

Пагинация

integer

Количество записей, которые нужно пропустить. По умолчанию 0.

integer

Номер страницы (альтернатива skip). Начинается с 1.

integer

Количество записей на странице. По умолчанию 100, максимум 1000.

Фильтрация

integer[]

Фильтр по ID трудоустройств. До 250 значений.

string[]

Фильтр по внешним идентификаторам (extId) трудоустройств. До 250 значений, каждое до 50 символов.

integer[]

Фильтр по ID пользователей. До 250 значений.

integer[]

Фильтр по ID департаментов. До 250 значений.

string[]

Фильтр по внешним идентификаторам (extId) департаментов. До 250 значений, каждое до 50 символов.

integer[]

Фильтр по ID должностей. До 250 значений.

string[]

Фильтр по внешним идентификаторам (extId) должностей. До 250 значений, каждое до 50 символов.

enum[]

Фильтр по статусам трудоустройства. Возможные значения: Active, Terminated. До 250 значений.

boolean

Если true — вернуть только активные трудоустройства.

string

Поиск по сотруднику (имя, идентификаторы). Максимум 50 символов.

Поля ответа

object

Постраничный список трудоустройств.

Show Свойства payload

object[]

Массив трудоустройств.

Show Свойства элемента

integer

ID трудоустройства.

integer

ID школы.

integer

ID пользователя-сотрудника.

integer | null

ID должности или null — для трудоустройства без должности.

integer

ID департамента.

string | null

Внешний идентификатор трудоустройства из системы клиента или null. Уникален в рамках школы среди открытых (не завершённых) записей; при переводе/повышении переносится на новую запись.

string

Дата начала трудоустройства (ISO 8601).

string | null

Дата завершения трудоустройства (ISO 8601) или null для активной записи.

enum

Статус: Active или Terminated.

enum

Вид занятости: Main (основное место работы), InternalSecondary (внутреннее совместительство), ExternalSecondary (внешнее совместительство).

enum

Тип занятости: FullTime (полная) или PartTime (частичная).

number

Ставка — доля полной ставки, от 0.01 до 1 (например, 0.5).

string

Дата создания записи.

string

Дата последнего обновления.

integer

Текущая страница.

integer

Общее количество записей.

integer

Общее количество страниц.

boolean

Признак первой страницы.

boolean

Признак последней страницы.

object

Параметры следующей страницы (skip, take, page).

object

Параметры предыдущей страницы (skip, take, page).

curl --location 'https://api.exode.biz/saas/v2/staff/employment/list?take=10&activeOnly=true' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const axios = require('axios');

const listEmployments = async () => {
  const { data } = await axios.get('https://api.exode.biz/saas/v2/staff/employment/list', {
    params: { take: 10, activeOnly: true },
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload.items);
};

listEmployments();

{
  "success": true,
  "code": 200,
  "payload": {
    "page": 1,
    "count": 4,
    "pages": 1,
    "isFirst": true,
    "isLast": true,
    "items": [
      {
        "id": 9,
        "createdAt": "2026-07-02T11:15:47.312Z",
        "updatedAt": "2026-07-02T11:15:47.312Z",
        "archivedAt": null,
        "schoolId": 198,
        "userId": 1683,
        "positionId": 4,
        "departmentId": 4,
        "extId": "emp-1683",
        "startAt": "2026-07-02T11:15:47.316Z",
        "finishAt": null,
        "status": "Active",
        "kind": "Main",
        "type": "FullTime",
        "rate": 1
      },
      {
        "id": 8,
        "createdAt": "2026-07-02T11:15:47.295Z",
        "updatedAt": "2026-07-02T11:15:47.312Z",
        "archivedAt": null,
        "schoolId": 198,
        "userId": 1683,
        "positionId": 3,
        "departmentId": 4,
        "extId": "emp-1683",
        "startAt": "2026-07-02T11:15:47.299Z",
        "finishAt": "2026-07-02T11:15:47.316Z",
        "status": "Terminated",
        "kind": "Main",
        "type": "FullTime",
        "rate": 1
      }
    ],
    "next": {
      "skip": 0,
      "take": 10,
      "page": 1
    },
    "prev": {
      "skip": 0,
      "take": 10,
      "page": 1
    }
  }
}

{
  "code": 403,
  "success": false,
  "cause": "Forbidden",
  "error": "Доступ к ресурсу ограничен",
  "message": "Доступ к ресурсу ограничен"
}

Нанять сотрудника

POST /saas/v2/staff/employment/hire

Требуется аутентификация и право StaffManage. Создаёт новую активную запись трудоустройства. Пользователь, департамент и должность (если указана) должны принадлежать школе. У сотрудника не может быть активного дубля с той же парой департамент + должность, а при найме без должности — с той же парой департамент + пользователь. Если пользователь ранее был уволен и имеет статус Terminated, найм автоматически возвращает ему статус Active. Департамент обязателен и указывается по ID или внешнему идентификатору: в паре departmentId / departmentExtId передаётся ровно один параметр. Должность опциональна: передайте ровно один параметр из пары positionId / positionExtId, либо не передавайте оба — тогда сотрудник нанимается без должности. Оба поля одной пары одновременно передавать нельзя.

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

integer

required

ID пользователя, который принимается на работу. Пользователь должен принадлежать школе.

string

Внешний идентификатор трудоустройства из системы клиента. От 1 до 50 символов, без / и пробелов. Должен быть уникален в рамках школы среди открытых (не завершённых) трудоустройств.

integer

ID должности. Должность должна принадлежать школе. Опционально: передайте один параметр из пары positionId / positionExtId, либо не передавайте оба — сотрудник будет нанят без должности.

string

Внешний идентификатор (extId) должности — альтернатива positionId.

integer

ID департамента. Департамент должен принадлежать школе. Передаётся ровно один параметр из пары departmentId / departmentExtId.

string

Внешний идентификатор (extId) департамента — альтернатива departmentId.

string

Дата начала трудоустройства в формате ISO 8601. По умолчанию — текущий момент.

enum

Вид занятости: Main (основное место работы), InternalSecondary (внутреннее совместительство), ExternalSecondary (внешнее совместительство). По умолчанию Main.

enum

Тип занятости: FullTime (полная) или PartTime (частичная). По умолчанию FullTime.

number

Ставка — доля полной ставки, от 0.01 до 1. По умолчанию 1.

curl --location 'https://api.exode.biz/saas/v2/staff/employment/hire' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "userId": 1683,
    "extId": "emp-1683",
    "positionId": 3,
    "departmentId": 3,
    "startAt": "2026-07-02T00:00:00.000Z",
    "kind": "Main",
    "type": "PartTime",
    "rate": 0.5
  }'

const axios = require('axios');

const hireEmployment = async () => {
  const { data } = await axios.post('https://api.exode.biz/saas/v2/staff/employment/hire', {
    userId: 1683,
    extId: 'emp-1683',
    positionId: 3,
    departmentId: 3,
    startAt: '2026-07-02T00:00:00.000Z',
    kind: 'Main',
    type: 'PartTime',
    rate: 0.5,
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

hireEmployment();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 6,
    "createdAt": "2026-07-02T11:15:47.273Z",
    "updatedAt": "2026-07-02T11:15:47.273Z",
    "archivedAt": null,
    "schoolId": 198,
    "userId": 1683,
    "positionId": 3,
    "departmentId": 3,
    "extId": "emp-1683",
    "startAt": "2026-07-02T11:15:47.273Z",
    "finishAt": null,
    "status": "Active",
    "kind": "Main",
    "type": "PartTime",
    "rate": 0.5
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentAlreadyExists",
  "message": "Staff active employment already exists",
  "error": "Staff active employment already exists"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentExtIdIsNotUniq",
  "message": "Staff employment extId is not uniq",
  "error": "Staff employment extId is not uniq"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffPositionNotFound",
  "message": "Staff position not found",
  "error": "Staff position not found"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffDepartmentNotFound",
  "message": "Staff department not found",
  "error": "Staff department not found"
}

{
  "code": 400,
  "success": false,
  "cause": "UserNotBelongsToSchool",
  "message": "User does not belong to the school",
  "error": "User does not belong to the school"
}

Перевести в другой департамент

POST /saas/v2/staff/employment/transfer

Требуется аутентификация и право StaffManage. Закрывает текущую активную запись трудоустройства (finishAt, статус Terminated) и создаёт новую активную запись в целевом департаменте с сохранением должности. Целевой департамент должен принадлежать школе, у сотрудника не должно быть активного дубля в целевом департаменте.

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

integer

required

ID переводимой активной записи трудоустройства.

integer

ID целевого департамента. Департамент должен принадлежать школе. Передаётся ровно один параметр из пары toDepartmentId / toDepartmentExtId.

string

Внешний идентификатор (extId) целевого департамента — альтернатива toDepartmentId.

string

Дата перевода в формате ISO 8601. Должна попадать в интервал текущего трудоустройства. По умолчанию — текущий момент.

curl --location 'https://api.exode.biz/saas/v2/staff/employment/transfer' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "employmentId": 6,
    "toDepartmentId": 4,
    "startAt": "2026-07-02T00:00:00.000Z"
  }'

const axios = require('axios');

const transferEmployment = async () => {
  const { data } = await axios.post('https://api.exode.biz/saas/v2/staff/employment/transfer', {
    employmentId: 6,
    toDepartmentId: 4,
    startAt: '2026-07-02T00:00:00.000Z',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

transferEmployment();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 8,
    "createdAt": "2026-07-02T11:15:47.295Z",
    "updatedAt": "2026-07-02T11:15:47.295Z",
    "archivedAt": null,
    "schoolId": 198,
    "userId": 1683,
    "positionId": 3,
    "departmentId": 4,
    "extId": "emp-1683",
    "startAt": "2026-07-02T11:15:47.299Z",
    "finishAt": null,
    "status": "Active",
    "kind": "Main",
    "type": "FullTime",
    "rate": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentNotFound",
  "message": "Staff active employment not found",
  "error": "Staff active employment not found"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentInvalidTransitionDate",
  "message": "Staff employment transition date is outside employment interval",
  "error": "Staff employment transition date is outside employment interval"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentAlreadyExists",
  "message": "Staff active employment already exists",
  "error": "Staff active employment already exists"
}

Перевести по внешнему идентификатору

POST /saas/v2/staff/employment/ext/{extId}/transfer

Требуется аутентификация и право StaffManage. Аналог перевода по employmentId, но активная запись трудоустройства находится по внешнему идентификатору extId в рамках школы. Тело запроса — как у обычного перевода, без поля employmentId.

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

string

required

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

integer

string

Внешний идентификатор (extId) целевого департамента — альтернатива toDepartmentId.

string

curl --location 'https://api.exode.biz/saas/v2/staff/employment/ext/emp-1683/transfer' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "toDepartmentExtId": "dep-sales",
    "startAt": "2026-07-02T00:00:00.000Z"
  }'

const axios = require('axios');

const transferEmploymentByExtId = async () => {
  const extId = encodeURIComponent('emp-1683');

  const { data } = await axios.post(`https://api.exode.biz/saas/v2/staff/employment/ext/${extId}/transfer`, {
    toDepartmentExtId: 'dep-sales',
    startAt: '2026-07-02T00:00:00.000Z',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

transferEmploymentByExtId();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 8,
    "createdAt": "2026-07-02T11:15:47.295Z",
    "updatedAt": "2026-07-02T11:15:47.295Z",
    "archivedAt": null,
    "schoolId": 198,
    "userId": 1683,
    "positionId": 3,
    "departmentId": 4,
    "extId": "emp-1683",
    "startAt": "2026-07-02T11:15:47.299Z",
    "finishAt": null,
    "status": "Active",
    "kind": "Main",
    "type": "FullTime",
    "rate": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentNotFound",
  "message": "Staff active employment not found",
  "error": "Staff active employment not found"
}

Сменить должность

POST /saas/v2/staff/employment/promote

Требуется аутентификация и право StaffManage. Закрывает текущую активную запись трудоустройства (finishAt, статус Terminated) и создаёт новую активную запись с новой должностью в том же департаменте. Целевая должность должна принадлежать школе, у сотрудника не должно быть активного дубля с новой должностью. Запрос должен явно выражать намерение: передайте должность (toPositionId или toPositionExtId), чтобы назначить её, либо toPositionId: null, чтобы снять должность (сотрудник останется в департаменте без должности). Если не передать ни одно из этих полей, вернётся ошибка StaffEmploymentInputRequired.

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

integer

required

ID изменяемой активной записи трудоустройства.

integer | null

ID целевой должности. Должность должна принадлежать школе. Передаётся ровно один параметр из пары toPositionId / toPositionExtId. Значение null снимает должность — трудоустройство остаётся в департаменте без должности. Оба поля пары одновременно передавать нельзя.

string

Внешний идентификатор (extId) целевой должности — альтернатива toPositionId.

string

Дата смены должности в формате ISO 8601. Должна попадать в интервал текущего трудоустройства. По умолчанию — текущий момент.

curl --location 'https://api.exode.biz/saas/v2/staff/employment/promote' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "employmentId": 8,
    "toPositionId": 4,
    "startAt": "2026-07-02T00:00:00.000Z"
  }'

const axios = require('axios');

const promoteEmployment = async () => {
  const { data } = await axios.post('https://api.exode.biz/saas/v2/staff/employment/promote', {
    employmentId: 8,
    toPositionId: 4,
    startAt: '2026-07-02T00:00:00.000Z',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

promoteEmployment();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 9,
    "createdAt": "2026-07-02T11:15:47.312Z",
    "updatedAt": "2026-07-02T11:15:47.312Z",
    "archivedAt": null,
    "schoolId": 198,
    "userId": 1683,
    "positionId": 4,
    "departmentId": 4,
    "extId": "emp-1683",
    "startAt": "2026-07-02T11:15:47.316Z",
    "finishAt": null,
    "status": "Active",
    "kind": "Main",
    "type": "FullTime",
    "rate": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentNotFound",
  "message": "Staff active employment not found",
  "error": "Staff active employment not found"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentInvalidTransitionDate",
  "message": "Staff employment transition date is outside employment interval",
  "error": "Staff employment transition date is outside employment interval"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentAlreadyExists",
  "message": "Staff active employment already exists",
  "error": "Staff active employment already exists"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentInputRequired",
  "message": "Staff employment promote target position is required",
  "error": "Staff employment promote target position is required"
}

Сменить должность по внешнему идентификатору

POST /saas/v2/staff/employment/ext/{extId}/promote

Требуется аутентификация и право StaffManage. Аналог смены должности по employmentId, но активная запись трудоустройства находится по внешнему идентификатору extId в рамках школы. Тело запроса — как у обычной смены должности, без поля employmentId: передайте должность, чтобы назначить её, либо toPositionId: null, чтобы снять её; иначе — ошибка StaffEmploymentInputRequired.

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

string

required

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

integer | null

string

Внешний идентификатор (extId) целевой должности — альтернатива toPositionId.

string

curl --location 'https://api.exode.biz/saas/v2/staff/employment/ext/emp-1683/promote' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "toPositionExtId": "pos-lead",
    "startAt": "2026-07-02T00:00:00.000Z"
  }'

const axios = require('axios');

const promoteEmploymentByExtId = async () => {
  const extId = encodeURIComponent('emp-1683');

  const { data } = await axios.post(`https://api.exode.biz/saas/v2/staff/employment/ext/${extId}/promote`, {
    toPositionExtId: 'pos-lead',
    startAt: '2026-07-02T00:00:00.000Z',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

promoteEmploymentByExtId();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 9,
    "createdAt": "2026-07-02T11:15:47.312Z",
    "updatedAt": "2026-07-02T11:15:47.312Z",
    "archivedAt": null,
    "schoolId": 198,
    "userId": 1683,
    "positionId": 4,
    "departmentId": 4,
    "extId": "emp-1683",
    "startAt": "2026-07-02T11:15:47.316Z",
    "finishAt": null,
    "status": "Active",
    "kind": "Main",
    "type": "FullTime",
    "rate": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentNotFound",
  "message": "Staff active employment not found",
  "error": "Staff active employment not found"
}

Уволить сотрудника

POST /saas/v2/staff/employment/terminate

Требуется аутентификация и право StaffManage. Закрывает активную запись трудоустройства: проставляет finishAt, переводит статус в Terminated и снимает сотрудника с руководства департаментами. В ответе возвращается закрытая запись.

Увольнение с последнего активного трудоустройства автоматически переводит пользователя в статус Terminated — доступ к платформе закрывается: вход запрещён, активные сессии завершаются. Повторный найм (hire) пользователя со статусом Terminated автоматически возвращает ему статус Active.

Защиты при увольнении с последнего активного трудоустройства: нельзя уволить самого себя (StaffCannotTerminateSelf) и владельца школы (StaffCannotTerminateSchoolOwner).

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

integer

required

ID увольняемой активной записи трудоустройства.

string

Дата увольнения в формате ISO 8601. Должна попадать в интервал текущего трудоустройства. По умолчанию — текущий момент.

curl --location 'https://api.exode.biz/saas/v2/staff/employment/terminate' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "employmentId": 7,
    "finishAt": "2026-07-02T00:00:00.000Z"
  }'

const axios = require('axios');

const terminateEmployment = async () => {
  const { data } = await axios.post('https://api.exode.biz/saas/v2/staff/employment/terminate', {
    employmentId: 7,
    finishAt: '2026-07-02T00:00:00.000Z',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

terminateEmployment();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 7,
    "createdAt": "2026-07-02T11:15:47.284Z",
    "updatedAt": "2026-07-02T11:15:47.400Z",
    "archivedAt": null,
    "schoolId": 198,
    "userId": 1684,
    "positionId": 3,
    "departmentId": 4,
    "extId": "emp-1684",
    "startAt": "2026-07-02T11:15:47.285Z",
    "finishAt": "2026-07-02T11:15:47.401Z",
    "status": "Terminated",
    "kind": "Main",
    "type": "FullTime",
    "rate": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentInvalidTransitionDate",
  "message": "Staff employment transition date is outside employment interval",
  "error": "Staff employment transition date is outside employment interval"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffCannotTerminateSelf",
  "message": "Staff cannot terminate himself",
  "error": "Staff cannot terminate himself"
}

{
  "code": 400,
  "success": false,
  "cause": "StaffCannotTerminateSchoolOwner",
  "message": "Staff school owner cannot be terminated",
  "error": "Staff school owner cannot be terminated"
}

Уволить по внешнему идентификатору

POST /saas/v2/staff/employment/ext/{extId}/terminate

Требуется аутентификация и право StaffManage. Аналог увольнения по employmentId, но активная запись трудоустройства находится по внешнему идентификатору extId в рамках школы. Тело запроса — как у обычного увольнения, без поля employmentId. Действуют те же защиты и та же логика перевода пользователя в статус Terminated при увольнении с последнего активного трудоустройства.

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

string

required

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

string

curl --location 'https://api.exode.biz/saas/v2/staff/employment/ext/emp-1684/terminate' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "finishAt": "2026-07-02T00:00:00.000Z"
  }'

const axios = require('axios');

const terminateEmploymentByExtId = async () => {
  const extId = encodeURIComponent('emp-1684');

  const { data } = await axios.post(`https://api.exode.biz/saas/v2/staff/employment/ext/${extId}/terminate`, {
    finishAt: '2026-07-02T00:00:00.000Z',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

terminateEmploymentByExtId();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 7,
    "createdAt": "2026-07-02T11:15:47.284Z",
    "updatedAt": "2026-07-02T11:15:47.400Z",
    "archivedAt": null,
    "schoolId": 198,
    "userId": 1684,
    "positionId": 3,
    "departmentId": 4,
    "extId": "emp-1684",
    "startAt": "2026-07-02T11:15:47.285Z",
    "finishAt": "2026-07-02T11:15:47.401Z",
    "status": "Terminated",
    "kind": "Main",
    "type": "FullTime",
    "rate": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffEmploymentNotFound",
  "message": "Staff active employment not found",
  "error": "Staff active employment not found"
}

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

Модуль staff доступен только для школ сегмента Corporate. Для чтения списка требуется право StaffView, для операций найма, перевода, повышения и увольнения — право StaffManage.

Сервисный пользователь должен быть аутентифицирован по токену и иметь соответствующие права доступа к указанной школе.

Обновлено: 2026-07-22 12:19 UTC

Работа с API

Пользователи

Сотрудники (HR)

Группы

Курсы

Доступы и продажи

Отчеты и выгрузки

Кастомные поля

Формы

Нет нужного метода?

Все объекты

Трудоустройства

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

Список трудоустройств

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

Пагинация

Фильтрация

Поля ответа

Нанять сотрудника

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

Перевести в другой департамент

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

Перевести по внешнему идентификатору

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

Сменить должность

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

Сменить должность по внешнему идентификатору

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

Уволить сотрудника

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

Уволить по внешнему идентификатору

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

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

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

​Список трудоустройств

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

​Пагинация

​Фильтрация

​Поля ответа

​Нанять сотрудника

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

​Перевести в другой департамент

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

​Перевести по внешнему идентификатору

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

​Сменить должность

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

​Сменить должность по внешнему идентификатору

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

​Уволить сотрудника

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

​Уволить по внешнему идентификатору

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

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

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

Список трудоустройств

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

Пагинация

Фильтрация

Поля ответа

Нанять сотрудника

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

Перевести в другой департамент

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

Перевести по внешнему идентификатору

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

Сменить должность

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

Сменить должность по внешнему идентификатору

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

Уволить сотрудника

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

Уволить по внешнему идентификатору

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

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