Conectar ChannelDock a JTL Fulfillment Network (FFN) es una integración de centro de fulfillment. No es una conexión de canal de ventas del vendedor.

Hay dos integraciones JTL en ChannelDock. Use la que corresponda a quién crea los pedidos. Puede usar ambas si lo necesita.

Integración	Dirección	Usar cuando
JTL FFN merchant push	ChannelDock → JTL	Los pedidos ya existen en ChannelDock y deben enviarse a JTL Wawi / FFN para el fulfillment.
JTL FFN order import	JTL → ChannelDock	Los pedidos outbound se crean en JTL FFN y deben prepararse y empaquetarse en ChannelDock.

No mezcle tokens. Un token API de comerciante no es lo mismo que un token API de fulfiller.

Antes de empezar

• El centro de fulfillment debe tener una cuenta JTL Fulfiller.
• Cada comerciante debe tener una cuenta de vendedor ChannelDock. Invíelos desde CRM → All sellers.
• Cree las cuentas de comerciante JTL en JTL, no en ChannelDock.

Conectar JTL FFN merchant push

Use esto cuando ChannelDock deba enviar productos, pedidos y entradas a JTL.

1. En JTL FFN (conectado como fulfiller), copie el enlace de invitación de comerciante en Merchants:
   https://fulfillment.jtl-software.com/fulfiller/merchants
   El enlace tiene este aspecto: https://fulfillment.jtl-software.com/invitations/…
2. En ChannelDock vaya a Settings → Integrations.
3. Abra JTL FFN merchant push.
4. Pegue el enlace de invitación y haga clic en Connect JTL.
5. La conexión aparece en la tabla de integraciones. La URL de esa fila es la invitación que los comerciantes deben aceptar.

Conectar el enlace de invitación solo guarda la invitación. Cada vendedor sigue necesitando un token API de comerciante.

Conectar el token de comerciante de un vendedor

Hágalo después de que el vendedor tenga una cuenta de vendedor ChannelDock.

1. Cree una cuenta de comerciante JTL:
   https://kundencenter.jtl-software.de/login/registrierung
   Use la dirección de correo del comerciante.
2. Inicie sesión en JTL FFN como Merchant:
   https://fulfillment.jtl-software.com
3. En ChannelDock, abra Settings → Integrations y haga clic en la URL de invitación de la conexión JTL merchant-push. Acepte la invitación en JTL para vincular el comerciante al fulfiller.
4. Cree un token API de ChannelDock mientras está conectado como comerciante:
   https://fulfillment.jtl-software.com/extern-access/YCEY0XCHANNELDOCK
5. Deje el menú desplegable vacío. En el campo de nombre escriba ChannelDock. Haga clic en Anlegen (crear).
6. Copie el token.
7. En ChannelDock vaya a CRM → All sellers, abra el vendedor, haga clic en el icono del lápiz y pegue el token en JTL merchant API token.
8. Si el token es válido, ChannelDock muestra Connected.

Después asigne un almacén y métodos de envío al comerciante en JTL Wawi / FFN. ChannelDock no puede enviar pedidos hasta que existan en JTL.

Tras una conexión de comerciante correcta:

• ChannelDock envía a FFN los productos del vendedor disponibles en el centro de fulfillment.
• Los pedidos abiertos en ChannelDock se envían a JTL (tras un breve retraso para no enviar pedidos incompletos).
• Los envíos inbound pueden enviarse a FFN una vez asignado un almacén.
• Stock, envíos, seguimiento y métodos de envío se sincronizan de JTL a ChannelDock.

Conectar JTL FFN order import

Use esto cuando JTL crea los pedidos outbound y ChannelDock debe importarlos.

1. Cree un token API de fulfiller en JTL FFN (cuenta fulfiller).
2. En ChannelDock vaya a Settings → Integrations.
3. Abra JTL FFN order import.
4. Pegue el token API de fulfiller y haga clic en Connect JTL.
5. En cada vendedor, asigne el comerciante JTL FFN.
6. Autorice un almacén JTL FFN y métodos de envío para ese vendedor.

JTL exige al menos un método de envío Standard (paquete) en la autorización de almacén. Los métodos de palé o de proveedor de etiquetas por sí solos no bastan.

Tras esta conexión, ChannelDock puede importar outbounds, productos, entradas, stock, envíos y devoluciones desde JTL. Cuando el centro de fulfillment recibe un inbound en ChannelDock, el recibo se envía de vuelta a JTL.

Error: 401 Unauthorized en users/current

Puede ver:

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

Esto ocurre al guardar el token API de comerciante JTL en un vendedor (CRM → All sellers). ChannelDock comprueba el token de inmediato con JTL.

401 Unauthorized significa que JTL rechazó el token. No es una incidencia de ChannelDock.

Causas habituales:

• Se pegó un token de fulfiller en el campo de token de comerciante del vendedor.
• El token se creó con el menú desplegable relleno. El menú desplegable debe permanecer vacío.
• El token se creó estando conectado a la cuenta JTL fulfiller en lugar de la cuenta de comerciante.
• No se usó la URL de token de ChannelDock.
• El comerciante aún no ha aceptado la invitación.
• El token se copió de forma incompleta, tiene espacios extra o fue revocado.

Cómo solucionarlo:

1. Cierre sesión en JTL si está en la cuenta fulfiller.
2. Inicie sesión como el comerciante.
3. Confirme que la invitación fue aceptada.
4. Abra https://fulfillment.jtl-software.com/extern-access/YCEY0XCHANNELDOCK
5. Deje el menú desplegable vacío, nombre el token ChannelDock y cree un token nuevo.
6. Pegue el nuevo token en el vendedor en ChannelDock.

Los tokens API de fulfiller pertenecen solo a Settings → Integrations → JTL FFN order import. Siempre fallarán con 401 si se usan como token de comerciante del vendedor.

Lista de comprobación si los pedidos o el stock no se sincronizan

• El vendedor tiene una cuenta ChannelDock y está conectado al centro de fulfillment.
• La invitación se aceptó en JTL.
• El vendedor tiene un token de comerciante válido (Connected).
• El comerciante tiene un almacén y métodos de envío en JTL.
• Para la importación de pedidos: el vendedor está asignado a un comerciante JTL FFN y tiene al menos un método de envío Standard autorizado.
• Compruebe los ajustes de la integración (engranaje) y View API log en Settings → Integrations.