跳到主要内容

Exchange Tracking History

运单在生命周期中可能产生多次交换追踪号，每次交换记录在历史表中。

Endpoints​

EndpointMethodDescription
/api/v1/waybill/exchange/historyPOST查询交换历史
/api/v1/waybill/exchange/activePOST查询当前有效交换号

查询交换历史​

POST /api/v1/waybill/exchange/history

{ "waybill_id": "133714" }

Response:

{
  "code": 200,
  "data": {
    "total": 2,
    "data": [
      {
        "exchange_tracking_number": "66903755",
        "tracking_number": "66951416",
        "exchange_label": "//assets.initcdn.com/x/2026/11/04/xxx.pdf",
        "grant_code": "Palletways",
        "exchange_type": "modified_to",
        "is_active": true,
        "created_at": "2026-11-05T10:30:00Z"
      }
    ]
  }
}

查询当前有效交换号​

POST /api/v1/waybill/exchange/active

{ "waybill_id": "133714" }

交换类型​

Type说明
original采购时的原始号
exchange交换面单产生的号
modified_to状态变更后的号

通知​

当面单交换历史变更时，系统自动推送通知到商户配置的 notifyUrl。

通知格式​

{
  "cmd": "exchangeHistory",
  "record": {
    "id": "abc123",
    "waybill_id": "133996",
    "tracking_number": "66936607",
    "exchange_tracking_number": "66953431",
    "exchange_label": "//assets.initcdn.com/...",
    "grant_code": "Palletways",
    "exchange_type": "modified_to",
    "is_active": true,
    "created_at": "2026-11-05T10:30:00Z"
  }
}

通知类型​

cmd说明
exchangeHistory交换历史新增时推送
exchangeHistoryUpdate交换历史面单更新时推送

手动测试通知​

POST /api/v1/waybill/exchange/notify

{
  "waybill_id": "133996",
  "cmd": "exchangeHistory"
}

cmd 可选值：exchangeHistory（测试新增通知）、exchangeHistoryUpdate（测试更新通知）。