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

Asocierea imprimantei fiscale

Asociază o casă de marcat (AMEF) cu aplicația E-BON pentru Android prin Bluetooth, USB, serial sau TCP, înțelege cum detectează aplicația protocolul automat și folosește Conectarea manuală atunci când detectarea nu reușește.

După ce aplicația a fost instalată și te-ai conectat cu contul de Portal, tab-ul Dispozitive este locul unde prezinți fiecare imprimantă fiscală (AMEF) aplicației E-BON. Pagina aceasta parcurge cele patru transporturi suportate — Bluetooth, USB, Serial, TCP —, explică modul în care aplicația detectează automat protocolul vorbit de imprimantă și îți arată ce să faci atunci când detectarea automată nu poate identifica modelul.

Punctul de plecare pentru toate fluxurile de pe pagină este ecranul Descoperire dispozitive. Deschide tab-ul Dispozitive și apasă Adaugă dispozitiv — ajungi pe ecranul cu cele trei carduri de acțiune descris mai jos.

Asociază prin Bluetooth

Bluetooth este transportul cel mai folosit pentru AMEF-urile de tejghea și cele mobile. Aplicația E-BON nu rulează un flux propriu de împerechere Bluetooth: se bazează pe UI-ul de pairing al sistemului Android, iar apoi preia imprimanta ca dispozitiv deja împerecheat. În felul acesta introducerea PIN-ului, confirmarea cheii de acces și negocierea criptării rămân în sarcina sistemului de operare, acolo unde le e locul.

Împerechează imprimanta din setările Bluetooth ale Android-ului

Pune imprimanta în modul de împerechere (consultă manualul aparatului — la majoritatea modelelor Datecs și Tremol ții apăsat un buton de pe panoul frontal până sună sonerizorul). Pe dispozitivul Android deschide Setări → Dispozitive conectate → Împerechează dispozitiv nou, atinge imprimanta când apare și confirmă cheia. Când sistemul raportează dispozitivul ca Împerecheat, pasul acesta s-a încheiat.

Deschide Descoperire dispozitive în aplicație

În aplicație atinge Dispozitive → Adaugă dispozitiv. Pe ecranul Descoperire dispozitive atinge Scanare Bluetooth. Aplicația enumeră dispozitivele Bluetooth deja împerecheate, pornește și o scanare scurtă BLE, iar rezultatele apar în lista de sub carduri.

Alege imprimanta și confirmă pe ecranul de asociere

Atinge intrarea imprimantei. Aplicația deschide ecranul Asociere dispozitiv, precompletând numele și protocolul sugerat (dacă a putut să îl deducă din numele Bluetooth sau din UUID-urile de serviciu). Ajustează numele afișat, pune o etichetă de locație dacă folosești așa ceva, verifică chipul de protocol și apasă Asociază dispozitivul. Dispozitivul este salvat local și înregistrat în cloud într-un singur pas.

Dacă scanarea Bluetooth nu returnează nimic, vinovatul tipic este prompt-ul Android pentru Dispozitive din apropiere (scanare + conectare Bluetooth) sau pentru Locație — vezi secțiunea de permisiuni din Instalare pe Android pentru motivul pentru care Android cere permisiunea de locație la scanările Bluetooth pe Android 10 și pe anumite dispozitive Android 12+.

Conectează prin USB

AMEF-urile certificate ANAF nu expun, de regulă, o interfață fiscală nativă USB-HID pentru Android — ele apar drept dispozitive seriale printr-o punte USB-to-Serial (CDC-ACM pentru imprimantele cu UART integrat sau un adaptor extern FTDI / CH340 / CP210x între portul RS-232 al imprimantei și portul USB-C al telefonului). Tocmai de aceea AndroidManifest.xml al aplicației nu declară permisiunile USB_HOST sau usb-feature, iar matricea dispozitivelor suportate tratează USB-ul ca fiind accesat prin intrarea Serial din registrul de protocoale.

În practică:

Conectează adaptorul la dispozitivul Android

