Napraw błędy połączenia 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.

Jeśli autoryzacja JTL nie zostanie dokończona, hub wyświetli stronę z tytułem oraz sekcjami What happened i What to do. Wybierz na tej stronie Read the troubleshooting guide, aby otworzyć odpowiednią sekcję poniżej, lub znajdź tytuł w tabeli. Nieudana próba niczego nie zapisuje i pozostawia istniejące połączenie bez zmian, więc zawsze możesz wybrać Try again.

Kod	Tytuł na ekranie	Znaczenie
callback_mismatch	JTL wyświetla własną stronę błędu	Adres callback w aplikacji JTL różni się od adresu w hubie.
invalid_client	JTL did not accept the app credentials	JTL odrzuca client ID lub client secret.
missing_scope	Permissions are missing	Aplikacji lub autoryzacji brakuje wymaganych zakresów.
cancelled	Connection cancelled	Dostęp nie został zatwierdzony w JTL.
expired	The authorization expired	Próba wygasła lub została dokończona w innej przeglądarce.
account_mismatch	A different account was used	Do ponownego połączenia użyto innego konta JTL.
not_activated	The JTL account is not ready yet	Konto nie zalogowało się jeszcze do portalu FFN lub nie jest kontem sprzedawcy.
permission_lost	You no longer have access	Podczas autoryzacji utracono uprawnienie Connections.
reconnect_required	Reconnect needed, na karcie konta	JTL nie akceptuje już zapisanej autoryzacji.
unavailable	JTL is not reachable right now	Nie udało się połączyć z JTL lub sieć była niedostępna.
failed	The connection could not be completed lub We could not confirm the connection	Nieoczekiwany błąd lub nie udało się potwierdzić wyniku.

Pasek adresu przeglądarki pokazuje też kod otrzymany przez hub, po outcome=.

Informacje dla zespołu wsparcia

Kontaktując się z zespołem wsparcia, podaj poniższe informacje. Żadna z nich nie jest poufna:

• czas próby wraz ze strefą czasową
• nazwę obszaru roboczego
• środowisko: Production lub Sandbox
• client ID aplikacji JTL
• adres callback widoczny w oknie Connect JTL Fulfillment Network
• tytuł widoczny na ekranie lub kod po outcome= na pasku adresu

Nigdy nie wysyłaj wartości client secret, hasła do JTL ani tokenów. Jeśli dołączasz zrzut ekranu, upewnij się, że nie widać na nim żadnej z tych wartości.

Adres callback się nie zgadza

Kod: callback_mismatch

Co widzisz: JTL zamiast strony logowania lub zgody wyświetla błąd, często z informacją o redirect URI. Nie wracasz do hubu. W zależności od tego, gdzie JTL sprawdza adres, hub może zamiast tego pokazać JTL did not accept the app credentials.

Prawdopodobna przyczyna: Redirect URI zapisany w aplikacji JTL nie jest dokładnie taki sam jak adres callback widoczny w oknie Connect JTL Fulfillment Network. Typowe różnice to brakujący lub dodatkowy ukośnik na końcu, http zamiast https, spacje albo adres skopiowany z innego miejsca.

Co zrobić:

1. W Balta Labs otwórz Settings → Connections, wybierz Add account, a następnie JTL FFN. W sekcji Before you continue wybierz Copy obok adresu callback.
2. Otwórz aplikację w kundencenter.jtl-software.de/oauth, zastąp jej redirect URI skopiowanym adresem i zapisz.
3. Wróć do hubu i ponownie wybierz Continue to JTL. Nie odświeżaj strony błędu JTL.

Dla zespołu wsparcia: informacje wymienione wyżej oraz treść błędu JTL.

JTL odrzuca client ID lub client secret

Kod: invalid_client

Co widzisz: Hub pokazuje JTL did not accept the app credentials. JTL może też wyświetlić błąd dotyczący klienta jeszcze przed logowaniem.

