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

Утвердить рабочий отчёт

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

Ставит рабочему отчёту сотрудника положительную оценку и подтверждает отчёт.

Требуется скоуп 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/167/approve" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/workday/work-reports/167/approve" \
  -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/167/approve', {
  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/167/approve', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})
const { data } = await res.json()

Поля ответа

Поле Тип Описание
success boolean true при успешном запросе
data boolean true — оценка поставлена

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

JSON 
{
  "success": true,
  "data": true
}

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

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

JSON 
{
  "success": false,
  "error": {
    "code": "BITRIX_ERROR",
    "message": "Report not found or cannot be changed"
  }
}

Ошибки

HTTP Код Описание
400 INVALID_PARAMS В id не положительное целое число, тело запроса не JSON-объект или в теле есть поле
422 BITRIX_ERROR Отчёта с таким id нет, у владельца учётных данных нет права в Битрикс24 оценивать отчёты этого сотрудника или Битрикс24 отказал в операции
409 TIMEMAN_MODULE_NOT_ENABLED Учёт рабочего времени недоступен на портале
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 — Ошибки.

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

  • Что меняется в отчёте. mark становится "G", approve — "Y". approve — подтверждение отчёта: оно равно "Y" и при положительной, и при отрицательной оценке, а саму оценку несёт mark. Изменения видны в GET /v1/workday/work-reports/:id.
  • Право оценивать нужно и для своего отчёта. Сотрудник без права оценивать отчёты получает 422 BITRIX_ERROR и на собственный отчёт.
  • Утвердить можно и несданный отчёт. Он остаётся несданным, сданный — сданным: active не меняется.
  • Повторный вызов не возвращает ошибку. Оценка остаётся положительной, ответ снова true.

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