Перейти до вмісту
gov.ua — державні сайти України

← До документації API

Форми № 1-екран і № К-2-рвк(1)

Коротка інструкція для респондентів, координаторів і адміністраторів модуля державної звітності.

Для кінотеатру

  1. Відкрийте кампанію потрібної форми: 1-екран — календарний місяць, К-2-рвк(1) — календарний рік. Квартальна кампанія може бути лише аналітичною і не подається.
  2. Створіть чернетку. Система збере показники з усіх кінотеатрів і залів юридичної особи в периметрі звіту.
  3. У розділі 2 форми 1-екран система автоматично заповнює рядок 01 «УСЬОГО» за мовною версією. Рядки «КІНОФІЛЬМИ» і «ВІДЕОФІЛЬМИ» не розподіляються, показуються прочерками та не редагуються. Однозначна language_adaptation береться з квиткових даних; затверджене рішення в картці фільму має пріоритет.
  4. Для К-2-рвк у картці кожного кінотеатру заповніть дату актуальності та кадрові показники: усього, адміністративно-управлінський, виробничо-технічний персонал і кіномеханіки — за штатним розкладом та фактично. Система підсумує їх по всіх чинних кінотеатрах юридичної особи.
  5. Перегляньте діагностику. Неповні кадрові дані не підміняються нулями: кадровий розділ лишається порожнім і позначається для ручної перевірки. Так само позначаються продажі без ticket_category або сеанси без session_category.
  6. Для К-2-рвк перегляньте звіряння з 12 місячними формами 1-екран. Відсутній місяць у будь-якому регіоні блокує подання.
  7. Перевірте PDF через GET /api/v1/screen-reporting/reports/{id}/pdf. Додайте ?download=1 для завантаження.
  8. Подайте звіт. Система фіксує знімок джерел, SHA-256, реєстраційний номер і незмінний PDF. Подальші виправлення оформлюються уточнюючою версією.

Порожнє значення і числовий нуль — різні стани. У PDF порожнє поле показане як --, а нуль — як 0.

Для адміністратора

  • Місячна кампанія: php artisan screen:open-period --type=month --year=2026 --month=8.
  • Річна кампанія: php artisan screen:open-period --type=year --year=2025.
  • Квартальна кампанія створюється з --type=quarter, має is_official=false і призначена лише для аналітики.
  • До відкриття кампанії перевірте профілі компаній, кадрові дані кінотеатрів та дату їх актуальності, періоди дії залів, місткість, звукові системи, класифікацію фільмів і мовних версій.
  • Право screen_report_audit є read-only і не дозволяє редагувати, подавати, приймати або повертати звіти.

Що система не підставляє припущенням

  • кадрові показники, якщо їх не внесено до карток усіх чинних кінотеатрів;
  • підписні реквізити, якщо профіль звітності не заповнений;
  • одну звітну країну копродукції без нормативно підтвердженої підстави;
  • ознаку першого випуску в Україні без дати та ідентифікатора правової підстави;
  • мовну категорію, якщо джерело передає кілька адаптацій без затвердженого рішення;
  • повноту даних за кожен день, якщо джерело не передає очікуваний календар або heartbeat.

Такі прогалини відображаються як ручне поле або блокуюча діагностика.