Odpravite napake pri povezavi JTL

Opomba: vmesnik aplikacije je trenutno na voljo v angleščini, nemščini in italijanščini. Vodnik zato navaja angleška imena gumbov in menijev v krepkem tisku.

Če pooblastitev JTL ni dokončana, hub prikaže stran z naslovom ter razdelkoma What happened in What to do. Na tej strani izberite Read the troubleshooting guide, da odprete ustrezni razdelek spodaj, ali pa naslov poiščite v tabeli. Neuspešen poskus ne shrani ničesar in obstoječo povezavo pusti nespremenjeno, zato lahko vedno izberete Try again.

Koda	Naslov na zaslonu	Pomen
callback_mismatch	JTL prikaže lastno stran z napako	Povratni URL v aplikaciji JTL se razlikuje od tistega v hubu.
invalid_client	JTL did not accept the app credentials	JTL je zavrnil client ID ali client secret.
missing_scope	Permissions are missing	Aplikaciji ali pooblastitvi manjkajo zahtevani obsegi dostopa.
cancelled	Connection cancelled	Dostop pri JTL ni bil odobren.
expired	The authorization expired	Poskus je potekel ali se je končal v drugem brskalniku.
account_mismatch	A different account was used	Za ponovno povezavo je bil uporabljen drug račun JTL.
not_activated	The JTL account is not ready yet	Račun se še ni prijavil v portal FFN ali ni račun trgovca.
permission_lost	You no longer have access	Med pooblastitvijo ste izgubili dovoljenje Connections.
reconnect_required	Reconnect needed, na kartici računa	JTL ne sprejema več shranjene pooblastitve.
unavailable	JTL is not reachable right now	JTL ali omrežje ni bilo dosegljivo.
failed	The connection could not be completed ali We could not confirm the connection	Nepričakovana napaka ali rezultata ni bilo mogoče potrditi.

Naslovna vrstica brskalnika za outcome= prikazuje tudi kodo, ki jo je prejel hub.

Podatki za podporo

Če se obrnete na podporo, navedite te podatke. Noben od njih ni zaupen:

• čas poskusa z vašim časovnim pasom
• ime delovnega prostora
• okolje: Production ali Sandbox
• client ID vaše aplikacije JTL
• povratni URL, prikazan v pogovornem oknu Connect JTL Fulfillment Network
• naslov, prikazan na zaslonu, ali koda za outcome= v naslovni vrstici

Nikoli ne pošiljajte vrednosti client secret, gesla za JTL ali žetonov. Če priložite posnetek zaslona, se prepričajte, da ne prikazuje ničesar od tega.

Povratni URL se ne ujema

Koda: callback_mismatch

Kaj vidite: JTL namesto strani za prijavo ali soglasje prikaže napako, ki pogosto omenja redirect URI. V hub se ne vrnete. Odvisno od tega, kje JTL preveri naslov, lahko hub namesto tega prikaže JTL did not accept the app credentials.

Verjeten vzrok: V aplikaciji JTL shranjeni redirect URI ni natanko enak povratnemu URL-ju, ki je prikazan v pogovornem oknu Connect JTL Fulfillment Network. Značilne razlike so manjkajoča ali odvečna poševnica na koncu, http namesto https, presledki ali naslov, kopiran od drugod.

Kaj storiti:

1. V Balta Labs odprite Settings → Connections, izberite Add account in nato JTL FFN. V razdelku Before you continue izberite Copy ob povratnem URL-ju.
2. Odprite aplikacijo na kundencenter.jtl-software.de/oauth, njen redirect URI zamenjajte s kopiranim naslovom in shranite.
3. Vrnite se v hub in znova izberite Continue to JTL. Strani JTL z napako ne nalagajte znova.

Za podporo: zgornji podatki in besedilo napake JTL.

JTL zavrne client ID ali client secret

Koda: invalid_client

Kaj vidite: Hub prikaže JTL did not accept the app credentials. JTL lahko že pred prijavo prikaže tudi napako v zvezi z odjemalcem.

Verjeten vzrok: Client ID ali client secret se ne ujema z nobeno aplikacijo pri JTL. Vrednost je morda napačna, nepopolna ali obdana s presledki ali pripada drugi aplikaciji, morda pa je bila aplikacija izbrisana ali njen secret zamenjan. Enak učinek ima lahko redirect URI, ki se ne ujema natanko s povratnim URL-jem.

Kaj storiti:

1. Odprite aplikacijo na kundencenter.jtl-software.de/oauth in znova kopirajte njen client ID in client secret.
2. Preverite, ali se njen redirect URI natanko ujema s povratnim URL-jem v hubu.
3. Za novo povezavo odprite Settings → Connections → Add account → JTL FFN. Za obstoječo na njeni kartici izberite Reconnect.
4. Vnesite obe vrednosti in izberite Continue to JTL oziroma pri obstoječi povezavi Reconnect with JTL.
5. Če ju JTL še vedno zavrne, ustvarite novo aplikacijo in uporabite njene vrednosti.

Za podporo: zgornji podatki. Preverite, ali se poslani client ID ujema s tistim v centru za stranke JTL.

