JTL-kapcsolódási hibák elhárítása

Megjegyzés: az alkalmazás felülete jelenleg angol, német és olasz nyelven érhető el. Az útmutató a kezelőelemek angol feliratait használja, félkövérrel kiemelve.

Ha egy JTL-engedélyezés nem fejeződik be, a hub egy oldalt jelenít meg, amelyen egy cím, valamint a What happened és a What to do rész látható. Az oldalon a Read the troubleshooting guide lehetőséggel megnyithatod az alábbi szakaszok közül a megfelelőt, vagy a címet a táblázatban is megkeresheted. A sikertelen kísérlet semmit sem ment, és a meglévő kapcsolatot változatlanul hagyja, így bármikor választhatod a Try again lehetőséget.

Kód	Cím a képernyőn	Jelentés
callback_mismatch	A JTL saját hibaoldala jelenik meg	A JTL-alkalmazásban megadott visszahívási URL eltér a hubban láthatótól.
invalid_client	JTL did not accept the app credentials	A JTL elutasította a client ID-t vagy a client secretet.
missing_scope	Permissions are missing	Az alkalmazásból vagy az engedélyezésből hiányoznak a szükséges hatókörök.
cancelled	Connection cancelled	A hozzáférést nem hagyták jóvá a JTL-nél.
expired	The authorization expired	A kísérlet lejárt, vagy egy másik böngészőben fejeződött be.
account_mismatch	A different account was used	Az újracsatlakoztatáshoz másik JTL-fiókot használtak.
not_activated	The JTL account is not ready yet	A fiók még nem jelentkezett be az FFN-portálra, vagy nem kereskedői fiók.
permission_lost	You no longer have access	Az engedélyezés közben elvesztetted a Connections jogosultságot.
reconnect_required	Reconnect needed (a fiók kártyáján)	A JTL már nem fogadja el a mentett engedélyezést.
unavailable	JTL is not reachable right now	A JTL vagy a hálózat nem volt elérhető.
failed	The connection could not be completed vagy We could not confirm the connection	Váratlan hiba történt, vagy az eredményt nem sikerült megerősíteni.

A böngésző címsorában az outcome= után a hub által kapott kód is látható.

Adatok az ügyfélszolgálat számára

Ha az ügyfélszolgálathoz fordulsz, add meg az alábbi adatokat. Egyik sem titkos:

• a kísérlet időpontja az időzónáddal együtt
• a munkaterület neve
• a környezet: Production vagy Sandbox
• a JTL-alkalmazásod client ID értéke
• a Connect JTL Fulfillment Network párbeszédablakban látható visszahívási URL
• a képernyőn látható cím, vagy a címsorban az outcome= utáni kód

Soha ne küldd el a client secretet, a JTL-jelszavadat vagy tokeneket. Ha képernyőképet csatolsz, ügyelj arra, hogy egyik se legyen látható rajta.

A visszahívási URL nem egyezik

Kód: callback_mismatch

Amit látsz: A JTL a bejelentkezési vagy hozzájárulási oldala helyett hibát jelenít meg, gyakran a redirect URI említésével. Nem kerülsz vissza a hubba. Attól függően, hogy a JTL hol ellenőrzi a címet, a hub ehelyett a JTL did not accept the app credentials üzenetet is megjelenítheti.

Valószínű ok: A JTL-alkalmazásban mentett redirect URI nem egyezik pontosan a Connect JTL Fulfillment Network párbeszédablakban látható visszahívási URL-lel. Jellemző eltérések: hiányzó vagy felesleges perjel a végén, https helyett http, szóközök vagy egy máshonnan kimásolt cím.

Teendők:

1. A Balta Labsban nyisd meg a Settings → Connections oldalt, válaszd az Add account gombot, majd a JTL FFN lehetőséget. A Before you continue részen válaszd a visszahívási URL melletti Copy gombot.
2. Nyisd meg az alkalmazást a kundencenter.jtl-software.de/oauth oldalon, cseréld le a redirect URI értékét a kimásolt címre, és mentsd.
3. Térj vissza a hubba, és válaszd újra a Continue to JTL gombot. Ne töltsd újra a JTL hibaoldalát.

Az ügyfélszolgálatnak: a fenti adatok és a JTL hibaüzenetének szövege.

A JTL elutasítja a client ID-t vagy a secretet

Kód: invalid_client

Amit látsz: A hub a JTL did not accept the app credentials üzenetet jeleníti meg. A JTL már a bejelentkezés előtt is jelezhet hibát a klienssel kapcsolatban.

