如果订单无法导入 ChannelDock，本文将说明如何识别并解决订单导入相关的常见问题。

检查 API 日志中的错误

识别 API 日志中的错误是了解问题的第一步。如何查看 API 日志中的潜在错误，请点击此处。

Magento 特定错误与修复

订单导入失败

原因： Magento 中缺少查看订单的用户权限。没有必要权限时，ChannelDock 通过 API 请求订单会收到 HTTP 401 Unauthorized。解决方案：

1. 登录 Magento Admin 面板。

2. 前往 System → Permissions → User Roles。

3. 打开用于 ChannelDock 集成的管理员用户所分配的角色。

4. 启用以下权限：Sales → Orders → View（权限键：Magento_Sales::actions_view）。

5. 保存角色。

6. 在 ChannelDock 中触发手动同步以重试 API 调用：

   • 前往 Connections → Sales channels → Actions → Sync API。
   • 确认订单现已出现在 ChannelDock 中。

No Product Attached to This Order 和 No Barcode Found

这些错误表示与订单关联的产品尚未导入 ChannelDock。解决方法：

1. 确保产品在销售渠道中已正确设置。如何在销售渠道中纠正这些错误，请见 销售渠道。
2. 在销售渠道中纠正问题后，将产品手动导入 ChannelDock 应能解决订单导入问题。手动导入产品说明请点击此处。

核验订单状态

在销售渠道中已处理或已关闭的订单不会导入 ChannelDock。请确保期望看到的订单在销售渠道中仍为未处理、未关闭。

库存更新未同步

原因： Magento 域名上的 Cloudflare 防护拦截了 ChannelDock 的 API 请求。Cloudflare 返回验证页而不是正常 API 响应，从而阻止库存同步。解决方案：

1. 登录 Cloudflare 账户。
2. 前往受影响 Magento 域名的设置。
3. 将 ChannelDock 生产 IP 地址加入白名单以允许 API 请求。
4. 保存更改并验证库存更新是否正确同步。

仍需帮助？

如果已按以上步骤操作，订单仍未导入 ChannelDock，请联系我们的支持团队。