e-bon
e-bon.ro
Aplicația E-BON

Operațiuni zilnice

Emite bonuri, retipărește duplicate, rulează rapoarte X și Z, gestionează depunerile și ridicările de numerar și închide ziua fiscală din aplicația E-BON pentru Android — fiecare acțiune este conectată la tab-ul Operațiuni din ecranul de detaliu al dispozitivului.

După ce o imprimantă este asociată și aplicația este conectată cu contul de Portal, toate acțiunile zilnice ale casierului trec prin două ecrane: tab-ul Bonuri (emiterea bonurilor noi de vânzare și consultarea istoricului) și tab-ul Detaliu dispozitiv → Operațiuni (comenzi fiscale punctuale, cum ar fi duplicate, rapoarte X/Z, depuneri/ridicări de numerar). Pagina aceasta le parcurge pe ambele, în ordinea în care le folosește un schimb obișnuit.

Emite un bon

Deschide tab-ul Bonuri și apasă + Creează Bon (FAB-ul din colțul dreapta-jos; același buton de acțiune apare și în starea goală pe o instalare nouă). Aplicația deschide ecranul Bon nou cu două secțiuni suprapuse — Adaugă articol și, după ce a fost adăugat cel puțin un articol, Plată.

Adaugă articolele

Pentru fiecare articol vândut, completează formularul din partea de sus a ecranului:

  • Denumire articol — text liber, obligatoriu.
  • Cantitate — numerică, valoare implicită 1.
  • Preț — preț unitar în RON, trebuie să fie strict mai mare decât zero.
  • Cotă TVA — alege unul dintre chip-uri. Acestea reflectă cotele TVA din România (ROMANIA_VAT_RATES) configurate în @e-bon/types; selecția implicită este cota standard.
  • Departament — chip-uri numerotate 19, valoare implicită 1.

Apasă Adaugă Articol. Linia coboară în lista Articole de dedesubt cu badge-urile TVA {rate}% și Dept {dept}, iar Total-ul curent din partea de jos se actualizează imediat.

Alege metoda de plată și suma

Când există cel puțin un articol pe bon, secțiunea Plată apare dedesubt. Alege un chip de MetodăNumerar, Card sau Voucher — și fie introdu suma plătită de client, fie lasă câmpul gol pentru a folosi totalul curent. Aplicația respinge sumele strict sub total cu o alertă Plată Insuficientă care indică minimul necesar.

Previzualizează și tipărește

Apasă Previzualizare & Tipărire. Aplicația salvează ciorna în ReceiptStore, navighează la ecranul Previzualizare bon cu sumarul articolelor, defalcarea TVA și detaliile de plată, și activează butonul Tipărește bonul. La apăsare, comanda este trimisă către primul dispozitiv asociat pentru locația activă (conform useFilteredDevices) prin FiscalPrinterService.printReceipt() — AMEF-ul tipărește bonul fiscal, bonul este actualizat cu ID-ul fiscal și data fiscală returnate de imprimantă, iar înregistrarea apare în istoricul Bonuri cu o linie verde Fiscal: … sub total.

Chip-urile Cotă TVA și numerele de Departament provin din configurația fiscală a imprimantei. Dacă trebuie să modifici cotele TVA programate în AMEF sau corespondența dintre departamente și familii de produse, fă-o din secțiunea Configurare Fiscală a detaliului de dispozitiv (tab-ul Operațiuni → Setare Cote TVA), nu din ecranul Bon nou.

Imprimă un bon duplicat

Uneori clientul are nevoie de a doua copie a unui bon care tocmai a fost tipărit. Deschide dispozitivul în tab-ul Dispozitive, treci pe Operațiuni, extinde secțiunea Bonuri și apasă Imprimare Bon Duplicat. Aplicația apelează fiscalDriverBridge.printReceipt() către AMEF-ul conectat, care retipărește ultimul bon păstrat în memoria de lucru a imprimantei și suprapune bannerul DUPLICAT prevăzut de protocol — ID-ul fiscal original este păstrat, niciun contor fiscal nou nu este consumat.

