getPackagesStatus(获取包裹状态)

接口说明

    用于查询包裹当前的状态,单次最大查询包裹数量为100个 。

1.请求参数

参数级别/参数名称 类型/关系 是否必须提交 参数含义及数值要求
syOrderNoList List<String> N 顺友流水号
客户订单号
注意:只能出现二者中的一个。
customerNoList List<String> N

2.请求示例 复制代码

					
{
    "data": {
        "syOrderNoList": [
            "SY10000050059",
            "SY10000050067"
        ]
    }
}
					
				



3.返回参数

参数级别/参数名称 类型/关系 是否必定返回 参数含义及数值要求
ack String Y 接口是否访问成功
SUCCESS:成功
FAILURE:失败
该字段仅用于判断服务接口是否正常响应,请勿用于判断包裹时否创建或预报成功。
errorCode String Y 当ack为FAILURE的时候,返回的错误代码
errorMsg String Y 当ack为FAILURE的时候,返回的错误信息
resultList / 一对多 N
resultList /
orderNo
String Y 查询单号
resultList /
status
String N 状态值
resultList /
statusSpecify
String N 状态值说明
resultList /
packageCode
String N 顺友流水号(成功时必会返回)
resultList /
trackingNumber
String N 追踪号
有值的时候必定会返回
注意:追踪号必须是预报成功之后才会有值
resultList /
processStatus
String N 是否成功
success:成功
failure:失败
resultList /
errorCode
String N 错误代码
processStatus为failure时必定返回
请参见附录
resultList /
errorMsg
String N 错误信息
processStatus为failure时必定返回

4.返回示例 复制代码

					
成功:
{
    "ack": "success",
    "data": {
        "resultList": [
            {
                "orderNo": "SY10000050059",
                "status": "4",
                "statusSpecify": "已预报[等待入仓]",
                "trackingNumber": "SYBAB10000001",
                "processStatus": "success"
            },
            {
                "orderNo": "SY10000050067",
                "status": "4",
                "statusSpecify": "已预报[等待入仓]",
                "trackingNumber": "SYBAB10000002",
                "processStatus": "success"
            }
        ]
    }
}

失败:
{
    "ack": "failure",
    "errorMsg": "需要获取的单号不能为空",
    "errorCode": "S1007"
}