JTL-Verbindungsfehler beheben

Hinweis: Die fett gesetzten Bezeichnungen entsprechen der deutschen Oberfläche. Ist die App auf Englisch eingestellt, erscheinen sie auf Englisch.

Wird eine JTL-Autorisierung nicht abgeschlossen, zeigt der Hub eine Seite mit einem Titel sowie Was ist passiert und Was Sie tun können. Wählen Sie dort Anleitung zur Fehlerbehebung lesen, um den passenden Abschnitt unten zu öffnen, oder suchen Sie den Titel in der Tabelle. Ein fehlgeschlagener Versuch speichert nichts und lässt eine bestehende Verbindung unverändert. Sie können also jederzeit Erneut versuchen wählen.

Code	Titel auf dem Bildschirm	Bedeutung
callback_mismatch	JTL zeigt eine eigene Fehlerseite	Die Callback-URL in der JTL-App weicht von der im Hub ab.
invalid_client	JTL hat die App-Zugangsdaten nicht akzeptiert	JTL hat die Client-ID oder das Client-Secret abgelehnt.
missing_scope	Berechtigungen fehlen	Der App oder der Autorisierung fehlen die erforderlichen Scopes.
cancelled	Verbindung abgebrochen	Der Zugriff wurde bei JTL nicht bestätigt.
expired	Die Autorisierung ist abgelaufen	Der Versuch ist abgelaufen oder wurde in einem anderen Browser abgeschlossen.
account_mismatch	Ein anderes Konto wurde verwendet	Für das Neuverbinden wurde ein anderes JTL-Konto verwendet.
not_activated	Das JTL-Konto ist noch nicht bereit	Das Konto hat sich noch nicht im FFN-Portal angemeldet oder ist kein Händlerkonto.
permission_lost	Sie haben keinen Zugriff mehr	Sie haben während der Autorisierung die Berechtigung „Verbindungen“ verloren.
reconnect_required	Neu verbinden nötig, auf der Kontokarte	JTL akzeptiert die gespeicherte Autorisierung nicht mehr.
unavailable	JTL ist gerade nicht erreichbar	JTL oder das Netzwerk war nicht erreichbar.
failed	Die Verbindung konnte nicht abgeschlossen werden, oder Die Verbindung konnte nicht bestätigt werden	Ein unerwarteter Fehler, oder das Ergebnis konnte nicht bestätigt werden.

Die Adresszeile des Browsers zeigt außerdem nach outcome= den Code, den der Hub erhalten hat.

Angaben für den Support

Wenn Sie sich an den Support wenden, geben Sie diese Angaben an. Keine davon ist geheim:

• der Zeitpunkt des Versuchs mit Ihrer Zeitzone
• der Name des Workspace
• die Umgebung: Produktion oder Sandbox
• die Client-ID Ihrer JTL-App
• die im Dialog JTL Fulfillment Network verbinden angezeigte Callback-URL
• der angezeigte Titel oder der Code nach outcome= in der Adresszeile

Senden Sie niemals das Client-Secret, Ihr JTL-Passwort oder Tokens. Wenn Sie einen Screenshot anhängen, achten Sie darauf, dass keiner dieser Werte zu sehen ist.

Die Callback-URL stimmt nicht überein

Code: callback_mismatch

Was Sie sehen: JTL zeigt statt der Anmelde- oder Einwilligungsseite einen Fehler an, der oft die redirect URI erwähnt. Sie gelangen nicht zurück zum Hub. Je nachdem, wo JTL die Adresse prüft, zeigt der Hub stattdessen möglicherweise JTL hat die App-Zugangsdaten nicht akzeptiert.

Wahrscheinliche Ursache: Die in der JTL-App gespeicherte Redirect-URI entspricht nicht genau der Callback-URL im Dialog JTL Fulfillment Network verbinden. Typische Unterschiede sind ein fehlender oder zusätzlicher Schrägstrich am Ende, http statt https, Leerzeichen oder eine von anderer Stelle kopierte Adresse.

So gehen Sie vor:

1. Öffnen Sie in Balta Labs Einstellungen → Verbindungen, wählen Sie Add account und dann JTL FFN. Wählen Sie unter Bevor Sie fortfahren neben der Callback-URL Kopieren.
2. Öffnen Sie die App unter kundencenter.jtl-software.de/oauth, ersetzen Sie ihre Redirect-URI durch die kopierte Adresse und speichern Sie.
3. Kehren Sie zum Hub zurück und wählen Sie erneut Weiter zu JTL. Laden Sie die Fehlerseite von JTL nicht neu.

Für den Support: die oben genannten Angaben und der Text der JTL-Fehlermeldung.

JTL lehnt die Client-ID oder das Secret ab

Code: invalid_client

