Installing on Android
The E-BON Android app is the on-site controller for your fiscal hardware. It runs on the phone or tablet sitting next to your Bluetooth or USB fiscal printer, drives every receipt and report the printer emits, and syncs the results back to the e-bon cloud in the background. Everything you configure in the Portal — locations, devices, API keys — shows up in the app after you sign in, so there is nothing to wire up by hand.
Check what you need
Before you install, make sure you have:
- Android 7.0 Nougat or newer (minimum SDK 24, compiled against Android 14 / SDK 36). The app runs on phones and tablets alike.
- Bluetooth on the device, if you plan to pair a Bluetooth fiscal printer. USB printers work over the phone's USB-C or USB-OTG port with no extra radio.
- Network connectivity — Wi-Fi or mobile data. Receipts are stored locally when offline and flushed to the cloud as soon as the link is back, but the initial sign-in needs a live connection.
- A Portal account with at least one location already created. If you have not done that yet, start with the Getting Started guide and the Locations page — the app refuses to move past sign-in until the account owns at least one location.
Install the app
Get the app on your Android device
Open the app and sign in
Launch E-BON from the app drawer. The first screen you see is the sign-in screen — enter the same email and password you use on app.e-bon.ro. There is no separate app account, no second password to remember: the app and the Portal share a single identity.
Pick a location
Right after sign-in the Location Selection screen lists every location on your account. Tap the one this device will serve — for example Bucharest — Unirii. The choice is sticky: the app remembers it across restarts, and every receipt issued from this device is stamped with this location. You can switch it later from the Settings tab.
Grant the permissions
Android 12 and newer split Bluetooth into a few runtime permissions, and the system prompts you the first time the app actually needs them — typically the first time you open the Devices tab. Here is exactly what each one is for and why it matters.
Allow Bluetooth scan and connect
The app requests BLUETOOTH_SCAN and BLUETOOTH_CONNECT so it can discover nearby Bluetooth fiscal printers and establish a paired connection with the one you choose. Without these the Devices tab cannot see any Bluetooth hardware. On Android 11 and earlier the legacy BLUETOOTH and BLUETOOTH_ADMIN permissions are granted automatically at install time and do the same job.
Allow location access for Bluetooth scanning
The app requests ACCESS_FINE_LOCATION and ACCESS_COARSE_LOCATION because Android itself requires a location permission to return Bluetooth scan results on Android 10 and older, and for Bluetooth LE scans on some Android 12+ devices that do not support the neverForLocation hint. It is a platform requirement, not an app feature.
Sync with the cloud over the network
INTERNET is granted at install time and is used to sync receipts, X and Z reports, device status, and remote commands with the e-bon cloud. This is the connection that makes the Portal's live view possible: when you issue a receipt in the app, it appears in the Portal within seconds.
Connect USB without a runtime permission
For USB fiscal printers there is no runtime permission to grant. USB connectivity uses Android's built-in USB host API; no special runtime permission is required on Android 6 and newer. When you plug a USB printer in, Android itself shows a one-time prompt asking whether to allow the E-BON app to access that specific device. Tick Always allow and you will not see the prompt again for that printer.
Take the first-launch tour
Once you are signed in and have picked a location, the app opens on the Home tab. Four tabs sit at the bottom of the screen — this is where you will spend the rest of your time.
- Home — a quick status panel for the selected location. See the currently paired printer, the last receipt issued, pending sync items, and shortcuts to the most common actions (issue a receipt, run an X report, open Devices).
- Devices — pair, unpair and manage fiscal printers for this location. Every Bluetooth scan, every USB permission prompt, and every printer health check lives here.
- Receipts — issue new receipts and reprint recent ones. Each receipt is attached to the current location and, once synced, becomes visible on the Portal's Receipts page.
- Settings — account info (the signed-in email, the active location, sign out), app preferences, diagnostic logs, and the Change location shortcut if the device ever needs to move.
Troubleshoot and continue
If sign-in fails, the location list is empty, or a permission dialog never appears, head to the Troubleshooting guide — it covers the common "I installed the app but…" cases (wrong Portal password, no location created yet, Bluetooth turned off at the system level, location services disabled) and how to clear each one in under a minute.
Organization
Manage your e-bon organization from the Portal — company name, CUI/CIF, billing address, plan and locations. Restricted to Owner and Admin roles.
Work offline and check connection health
Keep ringing up sales when the network drops. Learn what the orange "Reconnecting…" pill means, how to read printer status, and what to do when something goes red.