Для AI-агентов: markdown этой страницы — /docs-content/workday/work-reports/send.md индекс документации — /llms.txt

Отправить рабочий отчёт

POST /v1/workday/work-reports/:id/send

Отправляет ранее созданный рабочий отчёт по ID и отмечает его сданным, не меняя текст.

Требуется скоуп timeman. Битрикс24 проверяет права владельца учётных данных. Ключ READONLY может читать отчёты, запись запрещена.

Параметры

Параметр Тип Обяз. По умолч. Описание
id (path) integer да — ID отчёта. Список: GET /v1/workday/work-reports

Тело запроса не нужно. Пустой объект {} принимается, любое поле в теле возвращает 400 INVALID_PARAMS.

Примеры

curl — личный ключ

Terminal
curl -X POST "https://vibecode.bitrix24.tech/v1/workday/work-reports/159/send" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth-приложение

Terminal
curl -X POST "https://vibecode.bitrix24.tech/v1/workday/work-reports/159/send" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — личный ключ

javascript
const res = await fetch('https://vibecode.bitrix24.tech/v1/workday/work-reports/159/send', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})
const { data } = await res.json()

JavaScript — OAuth-приложение

javascript
const res = await fetch('https://vibecode.bitrix24.tech/v1/workday/work-reports/159/send', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})
const { data } = await res.json()

Поля ответа

Поле Тип Описание
success boolean true при успешной отправке
data object Сданный отчёт. Все поля — Поля отчёта

Пример ответа

Показаны основные поля отчёта. Полный список — Поля отчёта:

JSON
{
  "success": true,
  "data": {
    "id": 159,
    "userId": 101,
    "active": true,
    "reportType": "day",
    "reportDate": "2026-10-06T19:09:31.000Z",
    "dateFrom": "2026-10-06T21:00:00.000Z",
    "dateTo": "2026-10-06T21:00:00.000Z",
    "report": "Weekly report",
    "type": "REPORT",
    "mark": "N",
    "approve": "Y"
  }
}

Пример ответа при ошибке

404 — отчёта с таким id нет:

JSON
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "Report not found."
  }
}

Ошибки

HTTP Код Описание
400 INVALID_PARAMS В id не положительное целое число, тело запроса не JSON-объект или в теле есть поле
404 ENTITY_NOT_FOUND Отчёта с таким id нет
403 BITRIX_ACCESS_DENIED Отчёт другого сотрудника, и у владельца учётных данных нет прав в Битрикс24 менять отчёты этого сотрудника
409 TIMEMAN_MODULE_NOT_ENABLED Учёт рабочего времени недоступен на портале
422 BITRIX_ERROR Битрикс24 отказал в операции
502 BITRIX_UNAVAILABLE Битрикс24 недоступен или вернул ответ неожиданной формы
401 MISSING_API_KEY Не передан заголовок X-Api-Key
401 TOKEN_MISSING Ключ приложения передан без токена сессии в Authorization: Bearer
401 INVALID_SESSION Токен сессии неверный или истёк
403 WRITE_BLOCKED_READONLY_KEY Ключ READONLY, отправлять отчёты нельзя
403 SCOPE_DENIED У ключа нет скоупа timeman
429 RATE_LIMITED Превышен общий лимит запросов

Полный список общих ошибок API — Ошибки.

Известные особенности

  • Подтверждение зависит от руководителей сотрудника. Если у сотрудника есть руководители, отчёт ждёт их оценки: approve равен "N". Если руководителей нет, отчёт подтверждается сразу: approve равен "Y".
  • Повторная отправка ничего не меняет. Уже сданный отчёт возвращается без изменений.

Смотрите также