接 Wayfair：拉订单进来，推履约出去
从 Wayfair Partner Home 复制 Client ID 和 Client Secret，填进 Integration，测试、配 Mapping、激活——订单流进来，履约流回去。
Wayfair 连接器把 Wayfair 的订单拉进 OMS，再把履约推回 Wayfair；还能把产品和库存更新推出去，让两边的订单、发货与库存保持同步。
前置条件#
- 一个 Wayfair 供应商账号，且能进 Wayfair Partner Home。
- 有打开 Wayfair Partner Home 里 API 设置的权限——Client ID 和 Client Secret 就在那里显示。
- 如果要推库存或 tracking，先准备好您的 Wayfair Supplier ID——这两种推送都必填。字段示例值是 5000，请填您自己的编号，不要照抄示例。
- 先想清楚先接哪个环境：第一次试接用沙箱，正式订单用生产。沙箱和生产的订单不互通，不要混用。
拿凭证#
- 登录 Wayfair Partner Home，打开 API 设置。
- 在该页面复制 Client ID。
- 在同一页面复制 Client Secret。妥善保存——下一步要把它粘进 Integration。
- 不需要手动去拿 Access token。在 Integration 里把该字段留空，系统会用 Client ID 和 Client Secret 自动换取（client_credentials，有效期 12 小时）并保持续期。
填进 Integration#
- 打开 Integration → 连接器市场 → Wayfair → 新建连接。
- Client ID（必填）：粘贴您从 Wayfair Partner Home → API 设置复制的 Client ID。
- Client Secret（必填）：粘贴同一页面的 Client Secret。加密存储，永不回显。
- Access token（可选）：留空。系统会用 Client ID 和 Client Secret 自动换 token（client_credentials，12 小时有效）。只有明确想用自己的 token 覆盖自动换取时才填。
- Supplier ID：填您的 Wayfair 供应商编号，例如 5000。库存推送和 tracking 推送必填——不填这两种推送跑不了，但订单仍可拉取。
- 沙箱模式：填 "true" 使用 Wayfair 沙箱环境；保持默认（"false"）使用生产环境。这个开关要有意识地设——沙箱连接永远看不到生产订单。
测试连接#
点测试连接。测试会用您的 Client ID 和 Client Secret 换取访问令牌并探活 Wayfair API，再做单据级预览：拉一个真实订单，展示"平台字段 → 标准订单"对照。账号里还没有订单时，连通性仍可通过——先真实下一单或等一单再看预览；测试失败时对照下面的常见问题排查。
配 Mapping / 选模板#
选 Wayfair 标准模板。它把订单号、行 SKU、数量和收货地址映射成标准订单，再把履约和 tracking 映射回 Wayfair 格式。激活前先看映射预览，重点确认每个 Wayfair SKU 都配到了正确的产品，这样库存推送报的才是对的商品。
激活#
激活后，Integration 按您设的频率拉 Wayfair 新订单，并把带 tracking 的履约、以及产品和库存更新推回 Wayfair。先在 运行监控 / 日志里盯几单，确认无误再放手跑——尤其看第一单的 tracking 有没有推成功，它需要 Supplier ID。
常见问题#
测试失败：认证被拒绝
Client ID 或 Client Secret 填错了，Wayfair 不肯用它们换访问令牌。这两个值是同一 API 设置页里的一对——混入从别处复制的值、或 Secret 少了一个字符，换取都会失败。
回 Wayfair Partner Home → API 设置，从同一页面重新复制 Client ID 和 Client Secret，替换连接里的两个值，保存后重新测试。
连接本来能用，过了几个小时开始失败
手动填入的 Access token 过期了。这样拿到的 token 只有 12 小时有效，粘进 Access token 字段后一开始能用、之后就失效——而用 Client ID 和 Client Secret 自动换取本来会持续续期。
清空 Access token 字段并保存，让系统回到用 Client ID 和 Client Secret 自动换 token，再重新测试。手动字段只适合短期覆盖。
订单能拉进来，但库存或 tracking 推不出去
Supplier ID 没填或填错。拉订单只需要 Client ID 和 Client Secret，但库存推送和 tracking 推送还需要您的 Wayfair 供应商编号——该字段为空、填了别人的编号或照抄示例值，Wayfair 都不会接受这两种推送。
在连接里填入您自己的 Wayfair Supplier ID（不要用示例 5000，除非那确实是您的编号），保存后从 运行监控 / 日志重新跑一次推送。
测试能通过，但正式订单一直不出现
沙箱和生产混用了。沙箱模式填了 "true" 时，连接对接的是 Wayfair 沙箱环境，那里永远只有沙箱数据——拉多少次也看不到生产订单。
要拉正式订单，把沙箱模式改回 "false"（默认值）后重新测试。如果还想保留沙箱连接做试验，单独建一个连接并起清楚的名字。
连接正常但没有订单进来
连接本身没问题——测试能通过——只是这个供应商账号在 Wayfair 还没有新订单，没东西可拉。
等 Wayfair 出现下一笔真实订单（沙箱模式下则用沙箱订单），然后手动拉一次并看 运行监控 / 日志。Wayfair 出单后，新订单就会出现。