МЕНЕДЖЕР ПЛАТФОРМЫ BIL24
  Руководство пользователя

ГЛАВНОЕ ОКНО ПРИЛОЖЕНИЯ (ВКЛАДКА ОПЕРАТОРЫ)
ВКЛАДКИ ОРГАНИЗАТОРЫ, АГЕНТЫ
ВКЛАДКА ДОВЕРЕННЫЕ АГЕНТЫ
ВКЛАДКА ИНТЕРФЕЙСЫ
ВКЛАДКА ПОДПИСКИ
ВКЛАДКА НОВОСТИ
ВКЛАДКА МЭК
ВКЛАДКА ВИДЖЕТ
ВКЛАДКА АКЦИИ
ВКЛАДКА ФИСК. ДАННЫЕ
ВКЛАДКА ЭКВАЙРИНГИ
ВКЛАДКА ПОДКЛЮЧЕНИЯ К ВБС
ВКЛАДКА УВЕДОМЛЕНИЯ
РЕАЛИЗАЦИЯ АКЦИЙ И СКИДОК В ПРОТОКОЛЕ

ГЛАВНОЕ ОКНО ПРИЛОЖЕНИЯ (ВКЛАДКА ОПЕРАТОРЫ)

Приложение Менеджер предназначено для управления инфраструктурой платформы и учетными записями пользователей. Доступ в Менеджер имеют пользователи с ролями Оператор, Организатор, Агент. Пользователь любой роли может создавать учетные записи для собственных сотрудников, а также отключать их. Кроме этого, приложение Менеджер предназначено для создания и управления инфраструктурой пользователя в BIL24: интерфейсами, эквайрингами, фискальными данными, подключениями к Внешним Билетным Системам (ВБС), а также управления правилами продажи билетов (доверенные агенты, подписки).

Пользователь с ролью Оператор обладает наибольшими правами в платформе, ему доступны все вкладки и возможности приложения Менеджер (рис.1):



рис. 1

1. Вкладки для работы с ресурсами и инфраструктурой платформы.

2. Оператор собственной платформы (сети).

3. Данные оператора.

4. Галочка «Работа разрешена» дает возможность Оператору использовать платформу BIL24.

5. Сеть оператора, состоящая из Организаторов и Агентов, которых он добавил в свою собственную платформу (рис.1.1).



рис. 1.1

6. Учетные данные сотрудника. Чтобы добавить нового сотрудника нажмите

7. Галочка «Администрирование» устанавливает для сотрудника права администратора (максимально возможный набор прав). При этом выбор отдельных прав (п.8) деактивируется.

8. Выбор отдельных прав для сотрудника, возможен при снятой галочке «Администрирование» (п.7).

9.Кнопка «Обновить» загружает новые данные с сервера BIL24.

10. В консоли приложения показывается информация о его работе, ошибках, сетевом обмене.

11. Роль и название пользователя, использующего приложение.

ВКЛАДКИ ОРГАНИЗАТОРЫ, АГЕНТЫ

В этих вкладках (рис. 2 - 3) отображаются реквизиты выбранного предприятия или ИП, и учётные данные их сотрудников.

Каждый Организатор или Агент имеет свой уникальный идентификатор, который указан в квадратных скобках перед наименованием.

Пользователю с ролью Оператор доступно добавление новых предприятий или ИП с помощью кнопки "+". У пользователей с ролями Организатор и Агент такая возможность отсутствует, но они могут добавлять новых сотрудников. После регистрации сотрудник должен подтвердить свою почту и установить пароль - это активация. Если всё сделано верно, то у сотрудника будет стоять галочка "Активирован". Если сотрудник не перешёл по ссылке и не установил пароль, то галочка будет снята. Галочку "Активирован" нельзя установить вручную. Активация нужна после добавления нового сотрудника и после каждой смены адреса e-mail. Установка/снятие галочки "Работа разрешена" разрешает или запрещает деятельность пользователя в приложениях BIL24.