Conectează puntea USB-to-Serial (sau cablul imprimantei, dacă aceasta se prezintă drept CDC-ACM) la telefon sau la tabletă. Android afișează dialogul familiar de permisiune USB per-dispozitiv — fereastra care apare o singură dată și întreabă dacă permiți aplicației E-BON să acceseze acel dispozitiv USB anume. Apasă OK și bifează Deschide automat E-BON când acest dispozitiv USB este conectat dacă vrei să sari peste dialog data viitoare.

Folosește Conectare manuală pentru a înregistra endpoint-ul serial

Pentru că adaptorul este adresat ca Serial, deschide Dispozitive → Adaugă dispozitiv → Conectare manuală. Alege protocolul imprimantei, lasă transportul pe Serial și introdu identificatorul raportat de Android pentru adaptor (de regulă /dev/ttyUSB0 sau numele nodului CDC-ACM). Rata implicită este 115200 baud; coboar-o la 9600 pentru Incotex și pentru adaptorul generic Custom.

Conectează prin Serial (RS-232)

Transportul serial acoperă un cablu RS-232 direct (inclusiv cazul USB-to-Serial descris mai sus) între imprimantă și gazda Android. Nu există un pas de descoperire — imprimanta nu emite niciun beacon scanabil —, așa că serialul trece întotdeauna prin Conectare manuală.

Deschide Conectare manuală

Apasă Dispozitive → Adaugă dispozitiv → Conectare manuală pentru a deschide formularul de configurare manuală.

Alege protocolul și transportul

Alege protocolul care corespunde imprimantei (Datecs Extended / Compact / Professional, Tremol / Tremol V2, Daisy / Daisy RO, Eltrade, Incotex, MF/JE pentru Shtrih sau Custom pentru orice model nelistat). Pune Transport pe Serial.

Completează adresa și rata baud

Introdu identificatorul portului serial (de exemplu /dev/ttyS0 sau /dev/ttyUSB0) în câmpul Adresă. Rata implicită este 115200 baud, valoarea din registrul de protocoale pentru familiile ISL și ZFP. Coboar-o la 9600 pentru Incotex și pentru alternativa Custom — ambele au în registru rata implicită de 9600 baud.

Conectează prin TCP

TCP-ul este transportul pentru imprimantele conectate în LAN care expun un serviciu fiscal de rețea, dar și pentru imprimantele accesate printr-o punte Wi-Fi-to-Serial aflată în același subnet. Le poți adăuga fie rulând o scanare Scanare rețea din ecranul de descoperire — care sondează porturile implicite din registru pe subnet-ul local —, fie introducând adresa IP și portul manual, în Conectare manuală.

Pune imprimanta în rețea

Asigură-te că imprimanta (sau puntea din fața ei) este accesibilă din subnet-ul dispozitivului Android. Notează adresa IP — aproape întotdeauna apare pe bonul de stare al imprimantei sau în meniul de administrare.

Alege portul pentru familia de protocol

Portul TCP implicit depinde de familie:

  • 9100 — Datecs Extended / Compact / Professional, Daisy, Daisy RO, Eltrade, Incotex, MF/JE. Toate intrările din familia ISL și intrarea Shtrih împart acest port.
  • 4999 — Tremol și Tremol V2. Este portul distinctiv al familiei ZFP.
  • 8000 — alternativa generică Custom (Serial/TCP), verificată ultima.

Înregistrează dispozitivul

Fie pornești Scanare rețea de pe ecranul de descoperire și atingi rezultatul care apare (scanarea sondează porturile de mai sus pe subnet-ul local și consolidează rezultatele după gazdă), fie treci prin Conectare manuală, pui Transport pe TCP și completezi direct câmpurile Gazdă și Port.

Înțelege cum funcționează detectarea automată

Când atingi Scanare rețea sau Scanare Bluetooth, aplicația nu știe încă ce protocol vorbește dispozitivul descoperit. Parcurge o listă internă de protocoale candidat într-o ordine fixă și le încearcă unul după altul, până când unul dintre ele acceptă conexiunea.

