JTL mit dem Hub verbinden

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

Mit einer Verbindung zum JTL Fulfillment Network (JTL FFN) kann der Hub, Balta Labs, Lieferungen an Ihren JTL-Fulfiller übergeben und Sendungsverfolgung, Artikel- und Bestandsdaten zurücklesen. Durch das Verbinden des Kontos wird noch nichts versendet. Der Versand beginnt erst, wenn Sie in Fulfillment → Einrichtung einen Standort hinzufügen und seine Abläufe auf Aktiv stellen.

Vorbereitung

• Erstellen Sie eine JTL-App und halten Sie deren Client-ID und Client-Secret bereit. Siehe JTL-App erstellen.
• Verwenden Sie ein JTL-Konto mit der Rolle Merchant (Händler), das sich bereits einmal im FFN-Portal angemeldet hat.
• Verbinden Sie weclapp. Von dort kommen die Bestellungen und Lieferungen. Siehe weclapp verbinden.
• Sie benötigen im Workspace die Berechtigung Verbindungen und für die Einrichtung die Berechtigung Fulfillment.

Konto autorisieren

1. Öffnen Sie Einstellungen → Verbindungen, wählen Sie Add account und dann JTL FFN. Alternativ wählen Sie Anbieter hinzufügen im Bereich Fulfillment-Anbieter.
2. Prüfen Sie im Dialog JTL Fulfillment Network verbinden unter Bevor Sie fortfahren, ob die Callback-URL mit der in Ihrer JTL-App gespeicherten übereinstimmt.
3. Wählen Sie unter Umgebung die Option Produktion für Ihr echtes Konto oder Sandbox für das Testsystem von JTL.
4. Geben Sie Client-ID und Client-Secret Ihrer JTL-App ein.
5. Geben Sie optional unter Verbindungsname einen Namen ein. Ohne Namen verwendet der Hub den Namen des JTL-Kontos.
6. Wählen Sie Weiter zu JTL.
7. Melden Sie sich bei JTL mit dem Händlerkonto an, das Sie verbinden möchten.
8. Prüfen Sie den angeforderten Zugriff und erlauben Sie ihn.
9. JTL leitet Sie zurück zu Balta Labs, wo das Ergebnis bestätigt wird.

Schließen Sie den Vorgang ohne längere Pause ab. Jeder Versuch gilt 10 Minuten und nur in dem Browser, in dem er gestartet wurde. Läuft er ab, beginnen Sie erneut mit Schritt 1.

Das richtige JTL-Konto wählen

Balta Labs verbindet das Konto, mit dem Sie sich bei JTL anmelden. Das muss nicht das Konto sein, dem die App gehört. Ist Ihr Browser bereits bei JTL angemeldet, verwendet JTL diese Sitzung möglicherweise weiter. Handelt es sich nicht um das gewünschte Händlerkonto, melden Sie sich zuerst bei JTL ab und beginnen Sie erneut.

Balta Labs führt eine Verbindung pro JTL-Konto und Umgebung. Autorisieren Sie ein bereits verbundenes Konto, aktualisiert Balta Labs dessen Verbindung, statt ein Duplikat anzulegen. Um ein weiteres Händlerkonto zu verbinden, wählen Sie erneut Add account.

Die Bestätigungsseite

Sobald Balta Labs das Konto gespeichert und überprüft hat, erscheint JTL erfolgreich verbunden! mit Konto, Verbindung und Umgebung. Prüfen Sie, ob es sich um das gewünschte Konto handelt.

Ein Countdown führt Sie anschließend nach fünf Sekunden weiter zur Fulfillment-Einrichtung. Wählen Sie Jetzt fortfahren, um sofort weiterzugehen, oder Hier bleiben, um den Countdown anzuhalten. Nach einem Neuverbinden zeigt die Seite JTL erfolgreich neu verbunden! und führt Sie stattdessen zurück zur Verbindung.

Wurde die Autorisierung nicht abgeschlossen, zeigt die Seite einen Titel wie Berechtigungen fehlen, gefolgt von Was ist passiert und Was Sie tun können. Wählen Sie Erneut versuchen, um neu zu starten, oder Anleitung zur Fehlerbehebung lesen, um den passenden Abschnitt von JTL-Verbindungsfehler beheben zu öffnen.

Verbindung prüfen

Unter Einstellungen → Verbindungen erscheint das Konto im Bereich Fulfillment-Anbieter. Seine Karte zeigt den Zustand und wann das Konto zuletzt geprüft wurde:

• Nicht geprüft: Seit dem Hinzufügen oder Ändern des Kontos wurde kein Test ausgeführt.
• Funktioniert: Der letzte Test oder die letzte Anfrage an JTL war erfolgreich.
• Prüfung fehlgeschlagen: Der letzte Test oder die letzte Anfrage ist fehlgeschlagen. Die Karte zeigt die Meldung von JTL. Die Autorisierung bleibt erhalten; beheben Sie die Ursache und testen Sie erneut.
• Neu verbinden nötig: JTL akzeptiert die Autorisierung nicht mehr. Verbinden Sie das Konto neu, wie unten beschrieben.

