Vyriešte chyby pripojenia JTL

Poznámka: rozhranie aplikácie je zatiaľ dostupné v angličtine, nemčine a taliančine. V návode preto uvádzame anglické názvy ovládacích prvkov tučným písmom.

Keď sa autorizácia JTL nedokončí, hub zobrazí stránku s nadpisom a časťami What happened a What to do. Ak na tejto stránke vyberiete Read the troubleshooting guide, otvorí sa príslušná časť nižšie. Nadpis môžete vyhľadať aj v tabuľke. Neúspešný pokus nič neuloží a existujúce pripojenie ponechá v pôvodnom stave, takže môžete vždy vybrať Try again.

Kód	Nadpis na obrazovke	Význam
callback_mismatch	JTL zobrazí vlastnú chybovú stránku	Callback URL v aplikácii JTL sa líši od adresy, ktorú zobrazuje hub.
invalid_client	JTL did not accept the app credentials	JTL odmietol client ID alebo client secret.
missing_scope	Permissions are missing	Aplikácii alebo autorizácii chýbajú požadované rozsahy oprávnení (scopes).
cancelled	Connection cancelled	Prístup v JTL nebol schválený.
expired	The authorization expired	Pokus vypršal alebo sa dokončil v inom prehliadači.
account_mismatch	A different account was used	Na opätovné pripojenie sa použil iný účet JTL.
not_activated	The JTL account is not ready yet	Účet sa ešte neprihlásil do portálu FFN alebo nie je účtom obchodníka.
permission_lost	You no longer have access	Počas autorizácie ste prišli o oprávnenie Connections.
reconnect_required	Reconnect needed, na karte účtu	JTL už neprijíma uloženú autorizáciu.
unavailable	JTL is not reachable right now	Služba JTL alebo sieť nebola dostupná.
failed	The connection could not be completed alebo We could not confirm the connection	Neočakávaná chyba alebo výsledok nebolo možné potvrdiť.

Adresný riadok prehliadača zobrazuje za outcome= aj kód, ktorý hub dostal.

Informácie pre podporu

Ak kontaktujete podporu, uveďte tieto údaje. Žiadny z nich nie je tajný:

• čas pokusu vrátane vášho časového pásma
• názov pracovného priestoru
• prostredie: Production alebo Sandbox
• client ID vašej aplikácie JTL
• callback URL zobrazená v dialógu Connect JTL Fulfillment Network
• nadpis zobrazený na obrazovke alebo kód za outcome= v adresnom riadku

Nikdy neposielajte client secret, heslo k JTL ani tokeny. Ak prikladáte snímku obrazovky, skontrolujte, či na nej nič z toho nie je vidieť.

Callback URL sa nezhoduje

Kód: callback_mismatch

Čo uvidíte: JTL namiesto stránky na prihlásenie alebo udelenie súhlasu zobrazí chybu, často so zmienkou o redirect URI. Do hubu sa nevrátite. Podľa toho, kde JTL adresu kontroluje, môže hub namiesto toho zobraziť JTL did not accept the app credentials.

Pravdepodobná príčina: Redirect URI uložená v aplikácii JTL sa presne nezhoduje s callback URL zobrazenou v dialógu Connect JTL Fulfillment Network. Typické rozdiely sú chýbajúca alebo nadbytočná lomka na konci, http namiesto https, medzery alebo adresa skopírovaná odinakiaľ.

Čo robiť:

1. V Balta Labs otvorte Settings → Connections, vyberte Add account a zvoľte JTL FFN. V časti Before you continue vyberte Copy vedľa callback URL.
2. Otvorte aplikáciu na kundencenter.jtl-software.de/oauth, nahraďte jej redirect URI skopírovanou adresou a zmeny uložte.
3. Vráťte sa do hubu a znova vyberte Continue to JTL. Chybovú stránku JTL neobnovujte.

Pre podporu: údaje uvedené vyššie a text chyby z JTL.

JTL odmieta client ID alebo secret