Was Sie sehen: Der Hub zeigt JTL hat die App-Zugangsdaten nicht akzeptiert. JTL zeigt möglicherweise auch schon vor der Anmeldung einen Fehler zum Client an.

Wahrscheinliche Ursache: Client-ID oder Client-Secret passen zu keiner App bei JTL. Die Werte sind möglicherweise falsch, unvollständig oder von Leerzeichen umgeben oder gehören zu einer anderen App, oder die App wurde gelöscht bzw. ihr Secret ersetzt. Eine Redirect-URI, die nicht genau mit der Callback-URL übereinstimmt, kann dieselbe Wirkung haben.

So gehen Sie vor:

1. Öffnen Sie die App unter kundencenter.jtl-software.de/oauth und kopieren Sie Client-ID und Client-Secret erneut.
2. Prüfen Sie, ob ihre Redirect-URI genau mit der Callback-URL im Hub übereinstimmt.
3. Öffnen Sie für eine neue Verbindung Einstellungen → Verbindungen → Add account → JTL FFN. Wählen Sie bei einer bestehenden Verbindung Neu verbinden auf ihrer Karte.
4. Geben Sie beide Werte ein und wählen Sie Weiter zu JTL, bei einer bestehenden Verbindung Mit JTL neu verbinden.
5. Lehnt JTL sie weiterhin ab, erstellen Sie eine neue App und verwenden Sie deren Werte.

Für den Support: die oben genannten Angaben. Prüfen Sie, ob die Client-ID, die Sie senden, mit der im JTL-Kundencenter übereinstimmt.

Erforderliche Scopes fehlen

Code: missing_scope

Was Sie sehen: Nachdem Sie den Zugriff bestätigt haben, zeigt der Hub Berechtigungen fehlen. Bei einem bestehenden Konto kann Testen aus demselben Grund mit Prüfung fehlgeschlagen enden.

Wahrscheinliche Ursache: Die JTL-App enthält nicht sowohl ffn.merchant.read als auch ffn.merchant.write, zum Beispiel weil eine Vorlage nur mit Fulfiller-Scopes gewählt wurde. Möglicherweise hat JTL auch weniger Zugriff gewährt als angefordert.

So gehen Sie vor:

1. Öffnen Sie die App unter kundencenter.jtl-software.de/oauth.
2. Aktivieren Sie beide Scopes. Wenn Sie die Scopes nicht ändern können, erstellen Sie eine neue App mit beiden Scopes.
3. Wählen Sie im Hub Erneut versuchen oder bei einer bestehenden Verbindung Neu verbinden. Geben Sie die neue Client-ID und das neue Secret ein, wenn Sie eine neue App erstellt haben.
4. Bestätigen Sie bei JTL alle angeforderten Berechtigungen.

Für den Support: die oben genannten Angaben und die Scopes, die JTL für die App auflistet.

Die Autorisierung wurde abgebrochen

Code: cancelled

Was Sie sehen: Der Hub zeigt Verbindung abgebrochen. Es wurde nichts geändert.

Wahrscheinliche Ursache: Der Zugriff wurde auf der Einwilligungsseite von JTL abgelehnt, oder JTL hat ohne Zugriffsfreigabe zurückgeleitet.

So gehen Sie vor:

1. Wählen Sie Erneut versuchen.
2. Melden Sie sich bei JTL an und bestätigen Sie den Zugriff.
3. Wenn Sie nicht abgelehnt haben und der Fehler erneut auftritt, wenden Sie sich an den Support.

Für den Support: die oben genannten Angaben und was Sie auf der Seite von JTL ausgewählt haben.

Die Autorisierung ist abgelaufen

Code: expired

Was Sie sehen: Der Hub zeigt Die Autorisierung ist abgelaufen.

Wahrscheinliche Ursache: Jeder Versuch gilt 10 Minuten und nur in dem Browser, in dem er gestartet wurde. Einer dieser Fälle ist eingetreten:

• Zwischen Weiter zu JTL und Ihrer Rückkehr zum Hub sind mehr als 10 Minuten vergangen.
• Die Anmeldung wurde in einem anderen Browser, Browserprofil oder auf einem anderen Gerät abgeschlossen als begonnen, oder der Browser hat das Cookie blockiert, das der Hub für den Versuch verwendet.
• Eine JTL-Seite wurde neu geladen oder aus dem Browserverlauf erneut geöffnet, sodass ein bereits verwendeter Versuch ein zweites Mal ankam.
• JTL hat den einmaligen Autorisierungscode nicht mehr akzeptiert.
• Während eines Neuverbindens wurde das Konto aus dem Workspace entfernt.

So gehen Sie vor:

