метод REST scope: timeman

timeman.schedule.get

Получить рабочий график

Кто может выполнять: любой пользователь

Описание

Метод timeman.schedule.get получает рабочий график по идентификатору. Если графика с указанным идентификатором не существует — вернет пустой массив.

Параметры

id integer необязательный

Идентификатор графика.

Узнать идентификатор графика можно в списке графиков на странице *Сотрудники > Время и отчеты > Рабочие графики*

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":1}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/timeman.schedule.get

Ответ

HTTP-статус: 200

{
    "result": {
        "ID": 1,
        "NAME": "Для всех сотрудников",
        "SCHEDULE_TYPE": "FIXED",
        "REPORT_PERIOD": "MONTH",
        "REPORT_PERIOD_OPTIONS": {
            "START_WEEK_DAY": 0
        },
        "CALENDAR_ID": 1,
        "ALLOWED_DEVICES": {
            "browser": true
        },
        "DELETED": "0",
        "IS_FOR_ALL_USERS": true,
        "WORKTIME_RESTRICTIONS": [
            "[]"
        ],
        "CONTROLLED_ACTIONS": 3,
        "UPDATED_BY": 503,
        "DELETED_BY": 0,
        "DELETED_AT": "",
        "CREATED_BY": 0,
        "CREATED_AT": "2019-09-19T21:22:22+03:00",
        "SHIFTS": [
            {
                "ID": 1,
                "NAME": "",
                "BREAK_DURATION": 3600,
                "WORK_TIME_START": 28800,
                "WORK_TIME_END": 61200,
                "WORK_DAYS": "12345",
                "SCHEDULE_ID": 1,
                "DELETED": false
            }
        ],
        "CALENDAR": {
            "ID": 1,
            "NAME": "",
            "PARENT_CALENDAR_ID": 0,
            "SYSTEM_CODE": "",
            "EXCLUSIONS": []
        },
        "SCHEDULE_VIOLATION_RULES": {
            "ID": 1,
            "SCHEDULE_ID": 1,
            "ENTITY_CODE": "UA",
            "MAX_EXACT_START": 28859,
            "MIN_EXACT_END": 61200,
            "MAX_OFFSET_START": -1,
            "MIN_OFFSET_END": -1,
            "RELATIVE_START_FROM": -1,
            "RELATIVE_START_TO": -1,
            "RELATIVE_END_FROM": -1,
            "RELATIVE_END_TO": -1,
            "MIN_DAY_DURATION": 28800,
            "MAX_ALLOWED_TO_EDIT_WORK_TIME": 300,
            "MAX_WORK_TIME_LACK_FOR_PERIOD": 3600,
            "PERIOD_TIME_LACK_AGENT_ID": 309429,
            "MAX_SHIFT_START_DELAY": -1,
            "MISSED_SHIFT_START": 0,
            "USERS_TO_NOTIFY": {
                "FIXED_START_END": [
                    "U503"
                ],
                "FIXED_PER_RECORD": [
                    "U503"
                ],
                "FIXED_EDIT_WORKTIME": [
                    "U503"
                ],
                "FIXED_PERIODIC": [
                    "U503"
                ],
                "SHIFT_DELAY": [],
                "SHIFT_MISSED_START": []
            }
        }
    },
    "time": {
        "start": 1744036659.2339499,
        "finish": 1744036659.2655749,
        "duration": 0.031625032424926758,
        "processing": 0.008758068084716797,
        "date_start": "2025-04-07T17:37:39+03:00",
        "date_finish": "2025-04-07T17:37:39+03:00",
        "operating_reset_at": 1744037259,
        "operating": 0
    }
}

Возвращаемые данные

result object

Корневой элемент ответа.

Содержит объект с описанием графика работы сотрудников

ID integer

Идентификатор графика работы

NAME string

Название графика работы

SCHEDULE_TYPE string

Тип графика работы.

Варианты значений:
- FIXED — фиксированный
- SHIFT — посменный
- FLEXTIME — свободный

REPORT_PERIOD string

Периодичность формирования отчетов по графику.

Возможные значения:
- MONTH — месяц
- WEEK — неделя
- TWO_WEEKS — две недели
- QUARTER — квартал

REPORT_PERIOD_OPTIONS object

Объект с описанием дополнительных настроек периода формирования отчетов.

Только для REPORT_PERIOD со значениями WEEK и TWO_WEEKS

CALENDAR_ID integer

Идентификатор календаря, связанного с графиком работы

ALLOWED_DEVICES object

Объект с описанием разрешенных устройств для учета рабочего времени

DELETED string

Флаг удаления графика работы.

Значение "0" означает, что график активен. Значение "1" указывает на удаленное состояние

IS_FOR_ALL_USERS boolean

Применимость графика ко всем сотрудникам.

Значение true означает, что график применяется ко всем пользователям системы

WORKTIME_RESTRICTIONS array

Ограничения рабочего времени.

Содержит массив строк с правилами ограничений

CONTROLLED_ACTIONS integer

Количество контролируемых действий в рамках графика работы

UPDATED_BY integer

Идентификатор пользователя, который последним обновил график работы

DELETED_BY integer

Идентификатор пользователя, который удалил график работы.

Значение 0 указывает, что график не был удален

DELETED_AT string

Дата и время удаления графика работы.

Пустая строка означает, что график не был удален

CREATED_BY integer

Идентификатор пользователя, который создал график работы.

Значение 0 указывает на системное создание

CREATED_AT datetime

Дата и время создания графика работы

SHIFTS array

Массив объектов смен. Каждый объект содержит описание смены, связанной с графиком работы

CALENDAR object

Объект с информацией о календаре, связанном с графиком работы

SCHEDULE_VIOLATION_RULES object
time time

Информация о времени выполнения запроса

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.