Prawdopodobna przyczyna: Client ID lub client secret nie pasuje do żadnej aplikacji w JTL. Wartość może być błędna, niekompletna, otoczona spacjami lub należeć do innej aplikacji. Możliwe też, że aplikacja została usunięta albo jej client secret wymieniony. Ten sam skutek może mieć redirect URI, który nie jest dokładnie taki sam jak adres callback.

Co zrobić:

1. Otwórz aplikację w kundencenter.jtl-software.de/oauth i ponownie skopiuj jej client ID i client secret.
2. Sprawdź, czy jej redirect URI jest dokładnie taki sam jak adres callback w hubie.
3. W przypadku nowego połączenia otwórz Settings → Connections → Add account → JTL FFN. W przypadku istniejącego wybierz Reconnect na jego karcie.
4. Wpisz obie wartości i wybierz Continue to JTL lub, w przypadku istniejącego połączenia, Reconnect with JTL.
5. Jeśli JTL nadal je odrzuca, utwórz nową aplikację i użyj jej wartości.

Dla zespołu wsparcia: informacje wymienione wyżej. Sprawdź, czy przesyłany client ID zgadza się z tym w JTL Customer Center.

Brakuje wymaganych zakresów

Kod: missing_scope

Co widzisz: Po zatwierdzeniu dostępu hub pokazuje Permissions are missing. W przypadku istniejącego konta Test może z tego samego powodu zakończyć się stanem Check failed.

Prawdopodobna przyczyna: Aplikacja JTL nie zawiera obu zakresów ffn.merchant.read i ffn.merchant.write, na przykład dlatego, że wybrano szablon zawierający tylko zakresy dla fulfillerów. Możliwe też, że przyznany przez JTL dostęp jest mniejszy niż żądany.

Co zrobić:

1. Otwórz aplikację w kundencenter.jtl-software.de/oauth.
2. Zaznacz oba zakresy. Jeśli nie możesz ich zmienić, utwórz nową aplikację z obydwoma zakresami.
3. W hubie wybierz Try again lub Reconnect przy istniejącym połączeniu. Jeśli powstała nowa aplikacja, wpisz jej client ID i client secret.
4. W JTL zatwierdź wszystkie żądane uprawnienia.

Dla zespołu wsparcia: informacje wymienione wyżej oraz zakresy, które JTL wyświetla dla aplikacji.

Autoryzacja została anulowana

Kod: cancelled

Co widzisz: Hub pokazuje Connection cancelled. Nic nie zostało zmienione.

Prawdopodobna przyczyna: Dostęp został odrzucony na stronie zgody JTL albo nastąpił powrót z JTL bez przyznania dostępu.

Co zrobić:

1. Wybierz Try again.
2. Zaloguj się w JTL i zatwierdź dostęp.
3. Jeśli dostęp nie został odrzucony, a problem się powtarza, skontaktuj się z zespołem wsparcia.

Dla zespołu wsparcia: informacje wymienione wyżej oraz to, co zostało wybrane na stronie JTL.

Autoryzacja wygasła

Kod: expired

Co widzisz: Hub pokazuje The authorization expired.

Prawdopodobna przyczyna: Każda próba jest ważna przez 10 minut i tylko w przeglądarce, w której się rozpoczęła. Nastąpiła jedna z poniższych sytuacji:

• Od wybrania Continue to JTL do powrotu do hubu minęło ponad 10 minut.
• Logowanie rozpoczęło się i zakończyło w różnych przeglądarkach, profilach przeglądarki lub na różnych urządzeniach albo przeglądarka zablokowała plik cookie, którego hub używa do obsługi próby.
• Strona JTL została odświeżona lub ponownie otwarta z historii przeglądarki, przez co wykorzystana już próba dotarła po raz drugi.
• Jednorazowy kod autoryzacji JTL nie był już akceptowany.
• Podczas ponownego łączenia konto zostało usunięte z obszaru roboczego.

Co zrobić:

