接 SHEIN:拉订单进来,推履约出去
在 SHEIN 开放平台授权店铺,用 tempToken 换取 openKeyId 和 SecretKey,填进 Integration,测试、配 Mapping、激活——订单流进来,履约流回去。
SHEIN 连接器把您 SHEIN 店铺的订单拉进 OMS,再把履约推回 SHEIN;还能把产品和库存更新推到 SHEIN,让两边订单、发货与库存保持同步。
前置条件#
- 一个 SHEIN 卖家账号,且能在 SHEIN 商家后台管理对应店铺。
- 能进 SHEIN 开放平台,且有授权该店铺的权限。
- 备好您的 appSecretKey,用来解密授权后返回的 secretKey——没有它就拿不到用于签名的 SecretKey。
- 有人能妥善保管 openKeyId 和 SecretKey——重连时还需要它们。
拿凭证#
- 在 SHEIN 商家后台的店铺信息里找到店铺编码(Store code),原样复制。
- 在 SHEIN 开放平台授权店铺。授权后您会拿到一个 tempToken。
- 用 tempToken 调 /auth/get-by-token 换取凭证,然后复制返回结果里的 openKeyId。
- 用您的 appSecretKey 解密返回的 secretKey。解密后的值就是 SecretKey(签名),用于 HMAC-SHA256 请求签名。妥善保存。
填进 Integration#
- 打开 Integration → 连接器市场 → SHEIN → 新建连接。
- 店铺编码(Store code):粘贴 SHEIN 商家后台店铺信息中的店铺编码。它用来标识这个连接属于哪个店铺,必须与该店铺完全一致。
- openKeyId:粘贴您用 tempToken 调 /auth/get-by-token 换到的 openKeyId。此字段必填。
- SecretKey(签名):粘贴您用 appSecretKey 解密得到的 SecretKey。此字段必填。请求用它做 HMAC-SHA256 签名;它加密存储,永不回显。
测试连接#
点测试连接。测试会用您的 SecretKey 做 HMAC-SHA256 签名,连同 openKeyId 和店铺编码一起发请求去探活 SHEIN。通过说明 SHEIN 接受了签名、店铺也对得上。失败时先记下报错、对照下面的常见问题排查,再改其他设置。
配 Mapping / 选模板#
选 SHEIN 标准模板。它在 SHEIN 与标准订单之间映射订单号、行 SKU、数量、收货地址和履约状态。激活前先看映射预览,重点确认每个 SHEIN SKU 都配到了正确的 OMS 产品。
激活#
激活后,Integration 按您设的频率拉 SHEIN 新订单,把带追踪号的履约推回 SHEIN,并把产品和库存更新推到 SHEIN。先在 运行监控 / 日志里盯几单,确认无误再放手跑。
常见问题#
测试失败:凭证被拒
连接里的 openKeyId 或 SecretKey 错了。最常见的原因是粘了仍加密的 secretKey、而不是用 appSecretKey 解密后的值,或者 openKeyId 复制不完整,SHEIN 验不过 HMAC-SHA256 签名。
按顺序重走拿凭证步骤:在 SHEIN 开放平台重新授权店铺,用新的 tempToken 调 /auth/get-by-token,复制 openKeyId,用 appSecretKey 解密返回的 secretKey,把两个值都粘进连接,保存后重新测试。
连接以前能用,现在测试全失败
这个连接背后的令牌或密钥已过期或失效——比如店铺被重新授权过,会发出新的 tempToken 和新凭证,连接里存的 openKeyId 和 SecretKey 就与店铺对不上了。
换取新凭证:用最新的 tempToken 调 /auth/get-by-token,复制新的 openKeyId,用 appSecretKey 解密新的 secretKey,替换连接里的两个值,保存后重新测试。
测试失败:店铺找不到或店铺对不上
店铺编码(Store code)字段填错了——常是把另一个店铺的编码粘了进来,凭证与店铺不属于同一家,SHEIN 对不上这个连接与已授权店铺。
回 SHEIN 商家后台的店铺信息,把已授权店铺显示的店铺编码原样复制,替换连接里的值,保存后重新测试。
连接正常但没有订单进来
连接本身没问题——测试能通过——只是这个 SHEIN 店铺还没有新订单,没东西可拉。
在您的 SHEIN 店铺真实下一单(或等下一笔客户订单),然后手动拉一次并看 运行监控 / 日志。SHEIN 出单后,新订单就会出现。