Prevádzka
Diagnostika chýb
Diagnostiku skrátite na konkrétnu príčinu podľa rozhrania, oprávnenia, firmy a prostredia.
Predpoklady
- Presná HTTP odpoveď a identifikátor požiadavky, ak ho rozhranie vracia.
Diagnostika podľa kódu
HTTP status nestačí: rozhodujte podľa error.code a detailov odpovede. Rovnaký status môže vyžadovať odlišný postup.
| Kód | Najpravdepodobnejšia príčina | Prvý krok |
|---|---|---|
| 401 | Chýbajúci alebo expirovaný token. | Obnovte token a skontrolujte prostredie. |
| 403 | Chýbajúce oprávnenie, nepovolená firma alebo neaktívny prístup. | Porovnajte oprávnenia s dokumentáciou operácie. |
| 404 | Nesprávna cesta alebo dokument pre túto firmu neexistuje. | Skontrolujte cestu a firemný kontext. |
| 409 | Konflikt podľa error.code; napríklad súbežne spracovávaná požiadavka alebo konflikt identity. | Pri súbežnom spracovaní počkajte a overte stav; nemeníte kľúč. Migráciu riešte iba pri potvrdenom konflikte registrácie. |
| 422 | VALIDATION_ERROR: schéma; UBL_VALIDATION_ERROR/VALIDATION_FAILED: fakturačné pravidlá; IDEMPOTENCY_KEY_MISMATCH: zmenené telo pri rovnakom kľúči. | Pri validácii opravte polia alebo pravidlá v details. Pri idempotency konflikte obnovte pôvodné telo alebo overte pôvodnú operáciu; nový kľúč použite iba pre zámerne novú operáciu. Neopakujte 422 naslepo. |
| 429 | Prekročený limit volaní. | Spomaľte a rešpektujte uvedené hlavičky. |
| 502 / 503 alebo timeout | Dočasná nedostupnosť alebo neznámy výsledok; timeout nepotvrdzuje, že operácia neprebehla. | Overte stav. Idempotentnú operáciu opakujte s rovnakým kľúčom a telom, rastúcimi odstupmi a podľa Retry-After. Neidempotentnú pozvánku neopakujte automaticky. |
Otázky pred kontaktovaním podpory
- Ktoré rozhranie a ktorú operáciu volám a v akom prostredí?
- Ktorá firma je cieľom a akým právom k nej pristupujem?
- Ide o nové volanie alebo o opakovanie po timeoute?
Očakávaný výsledok
Pri každej chybe viete pomenovať rozhranie, právo, firmu a prostredie skôr, než napíšete podpore.
Keď to nefunguje
- Rovnaká chyba po oprave: overte, že volanie používa nové hodnoty a nie cache.
- Chyba iba v produkcii: porovnajte kľúče, identity a callbacky medzi prostrediami.