Поставување на Принтер за Сметки: Поврзување и Печатење Нарачки

Print Agent на RestaurantManage е лесна Windows услуга која прима команди за печатење од облакот и ги испраќа до вашиот термален принтер за сметки — овозможувајќи автоматско печатење сметки кога нарачките се платени или кога треба да се отпечатат кујнски билети. Агентот поддржува мрежни принтери (TCP порта 9100), USB принтери и Windows Spooler конекции. Овој водич ги покрива инсталацијата, конфигурацијата, поврзувањето на принтерот и решавањето проблеми.

Kako функционира печатењето на сметки?

Работниот тек на печатење е целосно автоматизиран. Кога касиерот ќе го потврди плаќањето или се активира кујнски билет, RestaurantManage задниот дел го генерира целото сметка како ESC/POS бајт команди. Овие бајти се испраќаат преку безбедна WebSocket конекција (PrintHub) до Print Agent кој работи на Windows PC во вашиот ресторан. Агентот ги декодира податоците и ги проследува директно до поврзаниот термален принтер. Целиот процес трае помалку од две секунди — од потврдата на плаќањето до отпечатената сметка.

Целосниот процес на печатење

Разбирањето на целосниот процес помага при решавање проблеми. Ова е редоследот на настани секогаш кога се печати сметка или кујнски билет:

1. Плаќањето е потврдено: Касиерот ја означува нарачката kako платена, или рачно се активира кујнски билет.
2. Задниот дел го форматира сметката: Серверот на RestaurantManage го извршува ReceiptFormattingService, кој го изградува распоредот на сметката со ReceiptBuilder и го претвора во ESC/POS бајт команди преку EscPosCommands и EscPosRasterEncoder.
3. Податоците се испраќаат преку PrintHub: Форматираните бајти на сметката (кодирани kako Base64) се емитуваат преку безбеден WebSocket канал (SignalR PrintHub) до правиот Print Agent — идентификуван со ID на вашиот ресторан.
4. Print Agent ја прима задачата: Windows услугата која работи на вашиот локален PC ја прима Base64 содржината, ја декодира назад во сирови ESC/POS бајти и утврдува кој принтер да се користи.
5. Излез на принтерот: Декодираните бајти се испраќаат директно до термалниот принтер преку мрежен TCP, Windows Spooler или USB — и сметката се печати за неколку секунди.

Što е вклучено во отпечатената сметка

Секоја сметка генерирана од RestaurantManage вклучува целосен сет детали за трансакцијата. Заглавието го прикажува името, адресата и логото на ресторанот (ако е конфигурирано). Телото вклучува број на маса, нумерирана листа на сите нарачани артикли со количини и единечни цени, применливи попусти и детален даночен преглед по даночна категорија. Подножјето го прикажува вкупниот износ на нарачката, начинот на плаќање (готово, картичка итн.), датумот и времето на плаќањето и опционална порака за благодарност. Кујнските билети следат поедноставен формат кој прикажува само број на маса, имиња на артикли, количини и евентуални забелешки.

Кога се активираат сметките

Сметките на клиентите се печатат автоматски кога касиерот ќе го потврди целосното или делумното плаќање на нарачка. Кујнските билети се печатат кога нова нарачка се поднесува од касиерскиот панел или мобилната апликација на келнерот. Во двата случаи, задачата за печатење е целосно управувана од задниот дел и автоматски се насочува до Print Agent. Овластениот персонал може исто така да иницира повторно печатење од административниот панел ако оригиналното печатење е пропуштено или нечитливо.

Kako го инсталирам Print Agent?

Инсталацијата трае околу пет минути на кој било современ Windows PC. PC мора да остане вклучен за време на работното време на ресторанот бидејќи Print Agent работи kako Windows услуга во позадина.