Imprimare Bon Duplicat retipărește ce consideră imprimanta a fi ultimul bon. Dacă trebuie să retipărești un bon mai vechi după ID-ul fiscal, aceasta nu este o operațiune din aplicație în aceeași zi — adu-l din arhiva de bonuri din pagina Portal → Bonuri, care oferă căutare completă și re-export PDF per bon.

Anulează, returnează sau stornează un bon

Reglementările fiscale românești fac distincție între două corecții:

  • Storno — anularea unei linii înainte ca bonul să fie închis. Are sens doar în interiorul unui bon deschis; după ce AMEF-ul a fiscalizat bonul, calea de storno nu mai este disponibilă pentru documentul respectiv.
  • Retur (RETUR) — un document fiscal separat care anulează un bon deja închis, parțial sau integral.

În build-ul curent al aplicației, tab-ul Bonuri doar afișează intrările de tip VÂNZARE, RETUR și STORNO în istoricul de bonuri (fiecare etichetată cu un badge colorat — verde pentru vânzare, galben pentru retur, roșu pentru storno), iar fluxul Bon nou emite doar bonuri de vânzare. Emiterea documentelor de retur și storno se face din Portal, nu din aplicația de control.

Pentru a emite un storno sau un retur împotriva unui bon tipărit anterior:

Găsește bonul în portal

Deschide Portal → Bonuri, caută după ID fiscal, interval de date, client sau sumă, și deschide detaliul bonului.

Declanșează corecția corespunzătoare

Portalul expune fluxurile de storno și retur care, în final, comandă imprimanta prin același fiscalDriverBridge. După ce corecția este fiscalizată, intrarea RETUR sau STORNO rezultată apare în tab-ul Bonuri al aplicației de control la următoarea sincronizare, cu badge-ul colorat corespunzător.

Nu trata Imprimare Bon Duplicat drept instrument de corecție. Un duplicat este o retipărire nefiscală a ultimului bon — nu anulează o vânzare, nu consumă un nou contor fiscal și nu apare în exportul MF/JE drept corecție. Pentru aceasta este nevoie de un retur sau storno real, emis din portal.

Rulează un raport X — instantaneu fără resetare

Raportul X este un instantaneu fără resetare al totalurilor fiscale acumulate de la ultimul Z. Casierii îl rulează de obicei la mijlocul schimbului pentru a compara totalurile din imprimantă cu sertarul de numerar sau cu batch-ul zilnic al terminalului de card.

Deschide dispozitivul, mergi în Operațiuni → Rapoarte și apasă Raport X. Aplicația apelează fiscalDriverBridge.xReport(), imprimanta tipărește instantaneul, iar operațiunea este înregistrată prin logOperation('xReport', true) în jurnalul local de audit al dispozitivului. Raportul X nu resetează niciun contor — îl poți rula de câte ori vrei pe parcursul schimbului.

Rulează raportul Z pentru a închide ziua fiscală

Raportul Z este închiderea fiscală a zilei. Rularea lui tipărește totalurile fiscale ale zilei și le mută din bufferul de lucru volatil în memoria fiscală a AMEF-ului, unde formează intrarea următoare a arhivei MF/JE. După ce Z a rulat, ziua este închisă, iar totalurile curente se resetează la zero — nu există revenire.

Deschide Rapoarte și apasă Raport Z

Operațiuni → secțiunea RapoarteRaport Z.

Confirmă acțiunea distructivă

Aplicația afișează o alertă de confirmare cu textul: „Aceasta va închide ziua fiscală. Această acțiune nu poate fi anulată. Ești sigur?” (textul deviceDetail.ops.zReportWarning din i18n/ro.json). Butonul Confirmă este stilizat ca destructive pentru a sublinia că este o operațiune fără cale de întoarcere. Apasă Anulează dacă ai deschis acțiunea din greșeală.

Lasă imprimanta să fiscalizeze închiderea

La confirmare, aplicația apelează fiscalDriverBridge.zReport(), imprimanta emite documentul Z, iar totalurile zilei sunt înregistrate în memoria fiscală. Jurnalul local de audit înregistrează zReport cu success: true; același raport Z este cel pe care îl va prelua următorul Portal → Rapoarte → export MF/JE.

