Dacă a dispărut internetul sau cloud-ul este indisponibil

Conexiunea se întrerupe: furnizorul, routerul, o furtună, o avarie la operator. Localul nu se închide însă — oaspeții stau la casă. Mai jos găsiți ce anume continuă să funcționeze, ce nu și ce trebuie să facă schimbul.

Distingeți două tipuri de defecțiune, pentru că se comportă diferit:

Ce s-a întâmplat	Casa din local	Oaspetele de pe stradă
A dispărut internetul în local	Funcționează offline: înregistrează, tipărește, acumulează coada	Vitrina se deschide (este servită din CDN), comanda pleacă în cloud — dar în local o vor vedea abia după restabilirea conexiunii
Cloud-ul este indisponibil	Același lucru: casa nu distinge una de alta — pentru ea este „înregistrarea nu a plecat”	Vitrina se poate deschide din cache, plasarea comenzii și plata nu vor trece

Casa nu încearcă intenționat să ghicească cauza: orice eroare de rețea înseamnă „lucrăm local, înregistrarea intră în coadă”.

Ce continuă să funcționeze#

Casa (POS web). Nu este doar o pagină pusă în cache, ci o coadă reală de înregistrări pe dispozitiv:

comanda se înregistrează și intră în coada de comenzi (trăiește pe casă 24 de ore);
chitanța și schimbul de numerar — coadă proprie de operațiuni (deschiderea schimbului, încasare și retragere, chitanță, retur, închiderea schimbului). Fiecare operațiune are o cheie de idempotență pe client, așa că retrimiterea nu dublează nimic;
schimbul deschis offline primește un număr temporar și continuă să funcționeze: regula „fără schimb deschis plata este interzisă” se aplică și offline, ea calculează după cache-ul local;
meniul, prețurile, mesele, nomenclatoarele se citesc din cache-ul local al browserului — au ajuns acolo cât timp a existat conexiune;
reîncărcarea paginii nu vă aruncă pe ecranul de autentificare: casa se deschide într-o „sesiune degradată” pe baza instantaneului local și se reconectează singură când revine rețeaua.

Tipărirea. Chitanța, tichetul de bucătărie și eticheta se tipăresc prin bridge-ul care rulează pe același computer: casa se adresează lui la adresa locală a mașinii — internetul nu este necesar pentru asta.

Chitanța fiscală. Dacă casa de marcat fiscală este conectată la același computer, chitanța se înregistrează prin bridge pe același canal local: memoria fiscală acumulează documente, iar operatorul de date fiscale le recuperează când apare conexiunea. Pentru 54-FZ acesta este un regim normal, nu o încălcare.

Ecranul de autentificare. Cât timp browserul are o sesiune recentă (fereastra — 7 zile), casierul se autentifică și lucrează; trimiterea celor acumulate va necesita oricum o autentificare reală la restabilirea conexiunii.

Ce nu funcționează fără conexiune#

Ecranul de bucătărie (KDS). Tichetele ajung pe el prin cloud; fără internet, comenzile noi nu vor ajunge în bucătărie — vor pleca acolo la restabilirea conexiunii. Între timp bucătăria lucrează după tichete tipărite, dacă aveți configurată tipărirea pentru bucătărie, sau după comunicarea verbală.
Terminalul bancar. Plata cu cardul necesită autorizare la bancă — offline nu va trece. Acceptați numerar.
Plata online de către oaspete (card pe vitrină, plata notei clientului de la masă, plata la chioșc) — este nevoie de acces la furnizorul de plăți.
A doua casă și tableta ospătarului. Dispozitivele nu se sincronizează între ele în rețeaua locală: fiecare își ține propria coadă și o trimite singur. Un contur local comun („modul LAN”) nu facem în mod deliberat — decizia proprietarului produsului: acoperim autonomia unei singure case cu tipărire.
Raportul X. Secțiunea intermediară se calculează pe server după vânzări — offline casa va refuza, pe bună dreptate. Schimbul poate fi închis, raportul Z se va genera când revine conexiunea.
Secțiunile panoului de administrare care calculează pe server — „Comenzi”, „Finanțe”, „Statistici”, „Stoc”, „Personal”. Ele citesc cloud-ul și offline arată în cel mai bun caz ultimul lucru citit.
Ecranul de predare, afișajul cozii, chioșcul — și ele suprafețe cloud.

