Отсутствия

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": 403,
  "success": false,
  "cause": "Forbidden",
  "error": "Доступ к ресурсу ограничен",
  "message": "Доступ к ресурсу ограничен"
}

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

string

required

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

string

required

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

string

required

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

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

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

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

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

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 значений.

integer[]

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

enum[]

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

boolean

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

Поля ответа

object

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

Show Свойства payload

object[]

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

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

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": 403,
  "success": false,
  "cause": "Forbidden",
  "error": "Доступ к ресурсу ограничен",
  "message": "Доступ к ресурсу ограничен"
}

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

POST /saas/v2/staff/absence/create

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

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

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

string

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

integer

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

string

Внешний идентификатор (extId) трудоустройства. Альтернатива employmentId — обязателен, если не передан employmentId. Если трудоустройство не найдено в школе — вернётся ошибка StaffEmploymentNotFound.

enum

required

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

string

required

Дата начала отсутствия в формате 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

required

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

string

enum

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

string

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

string

Дата окончания отсутствия в формате ISO 8601. Должна быть не раньше startAt.

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

required

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

string

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

enum

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

string

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

string

Дата окончания отсутствия в формате ISO 8601. Должна быть не раньше startAt.

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

required

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

Ответ

integer

required

Количество удалённых записей (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": 403,
  "success": false,
  "cause": "Forbidden",
  "error": "Доступ к ресурсу ограничен",
  "message": "Доступ к ресурсу ограничен"
}

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

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

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

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

string

required

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

Ответ

integer

required

Количество удалённых записей (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-07-14 22:58 UTC

Работа с API

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

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

Группы

Курсы

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

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

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

Формы

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

Все объекты

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

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

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

Пагинация

Фильтрация

Поля ответа

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

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

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

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

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

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

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

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

Ответ

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

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

Ответ

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

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

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

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

​Пагинация

​Фильтрация

​Поля ответа

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

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

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

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

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

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

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

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

​Ответ

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

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

​Ответ

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

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

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

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

Пагинация

Фильтрация

Поля ответа

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

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

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

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

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

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

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

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

Ответ

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

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

Ответ

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