接 eBay：拉订单进来，推履约出去

最后更新 2026-11-01

在 eBay Developers Program 拿到 App ID 和 Cert ID，填进 Integration，测试、配 Mapping、激活——订单流进来，履约流回去。

eBay 连接器经 eBay Sell API 把您 eBay 店铺的订单拉进 OMS，再把库存和履约推回 eBay。它还能拉退货、推产品与库存，让两边库存与发货保持同步。

eBay 接入步骤：先拿凭证，再测试，再配 Mapping，最后激活。

前置条件#

打开 eBay Developers Program → Application keys → Production。
复制 App ID。它就是 OAuth Client ID——填进 Integration 的 Client ID (App ID) 字段。
在同一页复制 Cert ID。它就是 OAuth Client Secret——填进 Integration 的 Client Secret (Cert ID) 字段。

Cert ID 只显示一次——拿到后立即妥善保存。两个值不要填反：App ID 填 Client ID，Cert ID 填 Client Secret。

打开 Integration → 连接器市场 → eBay → 新建连接。
Client ID (App ID)——必填：粘贴从 Application keys → Production 复制的 App ID。它用作 OAuth Client ID。
Client Secret (Cert ID)——必填：粘贴同一页的 Cert ID。它用作 OAuth Client Secret，加密存储，永不回显。
User access token——可选：如有经 OAuth 授权码流程拿到的用户令牌就填入（2 小时有效），系统会直接用它调用 Sell API。不填时，系统自动用 client credentials 换短期应用令牌。
Use sandbox——可选文本：填 "true" 走沙箱（api.sandbox.ebay.com）测试。生产环境留空。

点测试连接。测试会用您的凭证换令牌并探活 eBay API——通过说明 App ID、Cert ID 与环境三者匹配。失败时先记下错误码，对照下方常见问题排查，不要先改其他设置。

选 eBay 标准模板。它映射订单号、行 SKU、数量、收货地址、履约状态。激活前先用一个真实订单看映射预览——重点确认每个 eBay SKU 都配到了 OMS 产品。

eBay 订单往返：订单与退货进来，履约与库存回去。

激活后，Integration 按您设的频率拉新订单和退货，并把带追踪号的履约和库存变化推回 eBay。先在运行监控 / 日志里盯几单，确认无误再放手跑。

凭证对不上：最常见是 App ID 和 Cert ID 填反了，或其中一个复制时少了字符、多了空格，换令牌被拒。

回 eBay Developers Program → Application keys → Production，把 App ID 原样复制到 Client ID (App ID)、Cert ID 原样复制到 Client Secret (Cert ID)，再重新测试。

环境与密钥对不上：Use sandbox 填了 "true"，调用走的是沙箱 api.sandbox.ebay.com，但粘贴的 App ID 和 Cert ID 是生产密钥——或正好相反。

让两者成对一致再重测：生产环境把 Use sandbox 留空、用 Production 密钥；测试时填 "true"，并在同一连接里用沙箱密钥。

连接本身没问题：只是店铺在拉单范围内没有新订单，暂时没有可拉的单据。

在 eBay 店铺下一个测试订单，确认下单时间落在拉单范围内，再手动拉一次，在预览或运行监控 / 日志里确认订单出现。

eBay 订单行上的 SKU 与任何 OMS 产品都对不上，未配对前这一行无法入库。

打开产品映射的待处理页，把每个 eBay SKU 配到正确的 OMS 产品，保存后再重新预览或拉单。