用 API 查询 AliExpress 跨境包裹的物流轨迹

2026-07-20 · 阅读约 5 分钟

做跨境电商工具或者帮买家做订单跟踪，绕不开菜鸟网络：AliExpress 大量订单由菜鸟国际承运，从国内仓一路到目的国签收。本文讲清楚这类包裹的物流轨迹查询怎么用接口做，以及返回的清关、干线节点该怎么解读。

一、认识跨境单号

菜鸟国际的运单号是字母数字混合格式，常见 CGD、LP 等前缀，例如 CGD0000123456。注意两点：

单号里有字母，处理时不要按纯数字清洗（很多老代码会把非数字字符全部去掉，单号就废了）；
大小写不敏感，接口内部会统一为大写。

二、调用接口

快递公司编码用 cainiao：

curl -X POST https://api.kuaidichaxunapi.com/v1/tracking/trace \
  -H "Authorization: Bearer pk_xxx:sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"courierCode":"cainiao","trackingNumber":"CGD0000123456"}]}'

一个真实包裹（中国 → 沙特，已签收）返回的轨迹节选：

2026-06-11 17:47:55  用户已签收            DELIVERED
2026-06-11 10:03:40  包裹开始重新派送      OUT_FOR_DELIVERY
2026-06-10 10:46:10  包裹派送失败          FAILED
2026-06-08 22:12:33  包裹清关完成          IN_TRANSIT
2026-06-05 09:30:17  干线航班起飞          IN_TRANSIT
2026-06-04 20:54:45  集货仓出库成功        PICKED_UP

三、读懂跨境节点

跨境包裹的轨迹比国内件长，大体分五段：

阶段	典型描述	常见状态码
仓内处理	已下单 / 集货仓出库	`PICKED_UP`
干线运输	干线起飞 / 到达目的国	`IN_TRANSIT`
清关	出口/进口清关开始、完成	`IN_TRANSIT`
末端派送	交接本地承运商 / 开始派送	`OUT_FOR_DELIVERY`
终态	签收 / 派送失败 / 退回	`DELIVERED` / `FAILED` / `RETURNED`

实用提示：清关阶段停留数天属正常，不必因为轨迹几天不动就判定异常；而 FAILED（派送失败）之后常会出现「重新派送」并最终签收，像上面的例子那样 —— 给用户展示时建议以最新一条状态为准。

四、时区注意事项

跨境轨迹的每个事件发生在不同国家，dateTime 是事件当地时间 （出库是中国时间，签收是目的国时间）。做时间轴展示没问题；但如果要计算「运输总时长」，直接相减会有几小时误差，精确计算需按事件所在时区换算。

五、常见问题

查不到（NOT_FOUND）？ 刚下单的包裹上网需要时间，通常发货后数小时到一天内轨迹才出现，稍后重查即可。
轨迹语言：接口对轨迹描述做了标准化，主要节点为中文描述；个别末端承运商的原文会附在 description 字段。
国内快递呢？顺丰、中通等国内公司的接口编码与运单号格式见快递公司页，调用方式与本文完全相同。

对接基础（认证、批量、错误处理）见上一篇：快递查询接口对接指南。