Cenaly Hardware Bridge — оборудование заведения

Браузер сам по себе не умеет печатать чеки на POS-принтере, открывать денежный ящик или читать вес с весов. Эту задачу решает Cenaly Hardware Bridge — небольшое бесплатное приложение, которое ставится на компьютер кассы, работает в фоне и связывает страницу админки/кассы с локальным оборудованием заведения.

Открыть: Админ-панель → Оборудование (admin.cenaly.ru).

Что подключается#

Контроллер налива (флоуметры кранов) — пока каркас. Отчёт «налито ↔ продано» на вкладке «Розлив» уже работает, маппинг «кран → товар и порция» настраивается, но сторона «налито» до подключения физического датчика показывает демонстрационные данные — страница честно об этом предупреждает.

Фискальные устройства и онлайн-кассы по странам описаны в отдельном разделе Фискализация.

Очередь печати#

Печать через мост — не «отправил и надейся». У моста своя очередь заданий с повторами, которая переживает перезапуск: если принтер выключили или кончилась бумага, задание не теряется и напечатается, когда устройство оживёт.

Из-за этого у печати пять разных исходов, а не «получилось/не получилось»: напечатано, принято в очередь (бумаги ещё нет!), напечатано браузером, печатает фискальная касса (см. ниже) и не напечатано. В шапке кассы виден индикатор очереди с числом ожидающих заданий.

Задания идемпотентны: повторная отправка того же документа не даёт вторую бумажку.

Фискальный регистратор — не запасной чековый принтер. Если на точке нет отдельного чекового принтера, мост НЕ станет печатать наш чек через фискальную кассу: фискальный чек она печатает сама, а наш документ — это другая бумага. Касса в такой ситуации так и говорит: «чек печатает сама фискальная касса». Через регистратор разрешены только тестовая печать и пречек — и на них печатается пометка, что это не фискальный документ.

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

Установка моста#

Если мост не найден на этом ПК, страница предложит его установить:

1. Скачайте версию под вашу ОС — Windows, Linux (x64) или Linux (ARM64) (macOS — в планах). Для проверки указан SHA-256.
2. Запустите приложение (Windows — двойной клик; Linux — chmod +x и запуск). Оно стартует в фоне и открывает страницу состояния.
3. Убедитесь на странице состояния, что мост запущен — никакого кода вводить не нужно, привязка автоматическая.
4. Вернитесь в админку и нажмите «Искать снова» — касса сама найдёт мост на этом ПК и подключится.

Если Windows показывает предупреждение при скачивании/запуске — это ожидаемо: выберите «Сохранить», а при запуске «Подробнее» → «Выполнить в любом случае». Для Linux есть однострочная установка фоновым сервисом.

Мост на компьютере, где админку не открывают (сервер в подсобке, отдельный ПК у принтеров), привязать автопоиском нельзя — автопривязка работает только между мостом и страницей кассы на том же компьютере. Для такого случая владелец выписывает в админке одноразовый код привязки (живёт 15 минут) и вводит его на странице состояния моста.

Мост привязан к вашему бренду: скачанный с чужого брендингового домена он вашу админку обслуживать не будет, а если мост уже привязан к другой точке того же владельца, страница покажет это и предложит перепривязать его сюда одной кнопкой.

Управление и проверки#

Когда мост подключён, на странице видно:

• Устройства — список с состоянием каждого (подключено / внимание / ошибка / не найдено);
• Проверка оборудования — быстрый тест печати, сканирования, веса;
• Настройки оборудования;
• Активность — лента событий (скан, вес, печать) в реальном времени;
• Обновление — если вышла новая версия моста, её можно поставить прямо отсюда.

Найденное оборудование можно отключить или удалить. «Отключить» оставляет устройство в списке со всеми настройками, но драйвер не поднимается: COM-порт свободен, опроса нет, роль достаётся другому устройству — включается обратно одной кнопкой. «Удалить» (под подтверждением) убирает устройство насовсем, и автоподхват знакомого оборудования его больше не возвращает при следующем запуске моста. Оборудование, которое настраивали раньше, а сейчас поиск его не видит, показывается отдельной группой — иначе управлять им было бы нечем.