1. Преземете: Добијте го најновиот инсталатер за Print Agent од вашиот административен панел или контактирајте со поддршката.
2. Инсталирајте: Стартувајте го инсталаторот на Windows PC кој ќе остане вклучен за време на работното време.
3. Конфигурирајте: Отворете config.json и внесете ги основниот URL на API, ID на ресторанот и тајниот клуч на агентот (обезбеден од вашиот администратор).
4. Поврзете го принтерот: Поврзете го вашиот термален принтер преку USB или поврзете го со истата мрежа kako PC.
5. Стартувајте ја услугата: Стартувајте го Print Agent — автоматски се поврзува со PrintHub и прикажува зелен индикатор на статус.
6. Тест печатење: Обработете тест плаќање од касиерскиот панел и проверете дека сметката се печати правилно.

Системски барања

Print Agent има минимални хардверски барања но зависи од поддржан оперативен систем и извршна средина:

• Оперативен систем: Windows 10 (верзија 1909 или понова) или Windows 11. Print Agent е услуга само за Windows и не работи на macOS или Linux.
• Извршна средина: .NET 8 Runtime мора да биде инсталиран. Инсталаторот ќе ве побара да го преземете ако не е присутен — е бесплатен од Microsoft.
• Интернет конекција: Потребна е стабилна интернет конекција за комуникација со облакот на RestaurantManage. Агентот автоматски се поврзува повторно по кратки прекини.
• Мрежен пристап: PC мора да може да го достигне принтерот — или преку USB кабел или на истиот локален мрежен сегмент.
• Процесор и RAM: Секој современ процесор со најмалку 512 MB слободна RAM е доволен. Агентот е многу лесен.

Работење kako Windows услуга

За производствена употреба, Print Agent треба да се инсталира kako Windows услуга за да се стартува автоматски кога PC се вклучи — дури и пред да се најави корисник. За да го регистрирате kako услуга, кликнете со десна тастер на глувчето на install-service.bat и изберете Стартувај kako администратор. Ова го регистрира агентот кај Windows Service Control Manager под името RestaurantPrintAgent. По инсталацијата, можете да го управувате од панелот Услуги (services.msc) или преку командна линија користејќи sc start RestaurantPrintAgent и sc stop RestaurantPrintAgent. За да ја отстраните услугата, стартувајте uninstall-service.bat kako администратор.

Наоѓање на вашиот ID на ресторан и тајниот клуч

ID на ресторанот е уникатниот идентификатор на вашиот ресторан во системот RestaurantManage. Можете да го најдете во административниот панел под Поставки → Информации за ресторанот. Тајниот клуч на агентот е посебен акредитив кој го автентицира Print Agent со PrintHub WebSocket крајната точка — не е исто što и вашата корисничка лозинка. За да генерирате или регенерирате тајниот клуч, одете во Поставки → Print Agent во административниот панел и кликнете на Генерирај нов клуч. Копирајте го клучот веднаш и залепете го во config.json — нема да се прикаже повторно по навигацијата. Ако го изгубите клучот, едноставно генерирајте нов; старите автоматски ќе стане неважечки.

Кои типови на конекција за принтер се поддржани?

Print Agent поддржува три методи на конекција со автоматска резервна можност меѓу нив. Мрежните принтери, USB принтерите и Windows Spooler конекциите се сите поддржани. Агентот прво го испробува Spooler, потоа преминува на директен USB и конечно се обидува со UNC мрежни споделувања.

Мрежни принтери (препорачано)

Мрежните принтери се препорачаниот метод на конекција за повеќето ресторани. Мрежно поврзан термален принтер има своја IP адреса и прифаќа сирови податоци за печатење на TCP порта 9100 — стандардната порта за ESC/POS печатење. За поставување, поврзете го принтерот со рутерот или префрлувачот со Ethernet кабел, потоа користете ја вградената страница за конфигурација на принтерот или менито на предниот панел за да му доделите статична IP адреса (на пример, 192.168.1.100). Внесете ги оваа IP адреса и порта 9100 во конфигурацијата на Print Agent. Статичната IP е важна — ако принтерот добие нова IP од DHCP секогаш кога се рестартира, задачите за печатење ќе пропаднат.

USB и Windows Spooler принтери

USB термалните принтери директно се поврзуваат со Windows PC кој го стартува Print Agent. По поврзувањето на USB кабелот, инсталирајте го Windows драјверот на производителот ако е потребно (многу современи ESC/POS принтери користат генерички драјвер вклучен во Windows). Print Agent ќе го детектира принтерот преку Windows Spooler. Ако принтерот не се прикаже во Spooler, може да се обиде директната USB адресирачка метода: агентот може директно да пишува во патеки на USB уреди kako \\?\USB001 или патеки на паралелни порти kako LPT1.

