Подключение Gizmo (компьютерный клуб)
Связать Gizmo с кабинетом: геймеры, тайм-пакеты, чеки с маржой и «за ПК сейчас».
Что даёт интеграция
- база геймеров Gizmo и подписчики бота становятся одной базой (склейка по телефону и номеру карты);
- чеки клуба попадают в карточки геймеров и питают аналитику — с маржой и с плательщиком: Gizmo называет, кто именно оплатил, поэтому выручка ложится на гостя честно;
- меню бара и тайм-пакеты с себестоимостью подтягиваются в «Прайс»;
- видно, кто сейчас за ПК;
- геймер получает карту Wallet, бота и гостевое приложение — со стороны клуба для этого ничего дорабатывать не нужно.
Обмен идёт в одну сторону: мы читаем Gizmo и ничего в базе клуба не меняем.
Что понадобится
- Адрес сервера Gizmo в виде
https://адрес:порт. Сервер стоит в клубе, поэтому адрес знает ваш системный администратор. - Учётная запись оператора — логин и пароль. Это сотрудник Gizmo, а не геймер, и у него должен быть включён доступ к Web API.
- Часовой пояс клуба.
Шаг 1. Подключите сервер
Кабинет → Интеграции → карточка Gizmo → Подключить. Заполните адрес, логин и пароль оператора, часовой пояс → Проверить и сохранить.
Статус «подключён» и имя оператора в ответе = связь работает.
Если что-то не так, под формой будет причина:
- 401 — оператор не авторизуется: проверьте логин с паролем и что этому оператору в Gizmo открыт доступ к Web API.
- Сервер недоступен — проверьте адрес и порт и что сервер клуба включён.
Шаг 2. Загрузите меню и тайм-пакеты
Блок «Данные клуба» → Меню и тайм-пакеты. Товары бара и пакеты игрового времени попадают в раздел «Прайс» вместе с себестоимостью — благодаря ей аналитика меню сразу показывает маржу, руками ничего вводить не нужно. Тайм-пакеты сохраняются как услуга со сроком в минутах, а не как блюдо.
Шаг 3. Импортируйте геймеров
Импортировать геймеров — база Gizmo заливается в «Подписчиков». Совпадения с существующими гостями склеиваются по телефону и номеру карты, дублей не будет. Повторный запуск безопасен: он обновляет данные.
Анонимные посетители без телефона и карты не заводятся: такую карточку не с чем связать и незачем показывать.
Шаг 4. Загрузите чеки
Рядом с кнопкой Синхронизировать чеки выберите период. Начните с трёх дней — так вы сразу увидите, что данные идут правильно. Дальше можно взять неделю или месяц. Повторные запуски безопасны: уже загруженные чеки не задваиваются.
После этого чеки клуба живут в «Аналитике», «Сменах» и в карточках геймеров, а свежие подтягиваются сами — примерно раз в час.
Шаг 5. Брони и онлайн-оплаты на стойке (по желанию)
Если гости бронируют ПК через бота, брони и деньги можно доводить до кассы клуба — чтобы администратор видел их в своей привычной программе, а не в чужом кабинете.
Два тумблера в блоке Что уходит в кассу на странице интеграции, оба выключены по умолчанию:
- Отправлять брони в кассу — на выбранные гостем ПК создаётся резервация. Это ровно ваши брони из бота; чужие резервации мы не трогаем и не меняем.
- Проводить онлайн-оплаты в кассе — деньги, полученные через сайт, попадают в Gizmo: либо пополнением депозита гостя, либо продажей тайм-пакета.
Перед вторым тумблером заведите отдельный способ оплаты в Gizmo — например «Онлайн · AxleCRM» — и выберите его в списке. Без этого тумблер не включится и рядом будет написано, почему: онлайн-деньги не должны смешиваться с наличными и картой на стойке, иначе смена не сойдётся. Сам способ создаём не мы, а вы: это ваша касса.
Настройки этого блока принадлежат заведению, а не кассе: смените кассу — они останутся, а чего новая касса не умеет, будет выключено с пояснением.
Что важно знать:
- Гостевой путь не зависит от вашего сервера. Сервер Gizmo стоит в клубе и бывает выключен — бронь у гостя всё равно действует, а до стойки доедет, когда сервер включится. В кабинете такие брони помечены, есть кнопка «повторить».
- Одна бронь — одна запись. Повторные прогоны ничего не задваивают.
- Нет карточки гостя в Gizmo — деньги не проводим. В примечании к резервации будет строка «оплачено онлайн», администратор проведёт вручную. Чтобы карточки заводились сами, включите «Заводить в кассе гостей, которых там ещё нет».
Проверьте результат
- Смены — разбор вчерашнего дня: деньги, часы, чеки; открывается любой чек клуба.
- Аналитика → «Меню» — что приносит деньги: тайм-пакеты и бар с маржой тариф «Про».
- Карточка геймера — его чеки и покупки.
- Кнопка За ПК сейчас — кто играет прямо сейчас и сколько времени.
Если синхронизация сломалась
Сервер клуба выключили или сменили пароль оператора — вы увидите уведомление в колокольчике и причину на странице Gizmo. Почините доступ и нажмите Проверить и сохранить — уведомление закроется само.