Cum este organizat e-bon
e-bon e construit din trei componente cuplate slab. În funcție de rolul tău, vei atinge doar una sau două dintre ele, dar e util să știi ce rulează unde, ca să poți gândi clar despre unde stau datele, de unde pornesc comenzile și unde pot apărea probleme.
Cunoaște cele trei componente
Portalul Cloud — app.e-bon.ro
Aplicația web în care trăiesc patronii. Este dashboard-ul multi-locație pentru tot parcul tău fiscal: case de marcat, bonuri, rapoarte X/Z, locații, utilizatori, chei API, abonament, arhive ANAF. Tot ce are nevoie de un ecran și de o decizie umană se întâmplă aici. Construit pe Nuxt 4 + NuxtUI, rulează în orice browser modern, fără instalare.
Aplicația E-BON — Android, la fața locului
Controlerul on-site. Un telefon sau o tabletă Android stă lângă fiecare imprimantă fiscală și rulează aplicația E-BON. Aplicația este singura care comunică cu hardware-ul imprimantei — prin Bluetooth, USB, Serial sau TCP — și cu ANAF, atunci când se transmite un raport. Este offline-first: o pană de curent sau o conexiune slabă la internet nu o oprește din emis bonuri. Când conexiunea revine, sincronizează totul înapoi în Portalul Cloud automat.
API-ul REST public — api.e-bon.ro
Suprafața de integrare pentru partenerii POS. Este un API REST documentat (OpenAPI), autentificat cu chei API generate de patron în Portalul Cloud. Sistemele POS apelează acest API pentru a trimite bonuri fiscale, a cere rapoarte sau a interoga statusul caselor de marcat, fără să fie nevoie să cunoască modelul imprimantei sau transportul folosit la celălalt capăt.
Urmărește un bon de la cap la coadă
POS-ul trimite bonul către API-ul e-bon
Aplicația POS apelează POST https://api.e-bon.ro/v1/... cu conținutul bonului și cu cheia API a afacerii.
API-ul predă comanda către dispozitiv
API-ul identifică dispozitivul țintă, apoi împinge comanda prin canalul de timp real (MQTT / WebSocket, cu FCM ca fallback de trezire).
Aplicația E-BON acționează imprimanta
Aplicația primește comanda, alege driverul potrivit (Datecs, Daisy, Eltrade, Incotex, Tremol, Custom sau Shtrih) și trimite octeții protocolului prin transportul dispozitivului.
Imprimanta tipărește și raportează la ANAF
Imprimanta fiscală tipărește bonul și îl înregistrează în propria memorie fiscală. Rapoartele Z de la finalul zilei se trimit la ANAF la programul cerut de lege.
Portalul vede tot
Bonul, statusul dispozitivului și raportul ANAF apar în Portalul Cloud aproape în timp real, disponibile pentru căutare, export și control.
Unde mergi mai departe
Cont și primul dispozitiv
Înregistrează-te pe app.e-bon.ro, adaugă prima locație și instalează aplicația E-BON pe dispozitivul Android — primele 10 minute cu e-bon.
Depanare
Rețete pe simptom pentru cele mai frecvente erori e-bon — asociere, timeout-uri de comenzi, livrare webhook, respingeri ANAF, semnătură HMAC și limite de plan.