Шлюз — это подключение к внешней билетной системе (Яндекс.Афиша/Yaga, Ticketsteam, Intickets, Ticketland, Profticket и др.). Через шлюз TicketPrime получает из внешней системы события, залы и билеты, а затем публикует их у себя и продает.
Что нужно сделать
- Добавить шлюз и указать тип внешней системы и параметры доступа
- При необходимости включить автопубликацию
- Если событий нет — посмотреть лог запросов для диагностики
1. Назначение и принцип работы
Шлюз работает как адаптер: он обращается к API внешней системы, получает оттуда данные о событиях/сеансах/билетах, нормализует их и переносит в TicketPrime. Поддерживаемые системы:
- Yaga (Яндекс.Афиша), Ticketsteam, Intickets, Ticketland, Profticket, Edinoepole, Moscowshow, Ubsystem, Ticketscloud, Radario
- Список постоянно расширяется
Дальше события можно публиковать вручную или автоматически (автопубликация, раздел 4).
2. Добавление нового шлюза
- Откройте «Репертуар» → «Шлюзы» и нажмите «Создать».
- Заполните форму по вкладкам:
- «Основное» — Название, описание, статус.
- «Транспорт» — выберите тип внешней системы («Транспорт») и заполните параметры доступа (ключи/логины/токены — их состав зависит от выбранной системы; рядом с полями есть подсказки). Здесь же доступны фильтры: город, площадка, организатор.
- «Синхронизация» — автопубликация и сопутствующие опции (см. раздел 4).
- «Продажи» — параметры продажи (период, правила продавца, доступ)
- Сохраните шлюз.
3. Диагностика: в шлюзе не отображается ни одного события
Если после настройки в шлюзе пусто, посмотрите лог запросов — он показывает, что именно ответила внешняя система.
- Откройте шлюз → действие «События».
- В правом верхнем углу таблицы событий нажмите иконку диагностики (значок «жучок» / bug report) — откроется окно «Лог запросов».
- В логе видно по каждому запросу: время, длительность, метод и URL, а также тело запроса и ответ внешней системы (разворачиваются). По ним понятно, почему событий нет — например, ошибка авторизации, пустой ответ или неверные параметры доступа.
💡 Чаще всего пустой список означает неверные параметры доступа на вкладке «Транспорт» или фильтры (город/площадка/организатор), под которые не попадает ни одно событие.
4. Автопубликация
Автопубликация выставляет в продажу события из внешней системы.
- В форме шлюза откройте вкладку «Синхронизация» и включите «Автопубликация».
- Дополнительно доступны опции:
- Организатор — какому организатору присваивать события
- Передавать данные покупателей
- Закрывать события без билетов
Как это работает:
Автоматическая публикация запускается раз в сутки и на основе данных из шлюза создает места проведения, схемы залов, мероприятия и события. Площадки и мероприятия сопоставляются по названию.
Кроме ежедневного запуска, у активного шлюза с включенной автопубликацией в списке шлюзов появляется кнопка «Синхронизировать» — она запускает публикацию вручную (займет несколько минут).
5. Статус заказа в шлюзе
Если заказ связан с внешней системой, его статус там можно посмотреть прямо в заказе.
- Откройте заказ («Продажи» → «Заказы»).
- Найдите карточку «Шлюз» — в ней показаны название шлюза и ID заказа в шлюзе.
- Нажмите кнопку обновления (значок ⟲, подсказка «Статус в шлюзе») — система запросит у внешней системы актуальные данные и покажет статус заказа, количество билетов и сумму.
Частые вопросы
В шлюзе нет событий.
Откройте «События» → «Лог запросов» (раздел 3) и проверьте ответ внешней системы — обычно дело в параметрах доступа или фильтрах.
Включил автопубликацию, но событий не появилось.
Автопубликация по расписанию идет раз в сутки. Чтобы не ждать — нажмите «Синхронизировать» в списке шлюзов (раздел 4).
Не совпадают площадки/мероприятия.
Автопубликация сопоставляет их по названию — приведите названия к единому виду.