Aplicația E-BON

Lucrul offline și starea conexiunii

Continuă să emiți bonuri când rețeaua cade. Ce înseamnă pictograma de cloud din antet, cum citești starea dispozitivului și ce faci când ceva devine roșu.

Lucrul offline și starea conexiunii

Dacă te-ai întrebat vreodată ce îți spune pictograma de cloud din antet, această pagină este pentru tine. Răspunde la cele trei întrebări pe care le pune orice operator prima dată când conexiunea cade: ce înseamnă indicatorul? am pierdut bonurile? când revine?

Recunoaște cele două conexiuni

Aplicația ține cont de două conexiuni, iar acestea pot pica independent.

Conexiunea	Unde o vezi	Ce influențează
Cloud — între aplicație și serverele e-bon	Pictograma de cloud din antetul aplicației (gri `cloud-off`, verde `cloud-done` sau chihlimbar `cloud-queue`)	Dacă comenzile trimise din Portal ajung la acest dispozitiv.
Dispozitiv fiscal (AMEF) — între aplicație și casa de marcat	Pastila colorată de lângă fiecare dispozitiv din tab-ul Dispozitive — `Online`, `Ocupat`, `Avertisment`, `Eroare`, `Offline`	Dacă această aplicație poate trimite comenzi către AMEF.

Cele două indicatoare pot apărea în orice combinație. „Cloud Reconectare + AMEF Online" este normal în timpul unei căderi scurte de date mobile. „Cloud Conectat + AMEF Offline" indică de obicei o problemă de Bluetooth, USB sau alimentare la dispozitiv — nu o problemă de rețea.

Citește pictograma stării cloud

Pictograma de cloud stă în antetul aplicației pe orice ecran. Forma și culoarea ei urmăresc conexiunea cu cloud-ul:

Cloud tăiat, gri (cloud-off) — ești în regim Standalone (neautentificat). Nu există conexiune cu cloud-ul, prin design.
Cloud verde cu bifă (cloud-done) — Conectat și live. Aceasta este starea normală când ești autentificat.
Cloud chihlimbar (cloud-queue) — Reconectare: ești autentificat, dar conexiunea live este momentan căzută și aplicația încearcă din nou.

O mică bulină cu număr apare pe pictogramă când există bonuri care încă așteaptă să se sincronizeze în cloud — numărul arată câte sunt nesincronizate și dispare după ce totul s-a sincronizat. Pictograma dă și un scurt puls când sosește o comandă din cloud.

Pictograma este doar informativă. Nu există „atinge pentru reîncercare" — recuperarea este automată și de obicei durează sub un minut.

Continuă să vinzi când cloud-ul este căzut

Pierderea cloud-ului — sau nesemnarea niciodată — nu oprește casa de marcat.

Dispozitivul fiscal este local. Continuă să emiți bonuri ca de obicei — bonurile se tipăresc, se salvează pe dispozitiv și se sincronizează în cloud când rețeaua revine (sau când te autentifici, eventual).

Aplicația este offline-first prin design. Tot ce contează la tejghea funcționează fără niciun cont în cloud:

Emiterea bonurilor fiscale pe imprimanta din fața ta.
Rularea rapoartelor X și Z. CUI-ul există în interiorul AMEF-ului, deci rapoartele nu au niciodată nevoie de cloud.
Jurnalul ANAF — activitatea fiscală locală este înregistrată pe acest dispozitiv.
Asocierea, dezasocierea și administrarea imprimantelor la locația activă a acestui dispozitiv (locația locală Standalone când ești deconectat sau o locație reală când ești autentificat).
Navigarea și retipărirea bonurilor recente.

Ce se schimbă cât timp cloud-ul este inaccesibil (sau nu te-ai autentificat niciodată):

