e-bon
e-bon.ro
Portal

Operatori

Adaugă și gestionează operatorii (casieri, ospătari, responsabili de magazin) pe un dispozitiv fiscal din Portal — fluxul Setare Operator din tabul Operațiuni al paginii dispozitivului, cu capabilitățile interogate live de la AMEF.

Operatori

Operatorii sunt oamenii care emit bonuri pe un dispozitiv fiscal — în mod tipic casieri, ospătari și responsabili de magazin. AMEF-ul reține care operator este „autentificat” curent și marchează fiecare bon emis cu slotul acelui operator, astfel încât totalurile zilnice, rapoartele X / Z și istoricul bonurilor să fie atribuite corect.

Portalul expune un singur flux dedicat pentru asta: Detaliu dispozitiv → Operațiuni → Setare Operator. Nu există o pagină separată „Operatori” — operatorii trăiesc pe dispozitivul însuși, nu în baza de date a Portalului, așa că tot ce faci aici este o cerere live către AMEF.

Operatorii sunt înregistrați pe dispozitiv, nu pe locație și nici în organizația ta din e-bon. Fiecare AMEF își ține propriile sloturi de operator, independent. Dacă aceeași persoană lucrează pe două dispozitive, o configurezi pe fiecare dispozitiv în parte, cu același nume și același ID.

Găsește fluxul Setare Operator

  1. Deschide Portalul la https://app.e-bon.ro și autentifică-te.
  2. Mergi la Dispozitive și deschide dispozitivul pe care vrei să îl configurezi.
  3. Treci pe tabul Operațiuni din pagina de detaliu a dispozitivului.
  4. Apasă Setare Operator (iconiță: i-lucide-user).

Butonul este dezactivat când dispozitivul este offline — Portalul are nevoie de o conexiune live cu AMEF-ul ca să-i interogheze capabilitățile și să scrie slotul de operator.

Adaugă sau actualizează un operator

Deschide dispozitivul

Din Dispozitive, apasă pe rândul AMEF-ului pe care vrei să-l configurezi. Se deschide pagina de detaliu a dispozitivului.

Treci pe tabul Operațiuni

Tabul Operațiuni grupează acțiunile de control live ale dispozitivului (sincronizare ceas, cote TVA, antet / subsol, Setare Operator). Toate au nevoie ca dispozitivul să fie online.

Apasă Setare Operator

Se deschide modalul „Setare Nume și Parolă Operator”. În timp ce se încarcă, vei vedea „Se încarcă capabilitățile operatorului...” — Portalul apelează GET /api/v1/devices/:deviceId/operator-capabilities, care trimite comanda GetOperatorCapabilities către AMEF și așteaptă răspunsul cu { supportsPassword, maxNameLength, maxPasswordLength, ... }.

Completează formularul

Trei câmpuri, în această ordine:

  • ID Operator — număr întreg, minim 1. Acesta este slotul de pe AMEF pe care îl va ocupa operatorul. Fiecare AMEF are un număr fix de sloturi; setarea unui ID existent suprascrie slotul respectiv.
  • Nume Operator — text liber, limitat la maxNameLength din capabilitățile dispozitivului (implicit: 32 de caractere dacă dispozitivul nu raportează o valoare).
  • Parolă (opțional) — afișată doar dacă dispozitivul raportează supportsPassword: true. Limitată la maxPasswordLength (implicit: 8 caractere).

Salvează

Apasă Salvează. Portalul apelează POST /api/v1/devices/:deviceId/operator cu { operatorId, name, password? } și trimite SetOperator către AMEF. La succes, un toast afișează „Setările operatorului au fost salvate cu succes” și modalul se închide.

Limitele câmpurilor și vizibilitatea câmpului Parolă vin de la AMEF, nu de la e-bon. Modele diferite de AMEF raportează valori diferite pentru maxNameLength, maxPasswordLength și supportsPassword — de aceea modalul se deschide cu starea „Se încarcă capabilitățile operatorului...” și interoghează dispozitivul de fiecare dată.

Vezi cine a emis fiecare bon

Fiecare bon emis de AMEF este marcat cu ID-ul operatorului activ, iar acest ID este păstrat în arhiva bonului în Portal, alături de restul datelor fiscale.

Îl poți vedea în Portal pe pagina Bonuri: deschide orice bon ca să vezi panoul de detaliu — câmpul Operator afișează ID-ul operatorului care l-a emis. Lista de bonuri în sine nu permite filtrare după operator în acest moment; poți consulta valoarea operatorului pe fiecare bon din panoul de detaliu, sau o poți extrage programatic prin API.

Bonurile anterioare păstrează operatorul care era activ la momentul emiterii. Suprascrierea ulterioară a unui slot de operator nu schimbă retroactiv operatorul de pe bonurile deja emise — atribuirea istorică rămâne în arhiva fiscală pentru totdeauna.

Înlocuiește sau scoate un operator

Fluxul Setare Operator este singura cale de scriere. Pentru a roti operatorii, ai două opțiuni:

  • Refolosește același slot. Deschide Setare Operator, introdu același operatorId și suprascrie numele (și parola, dacă este suportată). Noul operator preia imediat acel slot. Bonurile vechi emise sub numele anterior rămân neschimbate.
  • Mută-te pe un slot nou. Deschide Setare Operator, introdu un operatorId nou care nu este folosit. Noul operator primește propriul slot; slotul vechi rămâne așa cum era pe dispozitiv până când îl suprascrii.

Nu există o acțiune „șterge operator” în Portal — sloturile de operatori sunt gestionate de dispozitiv. Tratează tabela de sloturi a AMEF-ului ca sursă de adevăr.

Gestionează dispozitive în mai multe locații

setOperator este per dispozitiv. Nu există o funcție „atribuie acest operator unei locații și propagă-l pe toate dispozitivele din locație” — dacă aceeași persoană lucrează pe trei dispozitive, faci Setare Operator de trei ori, o dată pe fiecare dispozitiv.

Dispozitivele sunt grupate pe locații în organizația ta (vezi Locații și Dispozitive). Această grupare organizează dispozitivele în interfața Portalului, dar sloturile de operator rămân un concept local fiecărui dispozitiv.

Gestionează operatorii programatic

Aceleași două endpoint-uri sunt expuse prin API-ul public și prin SDK, așa că poți scripta înrolarea (de exemplu, să provizionezi același set de operatori pe fiecare dispozitiv dintr-un lanț) în loc să faci click în Portal pentru fiecare dispozitiv.

  • REST: GET /api/v1/devices/:deviceId/operator-capabilities (scope: DevicesRead) și POST /api/v1/devices/:deviceId/operator (scope: DevicesWrite, body { operatorId, name, password? }). Referința completă în API → Dispozitive.
  • SDK: client.devices.getOperatorCapabilities(id) returnează { capabilities, deviceId, timestamp }; client.devices.setOperator(id, body) scrie slotul. Referința completă în SDK → Dispozitive.
  • Ambele endpoint-uri fac round-trip la AMEF, deci dispozitivul trebuie să fie online când le apelezi.

Înregistrare & Autentificare

Creează contul e-bon, autentifică-te în Portal și resetează o parolă uitată la app.e-bon.ro.

Alerte

Alerte de dispozitiv în timp real în Portalul e-bon — cele cinci tipuri de alerte, cum se derivă fiecare, unde apar în interfață și cum le citești programatic prin API.