1. Wählen Sie im selben Browser Erneut versuchen.
2. Schließen Sie die Anmeldung bei JTL innerhalb von 10 Minuten ab. Kopieren Sie die JTL-Adresse nicht in einen anderen Browser.
3. Tritt der Fehler weiterhin auf, erlauben Sie Cookies für Balta Labs oder versuchen Sie einen anderen Browser.

Für den Support: die oben genannten Angaben, Ihr Browser und die ungefähre Dauer der Anmeldung.

Ein anderes JTL-Konto wurde verwendet

Code: account_mismatch

Was Sie sehen: Beim Neuverbinden zeigt der Hub Ein anderes Konto wurde verwendet. Es wurde nichts geändert.

Wahrscheinliche Ursache: Sie haben sich bei JTL mit einem anderen als dem verbundenen Konto angemeldet, zum Beispiel mit dem Login eines Teammitglieds, einem Sandbox-Konto oder einem anderen Händlerkonto. Möglicherweise war Ihr Browser auch bereits mit einem anderen Konto bei JTL angemeldet.

So gehen Sie vor:

1. Wählen Sie Bearbeiten auf der Kontokarte, um zu sehen, welches JTL-Konto die Verbindung verwendet.
2. Melden Sie sich bei JTL ab. Alternativ öffnen Sie ein privates Browserfenster und melden sich dort bei Balta Labs an.
3. Wählen Sie Neu verbinden und melden Sie sich mit dem ursprünglichen JTL-Konto an.
4. Um stattdessen das andere JTL-Konto zu verwenden, fügen Sie es als neue Verbindung hinzu. Wählen Sie es dann in Fulfillment → Einrichtung als Anbieterkonto Ihrer Standorte aus.

Für den Support: die oben genannten Angaben, das unter Bearbeiten angezeigte JTL-Konto und der Name des JTL-Kontos, mit dem Sie sich angemeldet haben.

Das JTL-Konto ist nicht aktiviert

Code: not_activated

Was Sie sehen: Nachdem Sie den Zugriff bestätigt haben, zeigt der Hub Das JTL-Konto ist noch nicht bereit. Bei einem bestehenden Konto kann Testen mit Prüfung fehlgeschlagen und der Meldung enden, dass JTL FFN das Konto noch nicht kennt.

Wahrscheinliche Ursache: Die API von JTL antwortet mit not found, bis sich das Konto einmal im FFN-Portal angemeldet hat. Möglicherweise fehlt dem Konto auch die Rolle Merchant (Händler), zum Beispiel weil es ein Fulfiller-Konto ist. Auch die Umgebung kann die Ursache sein: Ein Produktionskonto muss sich im Produktionsportal anmelden, ein Sandbox-Konto im Sandbox-Portal.

So gehen Sie vor:

1. Melden Sie sich mit demselben JTL-Konto einmal unter fulfillment.jtl-software.com für die Produktion oder unter fulfillment-sandbox.jtl-software.com für die Sandbox an und schließen Sie die Händlereinrichtung ab.
2. Prüfen Sie, ob das Konto die Rolle Merchant hat. Fragen Sie im Zweifel den Kontoinhaber oder JTL.
3. Prüfen Sie, ob die im Hub gewählte Umgebung zu diesem Portal passt.
4. Wählen Sie Erneut versuchen.

Für den Support: die oben genannten Angaben und ob Sie sich im passenden FFN-Portal anmelden können.

Sie haben keine Berechtigung mehr

Code: permission_lost

Was Sie sehen: Sie haben den Zugriff bei JTL bestätigt, aber der Hub zeigt Sie haben keinen Zugriff mehr und hat nichts gespeichert.

Wahrscheinliche Ursache: Während Sie bei JTL waren, wurde Ihnen die Berechtigung Verbindungen in diesem Workspace entzogen, Ihre Rolle hat sich geändert oder Sie haben den Workspace verlassen. Der Hub prüft die Berechtigung vor dem Speichern erneut.

So gehen Sie vor:

1. Bitten Sie eine Workspace-Inhaberin oder einen Workspace-Inhaber, Ihnen unter Einstellungen → Team die Berechtigung Verbindungen zu erteilen.
2. Wählen Sie Erneut versuchen oder bitten Sie ein Teammitglied mit dieser Berechtigung, das Konto zu verbinden.

Für den Support: die oben genannten Angaben und Ihre Rolle im Workspace.

Das Konto muss neu verbunden werden

Code: reconnect_required

Was Sie sehen: Die Kontokarte zeigt Neu verbinden nötig, und Bearbeiten erklärt, dass JTL die gespeicherte Autorisierung nicht mehr akzeptiert. Fulfillment-Arbeit für dieses Konto schlägt fehl, bis Sie es neu verbinden.

