查询订单轨迹接口

接口

http://dmsqa.xiyou56.com/trackingRecords/getByOrdersIdOrTrackingNumber

Feign接口

com.wpglb.orders.feign.ITrackingRecordsClient#getByOrdersIdOrTrackingNumber

method

POST

请求示例

  • BODY
{
  "ordersId": 2042123082991476738,
  "trackingNumber": "WP2604090000456"
}

请求参数：

参数 类型 是否必填 说明
ordersId Long 否 订单ID
trackingNumber String 否 订单跟踪单号

响应示例

参数 类型 说明
code int 响应码
success boolean true：成功，false:失败
data object 响应数据
msg String 响应说明
  • data 说明
参数 类型 说明
trackingNumber String 跟踪号
referenceNo String 参考单号
ref2 String 自定义参考单号2
ref3 String 自定义参考单号3
trackingRecords String 轨迹列表
  • trackingRecords 说明
参数 类型 说明
nodeCode String 节点代码
nodeName String 节点名称
remarks String 备注
trackTime String 轨迹发生时间
trackZone String 轨迹发生时区
trackAddress String 轨迹发生地点
descriptionCn String 轨迹描述Cn
descriptionEn String 轨迹描述En
trackSource String 轨迹来源
trackSourceDesc String 轨迹来源描述

成功示例

{
  "code": 200,
  "success": true,
  "data": {
    "trackingNumber": "WP2604090000456",
    "referenceNo": "1775715058",
    "ref2": "audi0001-sku*[1]",
    "ref3": "aliexpress001",
    "trackingRecords": [
      {
        "nodeCode": "DD",
        "nodeName": "DELIVERED",
        "remarks": "Delivered",
        "trackTime": "2026-04-13 10:29:01",
        "trackZone": "America/New_York",
        "trackAddress": "FONTANA",
        "descriptionCn": "已送达",
        "descriptionEn": "Delivered",
        "trackSource": 4,
        "trackSourceDesc": "OR"
      },
      {
        "nodeCode": "OD",
        "nodeName": "OUT FOR DELIVERY",
        "remarks": "Out for Delivery",
        "trackTime": "2026-04-13 06:29:01",
        "trackZone": "America/New_York",
        "trackAddress": "Los Angeles",
        "descriptionCn": "派送中",
        "descriptionEn": "Out for Delivery",
        "trackSource": 1,
        "trackSourceDesc": "SYSTEM"
      },
      {
        "nodeCode": "AP",
        "nodeName": "ARRIVED AT WESTERN POST LOCATION",
        "remarks": "Arrived at Final Destination and Is Being Processed",
        "trackTime": "2026-04-13 02:29:01",
        "trackZone": "America/New_York",
        "trackAddress": "Los Angeles",
        "descriptionCn": "到达配送点",
        "descriptionEn": "Arrived at Western Post Location",
        "trackSource": 1,
        "trackSourceDesc": "SYSTEM"
      },
      {
        "nodeCode": "SI",
        "nodeName": "SHIPMENT INFORMATION SENT TO PILOT",
        "remarks": "Shipment Information sent to the Carrier",
        "trackTime": "2026-04-09 02:11:01",
        "trackZone": "America/New_York",
        "trackAddress": "Los Angeles",
        "descriptionCn": "快递信息发送",
        "descriptionEn": "Shipment Information Sent to Western Post",
        "trackSource": 2,
        "trackSourceDesc": "AUTO"
      }
    ]
  },
  "message": "操作成功"
}

失败示例

{
  "code": 400,
  "success": false,
  "data": {
    "trackingNumber": "",
    "referenceNo": "",
    "ref2": "",
    "ref3": "",
    "trackingRecords": []
  },
  "message": "参数错误"
}
{
  "code": 200,
  "success": true,
  "data": {
    "trackingNumber": "",
    "referenceNo": "",
    "ref2": "",
    "ref3": "",
    "trackingRecords": []
  },
  "message": "暂无承载数据"
}
作者：陈杨  创建时间：2026-04-14 14:28
最后编辑：陈杨  更新时间：2026-04-17 09:34