Отчёты
Методы для генерации отчётов по модулю.
- Для получения коллекции сгенерированных модулем отчётов используйте метод документов компании с фильтрацией по module.
- Для получения бинарного файла отчёта используйте метод объектного хранилища.
# Создание отчёта
POST/companies/{id}/modules/fm/report
Генерирует Excel-отчёт по модулю FM. Каждая сущность — отдельный лист. В поле types запроса передаётся массив нужных типов. Можно ограничить период с помощью start_date и end_date. Сгенерированный документ будет доступен в списке документов компании.
Структура запроса
GENERATE_REQUEST:
application/json
typesrequired
array
Типы
Типы отчётов для генерации (string[]: transactions, categories, counterparties, credits)
start_dateoptional
string
Начало
Начальная дата фильтрации (RFC 3339)
end_dateoptional
string
Конец
Конечная дата фильтрации (RFC 3339)
commentoptional
string
Комментарий
Комментарий к отчёту
Структура ответа
RESPONSE_DATA:
application/json
download_urlrequired
string
Ссылка (deprecated)
Прямая ссылка на скачивание. Устарело — используйте object_path из doc.
docrequired
array
Документ
Сгенерированный документ (Doc)
Документ
idrequired
string
ID
Уникальный идентификатор документа
object_pathrequired
string
Путь
Путь к файлу в объектном хранилище
moduleoptional
string
Модуль
Модуль, сгенерировавший документ (fm, crm, hrm, wm, dm)
typeoptional
string
Тип
Тип документа (report, invoice и др.)
commentoptional
string
Комментарий
Комментарий, указанный при генерации
created_atrequired
string
Создан
Дата генерации (RFC 3339)
updated_atrequired
string
Обновлён
Дата последнего обновления (RFC 3339)
Примеры ответов
{
"status": true,
"message": "Report generated successfully",
"data": {
"download_url": "https://cdn.kroncl.com/reports/fm-report-2026-06-14.pdf",
"doc": {
"id": "a10e8400-e29b-41d4-a716-446655440160",
"object_path": "reports/fm-report-2026-06-14.pdf",
"module": "fm",
"type": "report",
"comment": "Финансовый отчёт за июнь",
"created_at": "2026-06-14T12:00:00Z",
"updated_at": "2026-06-14T12:00:00Z"
}
},
"meta": {
"timestamp": "2026-06-14T12:00:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/fm/report",
"method": "POST"
}
}