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

Отрицательная оценка отчёта

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

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

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

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

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/workday/work-reports/167/disapprove" \
  -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/disapprove', {
  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/disapprove', {
  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 становится "B", approve — "Y". approve — подтверждение отчёта: оно равно "Y" и при положительной, и при отрицательной оценке, а саму оценку несёт mark. Изменения видны в GET /v1/workday/work-reports/:id.
  • Право оценивать нужно и для своего отчёта. Сотрудник без права оценивать отчёты получает 422 BITRIX_ERROR и на собственный отчёт.
  • Оценить можно и несданный отчёт. Он остаётся несданным, сданный — сданным: active не меняется.
  • Повторный вызов не возвращает ошибку. Оценка остаётся отрицательной, ответ снова true.

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