接 Wish：拉订单进来，推履约出去
拿到 Wish 商家 OAuth2 访问令牌，把它连同 API 地址一起填进 Integration，测试、配 Mapping、激活——订单流进来，履约、产品与库存流回去。
Wish 连接器把您 Wish 店铺的订单拉进 OMS，再把履约推回 Wish。它还能推产品与库存，让两边的商品、库存与发货保持同步。
前置条件#
- 一个 Wish 商家店铺，且能登录该店铺的 Wish 商家账号。
- 能为该店铺完成 Wish 商家 OAuth2 授权——访问令牌经该授权获取。
- 开始前先确认您的店铺适用哪一个 API 地址：默认地址、中国地址，或测试用的沙箱地址。具体地址见“填进 Integration”一步。
拿凭证#
- 登录要连接店铺的 Wish 商家账号，为该店铺完成 OAuth2 授权。授权前先确认登录的是正确的店铺——为别家店铺授权的令牌与本连接对不上。
- 复制授权完成后获取的访问令牌。这是 Wish 商家 OAuth2 访问令牌——之后要填进 Integration 的 Access token 字段。
- 记下拿到令牌的日期：它的有效期是 30 天。过期后重新完成 OAuth2 授权拿到新令牌，并更新连接。
填进 Integration#
- 打开 Integration → 连接器市场 → Wish → 新建连接。
- API 地址：填您的店铺适用的地址。默认：https://merchant.wish.com/api/v2 。中国：https://china-merchant.wish.com/api/v2 。沙箱：https://sandbox.merchant.wish.com/api/v2 。沙箱地址只用于测试，正式使用前改成默认或中国地址。
- 访问令牌——必填：粘贴上一步拿到的 Wish 商家 OAuth2 访问令牌。有效期 30 天，加密存储，永不回显。
测试连接#
点测试连接。测试会一起校验 API 地址与访问令牌，再拉一个真实订单做单据级预览，展示“平台字段 → 标准订单”对照。店铺里还没有订单时，先在 Wish 里下一个测试订单——预览需要一条真实单据。测试失败时先记下报错，对照下方常见问题排查，不要先改其他设置。
配 Mapping / 选模板#
选 Wish 标准模板。它映射订单号、行 SKU、数量、收货地址、履约状态。激活前先用一个真实订单看映射预览——重点确认每个 Wish SKU 都配到了 OMS 产品，让订单、产品与库存两边对齐。
激活#
激活后，Integration 按您设的频率拉新订单，把带追踪号的履约推回 Wish，并把产品与库存变化推到 Wish。留意访问令牌的到期日——有效期 30 天，请在过期前更新它，让订单不断流。先在 运行监控 / 日志里盯几单，确认无误再放手跑。
常见问题#
测试失败：访问令牌错误或已过期
连接里的访问令牌不能用。复制时不完整或多了空格，它属于一次旧授权，或它的 30 天有效期已经用完，Wish 拒绝了调用。
为同一家店铺重新完成 Wish 商家 OAuth2 授权，把新访问令牌原样复制，替换 Access token 字段且不要带多余空格，确认 API 地址与您的店铺相符，再重新测试。
授权的是另一家店铺
令牌本身能用，但它是在登录另一家 Wish 店铺时授权的。连接因此连到的是那家店铺，本店的订单不会出现——或出现的是另一家店铺的订单。
登录本连接对应的 Wish 商家账号，重新完成 OAuth2 授权，把 Access token 换成来自该店铺的新令牌，再重新测试。一家店铺用一个连接——不要多个店铺共用一个令牌。
连接成功但拉不到订单
连接本身没问题。只是店铺在拉单范围内没有新订单，暂时没有可拉的单据。
在 Wish 店铺下一个测试订单，确认下单时间落在拉单范围内，再手动拉一次，在预览或 运行监控 / 日志里确认订单出现。