Kód: invalid_client

Čo uvidíte: Hub zobrazí JTL did not accept the app credentials. JTL môže zobraziť aj chybu týkajúcu sa klienta ešte pred prihlásením.

Pravdepodobná príčina: Client ID alebo client secret nezodpovedá žiadnej aplikácii v JTL. Hodnota môže byť nesprávna, neúplná alebo obklopená medzerami, môže patriť inej aplikácii, prípadne mohla byť aplikácia odstránená alebo mohol byť vymenený jej secret. Rovnaký následok môže mať aj redirect URI, ktorá sa presne nezhoduje s callback URL.

Čo robiť:

1. Otvorte aplikáciu na kundencenter.jtl-software.de/oauth a znova skopírujte jej client ID a client secret.
2. Skontrolujte, či sa jej redirect URI presne zhoduje s callback URL, ktorú zobrazuje hub.
3. Pri novom pripojení otvorte Settings → Connections → Add account → JTL FFN. Pri existujúcom vyberte na jeho karte Reconnect.
4. Zadajte obe hodnoty a vyberte Continue to JTL, pri existujúcom pripojení Reconnect with JTL.
5. Ak ich JTL stále odmieta, vytvorte novú aplikáciu a použite jej hodnoty.

Pre podporu: údaje uvedené vyššie. Skontrolujte, či sa posielané client ID zhoduje s tým v JTL Customer Center.

Chýbajú požadované rozsahy oprávnení

Kód: missing_scope

Čo uvidíte: Po schválení prístupu hub zobrazí Permissions are missing. Pri existujúcom účte môže z rovnakého dôvodu Test skončiť stavom Check failed.

Pravdepodobná príčina: Aplikácia JTL neobsahuje oba rozsahy ffn.merchant.read a ffn.merchant.write, napríklad preto, že bola zvolená šablóna iba s rozsahmi pre fulfillerov. JTL mohol udeliť aj menší prístup, než aký bol požadovaný.

Čo robiť:

1. Otvorte aplikáciu na kundencenter.jtl-software.de/oauth.
2. Zaškrtnite oba rozsahy. Ak ich nemôžete zmeniť, vytvorte novú aplikáciu s oboma rozsahmi.
3. V hube vyberte Try again, pri existujúcom pripojení Reconnect. Ak ste vytvorili novú aplikáciu, zadajte jej nové client ID a secret.
4. V JTL schváľte všetky požadované oprávnenia.

Pre podporu: údaje uvedené vyššie a rozsahy, ktoré JTL pri aplikácii uvádza.

Autorizácia bola zrušená

Kód: cancelled

Čo uvidíte: Hub zobrazí Connection cancelled. Nič sa nezmenilo.

Pravdepodobná príčina: Prístup bol na stránke súhlasu JTL odmietnutý alebo vás JTL vrátil späť bez udelenia prístupu.

Čo robiť:

1. Vyberte Try again.
2. Prihláste sa v JTL a schváľte prístup.
3. Ak ste prístup neodmietli a situácia sa opakuje, kontaktujte podporu.

Pre podporu: údaje uvedené vyššie a čo ste vybrali na stránke JTL.

Platnosť autorizácie vypršala

Kód: expired

Čo uvidíte: Hub zobrazí The authorization expired.

Pravdepodobná príčina: Každý pokus platí 10 minút a iba v prehliadači, v ktorom sa začal. Nastala jedna z týchto situácií:

• Medzi výberom Continue to JTL a návratom do hubu uplynulo viac ako 10 minút.
• Prihlásenie sa dokončilo v inom prehliadači, profile prehliadača alebo zariadení, než v akom sa začalo, alebo prehliadač zablokoval súbor cookie, ktorý hub pre pokus používa.
• Stránka JTL bola obnovená alebo znova otvorená z histórie prehliadača, takže už použitý pokus prišiel druhýkrát.
• JTL už neprijal svoj jednorazový autorizačný kód.
• Počas opätovného pripojenia bol účet odstránený z pracovného priestoru.