Rulează Z exact o singură dată, la finalul schimbului. Rularea Z la mijlocul schimbului șterge contoarele curente deși ziua nu s-a încheiat — fiecare vânzare ulterioară se va acumula într-o nouă zi fiscală (scurtă), ceea ce complică reconcilierea cu sertarul de numerar și cu batch-ul zilnic al terminalului de card.

Depune și ridică numerar

Secțiunea Gestiune Numerar din tab-ul Operațiuni al dispozitivului permite casierului să înregistreze direct în AMEF mișcările de numerar care nu sunt vânzări — fondul de casă de la începutul schimbului (depunere de numerar, cashIn) și orice plăți efectuate în timpul schimbului (ridicare de numerar, cashOut). Suma este reflectată în contorul de numerar al imprimantei, astfel încât rapoartele X și Z să poată reconcilia sertarul.

Deschide secțiunea și alege direcția

Operațiuni → Gestiune Numerar → fie Depunere Numerar, fie Ridicare Numerar.

Introdu suma

Se deschide un modal care cere Suma în RON. Câmpul este numeric și respinge valorile goale, zero și negative; textul de ajutor este „Introduceți suma”.

Confirmă

Apasă Confirmă. Aplicația apelează fiscalDriverBridge.cashIn(amount) pentru o depunere, cashOut(amount) pentru o ridicare, tipărește bonul nefiscal corespunzător pe AMEF și raportează Operațiune finalizată cu succes. Anulează închide modalul fără a înregistra nimic.

Înregistrează fondul de casă drept prima depunere de numerar a schimbului, înainte de prima vânzare. Astfel, raportul X rulat la mijlocul schimbului și raportul Z de la final includ fondul și se reconciliază curat cu numerarul efectiv din sertar.

Închide ziua pas cu pas

Cele patru operațiuni de mai sus se combină într-o rutină scurtă și repetabilă de închidere. Rulează-le în ordinea de mai jos:

Asigură-te că fiecare vânzare a zilei a fost fiscalizată

Deschide tab-ul Bonuri și verifică să nu rămână ciorne în Bon nou — orice se află încă în formularul de ciornă nu este în memoria fiscală a imprimantei și nu va apărea pe raportul Z. Fie completează bonul și apasă Previzualizare & Tipărire, fie Anulează ciorna dacă nu trebuie emisă.

Tratează stornourile și returnările

Dacă vreo vânzare a zilei trebuie anulată, emite stornoul sau returul acum — înainte de Z. Folosește fluxul din Portal → Bonuri. După ce Z a rulat, orice stornare va ajunge în ziua fiscală de mâine.

Reconciliază sertarul de numerar

Numără numerarul din sertar. Dacă ai scos numerar pentru o plată în timpul zilei și nu ai înregistrat-o prin Ridicare Numerar, fă-o acum. Invers, dacă ai adăugat numerar în sertar la mijlocul schimbului în afara fondului inițial, înregistrează o Depunere Numerar. Sertarul trebuie să corespundă contorului de numerar al imprimantei după ce ai terminat.

Rulează un raport X și verifică totalurile

Operațiuni → Rapoarte → Raport X. Compară totalurile tipărite ale raportului X cu numărul de numerar din sertar, batch-ul zilnic al terminalului de card și eventualele bonuri voucher. Dacă ceva nu se potrivește, corectează (storno suplimentar, mișcare suplimentară de numerar) înainte de a trece la Z — raportul X este fără resetare și îl poți rula de câte ori este nevoie.

Rulează raportul Z pentru a închide fiscal ziua

Când totul se reconciliază, Operațiuni → Rapoarte → Raport Z, apoi Confirmă pe alerta distructivă. Imprimanta emite documentul Z, totalurile zilei sunt scrise în memoria fiscală a AMEF-ului, iar contoarele curente se resetează la zero. Ziua este oficial închisă.

După Z, datele fiscale ale zilei sunt sigilate în AMEF și sunt cele pe care le va prelua următorul export MF/JE lunar din Portal → Rapoarte. Dacă ceva din rutina de închidere nu se comportă corect — Bluetooth-ul pierde imprimanta în mijlocul tipăririi, confirmarea Z apăsată din greșeală, contorul de numerar nu corespunde sertarului — ghidul de Depanare listează căile de recuperare.