Ghid de integrare
Acest ghid duce un patron de la zero până la o casă de marcat complet conectată, cu o predare opțională către un partener POS la final. Folosește doar componentele care fac deja parte din e-bon: Portalul Cloud, aplicația E-BON pentru Android și API-ul public.
Conectează prima casă de marcat
Creează-ți contul e-bon
Înregistrează-te în portal (app.e-bon.ro) cu emailul de business. CUI-ul este completat automat din ANAF — confirmă-l, alege o parolă și contul este gata. Planul gratuit acoperă până la 3 case de marcat și nu necesită card.
Adaugă afacerea și prima locație
După ce ajungi în panoul principal, deschide Setări → Locații și adaugă magazinul, restaurantul sau biroul unde va sta prima casă de marcat. Folosește un nume clar, de tipul București — Unirii, ca să distingi locațiile mai târziu.
Instalează aplicația E-BON pe dispozitivul Android
Pe telefonul sau tableta Android care va sta lângă casa de marcat, instalează aplicația E-BON din Google Play. Conectează-te cu același email și parolă folosite pentru portal — aplicația se asociază automat la cont.
Asociază casa de marcat
În aplicație, deschide Setări → Adaugă imprimantă și alege cum se conectează casa:
- Bluetooth — pentru case asociate wireless cu dispozitivul Android
- USB — pentru case conectate direct cu cablu USB
- Serial — pentru case cu cablu serial (de obicei printr-un adaptor USB)
- TCP — pentru case accesibile în rețeaua locală
Aplicația detectează automat modelul și firmware-ul, deci nu trebuie să introduci detalii tehnice manual. Driverele suportate includ Datecs, Daisy, Eltrade, Incotex, Tremol, Custom și Shtrih.
Emite un bon de test ca să verifici conexiunea
Înapoi în portal, deschide pagina Case de marcat. Casa nou asociată ar trebui să apară cu status verde. Declanșează un bon de test din pagina casei — în câteva secunde ar trebui să-l vezi tipărit de imprimanta fiscală și înregistrat în secțiunea Bonuri din portal.
(Opțional) Generează o cheie API pentru partenerul tău POS
Dacă folosești un POS terț care trebuie să trimită bonuri fiscale către e-bon, deschide Setări → Chei API, creează o cheie cu permisiunile necesare și trimite-o partenerului POS. Va folosi cheia pentru a apela API-ul e-bon, iar bonurile tale vor continua să fie emise prin aceeași casă de marcat.
Verifică primul raport X la finalul zilei
Înainte să închizi ziua, deschide Rapoarte în portal, alege casa și rulează un raport X (o vedere de moment a zilei care nu închide ziua fiscală). La finalul zilei de lucru, rulează un raport Z pentru a închide ziua fiscal. e-bon te avertizează dacă raportul Z întârzie.
Continuă configurarea
Limită de plan depășită
De ce apare TIER_LIMIT_EXCEEDED, ce limite ale planului o declanșează și cum faci upgrade.
Ghid rapid pentru dezvoltatori
Ghid rapid pentru integratorii POS — de la zero la prima comandă fiscală și primul eveniment în aproximativ zece minute, folosind curl sau clientul Node @e-bon/sdk.