1. Wybierz Try again w tej samej przeglądarce.
2. Dokończ logowanie w JTL w ciągu 10 minut. Nie kopiuj adresu strony JTL do innej przeglądarki.
3. Jeśli problem się powtarza, zezwól na pliki cookie dla Balta Labs lub spróbuj innej przeglądarki.

Dla zespołu wsparcia: informacje wymienione wyżej, używana przeglądarka i przybliżony czas trwania logowania.

Użyto innego konta JTL

Kod: account_mismatch

Co widzisz: Podczas ponownego łączenia hub pokazuje A different account was used. Nic nie zostało zmienione.

Prawdopodobna przyczyna: W JTL użyto innego konta niż połączone, na przykład loginu współpracownika, konta sandbox lub innego konta sprzedawcy. Możliwe też, że przeglądarka była już zalogowana w JTL na inne konto.

Co zrobić:

1. Wybierz Edit na karcie konta. Pole JTL account pokazuje, którego konta JTL używa połączenie.
2. Wyloguj się z JTL. Możesz też otworzyć prywatne okno przeglądarki i zalogować się w nim do Balta Labs.
3. Wybierz Reconnect i zaloguj się na pierwotne konto JTL.
4. Aby zamiast tego użyć drugiego konta JTL, dodaj je jako nowe połączenie. Następnie wybierz je w polu Provider account lokalizacji w Fulfillment → Setup.

Dla zespołu wsparcia: informacje wymienione wyżej, wartość JTL account widoczna w Edit oraz nazwa konta JTL użytego do logowania.

Konto JTL nie jest aktywowane

Kod: not_activated

Co widzisz: Po zatwierdzeniu dostępu hub pokazuje The JTL account is not ready yet. W przypadku istniejącego konta Test może zakończyć się stanem Check failed z komunikatem, że JTL FFN jeszcze nie zna tego konta.

Prawdopodobna przyczyna: API JTL odpowiada not found, dopóki konto nie zaloguje się raz do portalu FFN. Konto może też nie mieć roli Merchant, na przykład dlatego, że jest kontem fulfillera. Przyczyną może być również środowisko: konto produkcyjne musi zalogować się do portalu produkcyjnego, a konto sandbox do portalu sandbox.

Co zrobić:

1. Tym samym kontem JTL zaloguj się raz na stronie fulfillment.jtl-software.com dla środowiska produkcyjnego lub fulfillment-sandbox.jtl-software.com dla środowiska sandbox i dokończ konfigurację konta sprzedawcy.
2. Sprawdź, czy konto ma rolę Merchant. Jeśli nie masz pewności, zapytaj właściciela konta lub JTL.
3. Sprawdź, czy ustawienie Environment wybrane w hubie odpowiada temu portalowi.
4. Wybierz Try again.

Dla zespołu wsparcia: informacje wymienione wyżej oraz informacja, czy możesz zalogować się do odpowiedniego portalu FFN.

Nie masz już uprawnienia

Kod: permission_lost

Co widzisz: Dostęp w JTL został zatwierdzony, ale hub pokazuje You no longer have access, a nic nie zostało zapisane.

Prawdopodobna przyczyna: W trakcie autoryzacji w JTL odebrano uprawnienie Connections w tym obszarze roboczym, zmieniono rolę albo nie należysz już do tego obszaru roboczego. Przed zapisaniem hub ponownie sprawdza uprawnienie.

Co zrobić:

1. Poproś właściciela obszaru roboczego o nadanie uprawnienia Connections w Settings → Team.
2. Wybierz Try again lub poproś współpracownika z tym uprawnieniem o połączenie konta.

Dla zespołu wsparcia: informacje wymienione wyżej oraz rola, którą masz w obszarze roboczym.

Konto wymaga ponownego połączenia

Kod: reconnect_required

Co widzisz: Karta konta pokazuje Reconnect needed, a Edit wyjaśnia, że JTL nie akceptuje już zapisanej autoryzacji. Do czasu ponownego połączenia zadania fulfillmentu dla tego konta kończą się błędem.