рис. 2


рис. 3





ВКЛАДКА ДОВЕРЕННЫЕ АГЕНТЫ

В этой вкладке (рис.4) Организатор самостоятельно определяет узкий круг Доверенных Агентов, которым он доверяет получать деньги от продажи билетов на свои представления. Организатор может установить единственного Базового агента с интернет-эквайрингом, который будет использоваться при продажах билетов на его представления с помощью банковских карт. Так же можно создать список Кассовых агентов, которым Организатор разрешает сбор наличных и безналичных средств в кассах и в любых системах вне платформы BIL24. Каждый Организатор может иметь множество Кассовых Агентов и только одного Базового Агента с эквайрингом. Один и тот же Базовый Агент может быть подключен к множеству Организаторов. Достаточно часто, Базовый Агент и Организатор являются одним и тем же юридическим лицом.


рис. 4





ВКЛАДКА ИНТЕРФЕЙСЫ

Во этой вкладке (рис. 5) отображаются данные об интерфейсах выбранного Агента, через которые осуществляются продажи.

Интерфейс (FRONTEND) - это интерфейс между покупателем и билетной платформой. Каждый FRONTEND принадлежит Агенту и имеет уникальный идентификатор FRONTEND ID (FID) и соответствующий ему токен. Эти данные используются для взаимодействия интерфейса и Центрального сервера BIL24 по Протоколу билетной системы.

Пользователи с ролью Оператор и Агент могут добавлять новые Интерфейсы с помощью кнопки "+".

Разрешённые интерфейсы:

Android - интерфейс для продажи билетов на устройствах под управлением Android.

IOS - интерфейс для продажи билетов на устройствах под управлением IOS.

Windows phone - интерфейс для продажи билетов на устройствах под управлением Windows.

Браузер - интерфейс для продажи билетов через Веб-браузеры.

Мобильный браузер - интерфейс для продажи билетов через мобильные Веб-браузеры.

Касса - интерфейс для продажи билетов в традиционных кассах за наличный расчёт.

Пригласительный - интерфейс для распространения бесплатных пригласительных билетов.

Билетная система - интерфейс для взаимодействия с внешними билетными системами.

СКД - интерфейс Системы контроля доступа для проверки билетов. Продажи через этот интерфейс не разрешены.

В поле Ссылка в зависимости от типа интерфейса отображается ссылка с данными (FID и токен) необходимыми для авторизации интерфейса при переходе по ссылке. В текущей версии приложения Менеджер ссылка генерируется только для интерфейсов типа Android. Для интерфейса этого ссылка ведет на страницу Основного мобильного приложения (ОМП) BIL24 в сервисе GOOGLE PLAY и содержит FID и токен интерфейса Агента. При установке приложения на мобильное устройство пользователя, FID и токен вносятся в локальное хранилище приложения. После успешной авторизации интерфейса, все билеты, проданные через это приложение, будут отображены в отчетах Агента. Пользователь, скачавший приложение по ссылке Агента, навсегда становится его клиентом. Агент может рассылать своим клиентам PUSH-уведомления.

Ссылка начинается с market:// и открывает приложение GOOGLE PLAY MARKET только на мобильных устройствах под управлением Android. Это обеспечивает корректность передачи данных для авторизации интерфейса.

Пользователи с ролью Оператор могут отмечать разрешённые агенту интерфейсы галочками (рис. 5).


рис. 5

Для Агента и Организатора возможность разрешать типы интерфейсов отсутствует (рис. 5.1).


рис. 5.1

Галочка "Работа разрешена" разрешает/запрещает работу интерфейса.

Во вкладке Интерфейсы Оператор и Агент могут устанавливать Сервисный сбор Агента и Сервисный сбор интерфейса. В билетной платформе BIL24 сервисный сбор устанавливается в процентах от номинальной стоимости покупаемого билета. Имеются следующие значения сервисного сбора:

1. Сервисный сбор Агента (ССА). Устанавливается для всех интерфейсов Агента.