Мостов на аккаунт может быть несколько, и каждому задаётся роль: универсальный, оборудование, камеры или телефония. Мосты точки перечислены отдельным списком — их можно переименовать и назначить мост по умолчанию.

Оборудование всего аккаунта и работа из облака#

Кроме моста «этого компьютера» на странице есть реестр оборудования аккаунта — сквозная таблица всех мостов, устройств и камер по всем точкам сети: видно, что где стоит, онлайн ли мост, каким точкам он обслуживает оборудование. Устройство можно перенести в другую локацию, если мост в этот момент онлайн; у офлайн-моста реестр только показывает, но не меняет.

У каждой машины в реестре раскрывается карточка «Детали ПК»: имя компьютера, IP и MAC, система, модель, процессор, память по слотам, накопители со свободным местом и состоянием, всё подключённое оборудование и все COM-порты — с пометкой, какой порт кем занят, а какой свободен. Это первое, куда стоит заглянуть, когда «принтер был, а теперь его не видно» или на кассовом ПК кончается место. Данные собирает сам мост; у старой версии моста список оборудования может быть пуст — тогда достаточно обновить мост.

Помимо локального канала (браузер ↔ мост на этом ПК) есть облачный: команда уходит мосту через сервер, поэтому напечатать чек или проверить принтер можно с другого устройства — например, официант со своего телефона печатает на кассовый принтер за стойкой. На странице это видно как «облачная привязка» у моста и отдельная кнопка облачной тестовой печати.

Печать на принтер соседнего компьютера. Если принтер физически подключён к другому ПК, его не обязательно «расшаривать» по сети или тянуть кабель. Действие «Печатать с другого ПК» в реестре заводит на этой машине ссылку на чужой принтер: выбираются компьютер-владелец, точка и имя, дальше строка помечена «через облако → ПК-владелец», а задания печатаются очередью того компьютера. Общая папка, VPN и прямая видимость машин не нужны — достаточно, чтобы оба моста обслуживали одну точку.

Удалённый экран кассы. С той же страницы (и по приглашению из рабочего чата) можно посмотреть на экран кассового компьютера — например, чтобы увидеть глазами, что там показывает касса. Решает всегда та сторона: пока её владелец не включил удалённый доступ у себя, кнопки подключения нет, а каждый сеанс требует его отдельного согласия — «больше не спрашивать» нет намеренно. Просмотр и управление — два разных разрешения, а закрытие окна гарантированно завершает сеанс.

Связанные разделы#

• Касса (POS) — где используется печать чеков и денежный ящик
• Чеки и возвраты — печать и повтор чеков
• Фискализация — фискальные принтеры и онлайн-кассы
• Печать на кухне и в зале — станции, стикеры, очередь и кодовые страницы
• Весовой товар и этикетки — работа с весами, единицы измерения и этикетки на полку
• Контроль потерь — видеоклипы опасных операций с камеры моста

Частые вопросы#

Нужно ли вводить код для привязки?#

Обычно нет: мост запускается на том же ПК, где открывают кассу, и она находит его сама по кнопке «Искать снова». Код нужен только для моста на компьютере, где админку не открывают, — тогда владелец выписывает одноразовый код и вводит его на странице моста.

На каких ОС работает мост?#

Windows и Linux (x64 и ARM64). Версия для macOS в планах.

Оборудование не видно — что проверить?#

Убедитесь, что мост запущен (страница состояния), и нажмите «Искать снова». Состояние каждого устройства и быстрые проверки доступны на странице «Оборудование». Если устройство не появилось, откройте в реестре оборудования карточку «Детали ПК» этой машины: там видно всё железо, которое видит сам компьютер, и все COM-порты с пометкой, кем порт занят, — этого обычно хватает, чтобы понять, дело в кабеле, в порте или в чужой программе, которая держит порт.