Die Verbindung von ChannelDock mit dem JTL Fulfillment Network (FFN) ist eine Integration für Fulfillment-Center. Es handelt sich nicht um eine Verkaufskanal-Verbindung für Verkäufer.

Es gibt zwei JTL-Integrationen in ChannelDock. Nutzen Sie die Integration, die dazu passt, wer die Bestellungen erstellt. Sie können beide verwenden, wenn nötig.

Integration	Richtung	Verwenden, wenn
JTL FFN merchant push	ChannelDock → JTL	Bestellungen existieren bereits in ChannelDock und sollen zur Erfüllung an JTL Wawi / FFN gesendet werden.
JTL FFN order import	JTL → ChannelDock	Outbound-Bestellungen werden in JTL FFN erstellt und sollen in ChannelDock kommissioniert und verpackt werden.

Mischen Sie Token nicht. Ein Händler-API-Token ist nicht dasselbe wie ein Fulfiller-API-Token.

Bevor Sie beginnen

• Das Fulfillment-Center muss ein JTL-Fulfiller-Konto haben.
• Jeder Händler muss ein ChannelDock-Verkäuferkonto haben. Laden Sie ihn über CRM → Alle Verkäufer ein.
• Legen Sie JTL-Händlerkonten in JTL an, nicht in ChannelDock.

JTL FFN merchant push verbinden

Nutzen Sie dies, wenn ChannelDock Produkte, Bestellungen und Wareneingänge an JTL senden soll.

1. Kopieren Sie in JTL FFN (als Fulfiller angemeldet) den Händler-Einladungslink unter Merchants:
   https://fulfillment.jtl-software.com/fulfiller/merchants
   Der Link sieht aus wie https://fulfillment.jtl-software.com/invitations/…
2. Gehen Sie in ChannelDock zu Einstellungen → Integrationen.
3. Öffnen Sie JTL FFN merchant push.
4. Fügen Sie den Einladungslink ein und klicken Sie auf Connect JTL.
5. Die Verbindung erscheint in der Integrationstabelle. Die URL in dieser Zeile ist die Einladung, die Händler annehmen müssen.

Das Verbinden des Einladungslinks speichert nur die Einladung. Jeder Verkäufer benötigt weiterhin ein Händler-API-Token.

Händler-Token eines Verkäufers verbinden

Tun Sie dies, nachdem der Verkäufer ein ChannelDock-Verkäuferkonto hat.

1. Erstellen Sie ein JTL-Händlerkonto:
   https://kundencenter.jtl-software.de/login/registrierung
   Verwenden Sie die E-Mail-Adresse des Händlers.
2. Melden Sie sich bei JTL FFN als Merchant an:
   https://fulfillment.jtl-software.com
3. Öffnen Sie in ChannelDock Einstellungen → Integrationen und klicken Sie auf die Einladungs-URL der JTL-merchant-push-Verbindung. Nehmen Sie die Einladung in JTL an, damit der Händler mit dem Fulfiller verknüpft ist.
4. Erstellen Sie ein ChannelDock-API-Token, während Sie als Händler angemeldet sind:
   https://fulfillment.jtl-software.com/extern-access/YCEY0XCHANNELDOCK
5. Lassen Sie das Dropdown leer. Geben Sie im Namensfeld ChannelDock ein. Klicken Sie auf Anlegen.
6. Kopieren Sie das Token.
7. Gehen Sie in ChannelDock zu CRM → Alle Verkäufer, öffnen Sie den Verkäufer, klicken Sie auf das Stift-Symbol und fügen Sie das Token unter JTL merchant API token ein.
8. Wenn das Token gültig ist, zeigt ChannelDock Connected.

Weisen Sie dem Händler anschließend ein Lager und Versandarten in JTL Wawi / FFN zu. ChannelDock kann keine Bestellungen pushen, bis diese in JTL vorhanden sind.

Nach einer erfolgreichen Händlerverbindung:

