Kad nešto ne radi: što znači koja poruka, kome se javiti i što se može riješiti odmah — bez čitanja programa.
Kad nešto ne radi, najgore je nagađati. Prvo prepoznajte o čemu se radi, zatim učinite korak iz tablice — i javite podršci ono što treba da se problem riješi iz prvog pokušaja.
Tvrtka ne može primati vožnje
Kod
Znači
Rješenje
errors.launchNotReady
Nije prošla kapija spremnosti (12 provjera)
Početna → Spremnost tvrtke pokazuje što nedostaje; popunjava vlasnik tvrtke
errors.moduleDisabled
Modul nije uključen za tvrtku
Platforma uključuje modul (Novac → Moduli); podaci ostaju
errors.tenantInactive
Tvrtka nije aktivna (probni period, blokada)
Platforma provjerava pretplatu i status tvrtke
400 uz key polja
Neispravno polje u obrascu — key imenuje polje
Polje je označeno uz poruku; ispravite i spremite ponovno
Prijava i sesija
Kod ili simptom
Znači
Rješenje
errors.invalidCredentials
Pogrešna e-pošta ili lozinka
Provjerite velika slova i razmake; upotrijebite Zaboravljena lozinka?
errors.sessionExpired
Sesija je istekla ili je opozvana
Prijavite se ponovno; ako se ponavlja, platforma provjerava sigurnost računa
errors.accountInactive
Račun je deaktiviran
Vlasnik tvrtke ga ponovno aktivira u Korisnici
Prijava traži kod, a nemate aplikaciju
Uključena je dvofaktorska zaštita
Upotrijebite rezervni kod ili zamolite platformu da resetira drugi faktor
Vožnje
Simptom
Najčešći uzrok
Rješenje
Vožnja čeka, a vozača „ima“
Vozači nisu na dužnosti, nemaju valjane dokumente ili im vozilo ne odgovara vrsti usluge
Flota → Vozači i Upozorenja; dodjela nudi samo podobne vozače
Vožnja se ne može otkazati
Već je završena ili otkazana (errors.rideTransitionNotAllowed)
Osvježite vožnju; ako treba nova, otvorite je kao novu
Ponuda ne stiže vozaču
Obavijesti su isključene ili je vozač na pauzi
Vozač uključi obavijesti i provjeri status smjene
Cijena u aplikaciji i u obračunu se razlikuju
Različito razdoblje ili vožnja još nije završena
Provjerite razdoblje i status vožnje u Obračunu
API i integracije
Status i kod
Znači
Rješenje
401 errors.invalidApiKey
Ključ nije prepoznat
Provjerite zaglavlje X-API-Key ili Authorization: Bearer
403 errors.forbidden
Ključu nedostaje opseg
Vlasnik tvrtke dodaje opseg (Tvrtka → Razvoj)
403 errors.apiKeyRevoked / apiKeyExpired
Ključ je opozvan ili istekao
Izdajte novi ključ i prebacite integraciju
403 errors.apiKeyIpNotAllowed
Zahtjev dolazi s adrese koje nema na popisu
Dodajte adresu na popis ključa ili uklonite ograničenje
429 errors.tooManyRequests
Prekoračeno ograničenje (120/min po ključu)
Poštujte zaglavlje Retry-After; smanjite broj poziva ili anketa
Webhook ne stiže
Krajnja točka vraća grešku ili je adresa odbijena (privatna adresa, http)
GET /api/v1/webhooks pokazuje broj dostava i mrtvo slovo
Aplikacije na telefonu
Simptom
Rješenje
Ponude ne dolaze u pozadini
Dopustite obavijesti i rad u pozadini; na Androidu isključite „optimizaciju baterije“ za aplikaciju
Lokacija se ne šalje
Dopuštenje za lokaciju mora biti „tijekom uporabe“ ili „uvijek“; provjerite i da je GPS uključen
Karta je prazna
Nema mreže ili je ključ karte istekao — javite tvrtki da provjeri postavke karte
Aplikacija traži prijavu svaki put
Sesija je opozvana ili je „Zapamti me“ isključen
Što reći podršciPošaljite: kod greške, vrijeme (datum i sat), broj vožnje (R-…) i ulogu iz koje ste radili. To su četiri podatka koja rješenje skraćuju s dana na minute.