Ordinea de sondare este fixă și intră în aplicație la compilare:

  1. Datecs Extended (ISL)
  2. Datecs Compact (ISL)
  3. Datecs Professional (ISL)
  4. Tremol (ZFP)
  5. Tremol V2 (ZFP)
  6. Daisy (ISL)
  7. Daisy RO (ISL)
  8. Eltrade (ISL)
  9. Incotex (ISL)
  10. MF/JE (Shtrih)
  11. Custom (Serial) — întotdeauna ultimul

Ordinea urmărește aproximativ cota de instalare pe piața din România: Datecs primul, Custom ultimul. Pentru o scanare TCP, sondarea este restrânsă în plus în funcție de port — un hit pe portul 4999 încearcă doar intrările Tremol, un hit pe 9100 încearcă familiile ISL și Shtrih, iar 8000 cade pe Custom. Matricea completă de porturi, rate baud și transporturi se află în Dispozitive și transporturi suportate.

După ce un dispozitiv a fost asociat cu succes o dată, protocolul său este memorat în intrarea locală a dispozitivului și în înregistrarea din cloud. La fiecare reconectare ulterioară aplicația sare complet peste sondare și deschide conexiunea direct cu protocolul memorat — exact lucrul care face ca reconectările să fie instantanee chiar și la adaptoarele Custom, care altfel ar fi cel mai lent de identificat.

Folosește Conectare manuală când detectarea eșuează

Detectarea automată este o încercare fără garanții. Poate eșua când dispozitivul este în spatele unui firewall care blochează porturile implicite, când imprimanta vorbește un dialect nelistat al unei variante ISL, când o punte USB-to-Serial expune o rată baud neobișnuită sau când un aparat Bluetooth-over-SPP anunță un nume lipsit de informație utilă. În toate aceste situații soluția este ecranul Conectare manuală, unde îi spui aplicației explicit ce să facă:

  • Nume dispozitiv — text liber care apare în lista Dispozitive și pe coloana de dispozitiv a bonurilor emise.
  • Protocol — alege intrarea exactă din registru. Dacă nu ești sigur, pornește de la familia producătorului (Datecs → ISL, Tremol → ZFP, Shtrih → MF/JE) și ajungi la Custom doar după ce celelalte eșuează.
  • Transport — TCP, Bluetooth sau Serial. Chipul USB este afișat pentru completitudine, dar se rezolvă intern tot ca Serial deocamdată.
  • Câmpuri de conectareGazdă + Port pentru TCP (portul este precompletat la 4999; schimbă-l la 9100 pentru ISL/Shtrih sau la 8000 pentru Custom); Adresă pentru Bluetooth (MAC-ul) și pentru Serial (nodul de dispozitiv).
  • Testează conexiunea — rulează o strângere de mână în timp real cu protocolul și transportul alese înainte să confirmi. O bifă verde înseamnă că aplicația a negociat protocolul cu succes; o cruce roșie arată că protocolul este greșit, portul nu e corect sau gazda nu răspunde.

Când Testează conexiunea reușește, apasă Salvează dispozitivul. Intrarea ajunge imediat în lista locală de dispozitive, iar apoi înregistrarea în cloud este încercată în fundal — exact același flux în doi pași folosit și de asocierea Bluetooth.

Depanează și continuă

Dacă asocierea eșuează, cazurile tipice sunt tratate în ghidul de depanare — prompt-ul de permisiune Bluetooth n-a apărut, dialogul USB a fost anulat, gazda este pe alt subnet, imprimanta n-a răspuns la niciunul dintre cei unsprezece candidați sondați sau protocolul a fost detectat corect, dar revendicarea din cloud a eșuat. Fiecare situație are o soluție dedicată acolo.

După ce dispozitivul este asociat, îl administrezi zi de zi din tab-ul Dispozitive al aplicației și din pagina Dispozitive a Portalului, care arată toate imprimantele asociate din toate locațiile, cu stare live, protocol, transport și marcaj de timp pentru ultima vedere.