Различия

Показаны различия между двумя версиями страницы.

--- abonement [2023/03/14 07:29] – n.zalozin
+++ abonement [2026/05/25 12:39] (текущий) – [Сводка: Абонемент vs Пакетная продажа] n.zalozin
@@ Строка 1: / Строка 1: @@
-Абонемент и Пакетные продажи
+====== Абонемент и Пакетные продажи ======
 В программных продуктах МДТЗК есть несколько сущностей, называемых абонементом.
 Техническая реализация их отличается, общий признак - это продажа права посещения нескольких мероприятий за одну операцию.
-Абонемент - документ, дающий право посещения нескольких мероприятий, проходящих в разное время в одном зале (сквозная продажа).
+**Абонемент** - документ, дающий право посещения нескольких мероприятий, проходящих в разное время в одном зале (сквозная продажа).
 Выкупается одно и то же место на мероприятиях, печатается один бланк БСО, по которому можно посетить каждое из мероприятий один раз. Продается только до начала первого мероприятия из его состава.
@@ Строка 12: / Строка 12: @@
 Форма и содержание бланка абонемента регулируется Министерством Культуры
-Абонемент-Пакет (пакетная продажа) - набор из нескольких билетов, продающихся совместно, группой со скидкой.
+//Таблица: продажа абонемента на место, возможные состояния мест//
+{{:abonement_bronirovki.jpg?600|таблица состояний}}
+**"Блокирующий заказ"** - блокировка мест в мероприятиях из состава абонемента и абонементах, использующих те же мероприятия, при продаже места в абонементе.
+//Схема: Логика создания блокирующих заказов//
+{{:abonement_algoritm.png?600|Схема создания блокирующих заказов}}
+//Красные стрелки - влияние абонементов на мероприятия//
+//Синие стрелки - влияние мероприятий на абонементы//
+//Черные стрелки - косвенное влияние абонементов с общими мероприятиями.//
+**Абонемент-Пакет** (Пакетная продажа) - набор из нескольких билетов, продающихся совместно, группой со скидкой. Заводится в ТЛпро (https://pro.ticketland.ru)
 Технически это акция, условием получения скидки которой является приобретение нескольких билетов. Билеты печатаются на каждое из мероприятий.
-Абонемент
+//Подробнее о **Пакете**  [[tlpro:ticketland-pro#абонементы_пакетная_продажа|Абонементы Пакетная продажа]]//
-Добавлен в ТБО с  2.73.1, КБО с 1.41.1 и в Проводник
-Оглавление:
-**1. Права на работу с абонементом
+====== Сводка: Абонемент vs Пакетная продажа ======
-кассир театра
+^ Критерий ^ Абонемент ^ Пакетная продажа ^
+| **Определение** | Документ, дающий право посещения нескольких мероприятий в **одном зале** | Набор билетов, продающихся совместно **группой со скидкой** |
+| **Зал** | **Только один зал** (все мероприятия в одном зале) | **Любые залы** (мероприятия могут быть в разных залах) |
+| **Места** | **Одно и то же место** на всех мероприятиях | **Любые места** (можно разные места на разные мероприятия) |
+| **Бланк БСО** | **Один бланк** на все мероприятия | **Отдельный бланк** на каждое мероприятие |
+| **Техническая реализация** | Тип мероприятия ''Abonement'' в БД | **Акция** (скидка при покупке нескольких билетов) |
+| **Где заводится** | Проводник | ТЛпро (https://pro.ticketland.ru) |
+| **Где применяется** | ТБО, КБО, Сайт, Фреймы | Фреймы |
+| **Переменная печати** | ''AbonementPerformances'' | Стандартные переменные е-билета |
+| **Шаблон е-билета** | ''default_tl_abonement.pdf'' (или кастомные с флагом «применять шаблон для абонемента») | Стандартные шаблоны |
+| **Продажа** | Только **до начала первого мероприятия** | До начала каждого мероприятия |
+| **Возврат** | Только **целиком** до начала первого мероприятия | **По отдельности** (каждый билет) |
+| **Блокировка мест** | «Блокирующий заказ» блокирует места во всех мероприятиях абонемента | Нет блокировки |
+| **Квоты** | Зависит от квот мероприятий в составе | Стандартные квоты |
+| **Возрастные ограничения** | Задаются на абонемент **независимо** от состава мероприятий | На каждое мероприятие отдельно |
+| **Схемы фондов** | **Один набор** схем распределения фондов на абонемент | Стандартные схемы мероприятий |
+| **Тарифы** | **Несколько тарифов** с независимыми схемами распоясовки и расценки, не зависит от тарифов мероприятий | Стандартные тарифы мероприятий |
+| **Отчётность** | Отчёт «По абонементным продажам» | Стандартные отчёты по продажам, нет специализированных |
+| **СКД** | Пропускает по кодам абонемента на мероприятия из его состава | Стандартные билеты |
+| **Регулирование** | **Форма бланка регулируется Министерством Культуры** | Стандартные бланки |
+===== Абонемент =====
+| Система | Версия |
+| **ТБО** | с 2.73.1 |
+| **КБО** | с 1.41.1 |
+| **Проводник** | с 1.54.1 |
-администратор театра
+===== Оглавление =====
+  * [[#1. Права_на_работу_с_абонементом|1. Права на работу с абонементом]]
+  * [[#2. Ограничения абонемента|2. Ограничения абонемента]]
+  * [[#3.  Влияние абонемента на мероприятия из его состава и другие абонементы.|3.  Влияние абонемента на мероприятия из его состава и другие абонементы.]]
+  * [[#4. Краткая схема заведения абонемента|4. Краткая схема заведения абонемента]]
+  * [[#5. Подробное описание (Проводник)|5. Подробное описание (Проводник)]]
+  * [[#тбо_кбо|ТБО/КБО]]
+  * [[#сайт_и_фреймы|Сайт и фреймы]]
+  * [[#смежные_сервисы_и_системы|Смежные сервисы и системы]]
+  * [[#шлюзы|Шлюзы]]
+  * [[#проверки|Проверки]]
+  * [[#отчетность|Отчетность]]
+  * [[#логирование|Логирование]]
+  * [[#памятка_разработчика|Памятка разработчика]]
+  * [[#памятка_техподдержки|Памятка техподдержки]]
+  * [[#приоритеты_правил_е-билетов|Приоритеты правил е-билетов]]
-. Ограничения абонемента
-.  Влияние абонемента на мероприятия из его состава и другие абонементы.
+====== 1. Права на работу с абонементом======
-Проводник
+| Роль | Права |
+| **Театр админ** | Создавать, продавать, возвращать (весь функционал) |
+| **Театр кассир** | Открывать и возвращать (если продажи и создание заказов открыты для пользователя) |
+| **Пользователь шлюза (ExtAPI)** | Если есть роль театр-админа: абонемент будет создан даже с мероприятием без права продажи. Если нет роли: абонемент не будет создан, будет уведомление об ошибке |
-. Как создать абонемент
-. Как назначить/убрать мероприятия абонемента
+====== 2. Ограничения абонемента ======
-. Как удалить абонемент
+* Абонемент может быть создан только на мероприятия, проходящие в **одном зале** учреждения
+  * На абонемент можно назначить только **один набор схем распределения фондов**
+  * Можно использовать **несколько тарифов**, с независимыми схемами распоясовки и расценки
+  * Реализована возможность продажи за **наличный расчет** и **безналичными способами** оплаты
+  * Продажа абонемента возможна только **до начала первого мероприятия** абонемента (плюс срок продажи задним числом первого мероприятия)
+  * Возврат абонемента возможен только **до начала первого мероприятия**, только **целиком** на все мероприятия из состава абонемента
+  * В случае если на какое-либо мероприятие, входящее в абонемент, наложено **ограничение операций** с мероприятием – продажа невозможна
+  * Купленное место в абонементе – **во всех мероприятиях абонемента будет занято то же самое место** (например, нельзя в одном мероприятии занять 1 ряд 1 место, а во втором 2 ряд 2 место)
+  * При добавлении мероприятия в абонемент – места, проданные и забронированные в абонементе, помещаются в **«блокирующий заказ»** и будут недоступны для выбора в добавленном мероприятии
+  * При выводе мероприятия из абонемента – заблокированные **«блокирующим заказом»** места в мероприятии освобождаются
+  * Если в добавленном мероприятии уже есть проданные места:
+    * В случае, если они **не пересекаются** с проданными местами абонемента – создается **«блокирующий заказ»** в абонементе
+    * Если **пересекаются** – «Проводник» не позволяет добавить такое мероприятие к абонементу, сообщая о коллизии
+  * **Нельзя создать 2 абонемента на одно и то же время в одном зале**
+  * **Нет пакетной обработки абонементов** (выдачи квот, остановки продаж)
+  * **Возрастные ограничения** задаются на абонемент независимо от состава мероприятий, администратору нужно следить за этим
-. Как назначить шаблон абонемента.
-ТБО
-. Как найти абонемент в списке
+====== 3.  Влияние абонемента на мероприятия из его состава и другие абонементы. ======
-. Как печатать абонемент
+**«Блокирующий заказ»** – блокировка мест в мероприятиях из состава абонемента и абонементах, использующих те же мероприятия, при продаже места в абонементе.
-. Возможные предупреждения
+//**Важно:** Возможность создать абонемент на место зависит от квот мероприятий в его составе, т.е. если на какое-то мероприятие квоты на место отозваны, то заказ не сформируется не только в мероприятии, но и в абонементе!//
-Система контроля доступа
+**Логика создания блокирующих заказов:**
-. Особенности считывания
+  * Если в добавляемом в абонемент мероприятии уже есть продажи и заказы – эти места в абонементе становятся недоступны через «блокирующий заказ»
+  * Если в абонемент, в котором уже есть продажи и заказы, добавляется мероприятие – эти места в мероприятии становятся недоступны через «блокирующий заказ»
+  * Если в добавляемом мероприятии уже продано место, на которое в абонементе тоже продано место – выводится сообщение о невозможности добавить такое мероприятие
+  * Если мероприятие с проданными местами в абонементе убирается – то в мероприятии блокирующие заказы с соответствующих мест снимаются
+  * Удаление абонемента – все блокированные заказы этого абонемента на места в мероприятиях убираются
+  * Удаление мероприятия из абонемента – все блокированные заказы на места в убранном мероприятии убираются
+  * Удаление мероприятия, входящего в абонемент (мероприятие отменено) – в абонементе исчезает это мероприятие
+  * Запрет продаж мероприятия из состава абонемента – недоступны продажи ни в мероприятии, ни в абонементе/абонементах, в состав которых мероприятие входит
-Отчеты
+**«Блокирующий заказ» недоступен кассирам для:**
+  * Удаления
+  * Редактирования
+  * Изменения параметров
+  * Аннулирования
+  * Не попадает в общие отчеты
-. Как контролировать продажи абонементов
+Выглядит как статус **«место недоступно»**.
-Прочие системы
+При изменении состояния места – обновляется во всех мероприятиях абонементов и абонементах, связанных с этим местом.
-**
+----
-Поддерживается передача абонемента через шлюзы МДТЗК -> распространитель.
-Вывод абонемента на фреймах площадок нашей системы.
+====== 4. Краткая схема заведения абонемента ======
+==== 1. Подготовка прав ====
+Сотрудник технической поддержки включает роль специалистам театра, уполномоченным создавать абонементы.
-====== 1. Права на работу с абонементом======
+Продавать абонементы могут все сотрудники площадки.
-кассир театра
+==== 2. Проводник ====
+В проводнике в конкретном зале в закладке абонемента заводится абонемент. **Сохраняется и закрывается, и открывается снова** – чтобы заполнить состав абонемента (до переоткрытия закладка «Состав» не видна).
-администратор театра
+==== 3. Добавление мероприятий ====
+В абонемент в свойствах абонемента добавляются мероприятия из этого же зала с датой большей или равной дате абонемента (для удобства, на самом деле дата абонемента влияет только на отображение в списке мероприятий).
-====== 2. Ограничения абонемента ======
+==== 4. Назначение БСО ====
+Назначается БСО абонемента. Переменная для БСО и Е-билетов – ''AbonementPerformances''.
+==== 5. Каналы продаж ====
+С версии 1.54.1 в контекстное меню абонемента добавлены меню каналов продаж, работающее аналогично каналам продаж на мероприятия.
+==== 6. ТБО/КБО ====
+В ТБО мероприятия выводятся в общем списке, отличаются от обычных мероприятий только по названию.
+Кассир выбирает места в абонементе и продает их любым удобным способом. В одном заказе могут быть как места абонемента, так и места обычных мероприятий.
+Выводится на сайт/фреймы/отдается по шлюзам как обычное мероприятие. Также нужно не забыть назначить на абонемент свой шаблон электронного билета, отличный от шаблона обычных бланков, с составом абонемента.
+==== 7. Сайт и фреймы ====
+Для корректного отображения состава абонемента на сайте Тикетленд и фреймах площадок – при выводе абонемента в продажу в проводнике надо мероприятия из его состава перевести в **статус 3 (продажа)**, при этом, чтобы они не выводились в продажу раньше времени, управлять их доступностью через **каналы продаж**.
+==== 8. Шаблон е-билета ====
+В директе в правилах Е-билетов нужно на мероприятие абонемента (/учреждение или другой требуемый уровень) назначить отдельный шаблон абонемента (в списке есть типовой шаблон ''default_tl_abonement.pdf''), и поставить флаг **«применять шаблон для абонемента»**.
+<color #ed1c24>(Приоритеты смотрите в разделе [[#приоритеты_правил_е-билетов|«Приоритеты правил е-билетов»]])</color>
+----
+====== 5. Подробное описание ======
+===== Проводник =====
+==== Заведение абонемента ====
+В проводнике, в разделе «Абонементы», отображается список доступных абонементов.
+{{:абонементы_проводник_заведение.png?400|}}
+В этом разделе, при нажатии кнопки меню «Добавить» открывается окно по созданию и редактированию нового абонемента. Интерфейс аналогичен интерфейсу создания мероприятий, добавлена только закладка «Состав», где выбираются мероприятия, включенные в абонемент.
+Для создания абонемента нужно выбрать зал проведения.
+==== Управление абонементами ====
+**можно:**
+  * Создать
+  * Изменить дату
+  * Изменить время начала
+  * Изменить атрибуты зрелища (наименование, организатор, тип зрелища, продолжительность)
+  * Изменить серию комплекта
+  * Задать или запретить доступные операции с билетами
+  * Назначить тарифы и их схемы фондов, расценки и распоясовки
+  * Скрыть
+  * Удалить (если при этом в абонементе были продажи/заказы, то он только скроется)
+  * Добавить и удалить в абонемент связанные мероприятия
+**нельзя:**
+  * Изменить зал проведения
+  * Изменить схемы фондов (можно переназначать места в фондах в ТБО)
+**Административные ограничения:**
+  * Нельзя удалять электронный комплект бланков на абонемент, в составе которого есть действующие мероприятия
+  * Если электронный комплект бланков автоматически удален – пересоздать его, или вывести мероприятия из состава абонемента (это нужно для доступности выбора мест в таких мероприятиях)
+==== Мероприятия в составе абонемента ====
+Доступны все мероприятия зала, кроме скрытых, все остальные настройки мероприятия на абонемент не влияют.
+//**Внимание!** Если в мероприятии есть недоступный для продажи фонд – он все равно будет доступен в абонементе, если в абонементе он не помещен в недоступный соответственно!//
+----
+===== ТБО/КБО =====
+  * **Продажа абонемента:** кассир выбирает места в абонементе и продает любым удобным способом
+  * **Печать билетов:** выводится БСО абонемента с переменной ''AbonementPerformances''
+  * **Печать мест в мероприятиях из состава:** возможна отдельная печать для каждого мероприятия
+  * **В одном заказе** могут быть как места абонемента, так и места обычных мероприятий
+----
+===== Сайт и фреймы =====
+Для корректного отображения состава абонемента:
+. Мероприятия из состава абонемента перевести в **статус 3 (продажа)**
+. Управлять доступностью через **каналы продаж** (чтобы не выводились раньше времени)
+. Назначить отдельный **шаблон е-билета** для абонемента (''default_tl_abonement.pdf'')
+. Поставить флаг **«применять шаблон для абонемента»**
+----
+===== Смежные сервисы и системы =====
+| Сервис | Статус | Примечание |
+| Фискализация | ✓ | |
+| Эквайринг | ✓ | |
+| Заказы | ✓ | |
+| Е-билеты | ✓ | Переменная печати ''AbonementPerformances'' |
+| Корпоративные билеты | ✓ | |
+| Система контроля доступа (СКД) | ✓ | Пропускает по кодам абонемента на мероприятия из его состава |
+----
+===== Шлюзы =====
+| Направление | Статус | Описание |
+| **Получение** | ❌ Не поддерживается | На момент написания документации другие шлюзы не поддерживали передачу абонементов |
+| **Передача** | ✓ Поддерживается | Для шлюза мероприятия абонемента – это обычное мероприятие, передается как есть |
+| **МДТЗК → Распространитель** | ✓ Поддерживается | Передача абонемента через шлюзы МДТЗК |
+| **Вывод на фреймы** | ✓ Поддерживается | Вывод абонемента на фреймах площадок нашей системы |
+----
-====== 3.  Влияние абонемента на мероприятия из его состава и другие абонементы. ======
+===== Отчетность =====
-**Проводник**
+**Проблема:** Продажи абонемента можно увидеть в обычных отчетах по мероприятиям, сняв отчет за конкретный абонемент, а вот заполняемость мест по мероприятиям из его состава, с учетом мест, проданных в абонементе – нет.
-====== 4. Как создать абонемент ======
+**Решение:** Добавлен отчет по абонементам [[https://reports.ticketland.ru/Reports/report/Театры/(PAPr1)%20По%20Абонементным%20Продажам%20Первый|«По абонементным продажам»]].
-====== 5. Как назначить/убрать мероприятия абонемента ======
+----
-====== 6. Как удалить абонемент ======
+===== Логирование =====
-====== 7. Как назначить шаблон абонемента. ======
+Изменения самого абонемента – видны в проводнике в закладке абонемента **«История изменений»**, аналогично мероприятию.
+Сейчас доступны история изменений и журналы самого абонемента:
+  * Операций с комплектом
+  * Перебронирования
+  * Изменений цен
-**ТБО**
+Как и у обычных мероприятий.
-====== 6. Как найти абонемент в списке ======
+----
-====== 7. Как печатать абонемент ======
+==== Настройки, возможные сбои ====
-====== 8. Возможные предупреждения ======
+| Задача | Решение |
+| Хотим продать место в мероприятии, не хотим в абонементе | Помещаем в абонементе места в фонд, недоступный пользователю (кассиру) |
+| Хотим продать место в абонементе только кассирами, не хотим продавать через МДТЗК (фрейм) | Помещаем в абонементе места в фонд, недоступный МДТЗК |
+| Хотим продать место только в абонементе, не хотим в мероприятии | 1. Продаем в абонементе БЕЗ добавления в него мероприятий 2. В самих мероприятиях выносим места в фонд, недоступный кассирам 3. Перед началом первого мероприятия и окончанием продаж в абонемент места в нерабочее время переносим в доступный кассирам фонд, мероприятия добавляем в абонемент. На уже проданные места создадутся блокированные заказы, остальные места можно будет продать в мероприятиях. После переноса СКД сможет пропускать по кодам абонемента на мероприятия из его состава |
+==== FAQ ====
-Система контроля доступа
+**Вопрос:** Театр не хочет передавать мероприятие по шлюзу.
-. Особенности считывания
+**Решение:** Поместить места в фонд **407628 «Фонд МДТЗК Без Агентов»**. Будет доступен только МДТЗК и фрейм. Доступ к фонду может дать саппорт.
-Отчеты
+---
-. Как контролировать продажи абонементов
+**Вопрос:** Абонемент с мероприятием с не своими продажами (КБО, сайт). У пользователя право открывать чужие заказы отсутствует.
+При попытке удалить мероприятие из состава абонемента ФР: ошибка **«52127 – нельзя открывать заказы, созданные из чужого учреждения»**.
+**Решение:** Зайти пользователем с правами открывать заказы (например, сотрудник МДТЗК), удалить мероприятие.
-Пакетные продажи -
+---

Ticketland Wiki

Инструменты пользователя

Инструменты сайта

Различия

Инструменты страницы