用户手册
帮助中心/用户手册/接 AliExpress:拉订单进来,推履约出去

接 AliExpress:拉订单进来,推履约出去

最后更新 2026-11-01

从 AliExpress App 控制台复制网关地址、App Key 和 App Secret,走 OAuth 授权拿到卖家账号的 Session,填进 Integration,测试、配 Mapping、激活——订单流进来,履约流回去。

AliExpress 连接器把您 AliExpress 卖家店铺的订单拉进 OMS,再把履约推回 AliExpress。它还能推产品与库存,让两边的商品、库存与发货保持同步。一个连接对应一个卖家店铺。

AliExpress 接入步骤:先拿凭证与授权,再测试,再配 Mapping,最后激活。

前置条件#

  • 一个 AliExpress 卖家账号,且有可售、可发货的店铺。
  • 在 AliExpress App 控制台里有一个应用,且有权限打开该应用复制其中的值。
  • 卖家账号持有人能走完 AliExpress OAuth 授权流程,拿到 Session(访问令牌)。

拿凭证#

  1. 打开 AliExpress App 控制台 → 你的应用,原样复制里面显示的 TOP 网关地址。不要凭记忆手打网关——该地址不硬编码,必须按控制台显示的原样填写。
  2. 在同一个应用里,复制 App Key。
  3. 在同一页面,复制 App Secret。它用于请求签名——妥善保存。
  4. 为您的卖家账号走完 AliExpress OAuth 授权流程,拿到该账号的 Session(访问令牌)。

填进 Integration#

  1. 打开 Integration → 连接器市场 → AliExpress → 新建连接。
  2. API 网关地址——必填:粘贴从 AliExpress App 控制台复制的 TOP 网关地址,按控制台显示的原样填写(占位示例:https://…)。
  3. App Key——必填:粘贴 AliExpress App 控制台 → 你的应用里的 App Key。
  4. App Secret——必填:粘贴同一页面的 App Secret。它用于请求签名,绝不打日志、不返回前端。
  5. Session(访问令牌)——必填:粘贴卖家账号的 OAuth session / access token,走 AliExpress OAuth 授权流程获取。

测试连接#

点测试连接。测试会检查网关地址、用 App Key 和 App Secret 签一次请求,并确认 Session 能被您的卖家账号接受。通过说明四个值是一套的。失败时先记下报错,对照下方常见问题排查,不要先改其他设置。

配 Mapping / 选模板#

选 AliExpress 标准模板。它映射订单号、行 SKU、数量、收货地址、履约状态。激活前先用一个真实订单看映射预览——重点确认每个 AliExpress SKU 都配到了 OMS 产品,这样产品与库存推送在两边才对得上。

AliExpress 订单往返:订单进来,履约、产品与库存回去。

激活#

激活后,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 卖家店铺下一个测试订单,确认下单时间落在拉单范围内,再手动拉一次,在预览或 运行监控 / 日志里确认订单出现。