Для 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 — личный ключ
curl -X POST "https://vibecode.bitrix24.tech/v1/workday/work-reports/159/send" \
-H "X-Api-Key: YOUR_API_KEY"
curl — OAuth-приложение
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 — личный ключ
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-приложение
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 | Сданный отчёт. Все поля — Поля отчёта |
Пример ответа
Показаны основные поля отчёта. Полный список — Поля отчёта:
{
"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 нет:
{
"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". - Повторная отправка ничего не меняет. Уже сданный отчёт возвращается без изменений.