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

接 Lowe's:拉订单进来,推履约出去

最后更新 2026-11-01

在 Lowe's Mirakl 卖家后台的 API 文档里找到 Mirakl API 地址,从右上角用户名 → API Key 复制 API Key,把两项填进 Integration,测试、配 Mapping、激活——订单流进来,履约流回去。

Lowe's 连接器经 Mirakl 把您 Lowe's 平台店铺的订单拉进 OMS,再把履约推回 Lowe's;还能把产品和库存更新推出去,让两边的订单、发货与库存保持同步。一个连接只指向一个 Lowe's Mirakl 环境——Mirakl API 地址和 API Key 必须属于同一个环境。

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

前置条件#

  • 一个 Lowe's 平台卖家账号,且能进该店铺的 Lowe's Mirakl 卖家后台。
  • 在 Mirakl 卖家后台有查看 API 文档、并为您的用户生成 API Key 的权限——连接器就是用这个 Key 登录的。
  • 手边有您自己的 Lowe's Mirakl 环境可供复制:API 地址是按环境区分的,并不是每个 Mirakl 平台都一样,不要借用另一个 Mirakl 店铺的地址。

拿凭证#

  1. 登录 Lowe's Mirakl 卖家后台,打开卖家后台的 API 文档,在里面找到 API 根地址——形如 https://<your-env>/api。按您环境里显示的样子完整复制。
  2. 在同一个卖家后台里,点右上角的用户名,然后打开 API Key。
  3. 在 API Key 页面,如果还没有 Key 就选 Generate New Key 生成一个新的,如果已有就选 Copy 复制。把 Key 妥善保存——下一步要把它粘进 Integration;它会作为 Authorization 请求头的值随每个请求发送。

填进 Integration#

  1. 打开 Integration → 连接器市场 → Lowe's → 新建连接。
  2. Mirakl API base URL:粘贴您在 Lowe's Mirakl 卖家后台 API 文档里找到的 API 根地址,例如 https://<your-env>/api。只粘您自己 Lowe's 环境的地址——填成别的 Mirakl 实例的地址,就算格式看着对,也会连到错误的平台。
  3. API key:粘贴您从 Lowe's Mirakl 卖家后台 → 右上角用户名 → API Key 复制的 API Key。此字段必填,它会作为 Authorization 请求头的值发送,加密存储,永不回显。

测试连接#

点测试连接。测试会用您填的 Mirakl API 地址和 API Key 去访问您的 Lowe's Mirakl 环境,确认 Key 能作为 Authorization 请求头被接受。通过说明地址连对了环境、Key 也能用。失败时先记下报错、对照下面的常见问题排查,再改其他设置——多数失败出在 Key 上,或出在地址指向了错误的 Mirakl 实例上。

配 Mapping / 选模板#

选 Lowe's 标准模板。它在 Lowe's(Mirakl)与标准订单之间映射订单号、行 SKU、数量、收货地址和履约状态,并带上推出去时用到的产品与库存字段。激活前先看映射预览,重点确认每个 Lowe's SKU 都配到了正确的 OMS 产品。

Lowe's 订单往返:订单进来,履约、产品和库存回去。

激活#

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

常见问题#

测试失败:API Key 不被接受

连接里的 API Key 错了或已失效——比如复制不完整、它属于另一个用户,或者已经生成了新 Key、连接里存的旧 Key 已不是当前那个。因为 Key 会作为 Authorization 请求头随每个请求发送,Mirakl 不认这个 Key 时,每个请求都会在门口被挡下。

去 Lowe's Mirakl 卖家后台,点右上角用户名 → API Key,完整复制当前 Key——需要新的就选 Generate New Key 生成——再粘进连接的 API key 字段。保存后重新测试。

测试失败或连到错误店铺:Mirakl 地址填错

Mirakl API base URL 字段里填的地址不属于您的 Lowe's 环境。最常见的是粘了另一个 Mirakl 实例的地址——另一个同样跑在 Mirakl 上的平台或环境。那个地址看着完全合法,但它指向别的地方,您的 Lowe's API Key 在那里对不上,测试自然连不到您的 Lowe's 店铺。

去 Lowe's Mirakl 卖家后台,重新打开卖家后台的 API 文档,复制里面为您的环境显示的 API 根地址——形如 https://<your-env>/api——把连接里的 Mirakl API base URL 换成这个准确地址,保存后重新测试。不要复用从另一个 Mirakl 店铺复制来的地址。

连接正常但没有订单进来

连接本身没问题——测试能通过——只是您的 Lowe's 店铺还没有新订单,没东西可拉。

先去 Lowe's Mirakl 卖家后台确认您的店铺是否真的已经出了新订单。如果已经出了,手动拉一次并看 运行监控 / 日志。如果后台里也没有新订单,就等下一笔客户订单——Lowe's 出单后,新订单就会出现在 Integration 里。