e-bon
e-bon.ro
Getting Started

Troubleshooting

Per-symptom recipes for the most common e-bon failure modes — pairing, command timeouts, webhook delivery, ANAF rejections, HMAC verification and tier limits.

This page is the index. Pick the recipe that matches the symptom you are seeing — each recipe lists the expected error code(s), likely causes, a verification command, and the concrete fix steps.

Find your recipe by symptom

SymptomRecipe
Printer won't pair (Bluetooth / USB / Serial / TCP)Device pairing failures by transport
Command timed out or seems stuckCommand timeouts and the 180s sweep
Webhook stopped firing or got auto-disabledWebhook delivery failures
ANAF rejected an MF / JE / P7B reportANAF report rejection
X-EBon-Signature verification fails on your endpointHMAC signature mismatch
API returns TIER_LIMIT_EXCEEDEDTier limit exceeded
Always branch on error.code (HTTP) or errorCode (FiscalError on commands), not on the human-readable message — codes are stable across releases. The full catalogue lives in Errors reference.

Get more help

If none of the recipes resolve the issue, open a support case at support@e-bon.ro or e-bon.ro/contact. Include the device ID, the affected command ID or delivery ID, and the relevant error code — those three identifiers let support trace a request end-to-end.