2. Сервисный сбор Интерфейса (ССИ). Устанавливается для конкретного интерфейса (FRONTEND) Агента. Замещает сервисный сбор Агента (п.1) на этом интерфейсе.

3. Минимальный сервисный сбор Представления (МССП). Устанавливается Организатором для представления в целом и действует для всех сеансов представления. Минимальный Сервисный сбор Представления устанавливается в приложении Редактор событий (рис. 6).


рис. 6

Минимальный Сервисный сбор Представления используется Организатором продаж в случае, когда Устроитель представления устанавливает низкое агентское вознаграждение, которое не покрывает расходов на эквайринг, налоговые отчисления и оплату за использование платформы. Для всех агентов системы это минимальный сервисный сбор, с которым они могут продавать билеты.

На электронных интерфейсах: если применяемый сервисный сбор ССА или ССИ больше или равен МССП, то используется ССА или ССИ, если МССП больше ССА или ССИ, то используется МССП.

На Рабочем месте кассира (РМК) используется собственный, не связанный с системой Сервисный сбор кассы (ССК). Если ССК меньше МССП, то в ответ на попытку приобрести билеты будет выдана ошибка "Сервисный сбор меньше установленного минимального сервисного сбора представления".




ВКЛАДКА ПОДПИСКИ

В этой вкладке (рис. 7) реализована возможность подписать доступные Агентам представления на отдельные интерфейсы (рис. 7). Доступ возможен для пользователей с ролями Агент и Оператор. По умолчанию у каждого интерфейса стоит галочка "Все доступные представления". Если эту галочку снять, то можно назначить интерфейсу отдельные представления. Таким образом, можно каждому интерфейсу назначить свой уникальный набор представлений.


рис. 7

Пользователям с ролями Оператор и Агент доступна Проверка представления или сеанса (рис. 8).


рис. 8

Проверка производится для конкретного Интерфейса Агента. В отчете после проверки указываются различные параметры Представлений и сеансов (рис. 9, 10), которые влияют на возможность продавать их через данный интерфейс.


рис. 9


рис. 10





ВКЛАДКА НОВОСТИ

В этой вкладке (рис. 11) пользователи с ролью Оператор могут отправлять новости Билетной платформы, в том числе и в виде Push-уведомлений для мобильных устройств.

Push-уведомления - это небольшие всплывающие окна с текстовой информацией. Они могут появляться на экране любого устройства, где есть область оповещений.


рис. 11

Создание новости доступно только пользователям с ролью Оператор с помощью кнопки "+" (рис. 12).


рис. 12

В окне "Добавить новость…" необходимо ввести заголовок новости и выбрать адрес назначения, на который она будет доставлена. Обязательно необходимо заполнить Краткое описание и Полное описание новости, дату и время Начала показа (когда новость будет опубликована).

- Галочка "Push" разрешает/запрещает отправку новости в качестве push - уведомления на мобильное устройство.

- Галочка "Показ разрешён" разрешает/запрещает отображение новости у адресатов.




ВКЛАДКА МЭК

Вкладка (рис. 13) предназначена для управления Мобильными электронными картами (МЭК). Пока управление МЭК доступно только пользователям с ролью Оператор.


рис. 13





ВКЛАДКА WIDGET

Данная вкладка (рис. 14) доступна пользователям с ролями Оператор или Агент, в ней можно получить ссылки на WEB WIDGET для любого города или события.


рис. 14

1. Выбор Агента.

2. Выбор интерфейса для создания виджета. В ссылке на виджет передается FID и токен интерфейса.

3. Виджет позволяет продавать билеты как на отдельное представление, так и на все представления в городе или определенном месте проведения. Для этого необходимо выбрать один из трех вариантов использования:

- для всех доступных представлений в городе.

- для всех доступных представлений в месте проведения.

- только для выбранного представления.

4. Выбор языка.

5. Выбор города.

6. Выбор представления, из списка доступных для этого интерфейса в этом городе.

