Отсутствия

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

const axios = require('axios');

const listAbsences = async () => {
  const { data } = await axios.get('https://api.exode.biz/saas/v2/staff/absence/list', {
    params: { take: 10, types: ['Vacation'] },
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

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

listAbsences();

{
  "success": true,
  "code": 200,
  "payload": {
    "page": 1,
    "count": 1,
    "pages": 1,
    "isFirst": true,
    "isLast": true,
    "items": [
      {
        "id": 2,
        "createdAt": "2026-07-02T11:15:47.341Z",
        "updatedAt": "2026-07-02T11:15:47.354Z",
        "archivedAt": null,
        "schoolId": 198,
        "employmentId": 9,
        "extId": "1c-absence-2024-001",
        "type": "Vacation",
        "startAt": "2026-07-06T00:00:00.000Z",
        "finishAt": "2026-07-20T00:00:00.000Z",
        "note": "Summer vacation (updated)"
      }
    ],
    "next": {
      "skip": 0,
      "take": 10,
      "page": 1
    },
    "prev": {
      "skip": 0,
      "take": 10,
      "page": 1
    }
  }
}

{
  "code": 401,
  "success": false,
  "cause": "Forbidden",
  "error": "Forbidden seller resource - permissions StaffView",
  "message": "Forbidden seller resource - permissions StaffView"
}

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

const axios = require('axios');

const listAbsences = async () => {
  const { data } = await axios.get('https://api.exode.biz/saas/v2/staff/absence/list', {
    params: { take: 10, types: ['Vacation'] },
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

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

listAbsences();

{
  "success": true,
  "code": 200,
  "payload": {
    "page": 1,
    "count": 1,
    "pages": 1,
    "isFirst": true,
    "isLast": true,
    "items": [
      {
        "id": 2,
        "createdAt": "2026-07-02T11:15:47.341Z",
        "updatedAt": "2026-07-02T11:15:47.354Z",
        "archivedAt": null,
        "schoolId": 198,
        "employmentId": 9,
        "extId": "1c-absence-2024-001",
        "type": "Vacation",
        "startAt": "2026-07-06T00:00:00.000Z",
        "finishAt": "2026-07-20T00:00:00.000Z",
        "note": "Summer vacation (updated)"
      }
    ],
    "next": {
      "skip": 0,
      "take": 10,
      "page": 1
    },
    "prev": {
      "skip": 0,
      "take": 10,
      "page": 1
    }
  }
}

{
  "code": 401,
  "success": false,
  "cause": "Forbidden",
  "error": "Forbidden seller resource - permissions StaffView",
  "message": "Forbidden seller resource - permissions StaffView"
}

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

string

обязательно

API-токен сервисного пользователя в формате Bearer YOUR_TOKEN. Токен выпускает владелец школы в кабинете: Управление → Школа → Для разработчиков → API-ключи — подробнее в разделе «Аутентификация».

integer

обязательно

Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице API-ключи в карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.

integer

обязательно

Числовой ID школы, берётся там же, где Seller-Id. Значение должно совпадать со школой продавца — иначе вернётся ошибка 400 с cause: "ForbiddenSchoolMismatch".

Отсутствие (absence) фиксирует период, когда сотрудник не работает: отсутствие без уточнения причины (Absent), отпуск (Vacation), отгул (DayOff), командировку (BusinessTrip), больничный (SickLeave), отпуск по уходу за ребёнком (ParentalLeave) или учебный отпуск (StudyLeave). Отсутствие привязывается к трудоустройству сотрудника, а не к пользователю: если у сотрудника несколько мест работы, укажите то, к которому относится отсутствие (на статус пользователя это не влияет — учитываются отсутствия по всем его трудоустройствам).

startAt и finishAt — моменты времени (ISO 8601, UTC), а не календарные дни. Отсутствие считается текущим, пока startAt ≤ текущий момент ≤ finishAt. Отпуск «с 1 по 14 августа включительно» передавайте как startAt: "2026-08-01T00:00:00Z", finishAt: "2026-08-14T23:59:59Z" (с поправкой на часовой пояс компании): значение 2026-08-14T00:00:00Z завершит отсутствие в начале 14-го числа. Без finishAt отсутствие действует бессрочно, пока вы не зададите дату окончания.

Создание, обновление и удаление отсутствия автоматически синхронизирует статус пользователя Active ↔ OnLeave: если у пользователя есть текущее (действующее на данный момент) отсутствие — статус становится OnLeave, если текущих отсутствий не осталось — возвращается Active. OnLeave — информационный статус: вход и доступ к платформе он не блокирует. Переходы не затрагивают пользователей в других статусах (Banned, Blocked, Terminated). Помимо пересчёта при API-вызовах, платформа раз в час автоматически сверяет статусы с календарём: отсутствие с будущей датой начала переведёт сотрудника в OnLeave при её наступлении, а истёкшее — вернёт Active без каких-либо вызовов с вашей стороны.

Все эндпоинты модуля staff доступны только для школ сегмента Corporate. Для остальных сегментов запрос вернёт 401 с cause: "Forbidden" и сообщением Allowed only for Corporate school.

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

GET /saas/v2/staff/absence/list

Требуется аутентификация и право «Просмотр персонала» (StaffView).

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

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

Пагинация

integer

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

integer

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

integer

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

Фильтрация

string[]

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

integer[]

Фильтр по ID трудоустройств. До 250 значений. При переводе и смене должности отсутствия остаются на закрытой записи трудоустройства, поэтому для всей истории сотрудника передайте ID всех его записей — их можно получить через employment/list?userIds=....

integer[]

Фильтр по ID должностей (должность берётся из трудоустройства, к которому привязано отсутствие). До 250 значений.

enum[]

Фильтр по типам отсутствия. Возможные значения: Absent, Vacation, DayOff, BusinessTrip, SickLeave, ParentalLeave, StudyLeave. До 250 значений.

boolean

Если true — вернуть только текущие отсутствия: startAt уже наступил, а finishAt не задан или ещё не прошёл.

Поля ответа

object

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

Показать Свойства payload

object[]

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

Показать Свойства элемента

integer

ID отсутствия.

integer

ID школы.

integer

ID трудоустройства сотрудника.

string | null

Внешний идентификатор из системы клиента. Уникален в рамках школы среди неудалённых записей.

enum

Тип отсутствия: Absent, Vacation, DayOff, BusinessTrip, SickLeave, ParentalLeave или StudyLeave.

string

Дата начала отсутствия (ISO 8601).

string | null

Дата окончания отсутствия (ISO 8601) или null.

string | null

Комментарий к отсутствию.

string

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

string

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

integer

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

integer

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

integer

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

boolean

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

boolean

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

object

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

object

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

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

const axios = require('axios');

const listAbsences = async () => {
  const { data } = await axios.get('https://api.exode.biz/saas/v2/staff/absence/list', {
    params: { take: 10, types: ['Vacation'] },
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

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

listAbsences();

{
  "success": true,
  "code": 200,
  "payload": {
    "page": 1,
    "count": 1,
    "pages": 1,
    "isFirst": true,
    "isLast": true,
    "items": [
      {
        "id": 2,
        "createdAt": "2026-07-02T11:15:47.341Z",
        "updatedAt": "2026-07-02T11:15:47.354Z",
        "archivedAt": null,
        "schoolId": 198,
        "employmentId": 9,
        "extId": "1c-absence-2024-001",
        "type": "Vacation",
        "startAt": "2026-07-06T00:00:00.000Z",
        "finishAt": "2026-07-20T00:00:00.000Z",
        "note": "Summer vacation (updated)"
      }
    ],
    "next": {
      "skip": 0,
      "take": 10,
      "page": 1
    },
    "prev": {
      "skip": 0,
      "take": 10,
      "page": 1
    }
  }
}

{
  "code": 401,
  "success": false,
  "cause": "Forbidden",
  "error": "Forbidden seller resource - permissions StaffView",
  "message": "Forbidden seller resource - permissions StaffView"
}

Создать отсутствие

POST /saas/v2/staff/absence/create

Требуется аутентификация и право «Управление персоналом» (StaffManage).

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

Трудоустройство указывается ровно одним из двух полей: employmentId или employmentExtId.

string

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

integer

ID трудоустройства сотрудника, к которому относится отсутствие. Обязателен, если не передан employmentExtId. Можно указать и уже закрытую запись — например, при переносе истории отсутствий.

string

Внешний идентификатор (extId) трудоустройства — тот, что вы передали при найме. Альтернатива employmentId — обязателен, если не передан employmentId. Ищется только среди открытых (не уволенных) трудоустройств школы; если такого нет — вернётся ошибка StaffEmploymentNotFound.

enum

обязательно

Тип отсутствия. Возможные значения: Absent (отсутствует), Vacation (отпуск), DayOff (отгул), BusinessTrip (командировка), SickLeave (больничный), ParentalLeave (отпуск по уходу за ребёнком), StudyLeave (учебный отпуск).

string

обязательно

Дата начала отсутствия в формате ISO 8601. Должна быть не позже finishAt.

string

Дата окончания отсутствия в формате ISO 8601. Должна быть не раньше startAt, иначе запрос будет отклонён. Не передавайте, если дата окончания пока неизвестна.

string

Комментарий к отсутствию. Максимум 500 символов. Автоматически обрезаются пробелы в начале и конце.

curl --location 'https://api.exode.biz/saas/v2/staff/absence/create' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "extId": "1c-absence-2024-001",
    "employmentId": 9,
    "type": "Vacation",
    "startAt": "2026-07-06T00:00:00.000Z",
    "finishAt": "2026-07-20T00:00:00.000Z",
    "note": "Summer vacation"
  }'

const axios = require('axios');

const createAbsence = async () => {
  const { data } = await axios.post('https://api.exode.biz/saas/v2/staff/absence/create', {
    extId: '1c-absence-2024-001',
    employmentId: 9,
    type: 'Vacation',
    startAt: '2026-07-06T00:00:00.000Z',
    finishAt: '2026-07-20T00:00:00.000Z',
    note: 'Summer vacation',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

createAbsence();

{
  "success": true,
  "code": 201,
  "payload": {
    "id": 2,
    "createdAt": "2026-07-02T11:15:47.341Z",
    "updatedAt": "2026-07-02T11:15:47.341Z",
    "archivedAt": null,
    "schoolId": 198,
    "employmentId": 9,
    "extId": "1c-absence-2024-001",
    "type": "Vacation",
    "startAt": "2026-07-06T00:00:00.000Z",
    "finishAt": "2026-07-20T00:00:00.000Z",
    "note": "Summer vacation"
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffAbsenceInvalidInterval",
  "message": "Staff absence interval is invalid",
  "error": "Staff absence interval is invalid"
}

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

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

Обновить отсутствие

PUT /saas/v2/staff/absence/{absenceId}/update

Требуется аутентификация и право «Управление персоналом» (StaffManage). Обновляет поля отсутствия. Все поля тела необязательны — передавайте только те, которые нужно изменить. Привязку к трудоустройству (employmentId) изменить нельзя.

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

integer

обязательно

ID обновляемого отсутствия.

string

enum

Тип отсутствия. Возможные значения: Absent, Vacation, DayOff, BusinessTrip, SickLeave, ParentalLeave, StudyLeave.

string

Дата начала отсутствия в формате ISO 8601. Должна быть не позже finishAt.

string | null

Дата окончания отсутствия в формате ISO 8601. Должна быть не раньше startAt (с учётом уже сохранённого значения, если startAt не передан), иначе вернётся StaffAbsenceInvalidInterval. null снимает дату окончания — отсутствие становится бессрочным.

string

Комментарий к отсутствию. Максимум 500 символов.

curl --location --request PUT 'https://api.exode.biz/saas/v2/staff/absence/2/update' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "note": "Summer vacation (updated)"
  }'

const axios = require('axios');

const updateAbsence = async () => {
  const { data } = await axios.put('https://api.exode.biz/saas/v2/staff/absence/2/update', {
    note: 'Summer vacation (updated)',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

updateAbsence();

{
  "success": true,
  "code": 200,
  "payload": {
    "id": 2,
    "createdAt": "2026-07-02T11:15:47.341Z",
    "updatedAt": "2026-07-02T11:15:47.354Z",
    "archivedAt": null,
    "schoolId": 198,
    "employmentId": 9,
    "extId": "1c-absence-2024-001",
    "type": "Vacation",
    "startAt": "2026-07-06T00:00:00.000Z",
    "finishAt": "2026-07-20T00:00:00.000Z",
    "note": "Summer vacation (updated)"
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffAbsenceInvalidInterval",
  "message": "Staff absence interval is invalid",
  "error": "Staff absence interval is invalid"
}

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

Обновить отсутствие по extId

PUT /saas/v2/staff/absence/ext/{extId}/update

Требуется аутентификация и право «Управление персоналом» (StaffManage). Аналог обновления по absenceId, но отсутствие идентифицируется внешним идентификатором (extId) в рамках школы. Тело запроса такое же, как у PUT /saas/v2/staff/absence/{absenceId}/update.

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

string

обязательно

Внешний идентификатор обновляемого отсутствия. Передаётся в URL-encoded виде.

string

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

enum

Тип отсутствия. Возможные значения: Absent, Vacation, DayOff, BusinessTrip, SickLeave, ParentalLeave, StudyLeave.

string

Дата начала отсутствия в формате ISO 8601. Должна быть не позже finishAt.

string | null

string

Комментарий к отсутствию. Максимум 500 символов.

curl --location --request PUT 'https://api.exode.biz/saas/v2/staff/absence/ext/1c-absence-2024-001/update' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "note": "Summer vacation (updated)"
  }'

const axios = require('axios');

const updateAbsenceByExtId = async () => {
  const extId = encodeURIComponent('1c-absence-2024-001');

  const { data } = await axios.put(`https://api.exode.biz/saas/v2/staff/absence/ext/${extId}/update`, {
    note: 'Summer vacation (updated)',
  }, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

updateAbsenceByExtId();

{
  "success": true,
  "code": 200,
  "payload": {
    "id": 2,
    "createdAt": "2026-07-02T11:15:47.341Z",
    "updatedAt": "2026-07-02T11:15:47.354Z",
    "archivedAt": null,
    "schoolId": 198,
    "employmentId": 9,
    "extId": "1c-absence-2024-001",
    "type": "Vacation",
    "startAt": "2026-07-06T00:00:00.000Z",
    "finishAt": "2026-07-20T00:00:00.000Z",
    "note": "Summer vacation (updated)"
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffAbsenceNotFound",
  "message": "Staff absence not found",
  "error": "Staff absence not found"
}

Удалить отсутствие

DELETE /saas/v2/staff/absence/{absenceId}/delete

Требуется аутентификация и право «Управление персоналом» (StaffManage).

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

integer

обязательно

ID удаляемого отсутствия.

Ответ

integer

обязательно

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

curl --location --request DELETE 'https://api.exode.biz/saas/v2/staff/absence/2/delete' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const axios = require('axios');

const deleteAbsence = async () => {
  const { data } = await axios.delete('https://api.exode.biz/saas/v2/staff/absence/2/delete', {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

deleteAbsence();

{
  "success": true,
  "code": 200,
  "payload": {
    "affected": 1
  }
}

{
  "code": 401,
  "success": false,
  "cause": "Forbidden",
  "error": "Forbidden seller resource - permissions StaffManage",
  "message": "Forbidden seller resource - permissions StaffManage"
}

Удалить отсутствие по extId

DELETE /saas/v2/staff/absence/ext/{extId}/delete

Требуется аутентификация и право «Управление персоналом» (StaffManage). Аналог удаления по absenceId, но отсутствие идентифицируется внешним идентификатором (extId) в рамках школы.

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

string

обязательно

Внешний идентификатор удаляемого отсутствия. Передаётся в URL-encoded виде.

Ответ

integer

обязательно

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

curl --location --request DELETE 'https://api.exode.biz/saas/v2/staff/absence/ext/1c-absence-2024-001/delete' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Authorization: Bearer YOUR_TOKEN'

const axios = require('axios');

const deleteAbsenceByExtId = async () => {
  const extId = encodeURIComponent('1c-absence-2024-001');

  const { data } = await axios.delete(`https://api.exode.biz/saas/v2/staff/absence/ext/${extId}/delete`, {
    headers: {
      'Seller-Id': '{{ sellerId }}',
      'School-Id': '{{ schoolId }}',
      'Authorization': 'Bearer YOUR_TOKEN',
    },
  });

  console.log(data.payload);
};

deleteAbsenceByExtId();

{
  "success": true,
  "code": 200,
  "payload": {
    "affected": 1
  }
}

{
  "code": 400,
  "success": false,
  "cause": "StaffAbsenceNotFound",
  "message": "Staff absence not found",
  "error": "Staff absence not found"
}

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

Модуль staff доступен только для школ сегмента Corporate. Для чтения списка требуется право «Просмотр персонала» (StaffView), для создания, обновления и удаления отсутствий — право «Управление персоналом» (StaffManage).

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

Обновлено: 2026-09-25 13:43 UTC

Работа с API

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

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

Группы

Курсы

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

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

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

Формы

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

Все объекты

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

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

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

Пагинация

Фильтрация

Поля ответа

Создать отсутствие

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

Обновить отсутствие

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

Обновить отсутствие по extId

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

Удалить отсутствие

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

Ответ

Удалить отсутствие по extId

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

Ответ

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

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

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

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

​Пагинация

​Фильтрация

​Поля ответа

​Создать отсутствие

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

​Обновить отсутствие

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

​Обновить отсутствие по extId

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

​Удалить отсутствие

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

​Ответ

​Удалить отсутствие по extId

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

​Ответ

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

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

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

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

Пагинация

Фильтрация

Поля ответа

Создать отсутствие

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

Обновить отсутствие

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

Обновить отсутствие по extId

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

Удалить отсутствие

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

Ответ

Удалить отсутствие по extId

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

Ответ

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