Автоматски редослед на резервна можност

Кога ќе се прими задача за печатење, Print Agent ги испробува методите на конекција во овој редослед: 1) Windows Spooler — ако принтерот е регистриран во Windows и достапен преку Spooler, овој метод се користи прв. 2) Директен USB — ако Spooler пропадне, агентот се обидува директно да пишува во патеки на USB уреди (USB001, USB002 итн.) и LPT порти. 3) UNC мрежно споделување — kako последно средство, агентот се обидува да го достигне принтерот преку Windows патека за мрежно споделување. Ако сите три методи пропаднат, грешката е забележана во папката logs/ со детали.

Kako го конфигурирам Print Agent?

Print Agent се конфигурира преку единствена датотека config.json лоцирана во директориумот за инсталација. Сите поставки се во обичен текст и стапуваат во сила следниот пат кога услугата ќе се стартува (или рестартира). Нема графички интерфејс за конфигурација — уредувањето на датотеката со кој било уредувач на текст е доволно.

Објаснување на датотеката config.json

Конфигурациската датотека има три задолжителни полиња и прифаќа опционални поставки за принтерот:

• ApiBaseUrl: Основниот URL на вашиот сервер RestaurantManage, на пример <code>https://restaurantmanage.xyz</code>. Не вклучувајте завршна коса черта. Print Agent го користи овој URL за поврзување со PrintHub и проверка на ажурирања.
• RestaurantId: Уникатниот идентификатор на вашиот ресторан. Можете да го најдете во административниот панел под Поставки → Информации за ресторанот.
• AgentSecretKey: Тајниот клуч генериран во административниот панел под Поставки → Print Agent. Овој клуч го автентицира агентот со серверот без потреба од најавување на корисник. Чувајте го доверливо.

Целосен пример на config.json изгледа вака: {"ApiBaseUrl": "https://restaurantmanage.xyz", "RestaurantId": "вашиот-id-ресторан", "AgentSecretKey": "вашиот-таен-клуч"}. По уредувањето на датотеката, рестартирајте ја услугата Print Agent за промените да стапат во сила.

Конфигурација на именото и IP адресата на принтерот

За мрежни принтери, ви треба IP адресата на принтерот. За да ја најдете: повеќето термални принтери печатат конфигурациска страна кога ќе го задржите копчето за напојување притиснато за време на вклучувањето — IP адресата е наведена таму. Алтернативно, проверете ја листата на DHCP клиенти на вашиот рутер за хост-именото на принтерот. Откако ќе ја добиете IP, доделете ја kako статична адреса во мрежните поставки на принтерот за да не се менува никогаш. За Windows Spooler принтери, именото на принтерот мора точно да се совпаѓа со она šo se прикажува во Windows Поставки → Принтери и скенери. Имињата на принтерите се чувствителни на мали/главни букви.

Датотеки со дневник и дијагностика

Print Agent пишува детални дневници во поддиректориумот logs/ во директориумот за инсталација. Датотеките со дневник се именувани по датум (на пример, log-2026-04-06.txt) и се ротираат дневно. Секој запис во дневникот вклучува временска ознака, ниво на сериозност (ИНФО, ПРЕДУПРЕДУВАЊЕ, ГРЕШКА) и опис на она što се случило. Ако решавате проблем со печатење, проверете ја датотеката со дневник за датумот на проблемот — точната порака за грешка ќе покаже дали проблемот е поврзан со мрежата, автентикацијата или принтерот.

Kako функционира автоматското ажурирање?

Print Agent проверува за ажурирања приближно на секои 2,5 часа со повикување на крајната точка за ажурирање на серверот RestaurantManage. Ако е достапна нова верзија, го презема пакетот за ажурирање kako ZIP датотека во папка за ажурирања на чекање, го стартува скриптот за инсталација и автоматски ја рестартира услугата. Ова значи дека вашиот ресторан секогаш работи со најновата верзија без рачна интервенција. Проверките за ажурирање вклучуваат временско трепкање по ресторан за да се избегне истовремено ажурирање на сите агенти.