Čo robiť:

1. V tom istom prehliadači vyberte Try again.
2. Prihlásenie v JTL dokončite do 10 minút. Adresu JTL nekopírujte do iného prehliadača.
3. Ak sa to opakuje, povoľte pre Balta Labs súbory cookie alebo skúste iný prehliadač.

Pre podporu: údaje uvedené vyššie, váš prehliadač a približne ako dlho prihlásenie trvalo.

Použil sa iný účet JTL

Kód: account_mismatch

Čo uvidíte: Pri opätovnom pripojení hub zobrazí A different account was used. Nič sa nezmenilo.

Pravdepodobná príčina: V JTL ste sa prihlásili iným účtom, než je ten pripojený, napríklad prihlasovacími údajmi kolegu, účtom v sandboxe alebo iným účtom obchodníka. Váš prehliadač mohol byť v JTL aj už prihlásený iným účtom.

Čo robiť:

1. Na karte účtu vyberte Edit; pole JTL account ukazuje, ktorý účet pripojenie používa.
2. Odhláste sa v JTL. Prípadne otvorte súkromné okno prehliadača a prihláste sa v ňom do Balta Labs.
3. Vyberte Reconnect a prihláste sa pôvodným účtom JTL.
4. Ak chcete namiesto neho použiť druhý účet JTL, pridajte ho ako nové pripojenie. Potom ho v Fulfillment → Setup zvoľte ako Provider account svojich lokalít.

Pre podporu: údaje uvedené vyššie, hodnota JTL account z Edit a názov účtu JTL, ktorým ste sa prihlásili.

Účet JTL nie je aktivovaný

Kód: not_activated

Čo uvidíte: Po schválení prístupu hub zobrazí The JTL account is not ready yet. Pri existujúcom účte môže Test skončiť stavom Check failed a hlásením, že JTL FFN účet ešte nepozná.

Pravdepodobná príčina: API JTL odpovedá not found, kým sa účet raz neprihlási do portálu FFN. Účtu môže chýbať aj rola Merchant, napríklad preto, že ide o účet fulfillera. Príčinou môže byť aj prostredie: produkčný účet sa musí prihlásiť do produkčného portálu a účet v sandboxe do portálu sandboxu.

Čo robiť:

1. Tým istým účtom JTL sa raz prihláste na fulfillment.jtl-software.com pre produkciu alebo na fulfillment-sandbox.jtl-software.com pre sandbox a dokončite nastavenie účtu obchodníka.
2. Skontrolujte, či má účet rolu Merchant. Ak si nie ste istí, opýtajte sa vlastníka účtu alebo JTL.
3. Skontrolujte, či Environment, ktoré ste zvolili v hube, zodpovedá tomuto portálu.
4. Vyberte Try again.

Pre podporu: údaje uvedené vyššie a informácia, či sa viete prihlásiť do zodpovedajúceho portálu FFN.

Už nemáte oprávnenie

Kód: permission_lost

Čo uvidíte: V JTL ste schválili prístup, ale hub zobrazí You no longer have access a nič neuložil.

Pravdepodobná príčina: Kým ste boli v JTL, v tomto pracovnom priestore vám bolo odobraté oprávnenie Connections, zmenila sa vaša rola alebo ste pracovný priestor opustili. Hub pred uložením oprávnenie overuje znova.

Čo robiť:

1. Požiadajte vlastníka pracovného priestoru, aby vám v Settings → Team udelil oprávnenie Connections.
2. Vyberte Try again alebo požiadajte kolegu s týmto oprávnením, aby účet pripojil.

Pre podporu: údaje uvedené vyššie a vaša rola v pracovnom priestore.

Účet je potrebné znova pripojiť

Kód: reconnect_required

Čo uvidíte: Karta účtu zobrazuje Reconnect needed a Edit vysvetľuje, že JTL už neprijíma uloženú autorizáciu. Úlohy plnenia pre tento účet zlyhávajú, kým účet znova nepripojíte.

