Фискален бон и термален печат — Appy POS Bridge

Всяка бележка стига до правилната хартия: кухненската в кухнята, баровата на бара, етикетът на своя принтер, а фискалният бон — до касовия апарат през интеграцията с FiscalNet.

Appy POS Bridge, принт сървърът, който работи на един компютър в обекта, свързва облачния POS с хартията на място. Всяка бележка — клиентският бон, производствените бележки за кухня и бар, етикетите, сметката — стига до него по живата връзка със сървъра, записва се в локална опашка и тръгва към термалния принтер, който си задал за този тип бележка. Фискализацията не я правим ние: фискалният бон се издава през FiscalNet — междинният софтуер, който реално говори с касовия апарат — а мостът пренася фискалните команди дотам и връща в POS получения номер на бон. Ако интернетът падне или принтер е офлайн, задачата не изчезва: остава в локалната опашка на диска и се повтаря, включително след рестарт на услугата или спиране на тока.

Заяви оглед

Прозрачни цени: Starter 0 € · Appy POS от 49 €/мес · Вижте цените

Фискален бон и термален печат — Appy POS Bridge

300+ ресторанта вече използват APPY POS

Poco LocoLondon BrothersPizza GiuliaCasa DacilorPizzeria di MariaLa Strada

Какво е принт сървър за ресторант?

Принт сървърът е програмата, която свързва облачния POS с физическите принтери в обекта. Браузърът не може да говори директно с термален принтер, затова сървърът го прави вместо него: получава бона, изпраща го към правилния принтер и го задържа в опашка, ако принтерът е офлайн.

  • Клиентски бонове, кухненски и барови бонове, етикети
  • Маршрутизиране по секции: всяка станция получава само своя бон
  • Термални принтери по мрежа, USB или през спулера на Windows
  • Опашка на диска, която преживява спиране на тока
  • Фискален бон през интеграцията с FiscalNet
  • Дедупликация: повторно изпратен бон не се отпечатва два пъти

Appy POS Bridge не фискализира сам и не е касов апарат. Фискалният бон се издава през FiscalNet, който говори със сертифицираното устройство. Работи само на Windows и не поддържа Bluetooth принтери.

Предизвикателства

  • Браузърът не може да говори директно с термален принтер — нито по мрежа, нито по сериен порт, нито през спулера на Windows.
  • Ако връзката или принтерът падне по време на смяна, кухненската бележка се губи и разбираш чак когато клиентът се оплаче.
  • Когато POS даде таймаут и изпрати заявката пак, същата поръчка може да се отпечата два пъти — на касов апарат това е втори реален фискален бон.
  • Всеки тип бележка има различна дестинация и някой накрая избира принтера на ръка при всеки печат.

С APPY

  • Appy POS Bridge — Windows услугата на един компютър в обекта — говори с принтерите вместо браузъра: мрежа по TCP, USB или сериен порт, спулер на Windows или офис принтер.
  • Задачите стоят в локална опашка на диска и се повтарят автоматично; прекъснатите по време на изпращане се връщат в опашката след рестарт.
  • Двойно доставяне на една и съща задача не води до втори бон — пазят го три независими слоя, а дубликатът връща реалния резултат от първия опит.
  • Всеки тип бележка си има свой принтер, зададен веднъж в локалния панел — след това маршрутизирането става само, поръчка след поръчка.

Резултати

5
Реално внедрени начина за свързване на принтер
3
Независими слоя срещу дублиран бон
0
Загубени задачи при падане на интернета — опашката е на диска
3×
Опита по подразбиране на задача, с пауза, която се удвоява: 2s, после 4s

Характеристики

Пет начина да свържеш принтер

Мрежа по TCP с ESC/POS, USB или сериен COM порт, суров печат през спулера на Windows за термални принтери само с Windows драйвер, страничен печат на лазерен или офис принтер, плюс запис като файл в наблюдавана папка. Едно и също съдържание на бона излиза по всеки от тях.

Фискален бон през интеграцията с FiscalNet

Фискалният бон не го изграждаме ние. POS съставя фискалните командни редове, Appy POS Bridge ги изпраща по HTTP към FiscalNet — междинния софтуер, който управлява касовия апарат — и връща номера на бона в POS. Заявката има таймаут от 15 секунди, а когато FiscalNet откаже бон, получаваш неговия код и съобщение за грешка, а не измислено от нас.

Локална опашка, която преживява аварията

