Поля отчёта

Рабочий отчёт сотрудника — объект, который возвращают методы раздела «Рабочие отчёты». Здесь его поля, типы и допустимые значения.

В ответе методов Получить рабочий отчёт, Создать рабочий отчёт, Обновить рабочий отчёт, Сдать рабочий отчёт и Отправить рабочий отчёт отчёт приходит в поле data. В ответе метода Список рабочих отчётов отчёты — элементы массива data, а параметр select оставляет в каждом отчёте id и перечисленные поля. В ответе метода Отчёты подчинённых data — массив сотрудников, а отчёты каждого — элементы его массива reports. Даты — строки ISO 8601 в UTC или null. Ключи внутри задач и событий приходят в верхнем регистре.

Поле	Тип	Описание
id	integer	ID отчёта. Список: GET /v1/workday/work-reports
userId	integer	ID сотрудника, чей это отчёт. Список: GET /v1/users
active	boolean | null	Сдан ли отчёт: true — сдан, false — нет. Сдают отчёт методы Сдать рабочий отчёт и Отправить рабочий отчёт
reportType	string | null	Длина периода отчёта: day — один день, week — от двух до семи дней, month — больше семи дней. null, если у отчёта нет дат периода
reportDate	string | null	Время создания отчёта. Обновление и сдача его не меняют
dateFrom	string | null	Первый день периода отчёта. Приходит как начало суток, переведённое в UTC: 6 октября по московскому времени — 2026-10-05T21:00:00.000Z
dateTo	string | null	Последний день периода отчёта в том же виде. У отчёта за один день совпадает с dateFrom
report	string | null	Текст отчёта из поля запроса reportText с разметкой BB-кода. Переданный HTML-тег <i> возвращается как [i]
reportPlain	string | null	Текст отчёта без разметки
reportExtended	string | null	Дополнительный текст отчёта. Пустая строка, если его нет
type	string | null	Тип отчёта: REPORT, AI_REPORT, ROBOT_REPORT, AI_DAY_PLAN или ROBOT_DAY_PLAN
plans	string | null	Планы. Пустая строка, если их нет
tasks	array | null	Задачи в отчёте. null, если задачи не передавали, [] — если список очистили пустым массивом
tasks[].ID	integer	ID задачи. Список: GET /v1/tasks
tasks[].TITLE	string	Название задачи в отчёте. Приходит, если передано
tasks[].TIME	integer	Время по задаче в секундах. Приходит, если передано
events	array | null	События календаря в отчёте. null, если события не передавали, [] — если список очистили пустым массивом
events[].ID	integer	ID события календаря. Список: GET /v1/calendar-events
events[].TITLE	string	Название события в отчёте. Приходит, если передано
events[].OWNER_ID	integer	ID владельца события. Приходит, если передан. Список: GET /v1/users
files	array | null	Файлы отчёта. Методы создания и обновления файлы не принимают: запрос с полем files в теле получает 400 INVALID_PARAMS
mark	string | null	Оценка отчёта: G — положительная, B — отрицательная, N — нейтральная или оценки нет, X — отчёт не подтверждён. Оценки ставят методы Утвердить рабочий отчёт, Отрицательная оценка отчёта и Нейтральная оценка отчёта, значение X они не ставят
approve	string | null	Подтверждение отчёта. Y — отчёт подтверждён: после положительной или отрицательной оценки, а у сотрудника без руководителей — сразу при сдаче или отправке. N — подтверждения нет: отчёт не сдан, ждёт оценки или получил нейтральную
fromUser	object | null	Сотрудник, чей это отчёт
fromUser.id	integer	ID сотрудника, совпадает с userId. Список: GET /v1/users
fromUser.name	string	Имя и фамилия сотрудника
fromUser.photo	string | null	Адрес фотографии профиля
toUsers	array | null	Получатели отчёта: руководители сотрудника. У сотрудника без руководителей — он сам
toUsers[].id	integer	ID получателя. Список: GET /v1/users
toUsers[].name	string	Имя и фамилия получателя
toUsers[].photo	string | null	Адрес фотографии профиля получателя
isReadyForSubmit	boolean | null	Готов ли отчёт к сдаче. В проверенных ответах — всегда null

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

• Рабочие отчёты
• Список рабочих отчётов
• Получить рабочий отчёт
• Дневные отчёты
• Рабочий день