Riešenie problémov
Bezpečná diagnostika pripojenia, mapovania, zásielok, faktúr, callbackov, PDF a automatizácií bez vytvárania duplicít.
Na tejto stránke
Pri chybe najprv zastavte automatizáciu ovplyvneného scenára, zaznamenajte bezpečné identifikátory a zistite, či vzdialená operácia už nevznikla. Opakovanie bez tejto kontroly môže vytvoriť duplicitnú zásielku alebo faktúru.
Bezpečné údaje pre diagnostiku
Podpore môžete poslať:
- doménu Shopify obchodu,
- názov aplikácie a modulu,
- bezpečné ID objednávky, dokumentu, zásielky alebo operácie,
- približný čas a časové pásmo,
- viditeľný chybový kód a stav,
- kroky, ktoré chybe predchádzali.
Neposielajte Shopify access token, Packeta API heslo, KROS API token, webhook secret, celé payloady, PDF doklad ani údaje zákazníka. Ak je potrebný citlivý súbor, podpora musí najprv určiť schválený bezpečný kanál a minimálny rozsah.
Aplikácia sa neotvorí v Shopify
- Obnovte stránku Shopify Admin a skúste aplikáciu otvoriť z Apps.
- Overte, že používateľ má oprávnenie používať aplikáciu a potrebné objednávky.
- Skontrolujte stav služby Torevo a Shopify.
- Ak bola aplikácia odinštalovaná alebo zmenila oprávnenia, vykonajte kontrolované opätovné pripojenie.
Neobchádzajte embedded prihlásenie zdieľaním administračnej URL inému obchodu.
Dopravca sa nepripojí
- Skontrolujte, či používate správny Packeta Network účet a API heslo, nie heslo používateľa portálu.
- Overte, že účet má povolené potrebné trhy a služby.
- Pri widgete skontrolujte samostatný widget key.
- Zadajte credentials znova bez medzier a spustite test spojenia.
- Po rotácii hesla aktualizujte iba zapisovateľné pole v Torevo.
Ak test zlyhá aj v portáli dopravcu alebo API nie je pre účet dostupné, problém musí vyriešiť vlastník účtu s dopravcom.
Spôsob dopravy sa nenamapuje
Mapovanie je explicitné a aplikácia neháda službu z názvu. Obnovte zoznam Shopify spôsobov dopravy, vyberte správny trh, modul a službu. Ak ste dopravu v Shopify premenovali alebo znovu vytvorili, môže mať nový identifikátor a vyžaduje nové mapovanie a testovaciu objednávku.
Chýba výdajné miesto
Overte, že podporovaný theme app extension blok je zapnutý v aktuálnej publikovanej téme a priradený k správnemu košíkovému toku. Skontrolujte widget key, trh, službu a to, či zrýchlený checkout nepreskočil výber.
Objednávku bez povinného pickup pointu automaticky neodosielajte. Kontaktujte zákazníka podľa vlastného procesu alebo opravte testovaciu objednávku.
Zásielka alebo faktúra zostala v spracovaní
Najprv použite Zosúladiť alebo obnovu stavu. Skontrolujte, či existuje vzdialené ID, callback alebo záznam v účte dopravcu/KROS. Až keď je bezpečne potvrdené, že operácia nevznikla, povoľte kontrolovaný retry.
Pri čiastočne úspešnej dávke opakujte len konkrétnu neúspešnú položku. Celú dávku neposielajte znova.
KROS spojenie sa neoverí
Postupujte podľa bezpečného kódu a neskúšajte vytvoriť doklad, kým kontrola spojenia neprejde:
| Príznak alebo kód | Čo overiť | Bezpečný ďalší krok |
|---|---|---|
401 alebo AUTH | token, medzery, správna firma, reset tokenu | vygenerujte nový token a vymeňte ho iba v Torevo |
| 402 alebo chyba licencie | aktívna funkcia API prepojenie | aktivujte ju v podporovanom balíku KROS; účet Zadarmo nestačí |
| žiadny číselný rad | nastavenie riadnych faktúr v správnej firme | vytvorte alebo opravte rad v KROS, potom obnovte možnosti |
| nesprávna firma | token patrí inému IČO alebo prostrediu | spojenie deaktivujte a vytvorte oddelený provider účet |
| timeout alebo 429 | dostupnosť/limit KROS | počkajte a zopakujte iba read-only kontrolu spojenia |
KROS_SETUP_INVALID | povinné polia, report, kultúra, DPH typ | opravte konfiguráciu; neznižujte validáciu |
Aktuálny prehľad podporovaných balíkov a presné nastavenie nájdete v návode Pripojenie účtu KROS Fakturácia.
KROS callback je odmietnutý
- Porovnajte callback URL s adresou zobrazenou pri správnom provider účte.
- Overte zhodný webhook authorization key na oboch stranách.
- Skontrolujte, či URL používa HTTPS a aktuálnu produkčnú doménu.
- Po rotácii secretu odstráňte starú hodnotu a odošlite testovaciu udalosť.
- Nezapínajte spracovanie nepodpísaných callbackov.
Ak callback iba mešká, faktúru znova nevytvárajte; spustite zosúladenie.
PDF nie je pripravené
Overte, že doklad je v KROS prijatý, vybraný report existuje v danej firme a prístupový token je platný. Spustite obnovenie PDF. Chyba reportu alebo úložiska sa rieši oddelene od vytvorenia faktúry.
PDF sa neotvára cez verejný odkaz. Používateľ musí byť prihlásený v správnom Shopify obchode a mať oprávnenie k aplikácii.
Platba alebo refundácia vyžaduje kontrolu
Skontrolujte bránu, typ transakcie, sumu, menu a predošlé operácie. Neznámy gateway zámerne blokuje automatickú registráciu. Refundáciu neposudzujte iba podľa sumy; overte riadky, množstvá, dopravu a daň.
Automatický dobropis nezapínajte ako riešenie chyby. Najprv musí byť scenár účtovne potvrdený a živý test zdokumentovaný.
Automatizácia sa nespustila
Overte, že pravidlo je aktívne, obchod má oprávnenie a plán, trigger zodpovedá aktuálnemu stavu objednávky a všetky readiness podmienky prešli. Pozrite audit rozhodnutia: bezpečne zablokovaný scenár je očakávané správanie, nie chyba workera.
Eskalácia incidentu
Ak hrozí opakované vytváranie dokladov alebo zásielok, únik credentialov či sprístupnenie údajov nesprávnemu obchodu, vypnite príslušnú automatizáciu, rotujte ohrozený secret a incident bezodkladne eskalujte. Nevymazávajte auditné záznamy potrebné na vyšetrovanie.