查询订单状态
接口说明:
1:用来获取订单的状态,接单后可以获取闪送员的信息以及轨迹等。
2:请注意,订单状态可能存在回退的情况。
请求url
- /openapi/developer/v5/orderInfo
接口协议以及签名计算
测试联调
参数 |
示例 |
说明 |
clientId |
ss6DzHy9GvHB46Jgo |
App-key |
accessToken |
70882965-5e51-463f-a746-7bcf1b3f1c34 |
通过商户授权获取 |
timestamp |
1631862240982 |
毫秒级时间戳 |
data |
{"issOrderNo":"TDH2021110113343411","thirdOrderNo":"C1119A000013053981"} |
业务入参 |
sign |
87D039703B348259DEF0888035764E3E |
签名 |
参数 |
字段描述 |
类型/是否必传 |
说明 |
issOrderNo |
闪送订单号 |
String(20)/YES |
订单计费接口获取 |
thirdOrderNo |
第三方平台流水号 |
String(30)/YES |
和计费接口orderNo字段保持一致 |
参数 |
类型/是否必传 |
说明 |
示例 |
orderNo |
String(30)/YES |
第三方平台流水号 |
C1119A000013053981 |
orderStatus |
Integer(8)/YES |
订单状态,参考下方订单状态枚举 |
30 |
orderStatusDesc |
String(8)/YES |
订单状态描述,参考下方订单状态枚举 |
待取货 |
subOrderStatus |
Integer(8)/YES |
订单子状态,参考下方订单状态枚举 |
1 |
subOrderStatusDesc |
String(8)/YES |
订单子状态描述,参考下方订单状态枚举 |
待取货 |
pickupPassword |
String(8)/NO |
取件密码,计费接口中pickupPwd传1时,下单后,订单会生成取件码 |
|
deliveryPassword |
String(8)/NO |
收件密码,骑手取件后生成 |
|
courier |
Object/NO |
闪送员信息 |
|
statusChangeLog |
Object[]/YES |
订单状态改变的日志记录 |
|
abortInfo |
Object/NO |
取消订单相关信息 |
|
courierPickupOrderPhotos |
String[]/NO |
闪送员取件时拍照照片 |
|
courierDeliveryOrderPhotos |
String[]/NO |
闪送员收件时拍照照片 |
|
feeInfoList |
Object[]/NO |
费用明细 |
|
totalAmount |
Integer(8)/YES |
订单总金额,优惠前的总费用,单位:分 |
|
couponSaveFee |
Integer(8)/YES |
总优惠额度,即订单总优惠金额,单位:分 |
|
totalFeeAfterSave |
Integer(8)/YES |
实付金额,优惠后的总金额,实付金额=订单总金额-总优惠额度,单位:分 |
|
interestDtoList |
Object[]/YES |
增值服务明细 |
|
sendBackFee |
Integer(8)/YES |
送回费,单位:分 |
0 |
drawback |
Integer(8)/YES |
退款金额,单位:分 |
0 |
参数 |
类型/是否必传 |
说明 |
示例 |
latitude |
String(20)/NO |
闪送员位置纬度(百度坐标系) |
116.289263 |
longitude |
String(20)/NO |
闪送员位置经度(百度坐标系) |
40.055091 |
name |
String(20)/YES |
闪送员姓名 |
测师傅 |
mobile |
String(20)/YES |
闪送员手机号 |
19000000000 |
time |
String(24)/YES |
闪送员位置所处的当前时间 |
2021-11-01 15:36:24 |
type |
Integer(8)/NO |
字段弃用,可忽略 |
1 |
orderCount |
Integer(8)/NO |
闪送员服务总次数 |
2971 |
headIcon |
String(100)/NO |
闪送员头像 |
|
id |
String(20)/NO |
骑手id |
SSBJ000000001 |
blacklisted |
Integer(8)/NO |
字段弃用,可忽略 |
0 |
deliveryProcessTrail |
Object[]/NO |
配送过程轨迹列表 |
|
estimateDeliveryTimeTip |
String(100)/NO |
预计送达时间文案,闪送员未接单或者订单终态,该值为空 |
226米,预计1分钟上门 |
pickupTimeout |
String(24)/YES |
取件超时时间 |
2023-11-01 15:36:24 |
参数 |
类型/是否必传 |
说明 |
示例 |
orderStatus |
String(8)/YES |
订单状态 |
20 |
updateTime |
String(24)/YES |
更新时间 |
2021-11-01 15:21:30 |
参数 |
类型/是否必传 |
说明 |
示例 |
type |
Integer(8)/YES |
费用类型 |
1 |
des |
String(8)/YES |
费用描述 |
里程费 |
fee |
Integer(8)/YES |
费用金额,单位:分 |
1400 |
参数 |
类型/是否必传 |
说明 |
示例 |
type |
Integer(8)/YES |
增值服务类型,详见下方增值服务明细枚举 |
1 |
desc |
String(8)/YES |
增值服务名称 |
蛋糕专送 |
status |
Integer(8)/YES |
状态,1:使用;0:不使用 |
1 |
subDesc |
String/NO |
权益明细 |
优先接单,取件超时赔 |
参数 |
类型/是否必传 |
说明 |
示例 |
deductAmount |
Integer(8)/NO |
扣款金额,单位:分 |
0 |
abortType |
Integer(8)/NO |
取消发起人,详见下方枚举 |
1 |
punishType |
Integer(8)/NO |
取消责任人,详见下方枚举 |
1 |
abortReason |
String(64)/NO |
取消原因 |
客户主动取消订单 |
参数 |
类型/是否必传 |
说明 |
示例 |
longitude |
String(20)/YES |
闪送员位置经度(百度坐标系) |
116.289993 |
latitude |
String(20)/YES |
闪送员位置纬度(百度坐标系) |
40.066191 |
datetime |
String(24)/YES |
闪送员位置所处的当前时间 |
2021-11-01 13:36:24 |
status:订单状态 |
statusDesc:状态描述 |
说明 |
20 |
派单中(转单改派中) |
商户已经支付,订单分配给配送员(subStatus为1,表示派单中;subStatus为2,表示转单改派中) |
30 |
待取货(已就位) |
配送员已经接单(subStatus为1,表示待取货;subStatus为2,表示已就位) |
40 |
闪送中(申请取消中、物品送回中、取消单客服介入中) |
已经取件,配送中(subStatus为1,表示闪送中;subStatus为2,申请取消中;subStatus为3,物品送回中;subStatus为4,取消单客服介入中) |
50 |
已完成(已退款) |
已经配送完成(subStatus为1:已完成;subStatus为2:已退款;) |
60 |
已取消 |
已经取消订单 |
类型 |
描述 |
1 |
客户发起取消 |
3 |
闪送员发起取消 |
10 |
系统自动发起取消 |
类型 |
描述 |
1 |
因客户 |
2 |
因服务 |
3 |
因闪送员 |
10 |
因系统自动取消 |
99 |
因其它 |
类型 |
描述 |
1 |
里程费 |
2 |
续重费 |
3 |
交通费 |
7 |
夜间费 |
8 |
上门费 |
9 |
加价费 |
10 |
溢价费 |
12 |
跨江费 |
15 |
保价费 |
16 |
平台服务费 |
18 |
预约费 |
21 |
偏远地区费 |
24 |
增值服务费 |
25 |
服务费 |
26 |
加价调度费 |
103 |
蛋糕专送服务费 |
104 |
蛋糕专送保费 |
107 |
餐饮专送服务费 |
108 |
品质专送费 |
类型 |
描述 |
15 |
保价 |
103 |
蛋糕专送 |
107 |
餐饮专送 |
108 |
品质专送 |