Wählen Sie Testen, um das Konto sofort zu prüfen. Der Test liest nur Daten von JTL. Wählen Sie Details, um Konto, Was der Hub kann und die Referenzlisten mit Lager und Versandarten zu sehen, jeweils mit ID und in der Spalte Fulfiller mit dem zugehörigen Fulfiller. Der Dialog für den Standort bietet dieselbe Auswahl an. Bearbeiten zeigt das JTL-Konto, seine Umgebung, die Client-ID der App und den Zeitpunkt der Autorisierung. Dort können Sie die Verbindung auch umbenennen.

Die Karte weist außerdem darauf hin, dass das Konto erst für Lieferungen genutzt wird, wenn ein Standort eingeschaltet ist, und verlinkt auf Fulfillment-Einrichtung öffnen.

Standort einrichten

Ein Standort ist ein weclapp-Lager, das ein Fulfillment-Dienstleisterkonto betreibt. Fügen Sie für jedes Lager, das JTL betreut, einen Standort hinzu:

1. Öffnen Sie Fulfillment → Einrichtung. Zeigt die Seite Mit weclapp beginnen, wählen Sie Ihre weclapp-Verbindung und dann Speichern und weiter.
2. Wählen Sie im Bereich Standorte die Schaltfläche Standort hinzufügen.
3. Geben Sie unter Name einen Namen ein.
4. Wählen Sie unter weclapp-Lager das Lager, dessen Lieferungen JTL abwickelt, oder geben Sie seine ID ein.
5. Wählen Sie unter Anbieterkonto das JTL-Konto. Der Dialog lädt dann die Auswahl des Kontos.
6. Wählen Sie unter Lager bei JTL das Lager. Dadurch werden Fulfiller-ID und Fulfiller-Lager-ID ausgefüllt; beide bleiben bearbeitbar. Meldet der Dialog Die Auswahl des Kontos konnte nicht geladen werden. Geben Sie die IDs stattdessen ein., geben Sie beide IDs selbst ein, oder wählen Sie auf der Kontokarte Testen, um die Ursache zu finden.
7. Wählen Sie unter Versandarten für jeden weclapp-Versanddienstleister Versanddienstleister hinzufügen und wählen Sie seine FFN-Versandart-ID aus den Vorschlägen. Sie enthalten nur die Versandarten dieses Fulfillers und zeigen den Namen der Versandart unter der ID. Eine Lieferung, deren Versanddienstleister keine Zuordnung hat, geht mit der Standardversandart an JTL, und der Hub protokolliert eine Warnung.
8. Wählen Sie Standort speichern.
9. Wählen Sie unter Synchronisierung die Schaltfläche Synchronisierung starten, falls noch nichts synchronisiert wird.

Bei einem neuen Standort stehen alle Abläufe zunächst auf Aus. Ein JTL-Standort hat diese Abläufe:

• Versand: übergibt freigegebene Lieferungen an JTL.
• Sendungsverfolgung: schreibt Sendungsnummern zurück nach weclapp.
• Katalog: sendet Artikel, Bilder und Artikelfreigaben an JTL.
• Bestandsabgleich: vergleicht den weclapp-Bestand mit JTL.
• Wareneingang: meldet eingehende Lieferungen bei JTL an.

Jeder Ablauf hat einen von drei Modi:

• Aus: Es passiert nichts.
• Schatten: Der Hub entscheidet und protokolliert, was er tun würde. Er schreibt nichts in JTL oder weclapp und sendet keine Benachrichtigungen.
• Aktiv: Der Hub erledigt die Arbeit.

Richten Sie Abläufe unter Fulfillment → Setup ein. Prüfen Sie Entscheidungen mit Shadow und aktivieren Sie anschließend Active. Wechsel zu oder von Active erfordern eine Bestätigung. Fulfillment-Anbieter verbinden erklärt Einrichtung und Überwachung.

Konto neu verbinden

Verbinden Sie das Konto neu, wenn die Karte Neu verbinden nötig anzeigt oder nachdem Sie das Client-Secret der App bei JTL ersetzt haben.

1. Öffnen Sie Einstellungen → Verbindungen und suchen Sie das Konto unter Fulfillment-Anbieter.
2. Wählen Sie auf seiner Karte Neu verbinden.
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.
5. Melden Sie sich mit demselben JTL-Konto wie zuvor an und erlauben Sie den Zugriff.
6. Prüfen Sie auf der Seite JTL erfolgreich neu verbunden! das Konto. Wählen Sie dann Testen auf der Karte.

Beim Neuverbinden bleibt die Umgebung des Kontos erhalten. Melden Sie sich mit einem anderen JTL-Konto an, zeigt der Hub Ein anderes Konto wurde verwendet und lässt die Verbindung unverändert. Um ein anderes Konto zu verbinden, fügen Sie es als neue Verbindung hinzu.

So bleibt der Zugriff gültig

JTL-Zugriffstokens sind etwa 30 Minuten gültig. Der Hub erneuert sie automatisch, und jede Erneuerung ersetzt das Refresh-Token. Sie müssen nichts tun. Lehnt JTL eine Erneuerung ab, zum Beispiel weil der Zugriff widerrufen wurde, zeigt die Karte Neu verbinden nötig, und der Hub kann nicht mit dem Konto arbeiten, bis Sie es neu verbinden. Prüfen Sie danach unter Fulfillment → Betrieb, welche Einträge in der Zwischenzeit fehlgeschlagen sind.