Instalare pe Android
Aplicația E-BON pentru Android este controller-ul local al echipamentului tău fiscal. Rulează pe telefonul sau tableta care stă lângă imprimanta fiscală Bluetooth sau USB, emite toate bonurile și rapoartele acesteia și sincronizează rezultatele cu cloud-ul e-bon în fundal. Tot ce configurezi în Portal — locații, dispozitive, chei API — apare în aplicație după ce te conectezi, deci nu ai nimic de cablat manual.
Verifică ce îți trebuie
Înainte de instalare, asigură-te că ai:
- Android 7.0 Nougat sau mai nou (SDK minim 24, compilat pentru Android 14 / SDK 36). Aplicația merge la fel pe telefoane și pe tablete.
- Bluetooth activ pe dispozitiv, dacă plănuiești să asociezi o imprimantă fiscală Bluetooth. Imprimantele USB funcționează prin portul USB-C sau USB-OTG al telefonului, fără să ceară radio.
- Conexiune la internet — Wi-Fi sau date mobile. Bonurile sunt stocate local când ești offline și se trimit în cloud imediat ce revine legătura, dar pentru prima conectare ai nevoie de o rețea activă.
- Un cont de Portal cu cel puțin o locație deja creată. Dacă nu ai făcut încă acest pas, începe cu ghidul de primii pași și cu pagina de Locații — aplicația nu te lasă să treci de ecranul de conectare până când contul nu are măcar o locație.
Instalează aplicația
Descarcă aplicația pe Android
Deschide aplicația și conectează-te
Pornește E-BON din meniul de aplicații. Primul ecran este cel de conectare — introdu același email și aceeași parolă pe care le folosești pe app.e-bon.ro. Nu există un cont separat pentru aplicație, nu ai o a doua parolă de ținut minte: aplicația și Portalul folosesc o singură identitate.
Alege o locație
Imediat după conectare, ecranul Selectare locație afișează toate locațiile din contul tău. Apasă pe cea care va fi deservită de acest dispozitiv — de exemplu București — Unirii. Alegerea rămâne memorată între porniri, iar fiecare bon emis de pe acest dispozitiv poartă numele acestei locații. O poți schimba oricând din tab-ul Setări.
Acordă permisiunile
Android 12 și versiunile mai noi împart Bluetooth-ul în mai multe permisiuni acordate la runtime, iar sistemul îți cere acordul prima dată când aplicația are efectiv nevoie de ele — de regulă la prima deschidere a tab-ului Dispozitive. Iată exact la ce folosește fiecare și de ce contează.
Permite scanarea și conectarea Bluetooth
Aplicația cere BLUETOOTH_SCAN și BLUETOOTH_CONNECT ca să poată descoperi imprimantele fiscale Bluetooth din apropiere și să stabilească o conexiune împerecheată cu cea pe care o alegi. Fără aceste permisiuni, tab-ul Dispozitive nu vede niciun echipament Bluetooth. Pe Android 11 și versiunile anterioare, permisiunile mai vechi BLUETOOTH și BLUETOOTH_ADMIN sunt acordate automat la instalare și fac același lucru.
Permite accesul la locație pentru scanarea Bluetooth
Aplicația cere ACCESS_FINE_LOCATION și ACCESS_COARSE_LOCATION pentru că Android-ul însuși impune o permisiune de locație pentru a returna rezultate la scanarea Bluetooth pe Android 10 și versiunile mai vechi, precum și pentru scanările Bluetooth LE pe unele dispozitive Android 12+ care nu suportă flag-ul neverForLocation. Este o cerință a platformei, nu o funcție a aplicației.
Sincronizează-te cu cloud-ul prin rețea
INTERNET este acordată automat la instalare și este folosită pentru a sincroniza bonurile, rapoartele X și Z, starea dispozitivului și comenzile de la distanță cu cloud-ul e-bon. Este conexiunea care face posibilă vizualizarea în timp real din Portal: când emiți un bon în aplicație, acesta apare în Portal în câteva secunde.
Conectează USB fără permisiune la runtime
Pentru imprimantele fiscale conectate prin USB nu este nevoie să acorzi nicio permisiune la runtime. Conectivitatea USB folosește API-ul host USB integrat în Android; nu este necesară o permisiune runtime specială pe Android 6 sau mai nou. Când conectezi o imprimantă USB, Android-ul afișează un dialog o singură dată și te întreabă dacă permiți aplicației E-BON să acceseze acel dispozitiv anume. Bifează Permite mereu și dialogul nu mai apare pentru acea imprimantă.
Fă turul la prima pornire
După conectare și alegerea locației, aplicația se deschide pe tab-ul Acasă. În partea de jos a ecranului sunt patru tab-uri — aici vei petrece restul timpului.
- Acasă — un panou rapid de stare pentru locația selectată. Vezi imprimanta curentă asociată, ultimul bon emis, elementele în așteptare la sincronizare și scurtături către acțiunile cele mai folosite (emite un bon, rulează un raport X, deschide Dispozitive).
- Dispozitive — asociază, deconectează și administrează imprimantele fiscale ale acestei locații. Toate scanările Bluetooth, toate prompt-urile de permisiune USB și toate verificările de stare ale imprimantei sunt aici.
- Bonuri — emite bonuri noi și retipărește-le pe cele recente. Fiecare bon este atașat locației curente și, după sincronizare, devine vizibil pe pagina de Bonuri din Portal.
- Setări — detalii de cont (emailul cu care ești conectat, locația activă, deconectare), preferințe de aplicație, jurnale de diagnosticare și scurtătura Schimbă locația, dacă dispozitivul trebuie să se mute.
Depanează și continuă
Dacă autentificarea eșuează, lista de locații e goală sau nu-ți apare niciun dialog de permisiune, deschide ghidul de depanare — acoperă cazurile uzuale din categoria „am instalat aplicația, dar…" (parolă greșită de Portal, nicio locație creată încă, Bluetooth oprit la nivel de sistem, servicii de locație dezactivate) și cum le rezolvi pe fiecare în mai puțin de un minut.
Organizație
Gestionează organizația e-bon din Portal — nume companie, CUI/CIF, adresă de facturare și locații. Restricționat la rolurile Proprietar și Administrator.
Lucrul offline și starea conexiunii
Continuă să emiți bonuri când rețeaua cade. Ce înseamnă pastila portocalie „Reconectare…", cum citești starea dispozitivului și ce faci când ceva devine roșu.