Ce trebuie să facă personalul#

Continuați să înregistrați. Imediat ce conexiunea dispare, pe casă apare un banner chihlimbar „offline” și un chip „N netrimise”. Acesta este un regim normal: comanda este preluată, chitanța tipărită, banii încasați.
Tipăriți oaspetelui chitanța ca de obicei. Tipărirea este locală — hârtia iese.
Lucrați pe același dispozitiv și în același browser. Coada se află pe acest computer: nu vă puteți muta pe a doua tabletă și „preda de acolo”.
Nu curățați cache-ul browserului, nu vă deconectați din cont, nu deschideți casa în mod incognito — astfel veți șterge comenzile și chitanțele netrimise.
Puteți reîncărca pagina. Coada supraviețuiește reîncărcării și repornirii browserului.
Nu înregistrați aceeași comandă de două ori „pentru orice eventualitate”: sistemul este protejat împotriva duplicatelor la retrimitere, dar două comenzi diferite le va număra, pe bună dreptate, ca două.
Nu acceptați cardul — terminalul nu autorizează offline. Numerar, iar la dorința oaspetelui — o factură pentru plata ulterioară.
Bannerul roșu „N nedistribuite” înseamnă că o parte din înregistrări nu au plecat nici după restabilirea conexiunii (a expirat termenul sau serverul a refuzat). Acesta este un motiv să chemați managerul, nu să ascundeți bannerul.

Ce se va întâmpla când revine conexiunea#

Retrimiterea începe singură — la evenimentul „a apărut rețeaua”, la revenirea în filă și după un temporizator.

Chipul „N netrimise” scade și dispare. Comenzile apar în secțiunea „Comenzi” și pe ecranul de bucătărie, chitanțele primesc numere, stocul se scade după fișele tehnologice.
Nu vor exista duplicate. Fiecare comandă are un identificator pe client, fiecare operațiune de casă — o cheie de idempotență; serverul recunoaște repetarea și nu o aplică a doua oară.
Schimbul offline este înlocuit cu cel real. Numărul temporar al schimbului este rescris cu cel real în toate chitanțele și mișcările care mai stau în coadă.
Raportul Z se generează pentru schimbul închis offline.
Nimic nu se șterge în tăcere. Înregistrările care nu au putut fi distribuite (au expirat cele 24 de ore sau serverul a returnat o eroare irecuperabilă) ajung într-o listă separată „nedistribuite” (se păstrează 7 zile, până la 100 de înregistrări) și sunt afișate cu un banner roșu, cu posibilitatea de a-l ascunde manual.

Ordinea se păstrează: coada este retrimisă secvențial, iar la erorile temporare ale serverului reîncearcă cu o pauză crescătoare.

Limitări#

Offline este disponibil doar pentru casă și imprimare — și nimic mai mult. Ecranul de bucătărie, terminalul bancar și sincronizarea între dispozitive în rețeaua locală nu funcționează fără internet; un circuit LAN complet nu este realizat în mod deliberat.
Coada este legată de dispozitiv și de browser. Ea se află în stocarea unui anumit browser: un alt computer, un alt browser sau modul incognito nu o văd.
Durata de viață a cozii este de 24 de ore pentru comenzi și operațiuni de casă. Mai mult de o zi fără conexiune — înregistrările ajung în lista „netrimise”, nu dispar în tăcere.
Sesiunea offline durează 7 zile. După aceea casa va cere autentificarea obișnuită, iar aceasta este imposibilă fără rețea.
Raportul X offline nu este disponibil — el se calculează pe server.
Suprafețele pentru oaspeți (vitrina, chioșcul) păstrează coada doar o oră — ele sunt concepute pentru o cădere scurtă a rețelei mobile la oaspete, nu pentru funcționarea fără internet.
Casa Android. Preluarea comenzii și chitanța fiscală locală funcționează offline, iar înregistrarea în registrul de chitanțe și schimbul de numerar offline — încă nu (este planificat). Sursa de adevăr offline acolo este memoria fiscală.
Testul complet „am scos cablul” pe un registrator fiscal real nu a fost încă efectuat. Modul offline al casei este acoperit de cod și de teste automate (inclusiv e2e „offline în timpul sesiunii”), iar verificarea pe hardware real de către proprietar este în plan — spunem acest lucru direct, nu îl prezentăm ca fiind deja efectuat.