Manjkajo zahtevani obsegi dostopa

Koda: missing_scope

Kaj vidite: Ko odobrite dostop, hub prikaže Permissions are missing. Pri obstoječem računu se lahko iz istega razloga Test konča s Check failed.

Verjeten vzrok: Aplikacija JTL ne vključuje obeh obsegov, ffn.merchant.read in ffn.merchant.write, na primer ker je bila izbrana predloga samo z obsegi za izvajalce izpolnitve (fulfiller). Možno je tudi, da je JTL dodelil manj dostopa, kot je bilo zahtevano.

Kaj storiti:

1. Odprite aplikacijo na kundencenter.jtl-software.de/oauth.
2. Označite oba obsega. Če ju ne morete spremeniti, ustvarite novo aplikacijo z obema obsegoma.
3. V hubu izberite Try again ali pri obstoječi povezavi Reconnect. Če ste ustvarili novo aplikacijo, vnesite njen client ID in client secret.
4. Pri JTL odobrite vsa zahtevana dovoljenja.

Za podporo: zgornji podatki in obsegi, ki jih JTL navaja za aplikacijo.

Pooblastitev je bila preklicana

Koda: cancelled

Kaj vidite: Hub prikaže Connection cancelled. Nič ni bilo spremenjeno.

Verjeten vzrok: Dostop je bil na strani JTL za soglasje zavrnjen ali pa vas je JTL preusmeril nazaj, ne da bi dodelil dostop.

Kaj storiti:

1. Izberite Try again.
2. Prijavite se pri JTL in odobrite dostop.
3. Če dostopa niste zavrnili in se težava ponovi, se obrnite na podporo.

Za podporo: zgornji podatki in kaj ste izbrali na strani JTL.

Pooblastitev je potekla

Koda: expired

Kaj vidite: Hub prikaže The authorization expired.

Verjeten vzrok: Vsak poskus velja 10 minut in samo v brskalniku, v katerem se je začel. Zgodilo se je nekaj od naslednjega:

• Med izbiro Continue to JTL in vašo vrnitvijo v hub je minilo več kot 10 minut.
• Prijava se je končala v drugem brskalniku, profilu brskalnika ali napravi, kot se je začela, ali pa je brskalnik blokiral piškotek, ki ga hub uporablja za poskus.
• Stran JTL je bila znova naložena ali odprta iz zgodovine brskalnika, zato je že uporabljen poskus prispel drugič.
• JTL ni več sprejel svoje enkratne kode za pooblastitev.
• Med ponovnim povezovanjem je bil račun odstranjen iz delovnega prostora.

Kaj storiti:

1. V istem brskalniku izberite Try again.
2. Prijavo pri JTL dokončajte v 10 minutah. Naslova JTL ne kopirajte v drug brskalnik.
3. Če se težava ponavlja, dovolite piškotke za Balta Labs ali poskusite z drugim brskalnikom.

Za podporo: zgornji podatki, vaš brskalnik in približno trajanje prijave.

Uporabljen je bil drug račun JTL

Koda: account_mismatch

Kaj vidite: Med ponovnim povezovanjem hub prikaže A different account was used. Nič ni bilo spremenjeno.

Verjeten vzrok: Pri JTL ste se prijavili z drugim računom, kot je povezani, na primer s prijavo sodelavca, z računom v peskovniku ali z drugim računom trgovca. Morda ste bili v brskalniku pri JTL že prijavljeni z drugim računom.

Kaj storiti:

1. Na kartici računa izberite Edit, da pod JTL account vidite, kateri račun JTL uporablja povezava.
2. Odjavite se pri JTL. Lahko pa odprete zasebno okno brskalnika in se tam prijavite v Balta Labs.
3. Izberite Reconnect in se prijavite s prvotnim računom JTL.
4. Če želite namesto tega uporabiti drugi račun JTL, ga dodajte kot novo povezavo. Nato ga v Fulfillment → Setup izberite kot Provider account svojih lokacij.

Za podporo: zgornji podatki, JTL account, prikazan pod Edit, in ime računa JTL, s katerim ste se prijavili.

Račun JTL ni aktiviran

Koda: not_activated

Kaj vidite: Ko odobrite dostop, hub prikaže The JTL account is not ready yet. Pri obstoječem računu se lahko Test konča s Check failed in sporočilom, da JTL FFN računa še ne pozna.

Verjeten vzrok: API JTL odgovarja z not found, dokler se račun vsaj enkrat ne prijavi v portal FFN. Račun morda tudi nima vloge Merchant, na primer ker je to račun izvajalca izpolnitve (fulfiller). Vzrok je lahko tudi okolje: produkcijski račun se mora prijaviti v produkcijski portal, račun v peskovniku pa v portal peskovnika.

Kaj storiti:

1. Z istim računom JTL se enkrat prijavite na fulfillment.jtl-software.com za produkcijsko okolje ali na fulfillment-sandbox.jtl-software.com za peskovnik in dokončajte nastavitev računa trgovca.
2. Preverite, ali ima račun vlogo Merchant. Če niste prepričani, vprašajte lastnika računa ali JTL.
3. Preverite, ali se Environment, ki ste ga izbrali v hubu, ujema s tem portalom.
4. Izberite Try again.

