Vytvorte aplikáciu 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.

Balta Labs sa k JTL Fulfillment Network (JTL FFN) pripája cez aplikáciu, ktorú si v JTL zaregistrujete sami. JTL ju označuje ako klienta OAuth. Aplikácia vám poskytne client ID a client secret. Obe hodnoty zadáte v Balta Labs a potom v JTL povolíte prístup, ako popisuje návod Pripojte JTL k hubu.

JTL tieto kroky popisuje v časti Getting started svojej dokumentácie Merchant API. Obrazovky JTL sa môžu meniť. Ak sa niektorý názov líši od tohto návodu, riaďte sa aktuálnym znením v JTL.

Skôr než začnete

• Účet v JTL Customer Center. V ňom aplikáciu vytvoríte.
• Účet JTL s rolou Merchant v JTL FFN. Týmto účtom sa prihlásite pri pripájaní. API, ktoré Balta Labs potrebuje, JTL sprístupňuje iba používateľom s rolou Merchant.
• Jedno prihlásenie týmto účtom do portálu FFN. Pre produkciu použite fulfillment.jtl-software.com, pre sandbox fulfillment-sandbox.jtl-software.com. Používateľa API vytvorí JTL pri prvom prihlásení. Dovtedy JTL odpovedá not found a Balta Labs hlási, že účet JTL ešte nie je pripravený.
• Oprávnenie Connections vo vašom pracovnom priestore Balta Labs. Potrebujete ho na otvorenie dialógu pripojenia a skopírovanie callback URL.

Skopírujte callback URL z Balta Labs

Po povolení prístupu vás JTL vráti do Balta Labs cez callback URL aplikácie. Musí sa presne zhodovať s adresou, ktorú zobrazuje Balta Labs.

1. V Balta Labs otvorte Settings → Connections, vyberte Add account a zvoľte JTL FFN. Môžete tiež vybrať Add provider v časti Fulfillment & notifications. Otvorí sa dialóg Connect JTL Fulfillment Network.
2. V časti Before you continue nájdite callback URL a vyberte Copy. Vyzerá napríklad takto: https://api.example.com/connections/oauth/jtl_ffn/callback. Vždy použite adresu zo svojho dialógu, nie tento príklad.
3. Kým vytvárate aplikáciu, nechajte dialóg otvorený. Uvádza aj rozsahy oprávnení (scopes), ktoré treba zaškrtnúť, a odkaz na tento návod.

Adresu neprepisujte ručne. Iný znak, http namiesto https, lomka navyše na konci alebo medzera spôsobí nezhodu callback URL. Ak dialóg hlási JTL connections are not available on this server yet, Balta Labs nemôže ponúknuť callback URL. Kontaktujte podporu Balta Labs.

Vytvorte aplikáciu v JTL

1. Otvorte kundencenter.jtl-software.de/oauth a prihláste sa. Na rovnakú stránku vedie aj odkaz Open the JTL Customer Center v dialógu. Z ponuky JTL Customer Center na túto stránku nevedie odkaz, preto adresu otvorte priamo.
2. Vytvorte nového klienta OAuth.
3. Ak JTL požaduje názov, zvoľte taký, ktorý neskôr spoznáte, napríklad Balta Labs.
4. Zaškrtnite rozsahy ffn.merchant.read a ffn.merchant.write. JTL môže rozsahy ponúkať v šablóne; zvoľte takú, ktorá obsahuje oba. Samotné rozsahy pre fulfillerov nestačia.
5. Vložte callback URL z Balta Labs ako redirect URI aplikácie. JTL môže toto pole nazývať aj callback URI.
6. Uložte klienta.
7. Skopírujte client ID a client secret, ktoré JTL pri klientovi zobrazuje.

Rozsah	Popis v JTL	Na čo ho Balta Labs používa
ffn.merchant.read	Úplný prístup na čítanie k Merchant API	Čítanie vášho účtu, skladov, spôsobov dopravy, produktov, zásob a aktualizácií zásielok
ffn.merchant.write	Úplný prístup na zápis k Merchant API	Vytváranie zásielok, produktov a prichádzajúcich dodávok, iba pri pracovných postupoch, ktoré nastavíte do režimu active

Produkcia a sandbox

JTL prevádzkuje produkčný systém a samostatný sandbox na testovanie. Podľa JTL funguje jeden klient OAuth pre oba systémy a callback URL je rovnaká. Líši sa účet, ktorým sa prihlasujete, a portál, do ktorého sa tento účet musel raz prihlásiť.

	Produkcia	Sandbox
Portál FFN na prvé prihlásenie	fulfillment.jtl-software.com	fulfillment-sandbox.jtl-software.com
Účet JTL	Váš produkčný účet obchodníka	Účet v sandboxe
Možnosť v časti Environment v dialógu	Production	Sandbox
Údaje	Skutočné zásielky a zásoby	Testovacie údaje oddelené od produkcie

Každá možnosť v dialógu zobrazuje aj adresu svojho portálu. Pripojenie zostáva v prostredí, v ktorom vzniklo. Ak chcete prejsť zo sandboxu do produkcie, pridajte nové pripojenie so zvoleným Production. Na testovanie môžete mať aj samostatnú aplikáciu JTL.

Zadajte client ID a secret bezpečne

• Client ID a client secret zadávajte iba do polí Client ID a Client secret v dialógu Connect JTL Fulfillment Network. Balta Labs ukladá secret zašifrovaný a už ho nikdy nezobrazí.
• Client secret nikdy neposielajte e-mailom, cez chat ani v požiadavke na podporu a nevkladajte ho do zdieľaných dokumentov. Podpora potrebuje iba client ID.
• Keď účet znova pripájate, môžete obe polia nechať prázdne, aby sa zachovali uložené prístupové údaje aplikácie.
• Ak mohol byť secret prezradený, vymeňte ho v JTL. Ak vám JTL jeho obnovenie nedovolí, vytvorte novú aplikáciu. Potom účet znova pripojte s novými hodnotami.

Ďalej pripojte JTL k hubu.