文档中心 > API类目 > 淘宝小时达履约

qimen.alibaba.xsd.logistics.subscribe.query (配送单订阅后查询配送历史状态)

配送单订阅后查询配送历史状态

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
deliveryOrderNo	String	必须	80002024101009		淘宝近场运力单号

响应参数

名称	类型	示例值	描述
success	Boolean	true	查询调用是否成功
code	String	SUCCESS	错误码，成功时非必填
message	String	调用成功	错误说明，成功时非必填
data	DeliverySubscribeQueryResp		返回对象
└ status String ACCEPTED 当前配送单状态 CREATED：创单成功 ACCEPTED：骑手接单 ARRIVED：骑手到店 SHIPPING：骑手揽收 SIGN：用户签收 ABNORMAL：配送异常 CANCEL：配送取消 └ deliveryPersonName String 李四骑手姓名 └ deliveryPersonPhone String 13711112222 骑手电话 history DeliveryOrderStatusHistory [] 历史流水，需包含当前状态 └ status String CREATED 物流状态 └ businessTime Number 1728454086000 物流状态变化时间 sender DeliveryOrderSender 发货人信息 └ senderPhone String 13789560890,0778 发货人电话（示例 13789560890,0778） └ senderAddress String xx省xx市xx区xx街道xx单元发货人地址 └ senderLat String 120.13 发货人纬度（高德坐标数据），格式如120.13 └ senderLng String 120.13 发货人经度（高德坐标数据），格式如120.13 receiver DeliveryOrderReceiver 收货人信息 └ receiverName String 张三收货人姓名 └ receiverAddress String 13789560890,0778 收货人电话（示例：13789560890,0778） └ receiverPhone String xx区xx街道xx单元收货人地址 └ receiverLat String 120.13 收货人纬度（高德坐标数据） └ receiverLng String 120.13 收货人经度（高德坐标数据）

请求示例

{"deliveryOrderNo":"80002024101009"}

响应示例

{
    "success":true,
    "code":"SUCCESS",
    "message":"调用成功",
    "data":{
        "status":"ACCEPTED",
        "deliveryPersonName":"李四",
        "deliveryPersonPhone":"13711112222",
        "history":[
            {
                    "status":"CREATED",
                    "businessTime":1728454086000
            }
        ],
        "sender":{
            "senderPhone":"13789560890,0778",
            "senderAddress":"xx省xx市xx区xx街道xx单元",
            "senderLat":"120.13",
            "senderLng":"120.13"
        },
        "receiver":{
            "receiverName":"张三",
            "receiverAddress":"13789560890,0778",
            "receiverPhone":"xx区xx街道xx单元",
            "receiverLat":"120.13",
            "receiverLng":"120.13"
        }
    }
}

验签示例

{"code":"sign-check-failure","success":"false","message":"Illegal request"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

淘宝小时达履约

qimen.alibaba.xsd.logistics.subscribe.query (配送单订阅后查询配送历史状态)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