Cenaly Hardware Bridge — обладнання закладу

Браузер сам по собі не вміє друкувати чеки на POS-принтері, відкривати грошову шухляду чи зчитувати вагу з ваг. Це завдання вирішує Cenaly Hardware Bridge — невеликий безкоштовний додаток, який встановлюється на комп'ютер каси, працює у фоні та зв'язує сторінку адмінки/каси з локальним обладнанням закладу.

Відкрити: Адмін-панель → Обладнання (admin.cenaly.com).

Що підключається#

Черга друку#

Друк через міст — не «надіслав і сподівайся». У моста своя черга завдань із повторами, яка переживає перезапуск: якщо принтер вимкнули або закінчився папір, завдання не губиться й надрукується, коли пристрій оживе.

Через це в друку п'ять різних результатів, а не «вдалося/не вдалося»: надруковано, прийнято в чергу (паперу ще немає!), надруковано браузером, друкує фіскальна каса (див. нижче) і не надруковано. У шапці каси видно індикатор черги з числом завдань, що очікують.

Завдання ідемпотентні: повторне надсилання того самого документа не дає другої бумажки.

Фіскальний реєстратор — не запасний чековий принтер. Якщо на точці немає окремого чекового принтера, міст НЕ стане друкувати наш чек через фіскальну касу: фіскальний чек вона друкує сама, а наш документ — це інший папір. Каса в такій ситуації так і каже: «чек друкує сама фіскальна каса». Через реєстратор дозволені лише тестовий друк і пречек — і на них друкується позначка, що це не фіскальний документ.

Подробиці, прив'язка принтерів до станцій і кодові сторінки для кирилиці та грузинської — Друк на кухні та в залі.

Встановлення моста#

Якщо моста не знайдено на цьому ПК, сторінка запропонує його встановити:

1. Завантажте версію для вашої ОС — Windows, Linux (x64) або Linux (ARM64) (macOS — у планах). Для перевірки вказано SHA-256.
2. Запустіть додаток. Windows — подвійний клік: міст іде у фон (значок у треї) і відкриває сторінку стану. Linux — надійніше одразу поставити фоновою службою однорядковиком зі сторінки «Обладнання» (curl … | sudo … bash): вона стартує при завантаженні ПК і перезапускається сама. Запуск завантаженого файлу вручну (chmod +x і запуск) теж працює, але міст живе лише поки відкрито термінал і після перезавантаження не повернеться; сторінку стану на Linux відкривайте самі — http://127.0.0.1:9100.
3. Переконайтеся на сторінці стану, що міст запущено. Відкрийте адмінку на цьому ж ПК, виберіть потрібну точку і розділ «Обладнання»: браузер підключається автоматично.
4. Поверніться в адмінку і натисніть «Шукати знову» — каса сама знайде міст на цьому ПК і підключиться.

Якщо Windows показує попередження при завантаженні/запуску — це очікувано: виберіть «Зберегти», а при запуску «Докладніше» → «Виконати в будь-якому разі». Для Linux є однорядкове встановлення фоновою службою.

Як прибрати міст з комп'ютера (Linux). Тим самим однорядковиком зі сторінки «Обладнання», тільки з підкомандою — на сторінці він схований під «Linux — зупинити або видалити міст»:

• … | sudo bash -s -- stop — зупинити службу і зняти її з автозапуску; файли й налаштування на місці, увімкнути назад — start;
• … | sudo bash -s -- uninstall — зняти службу і видалити саму програму. Налаштування і прив'язка каси залишаються, і скрипт друкує, де вони лежать;
• … | sudo bash -s -- uninstall --purge — те саме плюс налаштування: список обладнання і прив'язку до точки. Після цього касу доведеться зв'язати заново;
• … | sudo bash -s -- status — чи працює міст і за якою адресою (якщо 9100 зайнято, міст бере наступний вільний, до 9109).

На Windows для цього є звичайне «Встановлення та видалення програм» (запис «Cenaly Bridge») — деінсталятор прибирає і автозапуск.

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

