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

Deschide Portalul la e-bon.ro și autentifică-te.
Mergi la Dispozitive și deschide dispozitivul pe care vrei să îl configurezi.
Treci pe tabul Operațiuni din pagina de detaliu a dispozitivului.
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 întreabă AMEF-ul ce câmpuri și limite acceptă pentru un operator (dacă suportă parolă, lungimea maximă a numelui și lungimea maximă a parolei).

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 lungimea maximă a numelui raportată de dispozitiv (implicit: 32 de caractere dacă dispozitivul nu raportează o valoare).
Parolă (opțional) — afișată doar dacă dispozitivul suportă parolă pentru operator. Limitată la lungimea maximă a parolei raportată de dispozitiv (implicit: 8 caractere).

Salvează

Apasă Salvează. Portalul trimite slotul, numele și (opțional) parola operatorului către AMEF și scrie slotul. 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ă lungimi maxime diferite pentru nume și parolă, iar unele nu suportă deloc parolă pentru operator — 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 ID de operator ș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 ID de operator 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

Setarea operatorului 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: SDK-ul expune aceleași două operațiuni — un apel obține capabilitățile de operator pe care le raportează dispozitivul, celălalt scrie un slot cu ID-ul operatorului, numele și parola opțională. Referința completă în SDK → Dispozitive.
Ambele endpoint-uri fac round-trip la AMEF, deci dispozitivul trebuie să fie online când le apelezi.

Panou de control

Pagina pe care aterizezi după autentificarea în Portal - o privire de ansamblu pe un singur ecran a dispozitivelor și bonurilor de astăzi din organizația activă, actualizată live prin WebSocket cu polling de rezervă la 30 de secunde.

Alerte

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