Połącz JTL z hubem

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.

Połączenie JTL Fulfillment Network (JTL FFN) pozwala hubowi, czyli Balta Labs, przekazywać przesyłki do fulfillera w sieci JTL oraz pobierać informacje o śledzeniu przesyłek, produktach i zapasach. Samo połączenie konta niczego nie wysyła. Przekazywanie przesyłek rozpoczyna się dopiero wtedy, gdy w Fulfillment → Setup dodasz lokalizację i przełączysz jej procesy na Active.

Zanim zaczniesz

• Utwórz aplikację JTL i przygotuj jej client ID oraz client secret. Zobacz instrukcję Utwórz aplikację JTL.
• Użyj konta JTL z rolą Merchant, które już raz zalogowało się do portalu FFN.
• Połącz weclapp. Stamtąd pochodzą zamówienia i przesyłki. Zobacz instrukcję Połącz weclapp.
• Potrzebujesz uprawnienia Connections w obszarze roboczym oraz uprawnienia Fulfillment do konfiguracji.

Autoryzuj konto

1. Otwórz Settings → Connections, wybierz Add account, a następnie JTL FFN. Możesz też wybrać Add provider w sekcji Fulfillment & notifications.
2. W oknie Connect JTL Fulfillment Network sprawdź w sekcji Before you continue, czy adres callback jest taki sam jak zapisany w aplikacji JTL.
3. W sekcji Environment wybierz Production dla konta produkcyjnego lub Sandbox dla systemu testowego JTL.
4. Wpisz Client ID i Client secret aplikacji JTL.
5. Opcjonalnie wpisz nazwę w polu Connection name. Bez niej hub użyje nazwy konta JTL.
6. Wybierz Continue to JTL.
7. Zaloguj się w JTL na konto sprzedawcy, które chcesz połączyć.
8. Sprawdź żądany dostęp i zatwierdź go.
9. JTL przekieruje przeglądarkę z powrotem do Balta Labs, gdzie zobaczysz potwierdzenie wyniku.

Dokończ autoryzację bez dłuższej przerwy. Każda próba jest ważna przez 10 minut i tylko w przeglądarce, w której się rozpoczęła. Jeśli wygaśnie, zacznij ponownie od kroku 1.

Wybierz właściwe konto JTL

Balta Labs łączy konto, na które logujesz się w JTL. Nie musi to być konto, do którego należy aplikacja. Jeśli przeglądarka jest już zalogowana w JTL, JTL może użyć tej sesji. Jeśli to nie jest konto sprzedawcy, które chcesz połączyć, najpierw wyloguj się z JTL i zacznij od nowa.

Balta Labs utrzymuje jedno połączenie na każde konto JTL w danym środowisku. Autoryzacja konta, które jest już połączone, aktualizuje jego połączenie zamiast tworzyć duplikat. Aby połączyć kolejne konto sprzedawcy, ponownie wybierz Add account.

Ekran potwierdzenia

Gdy konto zostanie zapisane i zweryfikowane, Balta Labs wyświetli komunikat JTL connected successfully! z polami Account, Connection i Environment. Sprawdź, czy połączono właściwe konto.

Następnie rozpoczyna się odliczanie, a po pięciu sekundach otwiera się konfiguracja fulfillmentu. Wybierz Continue now, aby przejść od razu, lub Stay here, aby zatrzymać odliczanie. Po ponownym połączeniu ekran pokazuje JTL reconnected successfully! i zamiast tego prowadzi z powrotem do połączenia.

Jeśli autoryzacja nie została zakończona, ekran pokazuje tytuł, np. Permissions are missing, a pod nim sekcje What happened i What to do. Wybierz Try again, aby zacząć od nowa, lub Read the troubleshooting guide, aby otworzyć odpowiednią sekcję instrukcji Napraw błędy połączenia JTL.

Sprawdź połączenie

W Settings → Connections konto pojawia się w sekcji Fulfillment & notifications. Jego karta pokazuje stan połączenia i czas ostatniego sprawdzenia:

• Not checked: od dodania lub zmiany konta nie przeprowadzono żadnego testu.
• Working: ostatni test lub żądanie do JTL zakończyło się powodzeniem.
• Check failed: ostatni test lub żądanie zakończyło się błędem. Karta pokazuje komunikat JTL. Autoryzacja zostaje zachowana; usuń przyczynę i ponów test.
• Reconnect needed: JTL nie akceptuje już autoryzacji. Połącz konto ponownie w sposób opisany poniżej.

