接 Overstock：拉订单进来，推履约出去
从您的 Overstock 合作伙伴集成文档里取 API 地址和 API Key，填进 Integration，测试、配 Mapping、激活——订单流进来，履约流回去。
Overstock 连接器把 Overstock（现品牌为 Bed Bath & Beyond 平台）的订单拉进 OMS，再把履约推回该平台；还能把产品和库存更新推出去，让两边的订单、发货与库存保持同步。
前置条件#
- 一个 Overstock 合作伙伴账号，在现品牌为 Bed Bath & Beyond 的平台上销售。
- 您的 Overstock 合作伙伴集成文档。API 地址和 endpoint 路径都以这份文档为准——Overstock 未公开发布 REST API 规范，endpoint 无处别查。
- 按同一份合作伙伴集成文档说明、为您的账号签发的合作伙伴 API Key。先准备好可复制的原文——要粘进 Integration，不要凭记忆手敲。
拿凭证#
- 打开您账号的 Overstock 合作伙伴集成文档。您需要的两个值——API 地址和 API Key——都从这份文档里取；没有公开的 REST API 规范可替代查阅。
- 在文档里找到 API 根地址，原样复制。这就是 API 地址字段要填的值——以 https:// 开头。根地址照文档写的复制，endpoint 路径同样与这份文档核对。
- 在同一份文档里找到您的合作伙伴 API Key 并复制。妥善保存：它是密钥，每次请求都以 x-api-key 请求头发送，保存后 Integration 永不回显。
填进 Integration#
- 打开 Integration → 连接器市场 → Overstock → 新建连接。
- API 地址（必填）：粘贴您从 Overstock 合作伙伴集成文档复制的 API 根地址，形如 https://… 。照文档原样粘贴根地址——不要填平台店铺前台地址，也不要凭猜：Overstock 未公开发布 REST API 规范，这个值只能以文档为准。
- API 密钥（必填）：粘贴同一份文档里的合作伙伴 API Key。它以 x-api-key 请求头发送，加密存储，永不回显——保存后该字段不会再显示密钥，所以请以文档里的原文为准留好自己的副本。
测试连接#
点测试连接。测试会用您的 API 地址、并以 x-api-key 请求头发送 API Key 来验连通性，再做单据级预览：拉一个真实订单，展示"平台字段 → 标准订单"对照。账号里还没有订单时，连通性仍可通过——先等到或安排一笔真实订单再看预览；测试失败时对照下面的常见问题排查。
配 Mapping / 选模板#
选 Overstock 标准模板。它把订单号、行 SKU、数量和收货地址映射成标准订单，再把履约映射回平台格式。激活前先看映射预览，重点确认每个平台 SKU 都配到了正确的产品，这样产品和库存推送报的才是对的商品。
激活#
激活后，Integration 按您设的频率拉 Overstock 新订单，并把带 tracking 的履约、以及产品和库存更新推回平台。先在 运行监控 / 日志里盯几单，确认无误再放手跑。
常见问题#
测试失败：API Key 被拒绝
API Key 填错了。每次请求都以 x-api-key 请求头带这个 Key，所以少复制一个字符、用错账号的 Key、或填的根本不是合作伙伴 API Key，都会在第一次调用时被拒绝——还没轮到 API 地址起作用。
回您的 Overstock 合作伙伴集成文档，从那里重新复制合作伙伴 API Key，替换连接里的 API 密钥值，保存后重新测试。要粘贴，不要手敲。
测试失败：按 API 地址连不到平台
API 地址填错了。这个字段需要合作伙伴集成文档里的 API 根地址；平台店铺前台地址、从浏览器复制的页面地址、或凭猜写的地址，都指向 API 不会应答的地方。而且 Overstock 未公开发布 REST API 规范，看起来像样的地址也可能不对——只有文档定义的才是对的，endpoint 路径也一样。
打开合作伙伴集成文档，把 API 根地址按原文重新复制一遍，替换连接里的 API 地址，并用同一份文档核对 endpoint 路径。保存后重新测试。
连接正常但没有订单进来
连接本身没问题——测试能通过——只是平台上您的账号还没有新订单，没东西可拉。连接正常但订单为空时，表现就是这样，直到下一笔订单出现。
等平台出现下一笔真实订单，然后手动拉一次并看 运行监控 / 日志。平台出单后，新订单就会出现——如果平台上明明有订单、手动拉取后仍不出现，先按合作伙伴集成文档复核 API 地址和 API Key。