e-bon
e-bon.ro
Portal

Notificări

Configurează cine primește emailuri automate de la e-bon — adaugă până la 20 de adrese de abonați și alege dintre cele cinci categorii (Rapoarte, Alerte, Facturare, Evenimente dispozitive, Analiză), cu comutatoare per abonat, în spatele restricției pentru rolurile Proprietar/Administrator.

Notificări

Pagina Setări notificări este locul unde decizi cine din organizație (sau din afara ei — contabili, contractori de operațiuni, inbox-ul on-call) primește emailuri automate de la e-bon și ce categorii de notificări primește fiecare adresă. Este la nivel de organizație: lista se aplică întregii organizații, nu utilizatorului tău individual. Nu există control de mute per utilizator și nu există canale SMS sau web-push — emailul este singurul canal, iar destinatarii se configurează aici.

Deschide Setări notificări

Deschide meniul lateral al Portalului și alege Setări → Notificări. Pagina se află la /portal/settings/notifications și încarcă componenta SettingsNotifications.

Setările de notificări sunt restricționate la rolurile Proprietar și Administrator. Aceeași restricție este impusă pe API: GET /api/v1/org/settings/notifications și PATCH /api/v1/org/settings/notifications necesită Proprietar sau Administrator și returnează 403 Forbidden pentru rolul Operator. Dacă intrarea Setări → Notificări lipsește din meniul lateral, cere proprietarului organizației să îți acorde rolul potrivit.

Alege categoriile de notificări

e-bon grupează fiecare notificare automată pe care o trimite într-una din cinci categorii. Fiecare abonat alege orice subset al acestora — inclusiv toate cinci sau niciuna — și primește doar categoriile la care este abonat.

CategorieCe trimite
RapoarteRezumate rapoarte Z și alerte de întârziere.
AlerteNotificări dispozitiv offline și hârtie puțină.
FacturareGenerare facturi și actualizări privind starea plăților.
Evenimente dispozitiveNotificări schimbare stare dispozitive.
AnalizăRezumat săptămânal al vânzărilor și agregări analitice.

Setul de categorii este fix — nu poți adăuga categorii personalizate din Portal. Pentru push programatic, în timp real, de evenimente (ex. „declanșează un webhook la fiecare receipt.created”) folosește Webhook-uri; webhook-urile și emailurile de notificare sunt independente și pot rula în paralel.

Adaugă un abonat

Tastează o adresă de email

Câmpul Adresă email se află în partea de sus a paginii (placeholder email@companie.ro). Este validat client-side cu un regex standard pentru email: adresele invalide afișează „Adresă de email invalidă.” la submit; o adresă deja existentă pe listă afișează „Acest email este deja adăugat.” Adresa este normalizată în litere mici înainte de a fi stocată.

Apasă Adaugă destinatar

Butonul este dezactivat cât timp câmpul este gol; apăsarea Enter în input are același efect. Noul abonat apare imediat în cardul Abonați notificări de mai jos, abonat la toate cele cinci categorii implicit. Poți adăuga și mai multe adrese una după alta înainte de salvare.

Ajustează categoriile

Fiecare abonat se afișează ca un card cu emailul în partea de sus și o grilă cu cinci checkbox-uri — una per categorie — sub el. Bifează sau debifează pentru a abona/dezabona destinatarul de la acea categorie. Eticheta și descrierea scurtă a fiecărei categorii apar lângă checkbox, ca să nu trebuiască să ții minte ce înseamnă „Alerte” față de „Evenimente dispozitive”.

Un buton ghost mic Toate categoriile în dreapta-jos a fiecărui card comută întregul set on/off dintr-un singur clic — util când vrei ca un destinatar să primească doar Facturare sau doar rezumatul săptămânal de Analiză.

Apasă Salvează modificările

Nimic nu este trimis pe server până nu apeși Salvează modificările la baza cardului. Toast-ul de succes „Setările de notificare au fost actualizate.” confirmă persistarea; eșecurile afișează un banner roșu cu un buton Reîncearcă în partea de sus a cardului.

Lista de abonați este limitată la 20 de intrări server-side. Fiecare abonat trebuie să aibă cel puțin o categorie selectată — salvarea unui abonat fără nicio categorie bifată este respinsă de API cu 400 Validation error. Dacă vrei să dezabonezi complet o adresă, elimin-o în loc să debifezi toate categoriile.

Elimină un abonat

Apasă pe × mic din dreapta-sus a oricărui card de abonat pentru a începe fluxul de eliminare. Se deschide un modal de confirmare cu mesajul „<email> nu va mai primi notificări.” și două butoane:

  • Anulează — închide modal-ul, abonatul rămâne.
  • Elimină — elimină abonatul din lista încărcată în memorie. Atenție: schimbarea nu este încă persistată în acest moment — trebuie să apeși Salvează modificările la baza cardului pentru a confirma eliminarea în API. Dacă închizi pagina fără a salva, fiecare adăugare, editare și eliminare nesalvată este pierdută.

Dacă elimini un abonat din greșeală, apasă butonul Înapoi al browserului sau reîmprospătează înainte de salvare și lista originală este reîncărcată de pe server.

Migrează emailurile Z vechi

Organizațiile mai vechi care preced modelul de abonați foloseau o singură listă zReportEmails — o listă plată de adrese care primeau doar emailurile cu rapoarte Z. Prima dată când deschizi această pagină pe o astfel de organizație, API-ul auto-migrează lista veche: fiecare email devine un abonat cu toate cele cinci categorii active. Migrarea este read-only până la salvare — nimic nu este scris până când nu apeși Salvează modificările, deci poți revizui și reduce adresele auto-abonate înainte.

Continuă cu setările conexe

  • Webhook-uri — push în timp real al evenimentelor (receipt.created, device.offline, report.generated, …) către endpoint-urile tale HTTPS. Folosește webhook-urile pentru integrare mașină-la-mașină; folosește setările de notificare de pe această pagină pentru inbox-uri umane.
  • Organizație — numele companiei, adresa de facturare și locațiile.
  • Profil — contul tău personal, parola, badge-ul de rol.
  • Facturare și planuri — gestionează abonamentul organizației. Emailurile legate de facturare sunt guvernate de categoria Facturare de mai sus.
  • Chei API — credențialele pe care partenerii POS și sistemele externe le folosesc cu API-ul e-bon.