7. В поле "URL страницы успешной оплаты" необходимо указать адрес HTML-страницы, на которую банк перенаправит пользователя после успешной оплаты заказа. По умолчанию используется страница успешной оплаты на сайте bilw.ru.

8. В поле "URL страницы неуспешной оплаты" необходимо указать адрес HTML-страницы, на которую банк перенаправит пользователя если оплата заказа не прошла. По умолчанию используется страница неуспешной оплаты на сайте bilw.ru.

9. Чаще всего ссылка на виджет устанавливается на кнопку "Купить билет". В этом поле можно указать HTML-код этой кнопки, тогда он будет добавлен в код ссылки автоматически.

10. Текстовое поле, в котором размещена сгенерированная ссылка на сайт-контейнер bilw.ru. На этом сайте установлена последняя версия виджета, которая может использоваться всеми Агентами без ограничений.

11. Текстовое поле, в котором размещена сгенерированная ссылка на виджет, установленный на сайте агента.

12. Скрипт для отображения виджета поверх страницы в отдельном фрейме. Скрипт должен быть размещен в заголовке страницы. Пример использования такого скрипта: сайт sochitop10.ru.

13. Кнопка копирования HTML-кода из текстовых полей в буфер обмена.

14. Ссылка на архив с WEB WIDGET.

15. Для пользователей с ролью Оператор доступна возможность загружать шаблоны билетов.

16. URL Страницы соглашения. В процессе покупки билетов необходимо принять пользовательское соглашение, ссылка на которое берется из этого поля и указывается в корзине виджета. При формировании ссылки на web widget в режиме представления автоматически указывается ссылка на пользовательское соглашение, в зависимости от применяемого интернет-эквайринга.





ВКЛАДКА АКЦИИ

Промокод (от англ. promo code) — состоящая из букв и/или цифр совокупность символов, дающая право на приобретение товара или услуги на специальных условиях. Промокоды являются одним из инструментов стимулирования продаж. Промокоды используются для привлечения новых клиентов, активизации существующих клиентов, увеличения среднего чека, а также для отслеживания эффективности рекламных кампаний.

Акция - это совокупность действий, направленных на продвижение представлений или сеансов, которые воздействуют на потенциальных покупателей билетов. В Акциях BIL24 используются промокоды, для их создания и изменения используется вкладка Акции (рис.15):


рис. 15

1. Выбор организатора Акции. Создание и управление Акциями доступно пользователям с ролями Организатор и Оператор.

2. Название Акции. Вместе с описанием Акции (п.4) отображается пользователям, например, в мобильном приложении для Android (рис.16)


рис. 16

3. Кнопки добавления новой Акции и сохранения изменений в существующей Акции.

4. Описание Акции содержит информацию, которую организатор хочет донести до потенциальных покупателей (рис.16).

5. Срок проведения. Промокоды Акции будут действовать только в течение этого срока.

6. Размер скидки при применении промокодов Акции, устанавливается в процентах от номинальной стоимости билета.

7. Ограничения на каждый промокод: максимальная скидка и максимальное количество билетов. Один пользователь, подтвердивший свой email может использовать многоразовые и одноразовые промокоды только один раз.

8. Область действия Акции и её промокодов. Можно добавить в область действия Акции различные представления и различные сеансы (рис.17).


рис. 17

9. Кнопки добавления и удаления сеансов или представлений из области действия акции (п.8)

10. Кнопка для добавления промокодов. Промокоды могут быть многоразовыми и одноразовыми. В любом случае, один пользователь может использовать промокод только для одной успешной покупки. Таким образом, многоразовый промокод «ледовый» с числом использований 300, может использовать 300 пользователей по одному разу, а не один пользователь 300 раз (рис.18). Промокод отмечается как использованный только при успешной оплате заказа с билетами. При отмене и/или неуспешной оплате заказа промокод возвращается пользователю через некоторое время. Промокоды применяются автоматически к билетам на все сеансы и представления, которые находятся в корзине (в заказе) пользователя. Промокоды применяются максимально выгодным для пользователя способом. Для этого в платформе BIl24 реализован алгоритм решения NP-полной задачи комбинаторной оптимизации.