Задачите се записват в SQLite база на компютъра в обекта. Рестарт на услугата или спиране на тока не ги изтрива, а заседналите по време на изпращане се връщат автоматично в опашката. По подразбиране опитите са 3, с пауза, която се удвоява между тях — 2 секунди, после 4; ако вдигнеш броя опити, паузата продължава да расте, с таван 16 секунди.

Без втори бон при повторно изпращане

Една и съща заявка, пристигнала два пъти, не се печата два пъти: ключ за идемпотентност повтаря първия отговор в рамките на 5 минути, заявка, дошла едновременно директно и през релето, изчаква първия печат и наследява резултата му, а задача, преизпратена от сървъра, се игнорира при запис, защото носи същото id. Дубликатът връща реалния резултат от първия опит — отворен капак или свършила хартия никога не се маскират като успешен печат.

Оформлението на бона идва от шаблона, не от кода

Съдържанието на бележката е текст с маркери, управляван от платформата: центриране, получер, инверсия, шрифт A или B, увеличение от 1× до 8×, разделителни линии, редове в две колони, ширина между 16 и 64 знака, рязане, звук и импулс за касово чекмедже. QR кодът се генерира от фърмуера на самия принтер, а логото се сваля от URL и се печата като растерно изображение — PNG, JPEG или WebP.

Локален панел, откриване на принтери и тестов печат

Компютърът в обекта показва уеб панел на румънски, английски и български: сканираш мрежата за принтери на порт 9100, изброяваш серийните портове и инсталираните в Windows принтери, задаваш по един принтер на тип бележка, пускаш тестов печат и следиш последните задачи, състоянието на връзката и здравето на опашката.

Как работи

1

Инсталира се на един компютър в обекта

Един инсталатор поставя Windows услугата на машина, която стои включена в ресторанта, отваря порта в защитната стена и създава пряк път към локалния панел. Изисквания: 64-битов Windows, минимум Windows 7 SP1, с .NET Framework 4.8. Конфигурацията и данните за достъп остават криптирани на диска с ключа на машината, така че файлът не може да се прочете на друг компютър.

2

Задаваш по един принтер на всеки тип бележка

В локалния панел избираш приложението, локацията и POS устройството, сканираш мрежата или серийните портове, добавяш принтерите и ги свързваш с типовете бележки, които сървърът дефинира за твоето устройство — кухненска бележка, барова бележка, етикет, фискален бон и всичко друго, конфигурирано в платформата. Тестов печат потвърждава всяка точка преди първата смяна. Можеш да повториш всичко и без хардуер, върху вградените симулатори — фискалният изпраща само текстови редове, така че тестът не издава реален бон.

3

После гледаш само три числа

След настройката не пипаш нищо повече: мостът се обновява сам — първа проверка 2 минути след стартиране, после на всеки 3 часа и всеки път, когато връзката със сървъра се възстанови. Панелът показва три числа, които трябва да са нула: резултати, които още не са стигнали до сървъра, непотвърдени задачи и задачи, заседнали над 5 минути. Ако някое расте, виждаш проблема преди клиента.

Спецификации, които можеш да провериш

9100
TCP порт по подразбиране за мрежови принтери, с таймаут за свързване от 5 секунди
CP852
Кодова таблица за диакритиките; по подразбиране бонът се печата транслитериран, за да не излизат йероглифи
15s
Таймаут на заявката към FiscalNet, отчитан като отделна грешка, а не като отпечатан бон
7 дни
Колко остават приключените задачи в локалната опашка преди автоматично изчистване

Често задавани въпроси

