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 prístupový token Shopify, Packeta API heslo, KROS API token, autorizačný kľúč webhooku, úplný obsah požiadaviek, 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 prihlasovacie údaje znova bez nadbytočných 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, spätné volanie alebo záznam v účte dopravcu či KROS. Až keď je bezpečne potvrdené, že operácia nevznikla, povoľte kontrolované opakovanie.
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ý účet poskytovateľa |
| timeout alebo 429 | dostupnosť/limit KROS | počkajte a zopakujte iba read-only kontrolu spojenia |
KROS_SETUP_INVALID | povinné polia, PDF zostava, jazyk a formát, typ DPH | opravte konfiguráciu. Neznižujte úroveň overenia |
Aktuálny prehľad podporovaných balíkov a presné nastavenie nájdete v návode Pripojenie účtu KROS Fakturácia.
Spätné volanie KROS je odmietnuté
- Porovnajte adresu spätného volania s adresou zobrazenou pri správnom účte poskytovateľa.
- Overte zhodný autorizačný kľúč webhooku 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 spätné volanie iba mešká, faktúru znova nevytvárajte. Spustite zosúladenie.
PDF nie je pripravené
Overte, že doklad je v KROS prijatý, vybraná PDF zostava existuje v danej firme a prístupový token je platný. Spustite obnovenie PDF. Chyba zostavy 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ň.
Ak ide o refundáciu, dobropis vytvorte po účtovnom overení priamo v KROS. Aktuálne KROS API ho z Torevo nevie vytvoriť automaticky.
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 prihlasovacích údajov či sprístupnenie údajov nesprávnemu obchodu, vypnite príslušnú automatizáciu, zmeňte ohrozený tajný kľúč a incident bezodkladne eskalujte. Nevymazávajte auditné záznamy potrebné na vyšetrovanie.