# Дневные отчёты

Отчёт сотрудника о рабочем дне: чтение отчётов и сохранение текста отчёта в свою запись рабочего времени.

Отчёт привязан к записи рабочего дня, её `id` берётся из [истории рабочего дня](/docs/workday/records). Из чего состоит отчёт — [Поля отчёта](/docs/workday/daily-reports/fields).

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

## Операции

- [Список дневных отчётов](./daily-reports/list.md) — `GET /v1/workday/daily-reports`
- [Получить дневной отчёт](./daily-reports/get.md) — `GET /v1/workday/records/:recordId/report`
- [Сохранить дневной отчёт](./daily-reports/save.md) — `PUT /v1/workday/records/:recordId/report`

## Доступ

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

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

1. Найти запись рабочего дня: [`GET /v1/workday/records`](/docs/workday/records). Из ответа взять `id` записи.
2. Сохранить текст отчёта: [`PUT /v1/workday/records/:recordId/report`](./daily-reports/save.md).
3. Прочитать отчёт этой записи: [`GET /v1/workday/records/:recordId/report`](./daily-reports/get.md). Все отчёты сотрудника: [`GET /v1/workday/daily-reports`](./daily-reports/list.md).

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

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