метод REST scope: timeman

timeman.timecontrol.report.add

Добавить отчет об отсутствии

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

Описание

Метод timeman.timecontrol.report.add отправляет отчет об отсутствии и добавляет его в календарь.

По умолчанию пользователь может отправить отчет только для себя. Администратор портала может отправить отчет любому — для этого в параметре USER_ID нужно указать идентификатор пользователя.

Параметры

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

Идентификатор записи об отсутствии.

Получить идентификаторы записей можно методом timeman.timecontrol.reports.get

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

Идентификатор пользователя. Может указать только администратор.

Получить идентификатор пользователя можно методом user.get

TEXT string обязательный

Текст отчета

TYPE string необязательный

Тип отчета:
- WORK — рабочий
- PRIVATE — личный

Значение по умолчанию — PRIVATE

CALENDAR string необязательный

Добавлять событие в календарь:
- Y — да
- N — нет

Значение по умолчанию — Y

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"REPORT_ID":123,"TEXT":"Работал над проектом","TYPE":"WORK","CALENDAR":"Y"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/timeman.timecontrol.report.add

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1743056587.6559751,
        "finish": 1743056587.8529301,
        "duration": 0.19695496559143066,
        "processing": 0.16714906692504883,
        "date_start": "2025-03-27T09:23:07+03:00",
        "date_finish": "2025-03-27T09:23:07+03:00",
        "operating_reset_at": 1743057187,
        "operating": 0.1671299934387207
    }
}

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

result boolean

Результат выполнения. Возвращает true, если отчет добавлен успешно

time time

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

Обработка ошибок

HTTP-статус: 400

{
    "error": "TEXT_EMPTY",
    "error_description": "Text can't be empty"
}
Код Описание Значение
ACCESS_ERROR You don't have access for this report У вас нет доступа к этому отчету
TEXT_EMPTY Text can't be empty Текст отчета не может быть пустым

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

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