La connexion de ChannelDock au JTL Fulfillment Network (FFN) est une intégration pour centres de fulfillment. Ce n’est pas une connexion de canal de vente vendeur.

Il existe deux intégrations JTL dans ChannelDock. Utilisez celle qui correspond à qui crée les commandes. Vous pouvez utiliser les deux si besoin.

Intégration	Direction	Utiliser lorsque
JTL FFN merchant push	ChannelDock → JTL	Les commandes existent déjà dans ChannelDock et doivent être envoyées à JTL Wawi / FFN pour fulfillment.
JTL FFN order import	JTL → ChannelDock	Les commandes outbound sont créées dans JTL FFN et doivent être préparées et emballées dans ChannelDock.

Ne mélangez pas les jetons. Un jeton API marchand n’est pas le même qu’un jeton API fulfiller.

Avant de commencer

• Le centre de fulfillment doit avoir un compte JTL Fulfiller.
• Chaque marchand doit avoir un compte vendeur ChannelDock. Invitez-les depuis CRM → All sellers.
• Créez les comptes marchands JTL dans JTL, pas dans ChannelDock.

Connecter JTL FFN merchant push

Utilisez ceci lorsque ChannelDock doit envoyer produits, commandes et réceptions vers JTL.

1. Dans JTL FFN (connecté en tant que fulfiller), copiez le lien d’invitation marchand depuis Merchants :
   https://fulfillment.jtl-software.com/fulfiller/merchants
   Le lien ressemble à https://fulfillment.jtl-software.com/invitations/…
2. Dans ChannelDock, allez dans Settings → Integrations.
3. Ouvrez JTL FFN merchant push.
4. Collez le lien d’invitation et cliquez sur Connect JTL.
5. La connexion apparaît dans le tableau des intégrations. L’URL de cette ligne est l’invitation que les marchands doivent accepter.

Connecter le lien d’invitation enregistre seulement l’invitation. Chaque vendeur a encore besoin d’un jeton API marchand.

Connecter un jeton marchand vendeur

Faites-le après que le vendeur a un compte vendeur ChannelDock.

1. Créez un compte marchand JTL :
   https://kundencenter.jtl-software.de/login/registrierung
   Utilisez l’adresse e-mail du marchand.
2. Connectez-vous à JTL FFN en tant que Merchant :
   https://fulfillment.jtl-software.com
3. Dans ChannelDock, ouvrez Settings → Integrations et cliquez sur l’URL d’invitation de la connexion JTL merchant-push. Acceptez l’invitation dans JTL pour lier le marchand au fulfiller.
4. Créez un jeton API ChannelDock tout en étant connecté en tant que marchand :
   https://fulfillment.jtl-software.com/extern-access/YCEY0XCHANNELDOCK
5. Laissez le menu déroulant vide. Dans le champ nom, saisissez ChannelDock. Cliquez sur Anlegen (créer).
6. Copiez le jeton.
7. Dans ChannelDock, allez dans CRM → All sellers, ouvrez le vendeur, cliquez sur l’icône crayon et collez le jeton dans JTL merchant API token.
8. Si le jeton est valide, ChannelDock affiche Connected.

Assignez ensuite un entrepôt et des méthodes d’expédition au marchand dans JTL Wawi / FFN. ChannelDock ne peut pas pousser les commandes tant qu’ils n’existent pas dans JTL.

Après une connexion marchand réussie :

• ChannelDock envoie vers FFN les produits du vendeur disponibles au centre de fulfillment.
• Les commandes ouvertes dans ChannelDock sont envoyées à JTL (après un court délai pour ne pas envoyer de commandes incomplètes).
• Les expéditions inbound peuvent être envoyées à FFN une fois un entrepôt assigné.
• Stock, expéditions, suivi et méthodes d’expédition se synchronisent de JTL vers ChannelDock.

Connecter JTL FFN order import

Utilisez ceci lorsque JTL crée les commandes outbound et que ChannelDock doit les importer.

1. Créez un jeton API fulfiller dans JTL FFN (compte fulfiller).
2. Dans ChannelDock, allez dans Settings → Integrations.
3. Ouvrez JTL FFN order import.
4. Collez le jeton API fulfiller et cliquez sur Connect JTL.
5. Pour chaque vendeur, mappez le marchand JTL FFN.
6. Autorisez un entrepôt JTL FFN et des méthodes d’expédition pour ce vendeur.

JTL exige au moins une méthode d’expédition Standard (colis) lors de l’autorisation d’entrepôt. Les méthodes palette ou prestataire d’étiquettes seules ne suffisent pas.

Après cette connexion, ChannelDock peut importer outbounds, produits, réceptions, stock, expéditions et retours depuis JTL. Lorsque le centre de fulfillment reçoit un inbound dans ChannelDock, la réception est renvoyée à JTL.

Erreur : 401 Unauthorized sur users/current

Vous pouvez voir :

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

Cela se produit lors de l’enregistrement du jeton API marchand JTL sur un vendeur (CRM → All sellers). ChannelDock vérifie immédiatement le jeton auprès de JTL.

401 Unauthorized signifie que JTL a rejeté le jeton. Ce n’est pas une panne ChannelDock.

Causes fréquentes :

• Un jeton fulfiller a été collé dans le champ jeton marchand du vendeur.
• Le jeton a été créé avec le menu déroulant renseigné. Le menu déroulant doit rester vide.
• Le jeton a été créé alors que vous étiez connecté au compte JTL fulfiller au lieu du compte marchand.
• L’URL de jeton ChannelDock n’a pas été utilisée.
• Le marchand n’a pas encore accepté l’invitation.
• Le jeton a été copié de façon incomplète, contient des espaces ou a été révoqué.

Comment le corriger :

1. Déconnectez-vous de JTL si vous êtes dans le compte fulfiller.
2. Connectez-vous en tant que marchand.
3. Confirmez que l’invitation a été acceptée.
4. Ouvrez https://fulfillment.jtl-software.com/extern-access/YCEY0XCHANNELDOCK
5. Laissez le menu déroulant vide, nommez le jeton ChannelDock et créez un nouveau jeton.
6. Collez le nouveau jeton sur le vendeur dans ChannelDock.

Les jetons API fulfiller appartiennent uniquement à Settings → Integrations → JTL FFN order import. Ils échouent toujours avec 401 s’ils sont utilisés comme jeton marchand vendeur.

Liste de contrôle si les commandes ou le stock ne se synchronisent pas

• Le vendeur a un compte ChannelDock et est connecté au centre de fulfillment.
• L’invitation a été acceptée dans JTL.
• Le vendeur a un jeton marchand valide (Connected).
• Le marchand a un entrepôt et des méthodes d’expédition dans JTL.
• Pour l’import de commandes : le vendeur est mappé à un marchand JTL FFN et a au moins une méthode d’expédition Standard autorisée.
• Vérifiez les paramètres d’intégration (engrenage) et View API log dans Settings → Integrations.