Fiscalizare, Bon Fiscal & Imprimante Termice — Appy POS Bridge

Comanda ajunge singură pe hârtie: bonul de bucătărie la bucătărie, cel de bar la bar, eticheta la imprimanta ei, iar bonul fiscal la casa de marcat prin integrarea FiscalNet.

Appy POS Bridge, serverul de printare care rulează pe un PC din local, face legătura între POS-ul din cloud și hârtia din restaurant. Fiecare tichet — bonul de client, bonul de producție de la bucătărie sau bar, eticheta, nota de plată — ajunge la el prin conexiunea cu serverul, se scrie într-o coadă locală și pleacă spre imprimanta termică pe care ai mapat-o pentru acel tip de tichet. Fiscalizarea nu o facem noi: bonul fiscal se emite prin FiscalNet, middleware-ul care vorbește efectiv cu casa de marcat, iar puntea duce comenzile fiscale până acolo și întoarce în POS numărul de bon primit. Dacă pică internetul sau o imprimantă este offline, jobul nu dispare — rămâne în coada locală de pe disc și se reia, inclusiv după o repornire a serviciului sau o pană de curent.

Solicită o Evaluare

Prețuri transparente: Starter 0 € · Appy POS de la 49 €/lună · Vezi prețurile

Fiscalizare, Bon Fiscal & Imprimante Termice — Appy POS Bridge

300+ restaurante folosesc deja APPY POS

Poco LocoLondon BrothersPizza GiuliaCasa DacilorPizzeria di MariaLa Strada

Ce este un server de printare pentru restaurant?

Un server de printare este programul care leagă POS-ul din cloud de imprimantele fizice din local. Browserul nu poate vorbi direct cu o imprimantă termică, așa că serverul o face în locul lui: primește tichetul, îl trimite la imprimanta potrivită și îl păstrează în coadă dacă aceasta e offline.

  • Bon de client, bon de bucătărie, bon de bar și etichete
  • Rutare pe secții: fiecare stație primește doar tichetul ei
  • Imprimante termice în rețea, pe USB sau prin spooler-ul Windows
  • Coadă locală pe disc, care supraviețuiește unei pene de curent
  • Bon fiscal prin integrarea FiscalNet
  • Deduplicare: un tichet retrimis nu se tipărește a doua oară

Appy POS Bridge nu fiscalizează el însuși și nu e casă de marcat. Bonul fiscal se emite prin FiscalNet, care vorbește cu dispozitivul certificat. Rulează doar pe Windows și nu suportă imprimante Bluetooth.

Provocări

  • Browserul nu poate vorbi direct cu o imprimantă termică — nici pe rețea, nici pe port serial, nici prin spooler-ul Windows.
  • Dacă pică netul sau imprimanta este offline în mijlocul serviciului, bonul de bucătărie se pierde fără ca cineva să afle.
  • Când POS-ul dă timeout și retrimite cererea, aceeași comandă se poate tipări de două ori — pe casa de marcat asta înseamnă un al doilea bon fiscal real.
  • Fiecare tip de bon are altă destinație, iar cineva ajunge să aleagă manual imprimanta la fiecare tipărire.

Cu APPY

  • Appy POS Bridge, serviciul Windows instalat pe un PC din local, vorbește cu imprimantele în locul browserului: rețea TCP, USB / port serial, spooler Windows sau imprimantă office.
  • Joburile stau într-o coadă locală pe disc și se reiau automat; cele întrerupte în timpul trimiterii sunt repuse în coadă după repornire.
  • Livrarea dublă a aceluiași job nu produce un al doilea bon — protecția este pe trei niveluri independente, iar duplicatul raportează rezultatul real al primei încercări.
  • Fiecare tip de tichet are imprimanta lui, mapată o singură dată în panoul local — apoi rutarea se face singură, la fiecare comandă.

Rezultate

5
Moduri de conectare a imprimantelor, implementate
3
Straturi independente contra bonului dublat
0
Joburi pierdute când pică netul — coada e pe disc
3×
Tentative implicite pe fiecare job, cu pauză care se dublează: 2s, apoi 4s

Caracteristici

Cinci moduri de conectare a imprimantelor

Rețea TCP cu ESC/POS, USB sau port serial COM, spooler Windows în mod raw pentru imprimantele termice care au doar driver de Windows, randare pe pagină pentru o imprimantă laser sau office, plus export ca fișier într-un folder urmărit. Același conținut de bon merge pe oricare dintre ele.

Bon fiscal prin integrarea FiscalNet

Bonul fiscal nu îl construim noi. POS-ul compune liniile de comandă fiscală, Appy POS Bridge le trimite prin HTTP către FiscalNet — middleware-ul care vorbește cu casa de marcat — și întoarce în POS numărul de bon. Timeout de 15 secunde, iar dacă FiscalNet refuză, primești codul și mesajul lui de eroare, nu o eroare inventată de noi.

Coadă locală care supraviețuiește căderilor

