接 Best Buy:拉订单进来,推履约出去
从 Best Buy Mirakl 卖家后台复制 API Key,填进 Integration,测试、配 Mapping、激活——订单流进来,履约、产品和库存更新流回去。
Best Buy 连接器把 Best Buy 的订单拉进 OMS,再把履约推回 Best Buy,并推送产品和库存更新。一个连接用一个 API Key。
前置条件#
- 一个能登录 Best Buy Mirakl 卖家后台的 Best Buy 卖家账号。
- 有从该后台右上角用户名打开 API Key 页面的权限。
- 有人能妥善保管 API Key——重连或更换时还需要完整的 Key。
拿凭证#
- 登录 Best Buy Mirakl 卖家后台,点击右上角的用户名。
- 从该菜单打开 API Key。
- 点击 Generate / Copy,复制完整的 API Key。还没有 Key 时先生成,再复制。
填进 Integration#
- 打开 Integration → 连接器市场 → Best Buy → 新建连接。
- 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 产品。
激活#
激活后,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 产品,然后在 运行监控 / 日志里看下一单拉取结果。