接 AliExpress:拉订单进来,推履约出去
从 AliExpress App 控制台复制网关地址、App Key 和 App Secret,走 OAuth 授权拿到卖家账号的 Session,填进 Integration,测试、配 Mapping、激活——订单流进来,履约流回去。
AliExpress 连接器把您 AliExpress 卖家店铺的订单拉进 OMS,再把履约推回 AliExpress。它还能推产品与库存,让两边的商品、库存与发货保持同步。一个连接对应一个卖家店铺。
前置条件#
- 一个 AliExpress 卖家账号,且有可售、可发货的店铺。
- 在 AliExpress App 控制台里有一个应用,且有权限打开该应用复制其中的值。
- 卖家账号持有人能走完 AliExpress OAuth 授权流程,拿到 Session(访问令牌)。
拿凭证#
- 打开 AliExpress App 控制台 → 你的应用,原样复制里面显示的 TOP 网关地址。不要凭记忆手打网关——该地址不硬编码,必须按控制台显示的原样填写。
- 在同一个应用里,复制 App Key。
- 在同一页面,复制 App Secret。它用于请求签名——妥善保存。
- 为您的卖家账号走完 AliExpress OAuth 授权流程,拿到该账号的 Session(访问令牌)。
填进 Integration#
- 打开 Integration → 连接器市场 → AliExpress → 新建连接。
- API 网关地址——必填:粘贴从 AliExpress App 控制台复制的 TOP 网关地址,按控制台显示的原样填写(占位示例:https://…)。
- App Key——必填:粘贴 AliExpress App 控制台 → 你的应用里的 App Key。
- App Secret——必填:粘贴同一页面的 App Secret。它用于请求签名,绝不打日志、不返回前端。
- Session(访问令牌)——必填:粘贴卖家账号的 OAuth session / access token,走 AliExpress OAuth 授权流程获取。
测试连接#
点测试连接。测试会检查网关地址、用 App Key 和 App Secret 签一次请求,并确认 Session 能被您的卖家账号接受。通过说明四个值是一套的。失败时先记下报错,对照下方常见问题排查,不要先改其他设置。
配 Mapping / 选模板#
选 AliExpress 标准模板。它映射订单号、行 SKU、数量、收货地址、履约状态。激活前先用一个真实订单看映射预览——重点确认每个 AliExpress SKU 都配到了 OMS 产品,这样产品与库存推送在两边才对得上。
激活#
激活后,Integration 按您设的频率拉新订单,把带追踪号的履约推回 AliExpress,并推送产品与库存变化。先在 运行监控 / 日志里盯几单,确认无误再放手跑。
常见问题#
测试失败:App Key 或 App Secret 错了
说人话就是 AliExpress 认不出是谁在调用:您填的 App Key 和 App Secret 与控制台里的应用对不上——最常见是其中一个复制不全、多了空格,或两个值填反了——签名请求被拒。
回 AliExpress App 控制台 → 你的应用,把 App Key 原样复制到 App Key、App Secret 原样复制到 App Secret,并确认网关地址也是从控制台原样复制的,再重新测试。
授权过期:Session 不能用了
说人话就是 Session 只是上一次 OAuth 授权给的那张通行证,这张证已经过期了。App Key 和 App Secret 可能都没错——但没有有效的 Session,AliExpress 就不让这个连接替您的卖家账号办事,测试和拉单都会失败。
重新授权一次:再为卖家账号走一遍 AliExpress OAuth 授权流程,拿到新的 Session(访问令牌),把新值填进连接的 Session(访问令牌),保存后再重新测试。
连接成功但拉不到订单
说人话就是连接本身没问题——只是您的店铺在拉单范围内还没有新订单,暂时没有可拉的单据。这和授权失败不一样:测试能通过,只是订单列表回来是空的。
在您的 AliExpress 卖家店铺下一个测试订单,确认下单时间落在拉单范围内,再手动拉一次,在预览或 运行监控 / 日志里确认订单出现。