Depanare#

Casa cere autentificare, deși funcționa anterior. Sesiunea are mai mult de șapte zile sau browserul a fost curățat. Fără rețea nu se poate autentifica — restabiliți conexiunea.

Eticheta „N netrimise” nu scade. Verificați că conexiunea a revenit cu adevărat (deschideți orice site) și lăsați fila casei activă: retrimiterea are loc la evenimentul de rețea, la revenirea în filă și la temporizator. Dacă eticheta rămâne cu același număr — uitați-vă la bannerul roșu: o parte din înregistrări ar putea fi ajuns în „netrimise”.

A apărut bannerul roșu „N netrimise”. Înregistrările nu au fost acceptate de server: termenul de o zi a expirat sau răspunsul a fost irecuperabil (de exemplu, accesul a fost revocat). Comenzile și chitanțele din această listă trebuie procesate manual — verificați chitanțele de hârtie ale schimbului.

Comanda a fost înregistrată offline, dar în bucătărie nu apare. Așa trebuie să fie: tichetul va ajunge pe ecranul de bucătărie la restabilirea conexiunii. Cât timp nu există rețea, bucătăria se descurcă cu tichete tipărite.

Chitanța nu se tipărește offline. Deci problema nu este internetul: verificați că bridge-ul de pe acest computer este pornit și imprimanta este conectată — Cenaly Hardware Bridge. Bridge-ul și casa comunică în interiorul aceleiași mașini.

După restabilirea conexiunii au apărut comenzi duplicate. Duplicate de la retrimitere nu pot exista — verificați dacă nu ați înregistrat aceeași comandă de două ori manual și anulați comanda în plus în secțiunea „Comenzi”.

Întrebări frecvente#

Casa funcționează fără internet?#

Da: înregistrează comenzi, tipărește chitanțe și le fiscalizează prin bridge pe același computer. Tot ce trebuie să ajungă în cloud se acumulează în coada de pe dispozitiv și se retrimite automat.

Se vor pierde datele?#

Nu. Coada supraviețuiește reîncărcării paginii și repornirii browserului, iar ceea ce nu a putut fi livrat ajunge în lista vizibilă „netrimise”, nu dispare. O puteți pierde doar manual — curățând datele browserului.

Se pot înregistra chitanțe conform 54-FZ offline?#

Da, dacă registratorul fiscal este conectat la același computer ca și bridge-ul: memoria fiscală acumulează documente și le transmite operatorului de date fiscale când conexiunea apare. Acesta este un regim prevăzut de lege.

De ce nu funcționează ecranul de bucătărie?#

Tichetele trec prin cloud. Nu avem o rețea locală între casă și ecranul de bucătărie — aceasta este o decizie deliberată: acoperim autonomia casei cu imprimare, nu întreaga sală. Cât timp nu există rețea, bucătăria se descurcă cu tichete tipărite.

Oaspetele va putea deschide meniul cât timp nu avem internet?#

Da — vitrina este distribuită prin CDN și nu depinde de internetul dumneavoastră. Comanda plasată de oaspete va ajunge în cloud, dar în local o veți vedea doar după restabilirea conexiunii.

Ce facem cu plata cu cardul?#

Acceptați numerar: terminalul bancar are nevoie de autorizare la bancă.

Cât timp rezistă casa fără conexiune?#

O zi pentru coada de comenzi și operațiunile de casă, șapte zile — pentru sesiune. Practic, aceasta înseamnă: veți lucra un schimb liniștit.

Secțiuni conexe#

Casa (POS) — comandă, plată, moduri de servire și secțiunea „Lucrul offline”
Schimbul de numerar și raportul Z — deschidere, mișcări, rapoarte X și Z
Cenaly Hardware Bridge — bridge-ul pe computerul POS, imprimante și registratoare fiscale
Imprimarea pentru bucătărie — tichete pe stații, când ecranul de bucătărie nu este disponibil
Ecranul de bucătărie (KDS) — cum ajung tichetele în bucătărie
Prima zi: cafenea, restaurant, cantină — ce să activați imediat