Work offline and check connection health
Work offline and check connection health
If you have ever seen the orange pill in the app header turn into Reconnecting…, this page is for you. It answers the three questions every operator asks the first time the network drops: what does the badge mean? are my receipts lost? when will it come back?
Recognize the two connections
The app cares about two connections, and they fail independently.
| Connection | Where you see it | What it affects |
|---|---|---|
| Cloud link — between the app and e-bon servers | The pill in the app header (orange "Reconnecting…" or "{N} pending") | Whether commands sent from the Portal reach this device. |
| Printer link — between the app and the fiscal device (AMEF) | The colour badge next to each device on the Devices tab — Online, Busy, Warning, Error, Offline | Whether this app can issue commands to that printer. |
Read the cloud status pill
The pill lives in the app header on every screen.
- Hidden — the cloud is connected and there is nothing waiting. This is the normal state.
- Reconnecting… with a spinning icon — the network dropped and the app is dialling back. The number on the right is how many commands are stacked on the device, waiting for the printer to free up.
- pending with a cloud-off icon — the cloud is unreachable and there are commands queued locally.
Keep selling while the cloud is down
Losing the cloud does not stop the till.
What changes while the cloud is unreachable:
- Receipts on the printer in front of you: unaffected. Print as usual.
- Commands sent from the Portal (a colleague pressing "Print receipt" remotely, an integration call): they wait for the cloud link to come back. Anything that cannot be delivered within 3 minutes is marked as failed in the Portal — your colleague will see the failure and can re-send it.
- The "{N} pending" counter: this is how many commands are queued behind the printer on this device. Most commands take about a second, so the counter is usually
0. A long operation like a Z report (5–10 seconds) can briefly stack one or two more behind it.
Reconnect after a dropout
You don't have to do anything — the app retries on its own with a growing wait between attempts (1, 2, 4, 8, 16, 30 seconds, then once every 30 seconds until it gets through). Most short blips clear up within a minute.
Two cases need help from you:
After signing out, the cloud stays disconnected
That's expected — the app only talks to the cloud when someone is signed in.
The pill shows "Reconnecting…" right after sign-in and never clears
Your session was rejected. Sign out and sign back in. See Sign in.
Read the printer status badge
Each device on the Devices tab shows a coloured badge:
| Badge | Meaning | What to do |
|---|---|---|
| Online (green) | The printer is reachable and idle. | Nothing — this is the normal state. |
| Busy (blue) | A command is running on the printer right now. | Wait for it to finish. |
| Warning (yellow) | One ping to the printer failed. | Wait one more cycle (30 seconds). It usually clears on its own. |
| Error (red) | The printer reported a problem (paper out, drawer open, fiscal error). | Open the device, follow the on-screen instructions. |
| Offline (grey) | Three pings in a row failed. The app will try to reconnect on its own. | If it does not come back within a minute, check the cable, Bluetooth pairing, or power. |
Common causes of a printer going Warning or Offline:
- Bluetooth was unpaired or the phone was out of range.
- The USB cable was unplugged.
- A network printer was powered off or its network cable was unplugged.
- The paper roll ran out mid-print.
Match symptoms to actions
| What you see | What it means | What to do |
|---|---|---|
| Reconnecting… pill with a spinner | The cloud dropped briefly. | Wait. Keep selling. It usually clears in under a minute. |
| pending persists more than 2 minutes | The cloud has been unreachable longer than usual. | Check phone connectivity (mobile data on, Wi-Fi connected). See Troubleshooting. |
| Cloud stays disconnected right after sign-in | Your session was rejected. | Sign out and sign back in. See Sign in. |
| Header is green but a printer shows Warning then Offline | Problem with the printer link, not the network. | Check Bluetooth pairing, cable, and printer power. See Devices. |
| Both the header pill and a printer row are red | Both links are down — most often the phone has lost network. | Keep printing receipts. Everything will sync when the network is back. |
Where to next
- Devices tab — manage printers and read their status.
- Operations — what you can do from the app.
- Sign in — recover after a rejected session.
- Troubleshooting — symptom-by-symptom recovery.
Installing on Android
Install the E-BON Android app, sign in with your Portal account, grant the Bluetooth and location permissions needed for fiscal printers, and take the first-launch tour.
Device detail
Inspect a single fiscal printer — check cash balance, run X and Z reports, edit fiscal settings, and review the command history for that device.