• ChannelDock sendet die Produkte des Verkäufers, die im Fulfillment-Center verfügbar sind, an FFN.
• Offene Bestellungen in ChannelDock werden an JTL gesendet (nach einer kurzen Verzögerung, damit unvollständige Bestellungen nicht gesendet werden).
• Wareneingänge können an FFN gesendet werden, sobald ein Lager zugewiesen ist.
• Bestand, Sendungen, Tracking und Versandarten synchronisieren von JTL zurück nach ChannelDock.

JTL FFN order import verbinden

Nutzen Sie dies, wenn JTL Outbound-Bestellungen erstellt und ChannelDock sie importieren soll.

1. Erstellen Sie ein Fulfiller-API-Token in JTL FFN (Fulfiller-Konto).
2. Gehen Sie in ChannelDock zu Einstellungen → Integrationen.
3. Öffnen Sie JTL FFN order import.
4. Fügen Sie das Fulfiller-API-Token ein und klicken Sie auf Connect JTL.
5. Ordnen Sie jedem Verkäufer den JTL-FFN-Händler zu.
6. Autorisieren Sie ein JTL-FFN-Lager und Versandarten für diesen Verkäufer.

JTL verlangt mindestens eine Standard-Versandart (Paket) bei der Lagerautorisierung. Paletten- oder Label-Provider-Methoden allein reichen nicht.

Nach dieser Verbindung kann ChannelDock Outbounds, Produkte, Wareneingänge, Bestand, Sendungen und Retouren aus JTL importieren. Wenn das Fulfillment-Center einen Wareneingang in ChannelDock empfängt, wird der Empfang an JTL zurückgebucht.

Fehler: 401 Unauthorized bei users/current

Sie können Folgendes sehen:

Client error: GET https://ffn.api.jtl-software.com/api/v1/users/current resulted in a 401 Unauthorized response

Das passiert beim Speichern des JTL-Händler-API-Tokens bei einem Verkäufer (CRM → Alle Verkäufer). ChannelDock prüft das Token sofort bei JTL.

401 Unauthorized bedeutet, dass JTL das Token abgelehnt hat. Das ist kein ChannelDock-Ausfall.

Häufige Ursachen:

• Ein Fulfiller-Token wurde in das Händler-Token-Feld des Verkäufers eingefügt.
• Das Token wurde mit ausgefülltem Dropdown erstellt. Das Dropdown muss leer bleiben.
• Das Token wurde erstellt, während Sie im Fulfiller-JTL-Konto angemeldet waren statt im Händlerkonto.
• Die ChannelDock-Token-URL wurde nicht verwendet.
• Der Händler hat die Einladung noch nicht angenommen.
• Das Token wurde unvollständig kopiert, enthält Leerzeichen oder wurde widerrufen.

So beheben Sie es:

1. Melden Sie sich bei JTL ab, wenn Sie im Fulfiller-Konto sind.
2. Melden Sie sich als Händler an.
3. Bestätigen Sie, dass die Einladung angenommen wurde.
4. Öffnen Sie https://fulfillment.jtl-software.com/extern-access/YCEY0XCHANNELDOCK
5. Lassen Sie das Dropdown leer, nennen Sie das Token ChannelDock und erstellen Sie ein neues Token.
6. Fügen Sie das neue Token beim Verkäufer in ChannelDock ein.

Fulfiller-API-Token gehören nur unter Einstellungen → Integrationen → JTL FFN order import. Sie schlagen immer mit 401 fehl, wenn sie als Verkäufer-Händler-Token verwendet werden.

Checkliste, wenn Bestellungen oder Bestand nicht synchronisieren

• Der Verkäufer hat ein ChannelDock-Konto und ist mit dem Fulfillment-Center verbunden.
• Die Einladung wurde in JTL angenommen.
• Der Verkäufer hat ein gültiges Händler-Token (Connected).
• Der Händler hat ein Lager und Versandarten in JTL.
• Für den Order-Import: Der Verkäufer ist einem JTL-FFN-Händler zugeordnet und hat mindestens eine Standard-Versandart autorisiert.
• Prüfen Sie die Integrations-Einstellungen (Zahnrad) und View API log unter Einstellungen → Integrationen.