Wahrscheinliche Ursache: JTL hat die Erneuerung des Zugriffs abgelehnt. Das passiert, wenn der Zugriff bei JTL widerrufen wurde, wenn die App gelöscht oder ihr Secret ersetzt wurde oder wenn die gespeicherte Autorisierung nicht mehr gültig ist.

So gehen Sie vor:

1. Wenn Sie bei JTL das Secret ersetzt oder eine neue App erstellt haben, halten Sie die neue Client-ID und das neue Secret bereit.
2. Öffnen Sie Einstellungen → Verbindungen und wählen Sie Neu verbinden auf der Kontokarte.
3. Lassen Sie Client-ID und Client-Secret leer, um die gespeicherten App-Zugangsdaten zu behalten, oder geben Sie die neuen Werte ein.
4. Wählen Sie Mit JTL neu verbinden und melden Sie sich mit demselben JTL-Konto an.
5. Wählen Sie Testen. Sobald die Karte Funktioniert zeigt, öffnen Sie Fulfillment → Betrieb und wiederholen Sie die Einträge unter Fehlgeschlagen. Für das Wiederholen benötigen Sie die Berechtigung Fulfillment-Betrieb.

Für den Support: die oben genannten Angaben, wann der Status zuerst erschien und ob die App bei JTL geändert wurde.

JTL oder das Netzwerk ist nicht erreichbar

Code: unavailable

Was Sie sehen: Der Hub zeigt JTL ist gerade nicht erreichbar. Bei einem bestehenden Konto kann Testen mit Prüfung fehlgeschlagen und einer ähnlichen Meldung enden.

Wahrscheinliche Ursache: Der Dienst von JTL ist ausgefallen oder wird gewartet, oder bei der Verbindung zwischen dem Hub und JTL ist eine Zeitüberschreitung aufgetreten.

So gehen Sie vor:

1. Warten Sie einige Minuten. Es wurde nichts geändert, ein erneuter Versuch ist also unbedenklich.
2. Wählen Sie Erneut versuchen oder bei einem bestehenden Konto Testen.
3. Dauert das Problem länger als eine Stunde, prüfen Sie, ob Sie das FFN-Portal öffnen können, und wenden Sie sich dann an den Support.

Für den Support: die oben genannten Angaben und wie lange das Problem bereits besteht.

Ein anderer Fehler hat die Verbindung abgebrochen

Code: failed

Was Sie sehen: Der Hub zeigt Die Verbindung konnte nicht abgeschlossen werden. Dieser Abschnitt gilt auch für Die Verbindung konnte nicht bestätigt werden. Diese Meldung erscheint, wenn JTL Erfolg gemeldet hat, das Konto aber in dem geöffneten Workspace nicht aufgeführt ist.

Wahrscheinliche Ursache: JTL hat eine unerwartete Antwort geliefert, zum Beispiel keine Kontodaten, oder beim Speichern ist ein unerwarteter Fehler aufgetreten. Konnte der Hub die Verbindung nicht bestätigen, gehört das Konto möglicherweise zu einem Workspace, den Sie mit diesem Login nicht öffnen können, oder die Verbindungsliste konnte nicht geladen werden.

So gehen Sie vor:

1. Wenn die Seite Erneut prüfen anbietet, wählen Sie diese Option.
2. Öffnen Sie Einstellungen → Verbindungen in dem Workspace, in dem Sie begonnen haben, und prüfen Sie, ob das Konto aufgeführt ist.
3. Ist es nicht aufgeführt, wählen Sie einmal Erneut versuchen.
4. Schlägt der Versuch erneut fehl, wenden Sie sich an den Support.

Für den Support: die oben genannten Angaben mit dem genauen Zeitpunkt jedes Versuchs, damit der Support die Versuche finden kann.

Meldungen im Dialog „JTL Fulfillment Network verbinden“

Manche Probleme treten auf, bevor Sie den Hub verlassen:

• JTL-Verbindungen sind auf diesem Server noch nicht verfügbar. Balta Labs kann keine Callback-URL anbieten. Wenden Sie sich an den Support.
• Die JTL-Einstellungen konnten nicht geladen werden. Wählen Sie Erneut versuchen. Schlägt das Laden weiterhin fehl, wenden Sie sich an den Support.
• Die Autorisierung konnte nicht gestartet werden. Darunter steht der Grund, zum Beispiel dass Client-ID und Client-Secret fehlen. Eine neue Verbindung benötigt beide; beim Neuverbinden behalten leere Felder die gespeicherten App-Zugangsdaten.
• Beim Neuverbinden bleibt die Umgebung des Kontos erhalten. Sie können dabei nicht zwischen Produktion und Sandbox wechseln. Fügen Sie für die andere Umgebung eine neue Verbindung hinzu.