Інформація для підключення кінотеатру

Перелік відомостей, необхідних для створення юридичної особи, кінотеатру, залів, користувачів і технічної інтеграції в системі «Єдиний квиток».

1. Юридична особа або ФОП

• Обов’язково Повне найменування юридичної особи або ПІБ ФОП.
• За наявності Скорочене найменування.
• Обов’язково Тип суб’єкта: юридична особа або ФОП.
• Обов’язково Код ЄДРПОУ для юридичної особи або РНОКПП для ФОП.
• За наявності Статус і номер свідоцтва платника ПДВ.
• Обов’язково Юридична адреса.
• За наявності Фактична адреса, якщо відрізняється.
• Обов’язково Область і територіальна громада.
• Для звітності Код території за КАТОТТГ.
• Для звітності Основний КВЕД: код і назва; код організаційно-правової форми; форма власності.
• За наявності Найменування балансоутримувача для державних або комунальних закладів.
• За наявності Найменування банку та МФО, якщо реквізити використовуються в системі або договорі.
• Обов’язково Основний контактний email і телефон юридичної особи.

2. Відомості про демонстратора фільмів

• Для звітності Тип демонстратора.
• За наявності Дата внесення до реєстру, серія та номер свідоцтва демонстратора.
• Обов’язково Дата початку діяльності та поточний статус.
• За наявності Підстава припинення або призупинення діяльності.

3. Мережа кінотеатрів

Якщо кінотеатр входить до мережі, зазначте:

• назву мережі та юридичну особу — власника або оператора;
• перелік кінотеатрів мережі;
• внутрішній ID мережі в обліковій системі;
• ПІБ і контакти адміністратора мережі;
• одна інтеграція працюватиме для всієї мережі чи окрема для кожного кінотеатру.

Якщо кінотеатр не входить до мережі, зазначте: «незалежний кінотеатр».

4. Дані кожного кінотеатру

Для кожної окремої адреси заповнюється окрема картка.

• Обов’язково Повна та, за потреби, комерційна назва кінотеатру.
• Обов’язково Юридична особа та, за наявності, мережа.
• Обов’язково Область, населений пункт і повна фактична адреса.
• Для звітності Код території за КАТОТТГ.
• За наявності Вебсайт, контактний email і телефон кінотеатру.
• Обов’язково ПІБ і контакти керівника або відповідальної особи.
• Обов’язково Внутрішній ID кінотеатру в касовій/POS-системі.
• Узгоджується API-назва або код інтеграції.
• Обов’язково Статус: працює, тимчасово не працює, закритий, пошкоджений тощо.
• Для звітності Дата початку та, якщо застосовується, дата припинення діяльності у звітному периметрі.
• Для звітності Тип розміщення кіноустановки, кількість робочих днів на місяць, робота в зимовий період.
• За наявності Примітки щодо особливостей роботи.

5. Кінозали

Для кожного залу подається окремий рядок.

6. Персонал кінотеатру

Дані подаються агреговано, без ПІБ працівників, окремо для кожного кінотеатру:

• дата, станом на яку актуальні кадрові дані;
• загальна кількість працівників за штатним розписом і фактично;
• адміністративно-управлінський персонал — за штатним розписом і фактично;
• виробничо-технічний персонал — за штатним розписом і фактично;
• кіномеханіки — за штатним розписом і фактично.

Кадрові показники не блокують початок технічного тестування API, але потрібні для повного автоматичного формування звітності К-2-рвк(1).

7. Користувачі системи

Для кожного працівника, якому потрібен персональний доступ:

• Обов’язково Ім’я, прізвище, унікальний службовий email і контактний телефон.
• За потреби Бажаний логін.
• Обов’язково Роль: адміністратор мережі, відповідальний працівник кінотеатру, оператор, відповідальний за звітність або користувач для перегляду.
• Обов’язково Перелік кінотеатрів, до яких потрібен доступ.
• Обов’язково Чи має користувач право подавати звітність і переглядати фінансові показники.

Не надсилайте паролі, API-токени або секретні ключі у цій анкеті чи звичайною електронною поштою. Їх створює система, а передавання виконується окремим захищеним каналом.

8. Відповідальні за звітність

• ПІБ і посада керівника, який підписує звітність.
• ПІБ, посада, телефон та email відповідального виконавця.
• ПІБ головного бухгалтера, телефон і email бухгалтерії — за наявності.
• Факс — якщо використовується.

9. Касова система та технічна інтеграція

• Обов’язково Постачальник, назва та версія касової/POS-системи.
• Обов’язково ПІБ, email і телефон технічного спеціаліста з боку кінотеатру або постачальника.
• За наявності Документація API касової системи.
• Наявність тестового середовища.
• Можливість передавати дані в реальному часі та повторювати надсилання після збою.
• Підтримка передавання повернень квитків.
• Часовий пояс, формат дати й часу, валюта та формат суми.
• За наявності Статичні вихідні IP-адреси, якщо використовується мережева фільтрація.
• Орієнтовна кількість квиткових операцій на добу.
• Бажані дати тестового підключення та промислового запуску.
• Потреба в передаванні історичних даних і період таких даних.

10. Дані по кожному квитку

Обов’язкові поля продажу

• унікальний ID квитка;
• дата продажу та ціна;
• дата і час сеансу;
• канал продажу: online або cashbox;
• ID залу;
• ID фільму з узгодженого довідника.

Поля для повної аналітики та звітності

• ID і статус сеансу;
• категорія сеансу: дорослий або дитячий;
• категорія квитка: дорослий, дитячий або пільговий;
• ознака пільгового квитка;
• мова показу та тип мовної адаптації;
• дата останнього оновлення запису.

Поля повернення

• ID первинного квитка;
• сума повернення;
• кількість повернутих квитків.