JTL csatlakoztatása a hubhoz

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.

A JTL Fulfillment Network (JTL FFN) kapcsolattal a hub, vagyis a Balta Labs, a JTL-en keresztül átadhatja a szállítmányokat a fulfillerednek, és visszaolvashatja a nyomkövetési, termék- és készletadatokat. A fiók csatlakoztatása önmagában semmit sem küld el. A szállítmányok küldése csak azután indul el, hogy a Fulfillment → Setup oldalon hozzáadtál egy helyszínt, és Active módba állítottad a munkafolyamatait.

Mielőtt elkezded

• Hozz létre egy JTL-alkalmazást, és készítsd elő a client ID és a client secret értékét. Lásd: JTL-alkalmazás létrehozása.
• Olyan Merchant szerepkörű JTL-fiókot használj, amely már legalább egyszer bejelentkezett az FFN-portálra.
• Csatlakoztasd a weclappot. A rendelések és a szállítmányok onnan érkeznek. Lásd: weclapp csatlakoztatása.
• A munkaterületen a Connections jogosultságra, a beállításhoz pedig a Fulfillment jogosultságra van szükséged.

A fiók engedélyezése

1. Nyisd meg a Settings → Connections oldalt, válaszd az Add account gombot, majd a JTL FFN lehetőséget. A Fulfillment & notifications szakaszban az Add provider gombot is választhatod.
2. A Connect JTL Fulfillment Network párbeszédablak Before you continue részén ellenőrizd, hogy a visszahívási URL megegyezik-e a JTL-alkalmazásodban mentettel.
3. Az Environment részen válaszd a Production lehetőséget az éles fiókhoz, vagy a Sandbox lehetőséget a JTL tesztrendszeréhez.
4. Add meg a JTL-alkalmazásod Client ID és Client secret értékét.
5. Ha szeretnéd, adj meg egy nevet a Connection name mezőben. Név nélkül a hub a JTL-fiók nevét használja.
6. Válaszd a Continue to JTL gombot.
7. Jelentkezz be a JTL-nél azzal a kereskedői fiókkal, amelyet csatlakoztatni szeretnél.
8. Ellenőrizd a kért hozzáférést, és engedélyezd.
9. A JTL visszairányít a Balta Labsba, amely visszaigazolja az eredményt.

Hosszabb szünet nélkül fejezd be a folyamatot. Minden kísérlet 10 percig érvényes, és csak abban a böngészőben, amelyben elindult. Ha lejár, kezdd újra az 1. lépéstől.

A megfelelő JTL-fiók kiválasztása

A Balta Labs azt a fiókot csatlakoztatja, amellyel a JTL-nél bejelentkezel. Ez nem feltétlenül ugyanaz a fiók, amelyhez az alkalmazás tartozik. Ha a böngésződben már be vagy jelentkezve a JTL-be, a JTL újra felhasználhatja ezt a munkamenetet. Ha ez nem a kívánt kereskedői fiók, előbb jelentkezz ki a JTL-nél, majd kezdd újra.

A Balta Labs JTL-fiókonként és környezetenként egy kapcsolatot tart nyilván. Ha egy már csatlakoztatott fiókot engedélyezel, a meglévő kapcsolata frissül, és nem jön létre másodpéldány. Másik kereskedői fiók csatlakoztatásához válaszd újra az Add account gombot.

A sikeres csatlakozást jelző képernyő

Amikor a Balta Labs mentette és ellenőrizte a fiókot, megjeleníti a JTL connected successfully! üzenetet, valamint az Account, a Connection és az Environment értékét. Ellenőrizd, hogy a fiók az-e, amelyet csatlakoztatni akartál.

Ezután egy visszaszámlálás öt másodperc múlva továbbvisz a teljesítési beállításokhoz. Ha azonnal tovább szeretnél lépni, válaszd a Continue now gombot; ha meg szeretnéd állítani a visszaszámlálást, a Stay here gombot. Újracsatlakoztatás után a képernyő a JTL reconnected successfully! üzenetet mutatja, és ehelyett a kapcsolathoz visz vissza.

Ha az engedélyezés nem fejeződött be, a képernyőn egy cím jelenik meg, például Permissions are missing, alatta pedig a What happened és a What to do rész. Az újrakezdéshez válaszd a Try again lehetőséget, vagy a Read the troubleshooting guide lehetőséggel nyisd meg a JTL-kapcsolódási hibák elhárítása útmutató megfelelő szakaszát.

A kapcsolat ellenőrzése

A Settings → Connections oldalon a fiók a Fulfillment & notifications szakaszban jelenik meg. A kártyája mutatja az állapotát, és azt is, hogy mikor ellenőrizték utoljára:

• Not checked: a fiók hozzáadása vagy módosítása óta még nem futott teszt.
• Working: a legutóbbi teszt vagy JTL-kérés sikeres volt.
• Check failed: a legutóbbi teszt vagy kérés sikertelen volt. A kártya megjeleníti a JTL üzenetét. Az engedélyezés érvényben marad; hárítsd el a hiba okát, és teszteld újra a fiókot.
• Reconnect needed: a JTL már nem fogadja el az engedélyezést. Csatlakoztasd újra a fiókot az alább leírtak szerint.