Міст прив'язаний до вашого бренду: завантажений з чужого брендингового домену він вашу адмінку обслуговувати не буде, а якщо міст уже прив'язаний до іншої точки того самого власника, сторінка покаже це і запропонує переприв'язати його сюда однією кнопкою.

Три способи підключення#

Код входу співробітника з розділу «Пристрої» — окремий механізм. Якщо PIN або код минув, створіть новий відповідною кнопкою.

Керування та перевірки#

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

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

При додаванні принтера виберіть його призначення: чековий, кухонний або для етикеток. Роль видно в картці пристрою. Вона задає призначення всередині моста; розподіл обладнання між окремими робочими місцями — інший рівень налаштування. Якщо читання налаштувань не вдалося, майстер запропонує повторити і збереже наявний список.

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

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

Обладнання всього облікового запису та робота з хмари#

Крім моста «цього комп'ютера» на сторінці є реєстр обладнання облікового запису — наскрізна таблиця всіх мостів, пристроїв і камер за всіма точками мережі: видно, що де стоїть, чи онлайн міст, яким точкам він обслуговує обладнання. Пристрій можна перенести в іншу локацію, якщо міст у цей момент онлайн; у офлайн-моста реєстр лише показує, але не змінює.

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

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

Друк на принтер сусіднього комп'ютера. Якщо принтер фізично підключений до іншого ПК, його не обов'язково «розшарювати» по мережі чи тягнути кабель. Дія «Друкувати з іншого ПК» у реєстрі заводить на цій машині посилання на чужий принтер: вибираються комп'ютер-власник, точка та ім'я, далі рядок позначений «через хмару → ПК-власник», а завдання друкуються чергою того комп'ютера. Спільна папка, VPN і пряма видимість машин не потрібні — достатньо, щоб обидва мости обслуговували одну точку.

Віддалений екран каси. З тієї самої сторінки (і за запрошенням з робочого чату) можна подивитися на екран касового комп'ютера — наприклад, щоб побачити на власні очі, що там показує каса. Вирішує завжди та сторона: поки її власник не увімкнув віддалений доступ у себе, кнопки підключення немає, а кожен сеанс потребує його окремої згоди — «більше не питати» немає навмисно. Перегляд і керування — два різних дозволи, а закриття вікна гарантовано завершує сеанс.

Пов'язані розділи#

• Каса (POS) — де використовується друк чеків і грошова шухляда
• Чеки та повернення — друк і повтор чеків
• Фіскалізація — фіскальні принтери та онлайн-каси
• Друк на кухні та в залі — станції, стікери, черга та кодові сторінки
• Ваговий товар і етикетки — робота з вагами, одиниці вимірювання та етикетки на полицю
• Обладнання: що підключається — огляд класів заліза та мінімальні комплекти за форматами
• Телефонія: своя АТС — телефони та шлюзи моста обладнання не потребують і живуть своїм контуром
• Контроль втрат — відеокліпи небезпечних операцій з камери моста

Часті питання#

Чи потрібно вводити код для прив'язки?#

Зазвичай ні: міст запускається на тому самому ПК, де відкривають касу, і вона знаходить його сама за кнопкою «Шукати знову». Код потрібен лише для моста на комп'ютері, де адмінку не відкривають, — тоді власник виписує одноразовий код і вводить його на сторінці моста.

На яких ОС працює міст?#

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

Обладнання не видно — що перевірити?#

Переконайтеся, що міст запущено (сторінка стану), і натисніть «Шукати знову». Стан кожного пристрою та швидкі перевірки доступні на сторінці «Обладнання». Якщо пристрій не з'явився, відкрийте в реєстрі обладнання картку «Деталі ПК» цієї машини: там видно все залізо, яке бачить сам комп'ютер, і всі COM-порти з позначкою, ким порт зайнятий, — цього зазвичай достатньо, щоб зрозуміти, чи справа в кабелі, у порті чи в чужій програмі, яка тримає порт.