Alerte

Alertele de dispozitiv sunt semnalul în timp real al e-bon că un dispozitiv fiscal are nevoie de atenție. Te anunță când o imprimantă a rămas fără hârtie, când un capac este deschis, când un Raport Z este întârziat, când memoria fiscală se umple și când un dispozitiv a căzut offline pentru prea mult timp.

Alertele sunt derivate determinist din starea dispozitivului la fiecare citire. Nu sunt stocate ca înregistrări individuale și nu au un ciclu de viață separat în baza de date — de fiecare dată când Portalul sau API-ul calculează alertele, citește indicatorii de stare curenți ai dispozitivului, ultimul Raport Z reușit, marca de timp a ultimei activități a dispozitivului și starea conexiunii WebSocket active, apoi produce lista de la zero. De îndată ce condiția care a generat alerta dispare (s-a reîncărcat hârtia, s-a închis capacul, s-a trimis Raportul Z, dispozitivul s-a reconectat), alerta pur și simplu nu mai apare la următoarea citire.

Cele șase tipuri de alerte

Există exact șase tipuri de alerte — nici mai multe, nici mai puține. Fiecare are una dintre cele trei severități: warning, error sau info.

Hârtie terminată — paper_out

• Severitate: error
• Declanșator: dispozitivul raportează că hârtia s-a terminat complet.
• Mesaj: Paper is out
• Ce ai de făcut: încarcă o rolă nouă de hârtie pe AMEF — dispozitivul nu poate tipări bonuri până nu o faci.

Hârtie pe terminate — paper_low

• Severitate: warning
• Declanșator: dispozitivul raportează că hârtia este pe sfârșite (senzor de aproape-sfârșit).
• Mesaj: Paper is running low
• Ce ai de făcut: încarcă o rolă nouă de hârtie pe AMEF înainte să se termine în mijlocul unui bon.

Capac deschis — cover_open

• Severitate: error
• Declanșator: dispozitivul raportează că este deschis capacul imprimantei.
• Mesaj: Cover is open
• Ce ai de făcut: închide capacul imprimantei. Dispozitivul nu poate tipări bonuri cât timp capacul este deschis.

Memorie fiscală aproape plină — fiscal_memory_almost_full

• Severitate: warning
• Declanșator: dispozitivul raportează că memoria fiscală este aproape plină.
• Mesaj: Fiscal memory is almost full
• Ce ai de făcut: programează o intervenție tehnică autorizată pentru schimbarea modulului de memorie fiscală înainte ca acesta să se umple complet. Odată plină, AMEF-ul va refuza emiterea de bonuri noi până la intervenția în service.

Raport Z întârziat — z_report_overdue

• Severitate: warning
• Declanșator: au trecut mai mult de 24 de ore de la ultimul Raport Z reușit — sau nu a fost trimis niciodată un Raport Z de pe acest dispozitiv.
• Mesaj: Z report not submitted in over 24 hours
• Ce ai de făcut: trimite un Raport Z pentru dispozitiv — din aplicația e-bon de pe dispozitiv, sau din fluxul de operațiuni fiscale al Portalului.

Dispozitiv offline — disconnected

• Severitate: error
• Declanșator: dispozitivul este offline de mai mult de 1 oră — fără conexiune activă la backend-ul e-bon și fără activitate recentă.
• Mesaj: Device disconnected for over 1 hour
• Ce ai de făcut: verifică alimentarea, rețeaua și controlerul Android de la fața locului care rulează aplicația e-bon. Alerta dispare automat odată ce dispozitivul se reconectează.

Unde vezi alertele în Portal

Cine primește notificări

Alertele care se declanșează pe un dispozitiv generează și notificări pe email către destinatarii configurați pentru organizația ta. Destinatarii se abonează pe categorii (alerte, rapoarte, facturare, evenimente) și primesc doar categoriile la care s-au înscris. Lista de destinatari și abonările pe categorii se gestionează pe pagina dedicată Notificări — acea pagină este sursa unică de adevăr pentru cine primește ce.

API-ul

Accesul programatic la alerte este expus printr-un singur endpoint batch cu domeniul de aplicare la nivel de organizație: GET /api/v1/devices/alerts. Returnează alertele derivate pentru fiecare dispozitiv din organizația apelantă, indexate după id-ul dispozitivului, și acceptă un parametru opțional severity=warning|error|info astfel încât dashboard-urile să poată afișa un singur nivel.

Pentru forma cererii, payload-ul răspunsului, enumerarea severity și lista completă de valori type pentru alerte, vezi API → Dispozitive: Alerte. Pentru încapsularea tipată în SDK a aceluiași endpoint vezi SDK → Dispozitive.

Pași următori

• Dispozitive — lista de dispozitive și pagina de Detaliu dispozitiv unde apar alertele în interfață.
• Notificări — configurează destinatarii de email și abonările pe categorii care alimentează email-urile de alertă.
• API → Dispozitive — suprafața REST mai largă a API-ului de dispozitive.
• SDK → Dispozitive — metodele tipate ale clientului pentru obținerea alertelor și restul API-ului de dispozitive.