# Рабочие отчёты

Рабочий отчёт сотрудника за период: сотрудник создаёт и сдаёт отчёт, руководитель читает отчёты подчинённых и оценивает их.

Из чего состоит отчёт — [Поля отчёта](/docs/workday/work-reports/fields).

**Скоуп:** `timeman` | **Базовый URL:** `https://vibecode.bitrix24.tech/v1` | **Авторизация:** `X-Api-Key`

## Операции

- [Список рабочих отчётов](./work-reports/list.md) — `GET /v1/workday/work-reports`
- [Отчёты подчинённых](./work-reports/subordinates.md) — `GET /v1/workday/work-reports/subordinates`
- [Получить рабочий отчёт](./work-reports/get.md) — `GET /v1/workday/work-reports/:id`
- [Создать рабочий отчёт](./work-reports/create.md) — `POST /v1/workday/work-reports`
- [Обновить рабочий отчёт](./work-reports/update.md) — `PATCH /v1/workday/work-reports/:id`
- [Отправить рабочий отчёт](./work-reports/send.md) — `POST /v1/workday/work-reports/:id/send`
- [Сдать рабочий отчёт](./work-reports/submit.md) — `POST /v1/workday/work-reports/submit`
- [Утвердить рабочий отчёт](./work-reports/approve.md) — `POST /v1/workday/work-reports/:id/approve`
- [Нейтральная оценка отчёта](./work-reports/reject.md) — `POST /v1/workday/work-reports/:id/reject`
- [Отрицательная оценка отчёта](./work-reports/disapprove.md) — `POST /v1/workday/work-reports/:id/disapprove`

## Доступ

Битрикс24 проверяет права владельца учётных данных: для личного ключа это владелец ключа, для ключа приложения — пользователь, чей токен сессии передан в `Authorization`. Ключ `READONLY` читает отчёты, а создавать, править, сдавать и оценивать их не может. Каждый метод чтения принимает до 30 запросов в минуту от одной пары ключа и пользователя, сверх этого отвечает `429 RATE_LIMITED`.

## Типовой сценарий

Сотрудник:

1. Создать отчёт за период: [`POST /v1/workday/work-reports`](./work-reports/create.md). Поправить его: [`PATCH /v1/workday/work-reports/:id`](./work-reports/update.md).
2. Сдать созданный отчёт: [`POST /v1/workday/work-reports/:id/send`](./work-reports/send.md). Создать и сдать отчёт одним вызовом: [`POST /v1/workday/work-reports/submit`](./work-reports/submit.md) без `reportId`.

Руководитель:

1. Получить отчёты подчинённых: [`GET /v1/workday/work-reports/subordinates`](./work-reports/subordinates.md).
2. Оценить отчёт по его `id`: утвердить через [`approve`](./work-reports/approve.md), поставить нейтральную оценку через [`reject`](./work-reports/reject.md), отрицательную через [`disapprove`](./work-reports/disapprove.md).

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

- [Поля отчёта](/docs/workday/work-reports/fields)
- [Дневные отчёты](/docs/workday/daily-reports)
- [Рабочий день](/docs/workday)