Bonurile emise pe AMEF-ul din fața ta: neafectate. Tipărește în continuare.
Comenzi trimise din Portal (un coleg care apasă „Tipărește bon" de la distanță, un apel din integrare): relevante doar după ce te-ai autentificat. Dacă ești autentificat și cloud-ul cade, comenzile așteaptă în coadă revenirea conexiunii; tot ce nu se livrează în 3 minute este marcat ca eșuat în Portal și poate fi retrimis.
Bulina cu număr de pe pictograma de cloud: câte bonuri încă așteaptă să se sincronizeze în cloud. Când conexiunea este sănătoasă, se încarcă în fundal și bulina dispare; cât timp cloud-ul este inaccesibil, numărul rămâne pur și simplu până când revine.

Reconectează-te după o cădere

Nu ai nimic de făcut — aplicația reîncearcă singură, cu pauze tot mai lungi între încercări (1, 2, 4, 8, 16, 30 de secunde, apoi câte una la fiecare 30 de secunde până trece). Majoritatea căderilor scurte se rezolvă într-un minut.

Două situații cer ajutorul tău:

După deconectare, cloud-ul rămâne neconectat

Este normal și inofensiv — aplicația comunică cu cloud-ul doar când cineva este autentificat. Regimul standalone nu are deloc nevoie de o conexiune la cloud; pictograma arată pur și simplu cloud-ul tăiat, gri. Reautentificarea din Setări redeschide conexiunea și re-asociază automat organizației tale imprimantele și bonurile locale.

Pictograma rămâne chihlimbar (Reconectare) imediat după autentificare și nu se mai stinge

Sesiunea ta a fost respinsă. Ieși din cont și autentifică-te din nou. Vezi Autentificare în cloud.

Cât timp e-bon este în prim-plan, păstrează o singură conexiune securizată cu cloud-ul și primește actualizări live. Când treci la altă aplicație, e-bon închide intenționat această conexiune ca să economisească baterie. Dacă serverul are ceva de livrat — o comandă de la distanță, o acțiune din Portal — trimite o notificare silențioasă care doar trezește aplicația; comanda în sine se descarcă prin conexiunea redeschisă. La reconectare, aplicația golește mai întâi comenzile rămase în coadă pe acest dispozitiv, apoi recuperează tot ce a ratat înainte de a reveni la actualizări live.

Curios cum funcționează în spate? Vezi Prezentarea arhitecturii și pagina pentru dezvoltatori Realtime — primii pași.

Citește pastila stării dispozitivului

Fiecare dispozitiv din tab-ul Dispozitive are o pastilă colorată:

Pastilă	Înțeles	Ce ai de făcut
Online (verde)	AMEF-ul este accesibil și liber.	Nimic — este starea normală.
Ocupat (albastru)	Rulează o comandă pe AMEF chiar acum.	Așteaptă să se termine.
Avertisment (galben)	O încercare de comunicare cu AMEF-ul a eșuat.	Mai așteaptă un ciclu (30 de secunde). De obicei se reia singur.
Eroare (roșu)	AMEF-ul a raportat o problemă (hârtie terminată, sertar deschis, eroare fiscală).	Deschide dispozitivul și urmează instrucțiunile de pe ecran.
Offline (gri)	Trei încercări consecutive au eșuat. Aplicația va încerca să se reconecteze singură.	Dacă nu revine într-un minut, verifică cablul, asocierea Bluetooth sau alimentarea.

Cauze frecvente pentru Avertisment sau Offline:

Bluetooth-ul s-a desincronizat sau telefonul a ieșit din rază.
Cablul USB a fost scos.
O AMEF de rețea a fost oprită sau cablul de rețea a fost deconectat.
S-a terminat rola de hârtie în timpul unei tipăriri.

Potrivește simptomul cu acțiunea

Ce vezi	Ce înseamnă	Ce să faci
Pictogramă cloud-queue chihlimbar	Cloud-ul a căzut pentru scurt timp.	Așteaptă. Continuă să vinzi. De obicei se rezolvă în mai puțin de un minut.
Bulina cu număr persistă peste 2 minute	Bonurile așteaptă să se sincronizeze mai mult decât de obicei.	Verifică conectivitatea telefonului (date mobile pornite, Wi-Fi conectat). Vezi Depanare.
Cloud-ul rămâne deconectat imediat după autentificare	Sesiunea ta a fost respinsă.	Ieși din cont și autentifică-te din nou. Vezi Autentificare în cloud.
Antetul este verde, dar un dispozitiv arată Avertisment apoi Offline	Problemă pe conexiunea cu AMEF-ul, nu cu rețeaua.	Verifică asocierea Bluetooth, cablul și alimentarea AMEF-ului. Vezi Dispozitive.
Pictograma de cloud este chihlimbar și un rând de dispozitiv este roșu	Ambele conexiuni sunt căzute — de obicei telefonul a pierdut rețeaua.	Continuă să tipărești bonuri. Totul se va sincroniza când rețeaua revine.

Următorii pași

Tab-ul Dispozitive — administrează AMEF-urile și citește starea lor.
Operațiuni — ce poți face din aplicație.
Autentificare în cloud — opțională, se face din Setări; și aici recuperezi după o sesiune respinsă.
Depanare — recuperare per simptom.

Instalare pe Android

Instalează aplicația E-BON pe Android, acordă permisiunile de Bluetooth și locație necesare pentru imprimantele fiscale și fă turul de bun venit. Autentificarea în cloud este opțională și se face ulterior din Setări.

Detalii dispozitiv

Inspectați o singură imprimantă fiscală — verificați soldul de numerar, rulați rapoarte X și Z, modificați setările fiscale și consultați istoricul de comenzi al dispozitivului.