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-порти со ознака од кого е зафатен портот — тоа обично е доволно за да се разбере дали проблемот е во кабелот, во портот или во туѓа програма што го држи портот.