Prawdopodobna przyczyna: JTL odmawia odnowienia dostępu. Dzieje się tak, gdy dostęp został cofnięty w JTL, aplikacja została usunięta lub jej client secret wymieniony albo gdy zapisana autoryzacja nie jest już ważna.

Co zrobić:

1. Jeśli client secret został wymieniony lub w JTL powstała nowa aplikacja, przygotuj nowy client ID i client secret.
2. Otwórz Settings → Connections i wybierz Reconnect na karcie konta.
3. Pozostaw pola Client ID i Client secret puste, aby zachować zapisane dane aplikacji, lub wpisz nowe wartości.
4. Wybierz Reconnect with JTL i zaloguj się na to samo konto JTL.
5. Wybierz Test. Gdy karta pokaże Working, otwórz Fulfillment → Operations i ponów pozycje w sekcji Failed. Ponowienie wymaga uprawnienia Fulfillment operations.

Dla zespołu wsparcia: informacje wymienione wyżej, moment pierwszego pojawienia się tego statusu oraz informacja, czy aplikacja została zmieniona w JTL.

JTL lub sieć są niedostępne

Kod: unavailable

Co widzisz: Hub pokazuje JTL is not reachable right now. W przypadku istniejącego konta Test może zakończyć się stanem Check failed z podobnym komunikatem.

Prawdopodobna przyczyna: Usługa JTL nie działa lub trwają prace serwisowe albo upłynął limit czasu połączenia między hubem a JTL.

Co zrobić:

1. Odczekaj kilka minut. Nic nie zostało zmienione, więc ponowna próba jest bezpieczna.
2. Wybierz Try again lub Test przy istniejącym koncie.
3. Jeśli problem trwa dłużej niż godzinę, sprawdź, czy możesz otworzyć portal FFN, a następnie skontaktuj się z zespołem wsparcia.

Dla zespołu wsparcia: informacje wymienione wyżej oraz czas trwania problemu.

Inny błąd przerwał tworzenie połączenia

Kod: failed

Co widzisz: Hub pokazuje The connection could not be completed. Ta sekcja dotyczy też komunikatu We could not confirm the connection, który pojawia się, gdy JTL zgłasza powodzenie, ale konta nie ma na liście w otwartym obszarze roboczym.

Prawdopodobna przyczyna: Odpowiedź JTL była nieoczekiwana, na przykład nie zawierała danych konta, albo podczas zapisywania wystąpił nieoczekiwany błąd. Jeśli hub nie mógł potwierdzić połączenia, konto może należeć do obszaru roboczego, którego nie możesz otworzyć przy użyciu tego loginu, albo nie udało się wczytać listy połączeń.

Co zrobić:

1. Jeśli ekran oferuje Check again, wybierz tę opcję.
2. Otwórz Settings → Connections w obszarze roboczym, w którym rozpoczęła się autoryzacja, i sprawdź, czy konto jest na liście.
3. Jeśli konta nie ma, wybierz raz Try again.
4. Jeśli ponownie się nie powiedzie, skontaktuj się z zespołem wsparcia.

Dla zespołu wsparcia: informacje wymienione wyżej wraz z dokładnym czasem każdej próby, aby zespół wsparcia mógł je odnaleźć.

Komunikaty w oknie Connect JTL Fulfillment Network

Niektóre problemy pojawiają się jeszcze przed opuszczeniem hubu:

• JTL connections are not available on this server yet. Balta Labs nie może udostępnić adresu callback. Skontaktuj się z zespołem wsparcia.
• The JTL settings could not be loaded. Wybierz Try again. Jeśli błąd się powtarza, skontaktuj się z zespołem wsparcia.
• The authorization could not be started. Pod komunikatem pojawia się przyczyna, np. brak client ID i client secret. Nowe połączenie wymaga obu wartości; przy ponownym łączeniu puste pola zachowują zapisane dane aplikacji.
• A reconnect stays in the account’s environment. Przy ponownym łączeniu nie można przełączyć się między środowiskiem produkcyjnym a sandbox. Dla drugiego środowiska dodaj nowe połączenie.