JTL-alkalmazás létrehozá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.

A Balta Labs egy olyan alkalmazáson keresztül kapcsolódik a JTL Fulfillment Networkhöz (JTL FFN), amelyet te magad regisztrálsz a JTL-nél. A JTL ezt OAuth-kliensnek nevezi. Az alkalmazásból egy client ID és egy client secret értéket kapsz. Mindkettőt a Balta Labsban adod meg, majd a JTL-nél engedélyezed a hozzáférést, ahogy azt a JTL csatlakoztatása a hubhoz című útmutató leírja.

A JTL a Merchant API-dokumentációjában a Getting started részben írja le ezeket a lépéseket. A JTL képernyői változhatnak. Ha egy felirat eltér az útmutatóban szereplőtől, a JTL aktuális megfogalmazását kövesd.

Mielőtt elkezded

• Fiók a JTL Customer Centerben. Ott hozod létre az alkalmazást.
• Merchant szerepkörű JTL-fiók a JTL FFN-ben. Ezzel a fiókkal jelentkezel be a csatlakoztatáskor. A JTL csak a Merchant szerepkörű felhasználóknak engedi használni azt az API-t, amelyre a Balta Labsnak szüksége van.
• Legalább egy bejelentkezés ezzel a fiókkal az FFN-portálra. Az éles környezethez a fulfillment.jtl-software.com, a sandboxhoz a fulfillment-sandbox.jtl-software.com címet használd. A JTL az első bejelentkezéskor hozza létre az API-felhasználót. Addig a JTL not found választ ad, a Balta Labs pedig azt jelzi, hogy a JTL-fiók még nem áll készen.
• Connections jogosultság a Balta Labs-munkaterületeden. Erre a kapcsolódási párbeszédablak megnyitásához és a visszahívási URL kimásolásához van szükséged.

A visszahívási URL kimásolása a Balta Labsból

Miután engedélyezted a hozzáférést, a JTL az alkalmazás visszahívási URL-jén (callback URL) keresztül irányít vissza a Balta Labsba. Ennek pontosan meg kell egyeznie azzal a címmel, amelyet a Balta Labs mutat.

1. A Balta Labsban 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. Megnyílik a Connect JTL Fulfillment Network párbeszédablak.
2. A Before you continue részen keresd meg a visszahívási URL-t, és válaszd a Copy gombot. A cím például így néz ki: https://api.example.com/connections/oauth/jtl_ffn/callback. Mindig a saját párbeszédablakodban látható címet használd, ne ezt a példát.
3. Hagyd nyitva a párbeszédablakot, amíg létrehozod az alkalmazást. Az ablak a bejelölendő hatóköröket is felsorolja, és erre az útmutatóra is hivatkozik.

Ne gépeld be kézzel a címet. Egy eltérő karakter, https helyett http, egy felesleges perjel a végén vagy egy szóköz is visszahívási URL-eltérést okoz. Ha a párbeszédablakban a JTL connections are not available on this server yet üzenet jelenik meg, a Balta Labs nem tud visszahívási URL-t biztosítani. Fordulj a Balta Labs ügyfélszolgálatához.

Az alkalmazás létrehozása a JTL-nél

1. Nyisd meg a kundencenter.jtl-software.de/oauth oldalt, és jelentkezz be. A párbeszédablak Open the JTL Customer Center hivatkozása is ugyanerre az oldalra vezet. Az oldal a Customer Center menüjéből nem érhető el, ezért közvetlenül ezt a címet nyisd meg.
2. Hozz létre egy új OAuth-klienst.
3. Ha a JTL nevet kér, adj meg egy később is felismerhető nevet, például Balta Labs.
4. Jelöld be az ffn.merchant.read és az ffn.merchant.write hatókört (scope). A JTL sablonon keresztül is felkínálhatja a hatóköröket; ilyenkor olyan sablont válassz, amely mindkettőt tartalmazza. A fulfiller-hatókörök önmagukban nem elegendők.
5. Illeszd be a Balta Labsból kimásolt visszahívási URL-t az alkalmazás redirect URI mezőjébe. A JTL ezt a mezőt callback URI néven is jelölheti.
6. Mentsd a klienst.
7. Másold ki a JTL által a klienshez megjelenített client ID és client secret értéket.

Hatókör	A JTL leírása	Mire használja a Balta Labs
ffn.merchant.read	Teljes olvasási hozzáférés a merchant API-hoz	A fiókod, a raktárak, a szállítási módok, a termékek, a készlet és a szállítmányfrissítések olvasása
ffn.merchant.write	Teljes írási hozzáférés a merchant API-hoz	Szállítmányok, termékek és beszállítások létrehozása, kizárólag az általad aktívra állított munkafolyamatokban

Éles környezet és sandbox

A JTL egy éles rendszert és egy külön, tesztelésre szolgáló sandboxot üzemeltet. A JTL szerint egy OAuth-kliens mindkettőhöz használható, és a visszahívási URL is ugyanaz. Az különbözik, hogy melyik fiókkal jelentkezel be, és hogy ennek a fióknak melyik portálra kellett egyszer már bejelentkeznie.

	Éles környezet	Sandbox
FFN-portál az első bejelentkezéshez	fulfillment.jtl-software.com	fulfillment-sandbox.jtl-software.com
JTL-fiók	Az éles kereskedői fiókod	Egy sandbox-fiók
Választható lehetőség a párbeszédablak Environment részén	Production	Sandbox
Adatok	Valós szállítmányok és készlet	Tesztadatok, az éles adatoktól elkülönítve

A párbeszédablakban mindkét lehetőség mellett megjelenik a hozzá tartozó portál címe is. A kapcsolat abban a környezetben marad, amelyben létrejött. Ha a sandboxból éles környezetre váltanál, adj hozzá egy új kapcsolatot, és válaszd a Production lehetőséget. Teszteléshez külön JTL-alkalmazást is fenntarthatsz.

A client ID és a secret biztonságos megadása

• A client ID-t és a client secretet csak a Connect JTL Fulfillment Network párbeszédablak Client ID és Client secret mezőjében add meg. A Balta Labs a secretet titkosítva tárolja, és soha többé nem jeleníti meg.
• A client secretet soha ne küldd el e-mailben, csevegőüzenetben vagy támogatási jegyben, és ne illeszd be megosztott dokumentumokba. Az ügyfélszolgálatnak csak a client ID kell.
• Amikor újracsatlakoztatsz egy fiókot, mindkét mezőt üresen hagyhatod, így a mentett alkalmazás-hitelesítő adatok megmaradnak.
• Ha a secret illetéktelenek tudomására juthatott, cseréld le a JTL-nél. Ha a JTL nem engedi megújítani, hozz létre új alkalmazást. Ezután csatlakoztasd újra a fiókot az új értékekkel.

Következő lépésként csatlakoztasd a JTL-t a hubhoz.