连接 Billbee

将 Billbee 连接到 ChannelDock

Billbee 是德国、奥地利和瑞士许多卖家使用的多渠道订单管理平台。ChannelDock 集成（目前为 Beta）可将订单从 ChannelDock 推送到 Billbee 履约，可选择从 Billbee 导入库存和产品，并将发货运单同步回 ChannelDock。

此集成位于 Connections → Other — 不在 Sales channels 下。

---

连接如何工作

• ChannelDock 中状态为 order 或 backorder 的订单会同步到 Billbee。
• ChannelDock 使用您的 ChannelDock 订单号作为外部参考在 Billbee 中创建订单。
• 订单在 Billbee 发货后，运单会同步回 ChannelDock，并在原销售渠道完成订单。
• 订单在 Billbee 取消时，也会在 ChannelDock 中取消。
• 库存水平可选择从 Billbee 同步到 ChannelDock（默认关闭）。
• 可根据 EAN 从 Billbee 将新产品导入 ChannelDock。

---

连接之前

您需要在 Billbee 和 ChannelDock 中准备以下内容：

在 Billbee 中

1. 登录 Billbee。
2. 前往 Settings → Billbee API（或 Settings → System → Billbee API）。
3. 在 General settings 选项卡上启用 API 访问。
4. 设置 API password。Billbee 要求强密码：
   • 至少 12 个字符
   • 至少一个大写字母、一个小写字母、一个数字和一个特殊字符（!@$%^&*+#）
   • 密码中不要使用冒号（:） — 会导致身份验证错误
5. 保存设置。

您还需要用于该应用的 Billbee API Key。它会作为 HTTP 标头 X-Billbee-Api-Key 发送。如果还没有，请向 Billbee 申请——见 Billbee 的 API 文档。

连接用户名

• 主账户请使用 Billbee 账户注册的邮箱地址。
• 员工账户请使用该员工的 Billbee 用户名。

在 ChannelDock 中

• 先连接销售渠道（Shopify、bol.com、Amazon 等），以便订单流入 ChannelDock，再推送到 Billbee。

---

将 Billbee 连接到 ChannelDock

1. 登录 ChannelDock 账户。

2. 前往 Connections → Other。

   

3. 点击 Billbee 标志（标为 Beta）。

   

4. 填写连接表单：

   • Billbee API Key — 您的应用 API 密钥（作为 X-Billbee-Api-Key 发送）。
   • Billbee username/email — 您的 Billbee 登录邮箱或员工用户名。
   • Billbee API password — 您在 Billbee 中设置的 API 密码（不是日常登录密码）。

   

5. 点击 Connect Billbee。

ChannelDock 会根据 Billbee API 验证凭据。连接成功后，Billbee 会出现在 Other integrations 列表中。

---

配置 API 设置

连接后，点击 Billbee 行上的 settings（齿轮）图标，打开 Edit API settings：

查看并配置：

设置	说明
Billbee stock sync	关闭（默认）、EAN 或 SKU。启用后，会从 Billbee 读取库存并更新 ChannelDock 中匹配的产品。
Stock ID (optional)	若填写，ChannelDock 会从此特定 Billbee 库存位置读取库存，而不是默认位置。
Send orders from these sales channels	选择哪些已连接销售渠道的订单应推送到 Billbee。留空则不发送任何订单。

更改后保存设置。

---

订单流程

典型工作流如下：

1. 客户在已连接的销售渠道下单（例如 Shopify 或 bol.com）。
2. 订单导入 ChannelDock，状态为 order。
3. 如果该订单的销售渠道已在 Send orders from these sales channels 中选中，ChannelDock 将订单推送到 Billbee。
4. ChannelDock 使用您的 ChannelDock 订单号 作为 Billbee 中的订单参考。
5. 您在 Billbee 中履约（拣货、包装、发货）。
6. 订单在 Billbee 发货后，ChannelDock 收到运单号，并在原销售渠道将订单标记为完成。
7. 如果订单在 Billbee 取消，也会在 ChannelDock 中取消。

只有状态为 order 或 backorder 的订单会推送到 Billbee。已同步的订单不会再次发送。

---

库存同步（可选）

库存同步默认关闭。要启用：

1. 打开 ChannelDock 中的 Billbee 集成设置。
2. 将 Billbee stock sync 设为 EAN 或 SKU。
3. 如果在 Billbee 中使用多个库存位置，可选择设置 Stock ID。
4. 保存设置。

ChannelDock 使用所选字段（EAN 或 SKU）在 Billbee 与 ChannelDock 之间匹配产品。只有两边都有匹配标识符的产品才会更新。

库存变更会作为 Billbee stock update 事件出现在 ChannelDock 的库存日志中。

---

产品导入

ChannelDock 可以从 Billbee 导入 ChannelDock 中尚不存在的新产品。产品按 EAN 匹配和创建。已有相同 EAN 的产品会跳过。

导入的产品在 Billbee 有数据时会包含标题、SKU、EAN、库存、价格、图片 URL 和尺寸。

---

故障排除

连接失败或凭据被拒绝

• 确认已在 Billbee 的 Settings → Billbee API 中启用 API 访问。
• 填写全部三个字段：API Key、username/email 和 API password。
• 使用 API password，而不是日常 Billbee 登录密码。
• 检查 API 密码符合 Billbee 要求，且不含冒号（:）。
• 确认 Billbee API Key 有效且处于活动状态。

订单未发送到 Billbee

• 打开 Billbee 集成设置，检查 Send orders from these sales channels。必须至少选择一个销售渠道——列表为空则不会推送订单。
• 确认 ChannelDock 中的订单状态为 order 或 backorder。
• 检查订单尚未同步到 Billbee（在订单日志中查找与 Billbee 相关的条目）。

库存未从 Billbee 同步

• 确保 Billbee stock sync 设为 EAN 或 SKU — 默认关闭。
• 确认 Billbee 和 ChannelDock 中的产品存在匹配的 EAN 或 SKU。
• 如果在 Billbee 中使用多个库存位置，尝试设置正确的 Stock ID。

运单未同步回 ChannelDock

• 确认订单已在 Billbee 发货，并有运单号或追踪 URL。
• 在 ChannelDock 的订单日志中查看 Billbee 发货事件。
• 等待同步作业运行——状态更新会定期从 Billbee 拉取。

---

需要帮助？

如果 Billbee 集成遇到问题，请通过 ChannelDock 账户中的 support page 联系支持团队。请附上 Billbee 连接名称、问题描述，以及连接或同步期间显示的任何错误消息。