Joburile se scriu într-o bază SQLite pe PC-ul din local. Repornirea serviciului sau pana de curent nu le șterge, iar cele rămase blocate în trimitere se repun automat în coadă. Implicit sunt 3 tentative, cu pauză care se dublează între ele — 2 secunde, apoi 4; dacă ridici numărul de tentative, pauza crește mai departe, plafonată la 16 secunde.

Fără bon dublat la retrimitere

Aceeași cerere ajunsă de două ori nu se tipărește de două ori: cheie de idempotență cu memorie de 5 minute pe calea HTTP, revendicare între livrarea directă și cea prin releu, plus ignorarea la inserare a unui id de job deja existent în coadă. Duplicatul raportează rezultatul real al primei încercări — un capac deschis sau hârtia terminată nu se maschează niciodată ca „tipărit cu succes".

Layout-ul bonului vine din șablon, nu din cod

Conținutul tichetului este text cu marcaje, controlat din platformă: centrare, bold, video invers, font A sau B, mărire de la 1× la 8×, linii separatoare, rânduri pe două coloane, lățime configurabilă între 16 și 64 de caractere, tăiere, beep și deschidere de sertar. Codul QR este generat de firmware-ul imprimantei, iar logo-ul se descarcă din URL și se tipărește ca imagine raster — PNG, JPEG sau WebP.

Panou local, scanare și print de test

Pe PC-ul din local ai o interfață web în română, engleză și bulgară: scanezi rețeaua după imprimante pe portul 9100, enumeri porturile COM și imprimantele instalate în Windows, mapezi câte o imprimantă pe fiecare tip de tichet, dai un print de test și urmărești joburile recente, starea conexiunii și sănătatea cozii.

Cum funcționează

1

Se instalează pe un PC din local

Un singur installer pune serviciul Windows pe un calculator care rămâne pornit în restaurant, deschide portul din firewall și creează scurtătura către panoul local. Cerințe: Windows pe 64 de biți, minimum Windows 7 SP1, cu .NET Framework 4.8. Configurația și credențialele rămân criptate pe disc cu cheia mașinii, deci fișierul nu poate fi citit pe alt calculator.

2

Mapezi câte o imprimantă pe fiecare tip de tichet

Din panoul local alegi aplicația, locația și dispozitivul POS, scanezi rețeaua sau porturile COM, adaugi imprimantele și le legi la tipurile de tichet pe care serverul le definește pentru dispozitivul tău — bon de bucătărie, bon de bar, etichetă, bon fiscal și oricare altele configurate în platformă. Un print de test confirmă fiecare punct înainte de primul serviciu. Poți repeta totul și fără hardware, pe simulatoarele incluse — cel fiscal folosește doar linii de text, deci testul nu emite un bon real.

3

Apoi te uiți doar la trei cifre

După configurare nu mai atingi nimic: puntea se actualizează singură — o primă verificare la 2 minute după pornire, apoi la fiecare 3 ore și de fiecare dată când revine conexiunea cu serverul. Panoul arată trei numere care ar trebui să fie zero: rezultate care nu au ajuns încă la server, joburi neconfirmate și joburi blocate de peste 5 minute. Dacă vreunul crește, vezi problema înainte să o vadă clientul.

Specificații pe care le poți verifica

9100
Portul TCP implicit pentru imprimantele de rețea, cu timeout de conectare de 5 secunde
CP852
Pagina de cod pentru diacriticele românești; implicit bonul se tipărește transliterat, ca să nu iasă ideograme
15s
Timeout-ul cererii către FiscalNet, raportat ca eroare distinctă, nu ca „bon tipărit"
7 zile
Cât rămân joburile terminate în coada locală înainte de curățarea automată

Întrebări frecvente

