Экспорт результатов

Выгрузка ответов дегустации во внешние системы: хранилище качества, BI, документооборот.

Сценарии

• Регулярная выгрузка результатов в BI-систему или хранилище качества.
• Передача итогов дегустации в смежную систему после её завершения.
• Архивирование протоколов во внутреннем документообороте.

Отчёт по дегустации

POST /api/v1/degustations/{id}/exports
Content-Type: application/json

{
  "participants": [],
  "samples": [],
  "hidden_samples": false,
  "with_questions_detail": true
}

Параметр	Назначение
participants	Идентификаторы экспертов; пустой массив — все участники
samples	Идентификаторы образцов; пустой массив — все образцы
hidden_samples	Скрыть наименования образцов в отчёте
with_questions_detail	Включить детализацию по вопросам анкеты

Метод возвращает файл .xlsx (Content-Disposition: attachment), а не JSON. Сохраните тело ответа как файл, не пытайтесь разобрать его как объект.

Важно

Экспорт доступен и для активной дегустации — это удобно для промежуточного контроля. Итоговым считайте отчёт, выгруженный после перехода в статус «Завершена».

Параметр hidden_samples соответствует слепому режиму: наименования заменяются номерами. Используйте его, если отчёт передаётся тем, кто не должен видеть привязку образца к марке.

Получение данных без файла

Если нужен не готовый отчёт, а данные для собственной обработки, используйте методы чтения:

Метод	Что отдаёт
GET /api/v1/degustations/{id}	Параметры дегустации, состав образцов и участников
GET /api/v1/degustations-experts/{id}	Ответы конкретного эксперта
GET /api/v1/degustations-experts/stats	Статистика прохождения
GET /api/v1/products/{id}/stats	Накопленная статистика по продукту

Эти методы возвращают JSON и подходят для регулярной синхронизации.

Итоговый балл

Итоговый балл присутствует в выгрузке только если в шаблоне дегустации есть блок расчёта с именем totalScore.

Если блок не был добавлен до запуска, ответы выгрузятся без балла, и задним числом он не восстанавливается — см. Итоговый балл дегустации.

Права

Для выгрузки нужны разрешения «Просмотр результатов» в группе «Дегустации», для аналитических методов — «Экспорт» в группе «Аналитика». См. Роли.