Промокоды уникальны, их уникальность распространяется на всю платформу.


рис. 18

Одноразовые промокоды генерируются билетной платформой в соответствии с указанным количеством (рис.19).


рис. 19

11. Статистика использования промокодов.

12. Список промокодов. Использованные промокоды выделяются в таблице цветным фоном.

13. Кнопка Список промокодов позволяет отобразить промокоды в текстовом виде, для удобства их распространения.


Добавление и применение промокодов покупателями билетов описано на страницах:
Использование промокодов в приложении для Android.
Покупка билетов через веб-интерфейс BIL24 (WEB WIDGET 2.0).

ВКЛАДКА ФИСК. ДАННЫЕ

Наиболее удобным способом организации продажи билетов является использование интегрированного решения банка: интернет-эквайринг + ОФД + онлайн-касса. Для правильного применения такого решения необходимо настроить параметры в панели Фискальные данные (рис.20). Эти параметры критически важны , так как влияют на вид чеков и учет налогов ( данные чеков автоматически отправляются в ФНС).


рис. 20

Важные моменты:

1. Если используется интегрированное решение банка (эквайринг + ОФД + онлайн-касса), то необходимо активировать галочку «Использовать ОФД». При снятой галочке "Использовать ОФД" кассовый чек не создается и не отправляется покупателю.

2. Многие билеты продаются по агентским договорам. Для таких продаж на чеке должны печататься наименование и ИНН Поставщика (Устроителя события) и агентский признак. В этом случае в строке Платежный агент необходимо выбрать параметр «Иной агент». Название и ИНН Устроителя события указываются в приложении Редактор.

3. При работе с организаторами событий, использующими различные системы налогообложения, возникает вопрос правильного указания НДС на чеках. Например, если ваша онлайн-касса зарегистрирована с типом Общая Система Налогообложения (ОСН), то для работы с организаторами на УСН необходимо добавить кассе тип УСН. Это добавление происходит на стороне банка и Оператора Фискальных Данных (ОФД). Для работы с организаторами на УСН необходимо установить значение «Без НДС» в строке НДС номинала.

4. Для различных интерфейсов можно задавать индивидуальные настройки фискальных данных. Чтобы использовать эти настройки необходимо активировать галочку «Использовать индивидуальные настройки».

ВКЛАДКА ЭКВАЙРИНГИ

Документация в стадии создания

ВКЛАДКА ПОДКЛЮЧЕНИЯ К ВБС

Документация в стадии создания

ВКЛАДКА УВЕДОМЛЕНИЯ

Вкладка позволяет настроить экспорт данных из BIL24 через уведомления. В настоящее время, данные могут отправляться в Телеграм или на URL. Данные посылаются при срабатывании определенных триггеров. Триггером может быть, например, достижение заказом окончательного статуса: PAID или САNCELLED.

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


Настройка отправки уведомлений в Телеграм (рис.21):



рис. 21

1. Организация (Оператор, Организатор или Агент) к которой будет применено уведомление.

2.Уведомление – [идентификатор][способ доставки] название.

3. Кнопки для добавления, удаления и сохранения изменений в уведомлении. Для добавления нового уведомления нажмите .

4. Способ доставки

5. Название уведомления

6. Chat_id является необходимым параметром для доставки уведомлений в конкретный чат Телеграм. Платформа может отправлять уведомления как в личные чаты, так и в группы. Чтобы получить chat_id группы необходимо выбрать в меню группы пункт Администраторы и добавить бот PlatformicBot для реальной зоны BIL24, или PlatformicTestBot для тестовой зоны, в качестве администратора группы (рис.22).



рис. 22

