Alerte pentru dispozitive
Înțelege alertele dispozitivului
Alertele pentru dispozitive te anunță când unul dintre AMEF-urile tale are nevoie de atenție. Acoperă situațiile de zi cu zi pe care orice restaurant sau magazin le întâlnește: imprimanta a rămas fără hârtie, capacul a rămas deschis, dispozitivul a căzut offline sau raportul Z al zilei nu a fost încă depus.
Alertele sunt evaluate live de fiecare dată când Portalul sau integrarea ta le cere. Imediat ce rezolvi problema — reîncarci hârtia, închizi capacul, reconectezi dispozitivul, depui raportul Z — alerta dispare la următoarea reîmprospătare. Nu trebuie să confirmi sau să închizi nimic manual.
Recunoaște cele cinci tipuri de alertă
Vezi alertele în Portal
Deschide Portalul pentru a vedea alertele în trei locuri:
Insigna cu clopoțel din bara de sus
Pictograma cu clopoțel arată numărul de alerte active pentru toate dispozitivele organizației tale. Apasă pe ea pentru a deschide lista de alerte.
Pagina Dispozitive
Fiecare rând din lista Dispozitive afișează un jeton de alertă lângă orice dispozitiv care are nevoie de atenție. Culoarea jetonului corespunde severității — galben pentru avertismente, roșu pentru erori.
Pagina de detalii a dispozitivului
Deschide un dispozitiv pentru a vedea lista completă a alertelor sale curente, fiecare cu un mesaj scurt care o explică.
Portalul reîmprospătează alertele automat. Nu este nimic de confirmat — odată ce rezolvi problema pe dispozitiv, alerta dispare la următoarea reîmprospătare.
Citește alertele din API
Dacă îți construiești propriul panou de control sau o integrare de monitorizare, e-bon expune alertele prin HTTP.
Obține alertele unui singur dispozitiv
GET /api/v1/devices/{deviceId}/alerts
Returnează lista alertelor active pentru un singur dispozitiv.
Obține alertele întregii organizații
GET /api/v1/devices/alerts
Returnează alertele active grupate după ID-ul dispozitivului. Acesta este apelul potrivit pentru propriul tău contor de alerte sau panou de stare.
Ambele endpoint-uri acceptă un filtru opțional ?severity=warning sau ?severity=error și necesită un token API cu scope-ul devices:read. Vezi API — Dispozitive pentru detalii complete despre cereri și răspunsuri.
Inspectează câmpurile fiecărei alerte
| Câmp | Descriere |
|---|---|
type | Tipul alertei — paper_low, cover_open, fiscal_memory_almost_full, z_report_overdue sau disconnected. |
severity | warning sau error. |
message | O descriere scurtă, lizibilă. |
deviceId | Dispozitivul căruia îi aparține alerta. |
deviceName | Numele afișat al dispozitivului. |
detectedAt | Marca de timp la care această citire a observat condiția. |
detectedAt diferite — marca de timp reflectă momentul în care API-ul a verificat, nu momentul în care a apărut problema. Dacă agregi alertele, deduplică-le după perechea (deviceId, type).Primește notificări în timp real
Dacă interogarea periodică nu este suficient de rapidă pentru cazul tău, abonează-te la WebSocket-ul de evenimente și ascultă topic-ul device.alert. Integrarea ta primește o notificare imediat ce este detectată o alertă nouă, cu aceeași formă de date ca endpoint-ul REST.
WebSocket-ul de evenimente folosește același token API și scope (devices:read) ca endpoint-urile REST.
Continuă explorarea
- Alerte (Portal) — ghid complet pentru interfața de alerte din Portal.
- API — Dispozitive — contractele HTTP pentru endpoint-urile dispozitivelor.
- Erori — erorile fiscale (respingeri ANAF, eșecuri la nivel de driver) apar ca eșecuri de comenzi, nu ca alerte de dispozitiv.
Prezentare arhitectură
Cum conectează e-bon casa de marcat la imprimanta fiscală, la cloud și la ANAF — pe scurt.
Validarea conținutului comenzilor
Regulile de validare aplicate de e-bon fiecărei comenzi înainte de a ajunge la AMEF — cote de TVA, tipuri de plată, motive de stornare, echilibrul articole-vs-plăți și răspunsul de eroare primit când o comandă este respinsă.