Za podporo: zgornji podatki in ali se lahko prijavite v ustrezni portal FFN.

Nimate več dovoljenja

Koda: permission_lost

Kaj vidite: Pri JTL ste odobrili dostop, vendar hub prikaže You no longer have access in ni shranil ničesar.

Verjeten vzrok: Medtem ko ste bili pri JTL, vam je bilo v tem delovnem prostoru odvzeto dovoljenje Connections, vaša vloga se je spremenila ali pa ste delovni prostor zapustili. Hub pred shranjevanjem znova preveri dovoljenje.

Kaj storiti:

1. Prosite lastnika delovnega prostora, naj vam v Settings → Team dodeli dovoljenje Connections.
2. Izberite Try again ali prosite sodelavca s tem dovoljenjem, naj račun poveže.

Za podporo: zgornji podatki in vaša vloga v delovnem prostoru.

Račun je treba znova povezati

Koda: reconnect_required

Kaj vidite: Kartica računa prikazuje Reconnect needed, Edit pa pojasni, da JTL ne sprejema več shranjene pooblastitve. Opravila izpolnitve naročil za ta račun ne uspevajo, dokler računa znova ne povežete.

Verjeten vzrok: JTL je zavrnil obnovitev dostopa. To se zgodi, če je bil dostop pri JTL preklican, če je bila aplikacija izbrisana ali njen secret zamenjan ali če shranjena pooblastitev ni več veljavna.

Kaj storiti:

1. Če ste pri JTL zamenjali secret ali ustvarili novo aplikacijo, pripravite nov client ID in client secret.
2. Odprite Settings → Connections in na kartici računa izberite Reconnect.
3. Polji Client ID in Client secret pustite prazni, da ohranite shranjene poverilnice aplikacije, ali vnesite novi vrednosti.
4. Izberite Reconnect with JTL in se prijavite z istim računom JTL.
5. Izberite Test. Ko kartica prikaže Working, odprite Fulfillment → Operations in znova zaženite elemente pod Failed. Za ponovni zagon potrebujete dovoljenje Fulfillment operations.

Za podporo: zgornji podatki, kdaj se je stanje prvič pojavilo in ali je bila aplikacija pri JTL spremenjena.

JTL ali omrežje ni na voljo

Koda: unavailable

Kaj vidite: Hub prikaže JTL is not reachable right now. Pri obstoječem računu se lahko Test konča s Check failed in podobnim sporočilom.

Verjeten vzrok: Storitev JTL ne deluje ali je v vzdrževanju ali pa je povezavi med hubom in JTL potekla časovna omejitev.

Kaj storiti:

1. Počakajte nekaj minut. Nič ni bilo spremenjeno, zato lahko varno poskusite znova.
2. Izberite Try again ali pri obstoječem računu Test.
3. Če težava traja več kot eno uro, preverite, ali lahko odprete portal FFN, nato se obrnite na podporo.

Za podporo: zgornji podatki in koliko časa težava že traja.

Povezovanje je ustavila druga napaka

Koda: failed

Kaj vidite: Hub prikaže The connection could not be completed. Ta razdelek zajema tudi We could not confirm the connection, ki se prikaže, ko je JTL sporočil uspeh, vendar računa ni na seznamu v delovnem prostoru, ki ga imate odprtega.

Verjeten vzrok: JTL je vrnil nepričakovan odgovor, na primer brez podatkov o računu, ali pa je med shranjevanjem prišlo do nepričakovane napake. Če hub povezave ni mogel potrditi, račun morda pripada delovnemu prostoru, ki ga s to prijavo ne morete odpreti, ali pa seznama povezav ni bilo mogoče naložiti.

Kaj storiti:

1. Če zaslon ponuja Check again, ga izberite.
2. V delovnem prostoru, v katerem ste začeli, odprite Settings → Connections in preverite, ali je račun na seznamu.
3. Če ga ni, enkrat izberite Try again.
4. Če znova ne uspe, se obrnite na podporo.

Za podporo: zgornji podatki z natančnim časom vsakega poskusa, da jih podpora lahko najde.

Sporočila v pogovornem oknu Connect JTL Fulfillment Network

Nekatere težave se pokažejo, še preden zapustite hub:

• JTL connections are not available on this server yet. Balta Labs ne more ponuditi povratnega URL-ja. Obrnite se na podporo.
• The JTL settings could not be loaded. Izberite Try again. Če se napaka ponavlja, se obrnite na podporo.
• The authorization could not be started. Pod sporočilom je naveden razlog, na primer da manjkata client ID in client secret. Nova povezava potrebuje oba; pri ponovni povezavi prazni polji ohranita shranjene poverilnice aplikacije.
• A reconnect stays in the account’s environment. Pri ponovni povezavi ne morete preklopiti med produkcijskim okoljem in peskovnikom. Za drugo okolje dodajte novo povezavo.