用户手册
帮助中心/用户手册/接 Best Buy:拉订单进来,推履约出去

接 Best Buy:拉订单进来,推履约出去

最后更新 2026-11-01

从 Best Buy Mirakl 卖家后台复制 API Key,填进 Integration,测试、配 Mapping、激活——订单流进来,履约、产品和库存更新流回去。

Best Buy 连接器把 Best Buy 的订单拉进 OMS,再把履约推回 Best Buy,并推送产品和库存更新。一个连接用一个 API Key。

Best Buy 接入步骤:先拿凭证,再测试,再配 Mapping,最后激活。

前置条件#

  • 一个能登录 Best Buy Mirakl 卖家后台的 Best Buy 卖家账号。
  • 有从该后台右上角用户名打开 API Key 页面的权限。
  • 有人能妥善保管 API Key——重连或更换时还需要完整的 Key。

拿凭证#

  1. 登录 Best Buy Mirakl 卖家后台,点击右上角的用户名。
  2. 从该菜单打开 API Key。
  3. 点击 Generate / Copy,复制完整的 API Key。还没有 Key 时先生成,再复制。

填进 Integration#

  1. 打开 Integration → 连接器市场 → Best Buy → 新建连接。
  2. API key:粘贴您从 Best Buy Mirakl 卖家后台复制的 API Key。这是唯一的凭证字段,且必填。加密存储,永不回显。

测试连接#

点测试连接。测试会用您的 API Key 从 Best Buy 拉一页订单,确认 Key 能用。通过说明 Best Buy 接受了 Key 并返回了那一页订单。失败时先记下报错、对照下面的常见问题排查,再改其他设置。

配 Mapping / 选模板#

选 Best Buy 标准模板。它在 Best Buy 与标准订单之间映射订单号、行 SKU、数量、收货地址和履约状态。激活前先看映射预览,重点确认每个 Best Buy SKU 都配到了正确的 OMS 产品。

Best Buy 订单往返:订单进来,履约、产品和库存更新回去。

激活#

激活后,Integration 按您设的频率拉 Best Buy 新订单,把履约推回 Best Buy,并把产品和库存更新推出去。先在 运行监控 / 日志里盯几单,确认无误再放手跑。

常见问题#

测试失败:API Key 被拒绝

API Key 错了,或者已被吊销,所以测试拉一页订单时 Best Buy 不接受这个 Key。

在 Best Buy Mirakl 卖家后台 → 右上角用户名 → API Key → Generate / Copy 重新生成 API Key,把新的完整 Key 粘进连接,保存后重新测试。

粘贴 Key 后测试立刻失败

Key 复制不全——少了一部分,粘进来的值和 Best Buy Mirakl 卖家后台里的 API Key 对不上。

回 Best Buy Mirakl 卖家后台 → 右上角用户名 → API Key → Copy,重新完整复制 Key,替换连接里的值,保存后重新测试。

连接正常但没有订单进来

连接本身没问题——测试能通过——只是您的账号在 Best Buy 还没有新订单,没东西可拉。

先在 Best Buy Mirakl 卖家后台确认已出现新订单,然后手动拉一次并看 运行监控 / 日志。Best Buy 出单后,新订单就会出现。

SKU 显示未映射

渠道 SKU 还没有配到 OMS 的产品,带这个 SKU 的订单对不上产品。

去产品映射的待处理页,把每个渠道 SKU 配到 OMS 产品,然后在 运行监控 / 日志里看下一单拉取结果。