Pravdepodobná príčina: JTL odmietol obnoviť prístup. Stáva sa to, keď bol prístup v JTL odvolaný, keď bola aplikácia odstránená alebo jej secret vymenený, alebo keď uložená autorizácia už nie je platná.

Čo robiť:

1. Ak ste v JTL vymenili secret alebo vytvorili novú aplikáciu, pripravte si nové client ID a secret.
2. Otvorte Settings → Connections a na karte účtu vyberte Reconnect.
3. Ak chcete zachovať uložené prístupové údaje aplikácie, nechajte Client ID a Client secret prázdne, alebo zadajte nové hodnoty.
4. Vyberte Reconnect with JTL a prihláste sa tým istým účtom JTL.
5. Vyberte Test. Keď karta zobrazí Working, otvorte Fulfillment → Operations a zopakujte položky v časti Failed. Na opakovanie potrebujete oprávnenie Fulfillment operations.

Pre podporu: údaje uvedené vyššie, kedy sa stav zobrazil prvýkrát a či sa aplikácia v JTL menila.

Služba JTL alebo sieť je nedostupná

Kód: unavailable

Čo uvidíte: Hub zobrazí JTL is not reachable right now. Pri existujúcom účte môže Test skončiť stavom Check failed a podobným hlásením.

Pravdepodobná príčina: Služba JTL nefunguje alebo prebieha jej údržba, prípadne vypršal časový limit spojenia medzi hubom a JTL.

Čo robiť:

1. Počkajte niekoľko minút. Nič sa nezmenilo, takže nový pokus je bezpečný.
2. Vyberte Try again, pri existujúcom účte Test.
3. Ak problém trvá dlhšie ako hodinu, skontrolujte, či sa dá otvoriť portál FFN, a potom kontaktujte podporu.

Pre podporu: údaje uvedené vyššie a ako dlho problém trvá.

Pripojenie zastavila iná chyba

Kód: failed

Čo uvidíte: Hub zobrazí The connection could not be completed. Táto časť sa týka aj hlásenia We could not confirm the connection, ktoré sa zobrazí, keď JTL ohlásil úspech, ale účet nie je uvedený v pracovnom priestore, ktorý máte otvorený.

Pravdepodobná príčina: JTL vrátil neočakávanú odpoveď, napríklad bez údajov o účte, alebo pri ukladaní nastala neočakávaná chyba. Ak hub nemohol pripojenie potvrdiť, účet môže patriť pracovnému priestoru, ktorý s týmto prihlásením nemôžete otvoriť, alebo sa nepodarilo načítať zoznam pripojení.

Čo robiť:

1. Ak obrazovka ponúka Check again, vyberte túto možnosť.
2. Otvorte Settings → Connections v pracovnom priestore, v ktorom ste začali, a skontrolujte, či je účet uvedený.
3. Ak nie je, vyberte raz Try again.
4. Ak pokus znova zlyhá, kontaktujte podporu.

Pre podporu: údaje uvedené vyššie s presným časom každého pokusu, aby ich podpora vedela dohľadať.

Hlásenia v dialógu Connect JTL Fulfillment Network

Niektoré problémy sa zobrazia ešte predtým, ako hub opustíte:

• JTL connections are not available on this server yet. Balta Labs nemôže ponúknuť callback URL. Kontaktujte podporu.
• The JTL settings could not be loaded. Vyberte Try again. Ak sa chyba opakuje, kontaktujte podporu.
• The authorization could not be started. Dôvod sa zobrazí pod týmto hlásením, napríklad že chýba client ID a client secret. Nové pripojenie potrebuje obe hodnoty; pri opätovnom pripojení prázdne polia zachovajú uložené prístupové údaje aplikácie.
• A reconnect stays in the account’s environment. Pri opätovnom pripojení nemôžete prepínať medzi produkciou a sandboxom. Pre druhé prostredie pridajte nové pripojenie.