Limită de plan depășită
TIER_LIMIT_EXCEEDED înseamnă că abonamentul curent nu permite acțiunea pe care tocmai ai încercat-o. Cele mai frecvente cazuri sunt înregistrarea unui dispozitiv în plus față de cât permite planul, sau crearea unei chei API pe planul Free. Statusul HTTP returnat este 403 Forbidden.
Înțelege de ce apare eroarea
Cererea a fost respinsă pentru că organizația ta a atins o limită a planului curent. Răspunsul de eroare îți spune exact ce limită s-a atins, numărul curent și planul:
HTTP/1.1 403 Forbidden
Content-Type: application/json
{
"error": {
"code": "TIER_LIMIT_EXCEEDED",
"message": "Device limit reached. Your free plan allows a maximum of 2 devices (current: 2). Upgrade your plan to add more devices."
}
}
Vezi ce limite o declanșează
| Plan | Dispozitive | Creare chei API |
|---|---|---|
| Free | până la 2 | nepermisă |
| Pro | până la 10 | permisă |
| Enterprise | nelimitat | permisă |
Două acțiuni sunt limitate de plan:
- Înregistrarea unui dispozitiv nou — blocată după ce organizația are deja numărul maxim de dispozitive pentru plan.
- Crearea unei chei API — blocată complet pe planul Free, indiferent de câte dispozitive ai.
Verifică planul curent și dispozitivele
Confirmă pe ce plan se află organizația și câte dispozitive sunt înregistrate:
curl https://api.e-bon.ro/api/v1/org \
-H "Authorization: Bearer <token>"
curl https://api.e-bon.ro/api/v1/devices \
-H "Authorization: Bearer <token>"
Rezolvă eroarea
Șterge un dispozitiv pe care nu îl mai folosești
Dacă unul dintre dispozitivele listate nu mai e în uz — de exemplu un AMEF înlocuit sau o locație închisă — șterge-l ca să eliberezi un slot:
curl -X DELETE https://api.e-bon.ro/api/v1/devices/{deviceId} \
-H "Authorization: Bearer <token>"
Apoi reîncearcă înregistrarea noului dispozitiv.
Fă upgrade la plan
Conectează-te în portal ca owner sau admin și deschide pagina de Facturare. Alege planul potrivit pentru flota ta, finalizează checkout-ul, iar noile limite se aplică imediat.
Nu trebuie să rotești niciun token — sesiunea curentă rămâne validă.
Reîncearcă cererea originală
Re-trimite cererea care a eșuat. Schimbarea de plan e vizibilă imediat la următorul apel, deci acțiunea blocată anterior va reuși acum.
Pentru a crea chei API, fă upgrade la Pro sau Enterprise
Cheile API (token-urile ebon_live_… cu durată mare, folosite pentru integrări server-to-server) sunt disponibile începând cu planul Pro. Nu există excepții per organizație pe planul Free — upgrade-ul e singura cale pentru a activa crearea cheilor API.
Cere ajutor dacă ești tot blocat după upgrade
Dacă ai finalizat checkout-ul dar tot primești TIER_LIMIT_EXCEEDED, contactează suportul la support@e-bon.ro sau prin e-bon.ro/contact. Include:
- Slug-ul organizației
- Câmpul
orgIddin token - Un ID recent de cerere eșuată
Pentru context despre acest cod și alte erori HTTP, vezi Referința erorilor.
Nepotrivire de semnătură HMAC
De ce verificarea `X-EBon-Signature` eșuează pe endpoint-ul tău — drift de ceas, secret greșit după rotație și capcane la re-serializarea body-ului.
Ghid de integrare
Flux complet pentru conectarea primei case de marcat cu e-bon — de la crearea contului până la primul raport X.