将 ChannelDock 连接到 JTL Fulfillment Network (FFN) 是履约中心集成，不是卖家销售渠道连接。

ChannelDock 中有两种 JTL 集成。请选择与创建订单的一方匹配的集成。需要时可以同时使用。

集成	方向	使用场景
JTL FFN merchant push	ChannelDock → JTL	订单已在 ChannelDock 中存在，应发送到 JTL Wawi / FFN 履约。
JTL FFN order import	JTL → ChannelDock	出库订单在 JTL FFN 中创建，应在 ChannelDock 中拣货包装。

不要混用 token。merchant API token 与 fulfiller API token 不同。

开始之前

• 履约中心必须拥有 JTL Fulfiller 账户。

• 每位商户必须拥有 ChannelDock 卖家账户。从 CRM → All sellers 邀请他们。

  

• 在 JTL 中创建 JTL merchant 账户，而不是在 ChannelDock 中。

连接 JTL FFN merchant push

当 ChannelDock 应将产品、订单和入库发送到 JTL 时使用。

1. 在 JTL FFN（以 fulfiller 身份登录）中，从 Merchants 复制商户邀请链接：
   https://fulfillment.jtl-software.com/fulfiller/merchants
   链接类似 https://fulfillment.jtl-software.com/invitations/…

   点击 Kinder zur Zusammenarbeit einladen，然后复制链接：

   

   

2. 在 ChannelDock 中前往 Settings → Integrations。

3. 打开 JTL FFN merchant push。

4. 粘贴邀请链接并点击 Connect JTL。

5. 连接会出现在集成表中。该行上的 URL 是商户必须接受的邀请。

   

连接邀请链接只会保存邀请。每位卖家仍需要 merchant API token。

连接卖家 merchant token

在卖家拥有 ChannelDock 卖家账户后执行。

1. 创建 JTL merchant 账户：
   https://kundencenter.jtl-software.de/login/registrierung
   使用商户的邮箱地址。

   

2. 以 Merchant 身份登录 JTL FFN：
   https://fulfillment.jtl-software.com

   

3. 在 ChannelDock 中打开 Settings → Integrations，点击 JTL merchant-push 连接上的邀请 URL。在 JTL 中接受邀请，以便将商户关联到 fulfiller。

   

4. 以商户身份登录时创建 ChannelDock API token：
   https://fulfillment.jtl-software.com/extern-access/YCEY0XCHANNELDOCK

5. 将下拉菜单留空。在名称字段输入 ChannelDock。点击 Anlegen（创建）。

   

6. 复制 token。

   

7. 在 ChannelDock 中前往 CRM → All sellers，打开该卖家，点击铅笔图标，将 token 粘贴到 JTL merchant API token。

   

   

8. 如果 token 有效，ChannelDock 会显示 Connected。

   

然后在 JTL Wawi / FFN 中为商户分配仓库和发货方式。在 JTL 中存在这些之前，ChannelDock 无法推送订单。

商户连接成功后：

• ChannelDock 将履约中心可用的卖家产品发送到 FFN。
• ChannelDock 中的未结订单会发送到 JTL（有短暂延迟，以免发送不完整订单）。
• 分配仓库后，入库货件可发送到 FFN。
• 库存、发货、运单和发货方式从 JTL 同步回 ChannelDock。

连接 JTL FFN order import

当 JTL 创建出库订单且 ChannelDock 应导入它们时使用。

1. 在 JTL FFN（fulfiller 账户）中创建 fulfiller API token。
2. 在 ChannelDock 中前往 Settings → Integrations。
3. 打开 JTL FFN order import。
4. 粘贴 fulfiller API token 并点击 Connect JTL。
5. 在每位卖家上映射 JTL FFN merchant。
6. 为该卖家授权 JTL FFN 仓库和发货方式。

JTL 要求仓库授权上至少有一种 Standard（包裹）发货方式。仅有托盘或面单提供商方式不够。

连接后，ChannelDock 可以从 JTL 导入出库、产品、入库、库存、发货和退货。履约中心在 ChannelDock 中收到入库时，收货会回传到 JTL。

错误：users/current 上的 401 Unauthorized

您可能会看到：

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

这发生在卖家上保存 JTL merchant API token 时（CRM → All sellers）。ChannelDock 会立即向 JTL 检查该 token。

401 Unauthorized 表示 JTL 拒绝了该 token。这不是 ChannelDock 故障。

常见原因：

• 把 fulfiller token 粘贴到了卖家 merchant token 字段。
• 创建 token 时填写了下拉菜单。下拉菜单必须保持为空。
• 在 fulfiller JTL 账户登录时创建了 token，而不是 merchant 账户。
• 未使用 ChannelDock token URL。
• 商户尚未接受邀请。
• token 复制不完整、有多余空格，或已被撤销。

修复方法：

1. 如果当前在 fulfiller 账户中，请退出 JTL。
2. 以商户身份登录。
3. 确认邀请已接受。
4. 打开 https://fulfillment.jtl-software.com/extern-access/YCEY0XCHANNELDOCK
5. 将下拉菜单留空，将 token 命名为 ChannelDock，并创建新 token。
6. 在 ChannelDock 的卖家上粘贴新 token。

Fulfiller API token 只属于 Settings → Integrations → JTL FFN order import。用作卖家 merchant token 时总会返回 401。

订单或库存不同步时的检查清单

• 卖家拥有 ChannelDock 账户并已连接到履约中心。
• 邀请已在 JTL 中接受。
• 卖家拥有有效的 merchant token（Connected）。
• 商户在 JTL 中拥有仓库和发货方式。
• 对于订单导入：卖家已映射到 JTL FFN merchant，并已授权至少一种 Standard 发货方式。
• 检查集成齿轮设置，以及 Settings → Integrations 上的 查看 API 日志。