Utwórz aplikację JTL

Uwaga: interfejs aplikacji jest obecnie dostępny po angielsku, niemiecku i włosku. W tej instrukcji pogrubione nazwy przycisków i menu podajemy po angielsku.

Balta Labs łączy się z JTL Fulfillment Network (JTL FFN) przez aplikację, którą samodzielnie rejestrujesz w JTL. JTL nazywa ją klientem OAuth. Po utworzeniu aplikacji otrzymujesz client ID i client secret. Obie wartości wpisujesz w Balta Labs, a następnie zatwierdzasz dostęp w JTL, jak opisano w instrukcji Połącz JTL z hubem.

JTL opisuje te kroki w sekcji Getting started dokumentacji Merchant API. Ekrany JTL mogą się zmieniać. Jeśli jakaś etykieta różni się od podanej w tej instrukcji, kieruj się aktualnym nazewnictwem JTL.

Zanim zaczniesz

• Konto w JTL Customer Center. W nim utworzysz aplikację.
• Konto JTL z rolą Merchant w JTL FFN. Na to konto logujesz się podczas łączenia. JTL udostępnia API potrzebne Balta Labs tylko użytkownikom z rolą Merchant.
• Jednokrotne zalogowanie się tym kontem do portalu FFN. Użyj fulfillment.jtl-software.com dla środowiska produkcyjnego lub fulfillment-sandbox.jtl-software.com dla środowiska sandbox. JTL tworzy użytkownika API przy pierwszym logowaniu. Do tego czasu JTL odpowiada not found, a Balta Labs zgłasza, że konto JTL nie jest jeszcze gotowe.
• Uprawnienie Connections w obszarze roboczym Balta Labs. Potrzebujesz go, aby otworzyć okno połączenia i skopiować adres callback.

Skopiuj adres callback z Balta Labs

Po zatwierdzeniu dostępu JTL przekierowuje przeglądarkę z powrotem do Balta Labs przez adres callback aplikacji. Musi on być dokładnie taki sam jak adres wyświetlany w Balta Labs.

1. W Balta Labs otwórz Settings → Connections, wybierz Add account, a następnie JTL FFN. Możesz też wybrać Add provider w sekcji Fulfillment & notifications. Otworzy się okno Connect JTL Fulfillment Network.
2. W sekcji Before you continue znajdź adres callback i wybierz Copy. Adres wygląda podobnie do https://api.example.com/connections/oauth/jtl_ffn/callback. Zawsze używaj adresu z okna w Balta Labs, a nie tego przykładu.
3. Nie zamykaj okna podczas tworzenia aplikacji. Zawiera ono też listę zakresów do zaznaczenia i link do tej instrukcji.

Nie przepisuj adresu ręcznie. Inny znak, http zamiast https, dodatkowy ukośnik na końcu lub spacja powodują niezgodność adresu callback. Jeśli okno wyświetla komunikat JTL connections are not available on this server yet, Balta Labs nie może udostępnić adresu callback. Skontaktuj się z zespołem wsparcia Balta Labs.

Utwórz aplikację w JTL

1. Otwórz kundencenter.jtl-software.de/oauth i zaloguj się. Link Open the JTL Customer Center w oknie prowadzi do tej samej strony. Menu JTL Customer Center nie zawiera linku do tej strony, dlatego otwórz ten adres bezpośrednio.
2. Utwórz nowego klienta OAuth.
3. Jeśli JTL poprosi o nazwę, podaj taką, którą później łatwo rozpoznasz, np. Balta Labs.
4. Zaznacz zakresy (scopes) ffn.merchant.read i ffn.merchant.write. JTL może oferować zakresy w formie szablonów; wybierz szablon, który zawiera oba. Same zakresy dla fulfillerów nie wystarczą.
5. Wklej adres callback z Balta Labs jako redirect URI aplikacji. JTL może też nazywać to pole callback URI.
6. Zapisz klienta.
7. Skopiuj client ID i client secret, które JTL wyświetla dla tego klienta.

Zakres	Opis w JTL	Do czego służy w Balta Labs
ffn.merchant.read	Pełny dostęp do odczytu w Merchant API	Odczyt konta, magazynów, metod wysyłki, produktów, zapasów i aktualizacji przesyłek
ffn.merchant.write	Pełny dostęp do zapisu w Merchant API	Tworzenie przesyłek, produktów i dostaw przychodzących, tylko w procesach ustawionych jako aktywne

Środowisko produkcyjne i sandbox

JTL udostępnia system produkcyjny i osobny sandbox do testów. Według JTL jeden klient OAuth działa w obu środowiskach, a adres callback jest taki sam. Różnią się natomiast konto, na które się logujesz, oraz portal, w którym to konto musi się wcześniej raz zalogować.

	Produkcja	Sandbox
Portal FFN do pierwszego logowania	fulfillment.jtl-software.com	fulfillment-sandbox.jtl-software.com
Konto JTL	Produkcyjne konto sprzedawcy	Konto sandbox
Opcja w sekcji Environment w oknie	Production	Sandbox
Dane	Rzeczywiste przesyłki i zapasy	Dane testowe, oddzielone od produkcji

Każda opcja w oknie pokazuje też adres swojego portalu. Połączenie pozostaje w środowisku, w którym zostało utworzone. Aby przejść ze środowiska sandbox do produkcyjnego, dodaj nowe połączenie z wybraną opcją Production. Możesz też utrzymywać osobną aplikację JTL do testów.

Bezpiecznie wprowadź client ID i client secret

• Wpisuj client ID i client secret tylko w polach Client ID i Client secret okna Connect JTL Fulfillment Network. Balta Labs przechowuje client secret w postaci zaszyfrowanej i nigdy nie wyświetla go ponownie.
• Nigdy nie wysyłaj wartości client secret e-mailem, na czacie ani w zgłoszeniu do zespołu wsparcia i nie wklejaj jej do udostępnianych dokumentów. Zespołowi wsparcia wystarczy client ID.
• Gdy ponownie łączysz konto, możesz pozostawić oba pola puste, aby zachować zapisane dane aplikacji.
• Jeśli client secret mógł zostać ujawniony, wymień go w JTL. Jeśli JTL nie pozwala go odnowić, utwórz nową aplikację. Następnie ponownie połącz konto z nowymi wartościami.

Następnie połącz JTL z hubem.