У бота должно быть разрешение на публикацию сообщений. Далее необходимо написать /start в поле для ввода сообщений, и в ответе бота будет chat_id группы. Написать нужно только /start и ничего больше, как на рис.23.



рис. 23

После сохранения сконфигурированного уведомления в Менеджере, в чат придет тестовое сообщение.

Важно! Если после настройки уведомления в группе выдаются права администратора одному или нескольким пользователям, то Телеграм автоматически превращает группу в супергруппу. При этом меняется её ID, и при отправке сообщений, в том числе и тестовых, произойдет ошибка. В консоли приложения Менеджер ошибка выглядит так: "[400] Bad Request: group chat was upgraded to a supergroup chat." В этом случае необходимо поставить новый ID группы в поле chat_id (6) и нажать сохранить (3).

Рекомендуем назначать администраторов группы в Телеграм до настройки уведомления в Менеджере.


Чтобы получать уведомления в личный чат, необходимо открыть диалог с ботом PlatformicBot для реальной зоны BIL24, или ботом PlatformicTestBot для тестовой зоны. В этом диалоге отправить команду /start, в ответ придет chat_id.

7. Список триггеров, которые инициируют отправку уведомлений. В настоящий момент, существуют два триггера: достижение заказом статуса PAID (Заказ оплачен), достижение заказом статуса CANCELLED (Заказ отменен). Статусы PAID и CANCELLED являются окончательными и не могут быть изменены. В дальнейшем, список триггеров будет увеличиваться.

8. Галочка разрешающая/запрещающая работу уведомления.

9. Отправка тестового уведомления в Телеграм-чат.

Протестировать работу уведомлений в тестовой зоне платформы BIL24 можно при покупке билетов на экскурсию на Плесецкие водопады. Уведомление о покупке придет в Телеграм-чат BIL24. Тестирование уведомлений.


Настройка отправки уведомлений на URL (рис.24):



рис. 24

Для отправки уведомлений на URL необходимо указать этот адрес в стандарте Uniform Resource Locator (URL). В примере на скриншоте окна "Добавить уведомление..." (рис.24) это – https://yourdomain.com:777/... Данные передаются методом POST. На указанном адресе система пользователя должна принимать передаваемые платформой данные и в случае успеха присылать в ответ код 200 ОК. Иначе, в течение суток сервер BIL24 будет периодически повторять отправку уведомления. В остальном, уведомление для URL создается и конфигурируется аналогично уведомлению в Телеграм.

Описание данных уведомлений, передаваемых на URL

Данные заказа и билетов, передаваемые по триггерам «Заказ оплачен» и «Заказ отменен».

Данные билета, передаваемые по триггеру «Билет возвращен».

РЕАЛИЗАЦИЯ АКЦИЙ И СКИДОК В ПРОТОКОЛЕ

В тестовой зоне BIL24 действует акция Апрельский лед для представления «Любимые фильмы о главном». Акция действует только для сеансов 16,18,19 апреля 2025 года. Для акции доступны промокоды:

Ледовый
5kqwd6
zqavy2
c63y4r
a4rzcu
6b5w45
acsftn
dn4p7b
juuu6u
4t4hbd
cwy26q

Чтобы получить скидку, пользователь (покупатель) должен добавить промокод, который применится автоматически. Для добавления промокодов существует команда протокола (АПИ) BIL24 - ADD_PROMO_CODES. Добавленные пользователем промокоды можно получить командой GET_PROMO_CODES и, например, отобразить их в личном кабинете вместе с дополнительной информацией об акции.

Промокоды применяются автоматически. Для максимально выгодного применения промокодов используется алгоритм решения NP-полной задачи комбинаторной оптимизации. Промокод, мобильная электронная карта и другие причины скидки, а так же ее размер необходимо показывать пользователю в корзине. Для этого в ответе команды GET_CART имеются соответствующие поля.

Клиентские билетные системы, осуществляющие продажи билетов из BIL24, могут указывать размер скидки и без использования акций и промокодов в команде создания заказа CREATE_ORDER_EXT.