Решавање на вообичаени проблеми

Повеќето проблеми со печатење спаѓаат во една од три категории: проблеми со конекција, проблеми со хардверот на принтерот или грешки во конфигурацијата. Датотеките со дневник во папката logs/ се најдобрата почетна точка за дијагностицирање на кој било проблем.

Грешки во конекцијата и автентикацијата

• Агентот не се поврзува со серверот: Проверете дали ApiBaseUrl во config.json е точен и достапен од PC. Отворете прелистувач на истиот PC и одете до URL на API — треба да видите одговор. Проверете дека PC има активна интернет конекција.
• Неуспех при автентикација (грешка 401 во дневниците): AgentSecretKey е неточен или е регенериран. Најавете се во административниот панел, генерирајте нов клуч под Поставки → Print Agent, ажурирајте го config.json и рестартирајте ја услугата.
• Конекцијата се прекинува и повторно се поврзува повторено: Ова обично укажува на проблем со нестабилност на мрежата. Префрлете се од Wi-Fi на кабелски Ethernet. Проверете дали заштитен ѕид или антивирус ги блокира излезните WebSocket конекции (агентот користи HTTPS порта 443).
• Агентот се поврзува но не прима задачи за печатење: Потврдете дека ID на ресторанот во config.json точно одговара на оној во административниот панел (чувствителен на мали/главни букви). Исто така проверете дека Print Agent е овозможен под Поставки → Print Agent.

Проблеми со квалитетот на печатење и кодирањето

• Нечитливи знаци или симболи на сметката: Вашиот термален принтер можеби не го поддржува целосно ESC/POS сетот на команди кој го користи RestaurantManage. Проверете ја документацијата на принтерот за компатибилност. Повеќето 58mm и 80mm термални принтери произведени по 2015 година се компатибилни.
• Сметката се печати но текстот е отсечен: Поставката за ширина на хартија може да е неточна. RestaurantManage стандардно ги форматира сметките за хартија од 80mm. Ако користите принтер од 58mm, контактирајте со поддршката за да го овозможите режимот за тесна хартија.
• Сметката се печати празна или само со делумна содржина: Ова може да укажува на низок ролнa хартија или запушена глава за печатење. Заменете ја хартијата и исчистете ја главата за печатење со сув крпен. Ако проблемот продолжи, тестирајте го принтерот директно од Windows за да го изолирате проблемот.
• Специјалните знаци или арапски/RTL текст не се печатат правилно: Уверете се дека знаковниот сет на вашиот принтер е поставен на UTF-8 или соодветна кодна страна за вашиот јазик. Оваа поставка обично е достапна во конфигурациското мени на принтерот.

Неуспеси при стартување на услугата

• Агентот не се стартува kako Windows услуга: Мора да го стартувате install-service.bat kako администратор (десен клик → Стартувај kako администратор). Без зголемени дозволи, услугата не може да се регистрира кај Windows Service Control Manager.
• Услугата се стартува, а потоа веднаш застанува: Проверете го Windows Event Viewer (eventvwr.msc) под Windows Logs → Application за пораки за грешки од RestaurantPrintAgent. Исто така проверете ја папката logs/ за грешки при стартување. Вообичаени причини се отсутна или неправилно форматирана config.json, отсутна .NET 8 извршна средина или конфликт на порти.
• .NET извршна средина отсутна: Преземете и инсталирајте .NET 8 Runtime од https://dotnet.microsoft.com. По инсталацијата, рестартирајте ја услугата Print Agent.
• Заштитниот ѕид го блокира агентот: Windows Defender или заштитен ѕид на трета страна може да ја блокира излезната конекција на агентот. Додадете исклучок за извршната датотека на Print Agent во поставките на вашиот заштитен ѕид.

Поврзани водичи

• Касиерски панел: Kako да обработувате плаќања кои го активираат печатењето на сметки
• Кујнски екран: Kako печатењето на кујнски билети се интегрира со текот на нарачки
• Почеток: Целосен водич за поставување од регистрацијата до првата нарачка