Valószínű ok: A client ID vagy a client secret nem egyezik egyetlen JTL-alkalmazáséval sem. Lehet, hogy hibás, hiányos, szóköz van előtte vagy utána, vagy egy másik alkalmazáshoz tartozik; az is lehet, hogy az alkalmazást törölték, vagy lecserélték a secretjét. Ugyanezt okozhatja az is, ha a redirect URI nem egyezik pontosan a visszahívási URL-lel.

Teendők:

1. Nyisd meg az alkalmazást a kundencenter.jtl-software.de/oauth oldalon, és másold ki újra a client ID és a client secret értékét.
2. Ellenőrizd, hogy a redirect URI pontosan egyezik-e a hubban látható visszahívási URL-lel.
3. Új kapcsolatnál nyisd meg a Settings → Connections → Add account → JTL FFN útvonalat. Meglévő kapcsolatnál válaszd a kártyáján a Reconnect gombot.
4. Add meg mindkét értéket, és válaszd a Continue to JTL gombot, meglévő kapcsolatnál a Reconnect with JTL gombot.
5. Ha a JTL továbbra is elutasítja őket, hozz létre új alkalmazást, és annak az értékeit használd.

Az ügyfélszolgálatnak: a fenti adatok. Ellenőrizd, hogy az elküldött client ID megegyezik-e a JTL Customer Centerben láthatóval.

Hiányoznak a szükséges hatókörök

Kód: missing_scope

Amit látsz: Miután jóváhagytad a hozzáférést, a hub a Permissions are missing üzenetet jeleníti meg. Meglévő fióknál a Test eredménye ugyanezért Check failed is lehet.

Valószínű ok: A JTL-alkalmazás nem tartalmazza egyszerre az ffn.merchant.read és az ffn.merchant.write hatókört, például mert csak fulfiller-hatóköröket tartalmazó sablont választottak. Az is lehet, hogy a JTL a kértnél kisebb hozzáférést adott.

Teendők:

1. Nyisd meg az alkalmazást a kundencenter.jtl-software.de/oauth oldalon.
2. Jelöld be mindkét hatókört. Ha nem tudod módosítani őket, hozz létre egy új alkalmazást mindkét hatókörrel.
3. A hubban válaszd a Try again lehetőséget, meglévő kapcsolatnál pedig a Reconnect gombot. Ha új alkalmazást hoztál létre, add meg az új client ID és secret értékét.
4. A JTL-nél hagyd jóvá az összes kért jogosultságot.

Az ügyfélszolgálatnak: a fenti adatok és az alkalmazáshoz a JTL-nél felsorolt hatókörök.

Az engedélyezés megszakadt

Kód: cancelled

Amit látsz: A hub a Connection cancelled üzenetet jeleníti meg. Semmi sem változott.

Valószínű ok: A JTL hozzájárulási oldalán elutasították a hozzáférést, vagy a JTL a hozzáférés megadása nélkül irányított vissza.

Teendők:

1. Válaszd a Try again lehetőséget.
2. Jelentkezz be a JTL-nél, és hagyd jóvá a hozzáférést.
3. Ha nem utasítottad el a hozzáférést, és a hiba ismét előfordul, fordulj az ügyfélszolgálathoz.

Az ügyfélszolgálatnak: a fenti adatok, valamint az, hogy mit választottál a JTL oldalán.

Az engedélyezés lejárt

Kód: expired

Amit látsz: A hub a The authorization expired üzenetet jeleníti meg.

Valószínű ok: Minden kísérlet 10 percig érvényes, és csak abban a böngészőben, amelyben elindult. Az alábbiak egyike történt:

• Több mint 10 perc telt el a Continue to JTL gomb kiválasztása és a hubba való visszatérésed között.
• A bejelentkezés más böngészőben, böngészőprofilban vagy eszközön fejeződött be, mint ahol elkezdődött, vagy a böngésző letiltotta azt a sütit, amelyet a hub a kísérlethez használ.
• Egy JTL-oldalt újratöltöttek vagy a böngészési előzményekből nyitottak meg újra, így egy már felhasznált kísérlet másodszor is beérkezett.
• A JTL már nem fogadta el az egyszer használható engedélyezési kódját.
• Az újracsatlakoztatás közben a fiókot eltávolították a munkaterületről.

Teendők:

1. Ugyanabban a böngészőben válaszd a Try again lehetőséget.
2. 10 percen belül fejezd be a bejelentkezést a JTL-nél. Ne másold át a JTL-címet másik böngészőbe.
3. Ha a hiba továbbra is fennáll, engedélyezd a sütiket a Balta Labs számára, vagy próbálj ki egy másik böngészőt.

Az ügyfélszolgálatnak: a fenti adatok, a használt böngésző, valamint az, hogy nagyjából mennyi ideig tartott a bejelentkezés.

Másik JTL-fiókot használtál

Kód: account_mismatch

Amit látsz: Újracsatlakoztatás közben a hub az A different account was used üzenetet jeleníti meg. Semmi sem változott.

Valószínű ok: A JTL-nél nem a csatlakoztatott fiókkal jelentkeztél be, hanem például egy kolléga hozzáférésével, egy sandbox-fiókkal vagy egy másik kereskedői fiókkal. Az is lehet, hogy a böngésződ már eleve be volt jelentkezve a JTL-be egy másik fiókkal.

Teendők:

1. A fiók kártyáján válaszd az Edit gombot: a JTL account mezőben láthatod, melyik JTL-fiókot használja a kapcsolat.
2. Jelentkezz ki a JTL-nél. Másik lehetőségként nyiss egy privát böngészőablakot, és ott jelentkezz be a Balta Labsba.
3. Válaszd a Reconnect gombot, és jelentkezz be az eredeti JTL-fiókkal.
4. Ha inkább a másik JTL-fiókot használnád, add hozzá új kapcsolatként. Ezután a Fulfillment → Setup oldalon válaszd ki a helyszíneid Provider account mezőjében.

Az ügyfélszolgálatnak: a fenti adatok, az Edit alatt a JTL account mezőben látható fiók, valamint annak a JTL-fióknak a neve, amellyel bejelentkeztél.

A JTL-fiók nincs aktiválva

Kód: not_activated

Amit látsz: Miután jóváhagytad a hozzáférést, a hub a The JTL account is not ready yet üzenetet jeleníti meg. Meglévő fióknál a Test eredménye Check failed is lehet, azzal az üzenettel, hogy a JTL FFN még nem ismeri a fiókot.

Valószínű ok: A JTL API-ja mindaddig not found választ ad, amíg a fiók egyszer be nem jelentkezik az FFN-portálra. Az is lehet, hogy a fióknak nincs Merchant szerepköre, például mert fulfiller-fiók. A környezet is okozhatja a hibát: az éles fióknak az éles portálra, a sandbox-fióknak a sandbox-portálra kell bejelentkeznie.

Teendők:

1. Ugyanazzal a JTL-fiókkal jelentkezz be egyszer az éles környezethez a fulfillment.jtl-software.com, a sandboxhoz a fulfillment-sandbox.jtl-software.com oldalon, és fejezd be a kereskedői fiók beállítását.
2. Ellenőrizd, hogy a fióknak van-e Merchant szerepköre. Ha bizonytalan vagy, kérdezd meg a fiók tulajdonosát vagy a JTL-t.
3. Ellenőrizd, hogy a hubban kiválasztott Environment megfelel-e ennek a portálnak.
4. Válaszd a Try again lehetőséget.

Az ügyfélszolgálatnak: a fenti adatok, valamint az, hogy be tudsz-e jelentkezni a megfelelő FFN-portálra.

Már nincs jogosultságod

Kód: permission_lost

Amit látsz: A JTL-nél jóváhagytad a hozzáférést, de a hub a You no longer have access üzenetet jeleníti meg, és semmit sem mentett.

Valószínű ok: Amíg a JTL oldalán voltál, visszavonták a Connections jogosultságodat ezen a munkaterületen, megváltozott a szerepköröd, vagy kiléptél a munkaterületről. A hub mentés előtt újra ellenőrzi a jogosultságot.

Teendők:

1. Kérd meg a munkaterület egyik tulajdonosát, hogy a Settings → Team oldalon adja meg neked a Connections jogosultságot.
2. Válaszd a Try again lehetőséget, vagy kérj meg egy ilyen jogosultsággal rendelkező kollégát, hogy csatlakoztassa a fiókot.

Az ügyfélszolgálatnak: a fenti adatok és a szerepköröd a munkaterületen.

A fiókot újra kell csatlakoztatni

Kód: reconnect_required

Amit látsz: A fiók kártyáján a Reconnect needed állapot látható, az Edit pedig elmagyarázza, hogy a JTL már nem fogadja el a mentett engedélyezést. A fiókhoz tartozó teljesítési feladatok az újracsatlakoztatásig meghiúsulnak.