A fiók azonnali ellenőrzéséhez válaszd a Test gombot. A teszt csak olvas a JTL-ből. A Details gombbal megtekintheted az Account és a What the hub can do részt, valamint a Reference lists alatt a Warehouses és a Shipping methods listát: mindegyik tételnél az azonosítót, a Fulfiller oszlopban pedig azt a fulfillert, amelyhez tartozik. A helyszín párbeszédablaka ugyanezeket a választási lehetőségeket kínálja. Az Edit megmutatja a JTL-fiókot, a környezetét, az alkalmazás client ID értékét és az engedélyezés időpontját. Itt át is nevezheted a kapcsolatot.

A kártya arra is emlékeztet, hogy a fiók szállítmányokhoz addig nincs használatban, amíg be nem kapcsolsz egy helyszínt, és egy Open fulfillment setup hivatkozást is tartalmaz.

A helyszín beállítása

A helyszín egy olyan weclapp-raktár, amelyet egy teljesítési szolgáltatói fiók üzemeltet. Minden raktárhoz, amelyet a JTL kiszolgál, adj hozzá egy helyszínt:

1. Nyisd meg a Fulfillment → Setup oldalt. Ha az oldalon a Start with weclapp felirat látható, válaszd ki a weclapp-kapcsolatodat a weclapp connection mezőben, majd válaszd a Save and continue gombot.
2. A Locations részen válaszd az Add location gombot.
3. Töltsd ki a Name mezőt.
4. A weclapp warehouse mezőben válaszd ki azt a raktárt, amelynek a szállítmányait a JTL kezeli, vagy írd be az azonosítóját.
5. A Provider account mezőben válaszd ki a JTL-fiókot. A párbeszédablak ezután betölti a fiók választási lehetőségeit.
6. A Warehouse at JTL mezőben válaszd ki a raktárt. Ez kitölti a Fulfiller ID és a Fulfiller warehouse ID mezőt; mindkettő szerkeszthető marad. Ha a párbeszédablak a The account’s choices could not be loaded. Enter the IDs instead. üzenetet mutatja, írd be mindkét azonosítót magad, vagy a hiba okának kiderítéséhez válaszd a fiók kártyáján a Test gombot.
7. A Shipping methods részen minden weclapp-fuvarozóhoz válaszd az Add carrier gombot, és válaszd ki a hozzá tartozó FFN shipping method ID értéket a javaslatok közül. A javaslatok csak az adott fulfiller szállítási módjait tartalmazzák, és az azonosító alatt a szállítási mód nevét is mutatják. Ha egy szállítmány fuvarozójához nincs hozzárendelés, a szállítmány a standard szállítási típussal kerül a JTL-hez, a hub pedig figyelmeztetést rögzít.
8. Válaszd a Save location gombot.
9. Ha még nem fut szinkronizálás, a Sync részen válaszd a Start syncing gombot.

Egy új helyszín minden munkafolyamata Off módban indul. Egy JTL-helyszín a következő munkafolyamatokkal rendelkezik:

• Dispatch: átadja a jóváhagyott szállítmányokat a JTL-nek.
• Tracking: visszaírja a nyomkövetési számokat a weclappba.
• Catalog: elküldi a cikkeket, a képeket és a termékjóváhagyásokat a JTL-nek.
• Stock check: összeveti a weclapp-készletet a JTL készletével.
• Inbound: bejelenti a JTL-nek a beérkező szállításokat.

Minden munkafolyamat a három mód egyikében van:

• Off: nem történik semmi.
• Shadow: a hub eldönti és rögzíti, hogy mit tenne. Semmit sem ír a JTL-be vagy a weclappba, és nem küld értesítéseket.
• Active: a hub elvégzi a munkát.

A munkafolyamatokat a Fulfillment → Setup oldalon állítsa be. Ellenőrizze a döntéseket Shadow módban, majd engedélyezze az Active módot. Az Active módba vagy abból történő váltás megerősítést kér. Részletek: Fulfillment-szolgáltatók csatlakoztatása.

Fiók újracsatlakoztatása

Csatlakoztasd újra a fiókot, ha a kártyán a Reconnect needed állapot látható, vagy ha a JTL-nél lecserélted az alkalmazás client secretjét.

1. Nyisd meg a Settings → Connections oldalt, és keresd meg a fiókot a Fulfillment & notifications szakaszban.
2. 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 újakat.
4. Válaszd a Reconnect with JTL gombot.
5. Jelentkezz be ugyanazzal a JTL-fiókkal, mint korábban, és engedélyezd a hozzáférést.
6. A JTL reconnected successfully! képernyőn ellenőrizd a fiókot. Ezután válaszd a kártyán a Test gombot.

Az újracsatlakoztatás a fiók környezetén belül marad. Ha másik JTL-fiókkal jelentkezel be, a hub az A different account was used üzenetet jeleníti meg, és nem módosítja a kapcsolatot. Másik fiók csatlakoztatásához add hozzá azt új kapcsolatként.

Így marad érvényes a hozzáférés

A JTL hozzáférési tokenjei körülbelül 30 percig érvényesek. A hub automatikusan megújítja őket, és minden megújítás lecseréli a frissítési tokent. Neked ehhez semmit sem kell tenned. Ha a JTL elutasít egy megújítást, például mert visszavonták a hozzáférést, a kártyán a Reconnect needed állapot jelenik meg, és a hub mindaddig nem tud dolgozni a fiókkal, amíg újra nem csatlakoztatod. Ezután a Fulfillment → Operations oldalon keresd meg az időközben meghiúsult tételeket.