Само изпраща и е добре да го знаеш предварително. Фискализацията я прави FiscalNet — междинният софтуер на място, който реално говори с касовия апарат. POS съставя фискалните командни редове, Appy POS Bridge ги изпраща по HTTP към FiscalNet и връща получения номер на бон обратно в POS. В моста няма фискален протокол, няма ДДС логика, няма номериране на бонове, няма Z-отчет, няма електронен журнал и няма фискален архив — защото фискализацията не се случва там.
Честният отговор е: тези, които поддържа FiscalNet, а не тези, които ние бихме „сертифицирали". Appy POS Bridge не изпълнява никакъв директен протокол за касов апарат — в него няма драйвер за Datecs, Partner, Tremol или Custom — а списък с марки, който не можем да подкрепим с код, не ти върши работа. Съвместимостта се проверява върху твоето конкретно устройство, заедно с нас, преди инсталацията.
Задачите за печат живеят в SQLite база на компютъра в обекта, не в паметта: преживяват рестарт на услугата и спиране на тока, а прекъснатите по време на изпращане се връщат автоматично в опашката. Същото важи и за резултатите — ако сървърът е недостъпен в момента, в който бонът се отпечата, резултатът се записва на диска и се изпраща отново, докато сървърът го потвърди. Освен това мостът може да сервира локално интерфейса на POS и да препраща заявките към облака с кеш на диска, така че POS да работи и когато уеб сървърът не отговаря.
Двойното доставяне на една и съща задача не води до втори бон: ключът за идемпотентност повтаря първия отговор в рамките на 5 минути, заявка, пристигнала и директно, и през релето, изчаква първия печат и наследява реалния му резултат, а преизпратена от сървъра задача се игнорира при запис, защото носи същото id. Какво не можем да обещаем: заявка без ключ за идемпотентност не получава дедупликация по HTTP пътя, а ако FiscalNet върне грешка, след като касовият апарат вече е отрязал бона, нашият повторен опит може да произведе втори — FiscalNet не ни дава начин да попитаме „бон X отпечата ли се вече?". Затова точната формулировка е „двойното доставяне на една задача не дублира бона", а не „фискален бон никога не може да се дублира".
Краткият списък, за да няма изненади при инсталацията. Не фискализира — това го прави FiscalNet. Няма директен драйвер за касов апарат. Работи само на Windows: няма версия за macOS, Linux, Android или iOS. Не поддържа Bluetooth изобщо — транспортите са мрежа по TCP, сериен/COM, спулер на Windows и файл. Не говори ZPL, TSPL или EPL, така че етикетите се печатат като обикновено ESC/POS съдържание или по един на страница на офис принтер. Печата QR кодове, но не и 1D баркодове върху бона. Не превключва автоматично към резервен принтер, когато един откаже: задачата се повтаря на същия принтер и, ако пак не мине, се отбелязва като неуспешна. Няма драйвери за везна, скенер или клиентски дисплей, а касовото чекмедже се отваря само с импулс през принтера за бонове.
При мрежовите термални принтери — да: състоянието се проверява в реално време след всеки печат и получаваш онлайн, офлайн, отворен капак или свършила хартия. При FiscalNet — не: всичко, което можем да проверим, е че междинният софтуер отговаря по HTTP; реалното състояние на касовия апарат (хартия, фискална памет, отворен ден) не ни е достъпно. А сканирането на мрежата ти казва, че „нещо е отговорило на 192.168.x.y, порт 9100", а не какъв модел е; само серийните портове получават приятелско име, и то защото Windows го дава.
Защото такава е настройката по подразбиране и тя е нарочна. Много евтини термални принтери игнорират командата за избор на кодова таблица и четат разширените байтове като начало на CJK последователност, така че бонът излиза с йероглифи вместо с правилния текст. За да не стигаш дотам, автоматичната транслитерация към ASCII е включена от самото начало. Ако твоят принтер спазва командата за кодова таблица, изключваш опцията за него и получаваш пълния набор по CP852: Ă ă Â â Î î Ș ș Ț ț.
По подразбиране 7 дни, с възможност за промяна, а изчистването върви на всеки час. Мостът е опашка с плъзгащ прозорец, не архив: историята на поръчките и боновете живее в платформата, не на компютъра в обекта. Още едно ограничение, което си струва да знаеш — опашката приема най-много 1000 чакащи задачи за едно POS устройство, а над този праг задачата се отхвърля изрично, а не изчезва мълчаливо.
Локалният панел слуша на всички интерфейси, не само на localhost, а инсталаторът отваря порта в защитната стена за домейн и частен профил. Това е нарочно — POS таблетите в локалната мрежа трябва да го достигат — но означава услуга, достъпна в мрежата, а не запечатана в машината. В замяна конфигурацията и данните за достъп са криптирани на диска с ключа на локалната машина, така че конфигурационният файл не може да се разчете, ако бъде копиран на друг компютър.
Изнасяш от панела цялата конфигурация на Appy POS Bridge като архив — само настройките или настройките заедно с опашката и кеша — и я внасяш на новата машина. Обновяванията и без това стават сами, без опция операторът да ги изключи: първа проверка 2 минути след стартиране, после на всеки 3 часа и при всяко възстановяване на връзката със сървъра.

Виж дали Appy POS Bridge ляга върху това, което вече имаш в обекта

Заедно поглеждаме термалните ти принтери, касовия апарат и компютъра в ресторанта и ти казваме честно кое тръгва веднага, кое трябва да се смени и кое остава работа на FiscalNet.

Заяви оглед

Този уебсайт използва бисквитки, за да подобри потребителското изживяване.