Valószínű ok: A JTL elutasította a hozzáférés megújítását. Ez akkor fordul elő, ha a JTL-nél visszavonták a hozzáférést, törölték az alkalmazást vagy lecserélték a secretjét, illetve ha a mentett engedélyezés már nem érvényes.

Teendők:

1. Ha a JTL-nél lecserélted a secretet vagy új alkalmazást hoztál létre, készítsd elő az új client ID és secret értékét.
2. Nyisd meg a Settings → Connections oldalt, és a fiók kártyáján válaszd a Reconnect gombot.
3. Ha a mentett alkalmazás-hitelesítő adatokat megtartanád, hagyd üresen a Client ID és a Client secret mezőt, vagy add meg az új értékeket.
4. Válaszd a Reconnect with JTL gombot, és jelentkezz be ugyanazzal a JTL-fiókkal.
5. Válaszd a Test gombot. Ha a kártyán a Working állapot látható, nyisd meg a Fulfillment → Operations oldalt, és próbáld újra a Failed alatti tételeket. Az újrapróbáláshoz Fulfillment operations jogosultság szükséges.

Az ügyfélszolgálatnak: a fenti adatok, valamint az, hogy mikor jelent meg először az állapot, és módosult-e az alkalmazás a JTL-nél.

A JTL vagy a hálózat nem érhető el

Kód: unavailable

Amit látsz: A hub a JTL is not reachable right now üzenetet jeleníti meg. Meglévő fióknál a Test eredménye hasonló üzenettel Check failed is lehet.

Valószínű ok: A JTL szolgáltatása leállt vagy karbantartás alatt áll, vagy a hub és a JTL közötti kapcsolat túllépte az időkorlátot.

Teendők:

1. Várj néhány percet. Semmi sem változott, ezért nyugodtan próbálkozhatsz újra.
2. Válaszd a Try again lehetőséget, meglévő fióknál pedig a Test gombot.
3. Ha a probléma egy óránál tovább tart, ellenőrizd, meg tudod-e nyitni az FFN-portált, majd fordulj az ügyfélszolgálathoz.

Az ügyfélszolgálatnak: a fenti adatok, valamint az, hogy mióta áll fenn a probléma.

Egyéb hiba szakította meg a csatlakoztatást

Kód: failed

Amit látsz: A hub a The connection could not be completed üzenetet jeleníti meg. Ez a szakasz a We could not confirm the connection üzenetre is vonatkozik, amely akkor jelenik meg, ha a JTL sikert jelzett, de a fiók nem szerepel a megnyitott munkaterületen.

Valószínű ok: A JTL váratlan választ adott, például nem küldött fiókadatokat, vagy mentés közben váratlan hiba történt. Ha a hub nem tudta megerősíteni a kapcsolatot, lehet, hogy a fiók egy olyan munkaterülethez tartozik, amelyet ezzel a bejelentkezéssel nem tudsz megnyitni, vagy nem sikerült betölteni a kapcsolatok listáját.

Teendők:

1. Ha a képernyőn megjelenik a Check again lehetőség, válaszd azt.
2. Abban a munkaterületen, ahol a folyamatot elindítottad, nyisd meg a Settings → Connections oldalt, és ellenőrizd, hogy szerepel-e a fiók.
3. Ha nem szerepel, válaszd egyszer a Try again lehetőséget.
4. Ha ismét sikertelen, fordulj az ügyfélszolgálathoz.

Az ügyfélszolgálatnak: a fenti adatok, az egyes kísérletek pontos időpontjával, hogy az ügyfélszolgálat megtalálhassa őket.

Üzenetek a Connect JTL Fulfillment Network párbeszédablakban

Néhány probléma még a hubban, a JTL-re való továbblépés előtt jelentkezik:

• JTL connections are not available on this server yet. A Balta Labs nem tud visszahívási URL-t biztosítani. Fordulj az ügyfélszolgálathoz.
• The JTL settings could not be loaded. Válaszd a Try again lehetőséget. Ha továbbra is sikertelen, fordulj az ügyfélszolgálathoz.
• The authorization could not be started. Alatta megjelenik az ok, például hogy hiányzik a client ID és a client secret. Új kapcsolathoz mindkettő szükséges; újracsatlakoztatáskor az üres mezők megtartják a mentett alkalmazás-hitelesítő adatokat.
• A reconnect stays in the account’s environment. Újracsatlakoztatáskor nem válthatsz az éles környezet és a sandbox között. A másik környezethez adj hozzá új kapcsolatot.