Wybierz Test, aby od razu sprawdzić konto. Test tylko odczytuje dane z JTL. Wybierz Details, aby zobaczyć sekcje Account, What the hub can do oraz Reference lists z listami Warehouses i Shipping methods: każda pozycja ma swój identyfikator, a kolumna Fulfiller pokazuje, do którego fulfillera należy. Okno lokalizacji oferuje te same opcje. Edit pokazuje konto JTL, jego środowisko, client ID aplikacji i czas autoryzacji. Tam możesz też zmienić nazwę połączenia.

Karta przypomina też, że konto nie jest używane do przesyłek, dopóki żadna lokalizacja nie zostanie włączona, i zawiera link Open fulfillment setup.

Skonfiguruj lokalizację

Lokalizacja to magazyn weclapp obsługiwany przez konto dostawcy usług fulfillmentu. Dodaj ją dla każdego magazynu obsługiwanego przez JTL:

1. Otwórz Fulfillment → Setup. Jeśli strona pokazuje Start with weclapp, wskaż połączenie w polu weclapp connection i wybierz Save and continue.
2. W sekcji Locations wybierz Add location.
3. Wpisz nazwę w polu Name.
4. W polu weclapp warehouse wybierz magazyn, którego przesyłki obsługuje JTL, lub wpisz jego ID.
5. W polu Provider account wybierz konto JTL. Okno wczyta wtedy opcje tego konta.
6. W polu Warehouse at JTL wybierz magazyn. Spowoduje to wypełnienie pól Fulfiller ID i Fulfiller warehouse ID; oba można nadal edytować. Jeśli okno pokaże komunikat The account’s choices could not be loaded. Enter the IDs instead., wpisz oba identyfikatory samodzielnie albo wybierz Test na karcie konta, aby sprawdzić przyczynę.
7. W sekcji Shipping methods wybierz Add carrier dla każdego przewoźnika z weclapp i wybierz jego FFN shipping method ID z podpowiedzi. Podpowiedzi obejmują tylko metody wysyłki tego fulfillera i pokazują nazwę metody pod jej identyfikatorem. Przesyłka, której przewoźnik nie ma przypisania, trafia do JTL ze standardowym typem wysyłki, a hub zapisuje ostrzeżenie.
8. Wybierz Save location.
9. W sekcji Sync wybierz Start syncing, jeśli synchronizacja jeszcze nie działa.

W nowej lokalizacji każdy proces ma początkowo tryb Off. Lokalizacja JTL ma następujące procesy:

• Dispatch: przekazuje zwolnione przesyłki do JTL.
• Tracking: zapisuje numery śledzenia przesyłek w weclapp.
• Catalog: przesyła do JTL artykuły, zdjęcia i autoryzacje produktów.
• Stock check: porównuje zapasy w weclapp z JTL.
• Inbound: awizuje w JTL nadchodzące dostawy.

Każdy proces ma jeden z trzech trybów:

• Off: nic się nie dzieje.
• Shadow: hub podejmuje decyzje i rejestruje, co zostałoby wykonane. Niczego nie zapisuje w JTL ani w weclapp i nie wysyła powiadomień.
• Active: hub wykonuje zadania.

Skonfiguruj procesy w Fulfillment → Setup. Sprawdź decyzje w Shadow, a następnie włącz Active. Zmiana na Active lub z Active wymaga potwierdzenia. Zobacz Łączenie operatorów fulfillment.

Połącz konto ponownie

Połącz konto ponownie, gdy karta pokazuje Reconnect needed albo gdy client secret aplikacji został wymieniony w JTL.

1. Otwórz Settings → Connections i znajdź konto w sekcji Fulfillment & notifications.
2. Wybierz Reconnect na jego karcie.
3. Pozostaw pola Client ID i Client secret puste, aby zachować zapisane dane aplikacji, lub wpisz nowe.
4. Wybierz Reconnect with JTL.
5. Zaloguj się na to samo konto JTL co wcześniej i zatwierdź dostęp.
6. Na ekranie JTL reconnected successfully! sprawdź konto. Następnie wybierz Test na karcie.

Ponowne połączenie pozostaje w środowisku konta. Jeśli zalogujesz się na inne konto JTL, hub pokaże A different account was used i pozostawi połączenie bez zmian. Aby połączyć inne konto, dodaj je jako nowe połączenie.

Jak dostęp pozostaje ważny

Tokeny dostępu JTL są ważne przez około 30 minut. Hub odnawia je automatycznie, a każde odnowienie zastępuje token odświeżania. Nie musisz nic robić. Jeśli JTL odmawia odnowienia, na przykład z powodu cofnięcia dostępu, karta pokazuje Reconnect needed, a hub nie może korzystać z konta, dopóki nie połączysz go ponownie. Następnie sprawdź w Fulfillment → Operations, które pozycje zakończyły się w tym czasie błędem.