Doar trimite, și e important să știi asta dinainte. Fiscalizarea o face FiscalNet — middleware-ul instalat în local, care vorbește efectiv cu casa de marcat. POS-ul compune liniile de comandă fiscală, Appy POS Bridge le trimite prin HTTP către FiscalNet și întoarce în POS numărul de bon primit înapoi. În codul punții nu există protocol fiscal, logică de TVA, numerotare de bon, raport Z, jurnal electronic sau arhivă fiscală — pentru că nu acolo se întâmplă fiscalizarea.
Răspunsul onest este: cele pe care le suportă FiscalNet, nu cele pe care le-am „certifica" noi. Appy POS Bridge nu implementează niciun protocol direct de casă de marcat — nu are driver Datecs, Partner, Tremol sau Custom, iar o listă de mărci pe care nu o putem susține din cod nu îți folosește la nimic. Compatibilitatea se verifică pe modelul tău concret, împreună cu noi, înainte de instalare.
Joburile de imprimare stau într-o bază SQLite pe PC-ul din local, nu în memorie: supraviețuiesc repornirii serviciului și penei de curent, iar cele întrerupte în timpul trimiterii se repun automat în coadă. La fel și rezultatele — dacă serverul nu e accesibil în momentul în care bonul s-a tipărit, rezultatul se salvează pe disc și se retrimite până când serverul îl confirmă. În plus, puntea poate servi local interfața POS și poate proxy-a apelurile către cloud, cu cache pe disc, astfel încât POS-ul să funcționeze și când serverul web nu răspunde.
Livrarea dublă a aceluiași job nu produce un al doilea bon: cheia de idempotență reia răspunsul primei cereri timp de 5 minute, o cerere care ajunge și direct și prin releu așteaptă prima tipărire și moștenește rezultatul ei real, iar un job retransmis de server este ignorat la inserarea în coadă pentru că are același id. Ce nu putem promite: o cerere care sosește fără cheie de idempotență nu beneficiază de deduplicare pe calea HTTP, iar dacă FiscalNet întoarce eroare după ce casa de marcat a tăiat deja bonul, reîncercarea noastră poate produce un al doilea bon — FiscalNet nu ne oferă nicio cale prin care să întrebăm „bonul X s-a tipărit deja?". Deci formularea corectă este „livrarea dublă a aceluiași job nu duplică bonul", nu „un bon fiscal nu poate fi duplicat niciodată".
Lista scurtă, ca să nu ai surprize la instalare. Nu fiscalizează — o face FiscalNet. Nu are driver direct de casă de marcat. Rulează doar pe Windows: nu există versiune de macOS, Linux, Android sau iOS. Nu suportă Bluetooth deloc — transporturile sunt rețea TCP, serial/COM, spooler Windows și fișier. Nu vorbește ZPL, TSPL sau EPL, deci etichetele se tipăresc ca bonuri ESC/POS obișnuite sau câte una pe pagină la o imprimantă office. Nu tipărește coduri de bare 1D pe bon, doar coduri QR. Nu comută automat pe o imprimantă de rezervă când una cade: jobul se reia pe aceeași imprimantă și, dacă tot nu merge, este marcat eșuat. Nu are drivere de cântar, scanner sau display de client, iar sertarul de bani se deschide doar prin impuls trimis prin imprimanta de bonuri.
La imprimantele termice de rețea, da: după fiecare tipărire se interoghează starea în timp real și primești online, offline, capac deschis sau hârtie terminată. La FiscalNet, nu — tot ce putem verifica este că middleware-ul răspunde la HTTP; starea reală a casei de marcat (hârtie, memorie fiscală, zi deschisă) nu ne este expusă. Iar scanarea rețelei îți spune că „ceva a răspuns pe 192.168.x.y, portul 9100", nu ce model este; doar porturile seriale primesc un nume prietenos, pentru că îl dă Windows.
Pentru că așa este setat implicit, intenționat. Multe imprimante termice ieftine ignoră comanda de selectare a paginii de cod și interpretează octeții extinși ca început de secvență CJK, așa că bonul iese cu ideograme în loc de „Brânză afumată". Ca să nu ajungi acolo, transliterarea automată în ASCII este pornită din start și tipărește „Branza afumata". Dacă imprimanta ta respectă selecția de pagină de cod, oprești opțiunea pe imprimanta respectivă și primești diacriticele complete pe CP852: Ă ă Â â Î î Ș ș Ț ț.
Implicit 7 zile, configurabil, iar curățarea rulează din oră în oră. Puntea este o coadă cu fereastră rulantă, nu o arhivă: istoricul comenzilor și al bonurilor trăiește în platformă, nu pe PC-ul din local. Tot aici e o limită de care merită să știi — coada acceptă maximum 1000 de joburi în așteptare pentru un dispozitiv POS, iar peste acest prag jobul este respins explicit, nu pierdut în tăcere.
Panoul local ascultă pe toate interfețele, nu doar pe localhost, iar installerul deschide portul în firewall pe profilurile de domeniu și privat. Este intenționat — tabletele POS din rețeaua locală trebuie să ajungă la el — dar înseamnă că vorbim de un serviciu accesibil în LAN, nu de unul sigilat pe mașină. În schimb, configurația și credențialele sunt criptate pe disc cu cheia mașinii locale, deci fișierul de configurare nu poate fi decriptat dacă este copiat pe alt calculator.
Exporți din panou toată configurația Appy POS Bridge ca arhivă — doar setările sau setările împreună cu coada și cache-ul — și o imporți pe calculatorul nou. Actualizările se fac oricum singure, fără opțiune de dezactivare pentru operator: o primă verificare la 2 minute după pornire, apoi la fiecare 3 ore și la fiecare revenire a conexiunii cu serverul.

Vezi dacă Appy POS Bridge se așază peste ce ai deja în local

Ne uităm împreună la imprimantele termice, la casa de marcat și la PC-ul din restaurantul tău și îți spunem sincer ce merge din prima, ce trebuie schimbat și ce rămâne în sarcina FiscalNet.

Solicită o Evaluare

Soluții conexe

POS & Management Comenzi

Află mai multe

Ecrane Bucătărie (KDS)

Află mai multe

eFactura ANAF

Află mai multe

Acest site folosește cookie-uri pentru a îmbunătăți experiența utilizatorilor.