ChannelDock koppelen aan JTL Fulfillment Network (FFN) is een integratie voor fulfillment centers. Het is geen verkoopkanaal voor verkopers.

Er zijn twee JTL-integraties in ChannelDock. Gebruik de integratie die past bij wie de orders aanmaakt. U kunt beide gebruiken als dat nodig is.

Integratie	Richting	Gebruik wanneer
JTL FFN merchant push	ChannelDock → JTL	Orders bestaan al in ChannelDock en moeten naar JTL Wawi / FFN voor fulfillment.
JTL FFN order import	JTL → ChannelDock	Outbound-orders worden in JTL FFN aangemaakt en moeten in ChannelDock worden gepickt en gepackt.

Mix tokens niet. Een merchant API-token is niet hetzelfde als een fulfiller API-token.

Voordat u begint

• Het fulfillment center moet een JTL Fulfiller-account hebben.
• Elke merchant moet een ChannelDock seller-account hebben. Nodig hen uit via CRM → All sellers.
• Maak JTL merchant-accounts aan in JTL, niet in ChannelDock.

JTL FFN merchant push koppelen

Gebruik dit wanneer ChannelDock producten, orders en inbounds naar JTL moet sturen.

1. Kopieer in JTL FFN (ingelogd als fulfiller) de merchant-uitnodigingslink bij Merchants:
   https://fulfillment.jtl-software.com/fulfiller/merchants
   De link ziet eruit als https://fulfillment.jtl-software.com/invitations/…
2. Ga in ChannelDock naar Settings → Integrations.
3. Open JTL FFN merchant push.
4. Plak de uitnodigingslink en klik op Connect JTL.
5. De koppeling verschijnt in de integratietabel. De URL op die rij is de uitnodiging die merchants moeten accepteren.

Alleen de uitnodigingslink koppelen slaat de uitnodiging op. Elke verkoper heeft nog een merchant API-token nodig.

Een merchant-token voor een verkoper koppelen

Doe dit nadat de verkoper een ChannelDock seller-account heeft.

1. Maak een JTL merchant-account aan:
   https://kundencenter.jtl-software.de/login/registrierung
   Gebruik het e-mailadres van de merchant.
2. Meld u aan bij JTL FFN als Merchant:
   https://fulfillment.jtl-software.com
3. Open in ChannelDock Settings → Integrations en klik op de uitnodigings-URL van de JTL merchant-push-koppeling. Accepteer de uitnodiging in JTL zodat de merchant aan de fulfiller is gekoppeld.
4. Maak een ChannelDock API-token aan terwijl u als merchant bent ingelogd:
   https://fulfillment.jtl-software.com/extern-access/YCEY0XCHANNELDOCK
5. Laat de dropdown leeg. Vul in het naamveld ChannelDock in. Klik op Anlegen (aanmaken).
6. Kopieer het token.
7. Ga in ChannelDock naar CRM → All sellers, open de verkoper, klik op het potloodpictogram en plak het token bij JTL merchant API token.
8. Als het token geldig is, toont ChannelDock Connected.

Wijs daarna een magazijn en verzendmethoden toe aan de merchant in JTL Wawi / FFN. ChannelDock kan geen orders pushen totdat die in JTL bestaan.

Na een geslaagde merchant-koppeling:

• ChannelDock stuurt de producten van de verkoper die bij het fulfillment center beschikbaar zijn naar FFN.
• Open orders in ChannelDock worden naar JTL gestuurd (na een korte vertraging, zodat onvolledige orders niet worden verzonden).
• Inbound-zendingen kunnen naar FFN worden gestuurd zodra een magazijn is toegewezen.
• Voorraad, zendingen, tracking en verzendmethoden synchroniseren van JTL terug naar ChannelDock.

JTL FFN order import koppelen

Gebruik dit wanneer JTL outbound-orders aanmaakt en ChannelDock ze moet importeren.

1. Maak een fulfiller API-token aan in JTL FFN (fulfiller-account).
2. Ga in ChannelDock naar Settings → Integrations.
3. Open JTL FFN order import.
4. Plak het fulfiller API-token en klik op Connect JTL.
5. Koppel per verkoper de JTL FFN merchant.
6. Autoriseer een JTL FFN-magazijn en verzendmethoden voor die verkoper.

JTL vereist minstens één Standard (pakket) verzendmethode bij magazijnautorisatie. Pallet- of labelprovider-methoden alleen zijn niet voldoende.

Na deze koppeling kan ChannelDock outbounds, producten, inbounds, voorraad, zendingen en retouren uit JTL importeren. Wanneer het fulfillment center een inbound in ChannelDock ontvangt, wordt de ontvangst terug naar JTL geboekt.

Fout: 401 Unauthorized op users/current

U kunt dit zien:

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

Dit gebeurt bij het opslaan van het JTL merchant API-token bij een verkoper (CRM → All sellers). ChannelDock controleert het token direct bij JTL.

401 Unauthorized betekent dat JTL het token heeft afgewezen. Dit is geen storing van ChannelDock.

Veelvoorkomende oorzaken:

• Er is een fulfiller-token geplakt in het merchant-tokenveld van de verkoper.
• Het token is aangemaakt met een ingevulde dropdown. De dropdown moet leeg blijven.
• Het token is aangemaakt terwijl u in het fulfiller-JTL-account was ingelogd in plaats van het merchant-account.
• De ChannelDock token-URL is niet gebruikt.
• De merchant heeft de uitnodiging nog niet geaccepteerd.
• Het token is onvolledig gekopieerd, bevat extra spaties of is ingetrokken.

Hoe u het oplost:

1. Log uit bij JTL als u in het fulfiller-account zit.
2. Log in als de merchant.
3. Bevestig dat de uitnodiging is geaccepteerd.
4. Open https://fulfillment.jtl-software.com/extern-access/YCEY0XCHANNELDOCK
5. Laat de dropdown leeg, noem het token ChannelDock en maak een nieuw token aan.
6. Plak het nieuwe token bij de verkoper in ChannelDock.

Fulfiller API-tokens horen alleen onder Settings → Integrations → JTL FFN order import. Ze falen altijd met 401 als u ze als seller merchant-token gebruikt.

Checklist als orders of voorraad niet synchroniseren

• De verkoper heeft een ChannelDock-account en is gekoppeld aan het fulfillment center.
• De uitnodiging is in JTL geaccepteerd.
• De verkoper heeft een geldig merchant-token (Connected).
• De merchant heeft een magazijn en verzendmethoden in JTL.
• Voor orderimport: de verkoper is gekoppeld aan een JTL FFN merchant en heeft minstens één Standard verzendmethode geautoriseerd.
• Controleer de integratie-instellingen (tandwiel) en View API log onder Settings → Integrations.