clientId:ss6DzHy9GvHB46Jgo
accessToken:70882965-5e51-463f-a746-7bcf1b3f1c34
timestamp:1631862240982
data:{"issOrderNo":"TDH2021110113343411","thirdOrderNo":"C1119A000013053981"}
sign:87D039703B348259DEF0888035764E3E
{
"status": 200,
"msg": "订单信息",
"data": {
"orderNo": "C1119A000013053981",
"orderStatus": 30,
"orderStatusDesc": "待取货",
"subOrderStatus":1,
"subOrderStatusDesc":"待取货",
"abortInfo": null,
"pickupPassword": "",
"deliveryPassword": "",
"courier": {
"latitude": "40.055091",
"longitude": "116.289263",
"name": "测师傅",
"mobile": "19000000000",
"time": "2021-11-01 15:36:24",
"type": 1,
"orderCount": 2971,
"headIcon": "",
"id": "SSBJ000000001",
"blacklisted": 0,
"deliveryProcessTrail": [
{
"longitude": 116.289993,
"latitude": 40.066191,
"datetime": "2021-11-01 13:36:24"
},
{
"longitude": 116.297363,
"latitude": 40.067591,
"datetime": "2021-11-01 14:36:24"
},
{
"longitude": 116.399263,
"latitude": 40.155091,
"datetime": "2021-11-01 15:36:24"
}
],
"estimateDeliveryTimeTip": "226米,预计1分钟上门",
"pickupTimeout": "2023-11-01 15:36:24"
},
"statusChangeLog": [
{
"orderStatus": 20,
"updateTime": "2021-11-01 15:21:30"
},
{
"orderStatus": 30,
"updateTime": "2021-11-01 15:36:20"
}
],
"courierPickupOrderPhotos": [],
"courierDeliveryOrderPhotos": [],
"feeInfoList": [
{
"fee": 1400,
"des": "里程费",
"type": 1
},
{
"fee": 1000,
"des": "夜间费",
"type": 7
},
{
"fee": 500,
"des": "加价费",
"type": 9
},
{
"fee": 200,
"des": "保价费",
"type": 15
},
{
"fee": 321,
"des": "增值服务费",
"type": 24
},
{
"fee": 1250,
"des": "续重费",
"type": 2
},
{
"fee": 1200,
"des": "溢价费",
"type": 10
}
]
}
}