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

接 Home Depot:拉订单进来,推履约出去

最后更新 2026-11-01

从 Home Depot 供应商开通资料里拿 API 地址和 API Key,填进 Integration,测试、配 Mapping、激活——订单流进来,履约流回去。

Home Depot 连接器把 Home Depot 的订单拉进 OMS,再把履约推回 Home Depot;还能把产品和库存更新推出去,让两边的订单、发货与库存保持同步。

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

前置条件#

  • 您是 Home Depot 供应商,且供应商开通流程已完成、供应商 API 已为您开通。
  • 您手上有开通时拿到的 API 地址和 API Key——两者都是建连接必填的。
  • 您知道自己的 Home Depot 供应商编号。它可选、仅作备注,但手边有它方便以后核对连接。

拿凭证#

  1. 打开 Home Depot 供应商开通资料,找到供应商 API 地址。这个地址就是您的 API 地址——按给出的样子原样复制,以 https:// 开头。
  2. 在同一份开通资料里找到 API Key。完整复制并妥善保存——下一步要把它粘进 Integration;它会作为 X-API-Key 请求头随每个请求发送。
  3. 从同一份开通资料里记下您的 Home Depot 供应商编号。它在连接里只作备注,按资料上显示的样子记下来即可。

填进 Integration#

  1. 打开 Integration → 连接器市场 → Home Depot → 新建连接。
  2. API 地址:粘贴 Home Depot 供应商开通时给您的供应商 API 地址,完整、原样——例如以 https:// 开头。此字段必填,它决定每个请求发到哪里,所以不要截短,也不要用别处的地址。
  3. API 密钥:粘贴 Home Depot 供应商 API 开通时拿到的 API Key。此字段必填。它作为 X-API-Key 请求头发送,加密存储,永不回显。
  4. 供应商 ID:按开通资料上显示的样子填您的 Home Depot 供应商编号。此字段可选、仅作备注——它给连接标上您的供应商编号,一眼就能看出这个连接属于哪个供应商。

测试连接#

点测试连接。测试会用您填的 API 地址和 API Key 去访问 Home Depot 供应商 API,确认 Key 被接受。通过说明地址通了、Key 也能用。失败时先记下报错、对照下面的常见问题排查,再改其他设置。

配 Mapping / 选模板#

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

Home Depot 订单往返:订单进来,履约、产品和库存回去。

激活#

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

常见问题#

测试失败:API Key 不被接受

连接里的 API Key 错了——比如复制不完整,或它不是 Home Depot 供应商 API 开通时给您的那把 Key。Key 会作为 X-API-Key 请求头随每个请求发送,Home Depot 不认的 Key 每次都会在门口被挡下。

回到 Home Depot 供应商开通资料,重新完整复制 API Key,粘进连接的 API 密钥字段。保存后重新测试。

测试根本连不上 API

连接里的 API 地址填错了。这个字段填的是您自己 Home Depot 供应商开通时拿到的供应商 API 地址——如果粘的内容被截短、打错,或是别处的地址,请求就会发到错误的地方或根本发不出去,测试在还没验 Key 之前就失败了。

回到 Home Depot 供应商开通资料,把供应商 API 地址重新完整、原样复制一遍,替换连接里的 API 地址。保存后重新测试。

连接上的供应商 ID 对不上

供应商 ID 填错了,连接上的备注指向的供应商编号和 Home Depot 开通时给您的不是同一个。连接还能保存,但以后核对订单属于哪个供应商时,这个标记会误导您。

对照 Home Depot 供应商开通资料里的供应商编号,把供应商 ID 字段改成完全一致。如果您拿不准这个编号,就把字段清空——它可选、仅作备注——然后保存并重新测试。

连接正常但没有订单进来

连接本身没问题——测试能通过——只是 Home Depot 还没有给您的供应商发出新订单,没东西可拉。

等 Home Depot 给您的供应商发出下一笔订单,然后手动拉一次并看 运行监控 / 日志。Home Depot 出单后,新订单就会出现。