首页 /接口文档 /正文/

8：查询订单详情

2021年11月05日

查询订单详情

接口说明：
1：用来获取订单的状态，接单后可以获取闪送员的信息以及轨迹等。
2：请注意，订单状态可能存在回退的情况。
  • 入参说明
参数 示例 说明
clientId sssHhHPkzCNWG1sFs App-key
shopId 20000000000001715 商户ID
timestamp 1634095503814 毫秒级时间戳
data {"issOrderNo":"TDH2021101414762697","thirdOrderNo":"C1119A000013053981"} 业务入参
sign F91A3CB29F3BC44261A118067BAFFA97 签名
  • data参数说明
参数 字段描述 类型/是否必传 说明
issOrderNo 闪送订单号 String(20)/YES 订单计费接口获取
thirdOrderNo 第三方平台流水号 String(30)/YES 计费接口中orderNo字段保持一致
  • 出参说明
参数 类型/是否必传 说明 示例
orderNo String(20)/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 收件密码，计费接口中deliveryPwd传1时，骑手取件后生成
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
  • courier说明
参数 类型/是否必传 说明 示例
latitude String(20)/NO 闪送员位置纬度（百度坐标系） 116.289993
longitude String(20)/NO 闪送员位置经度（百度坐标系） 40.066191
name String(20)/YES 闪送员姓名 测师傅
mobile String(20)/YES 闪送员手机号 19000000000
time String(24)/YES 闪送员位置所处的当前时间 2021-10-14 12:32:06
type Integer(8)/NO 字段弃用，可忽略 1
orderCount Integer(8)/NO 闪送员服务总次数 2927
headIcon String(100)/NO 闪送员头像
id String(20)/NO 骑手id SSBJ000000001
blacklisted Integer(8)/NO 字段弃用，可忽略 0
deliveryProcessTrail Object[]/NO 配送过程轨迹列表
estimateDeliveryTimeTip String(100)/NO 预计送达时间文案,闪送员未接单或者订单终态，该值为空 228米,预计1分钟上门
pickupTimeout String(24)/YES 取件超时时间 2023-11-01 15:36:24
  • statusChangeLog说明
参数 类型/是否必传 说明 示例
orderStatus String(8)/YES 订单状态 20
updateTime String(24)/YES 更新时间 2021-10-14 14:24:18
  • feeInfoList说明
参数 类型/是否必传 说明 示例
type Integer(8)/YES 费用类型 1
des String(8)/YES 费用描述 里程费
fee Integer(8)/YES 费用金额，单位：分 1400
  • interestDtoList说明
参数 类型/是否必传 说明 示例
type Integer(8)/YES 增值服务类型，详见下方增值服务明细枚举 1
desc String(8)/YES 增值服务名称 蛋糕专送
status Integer(8)/YES 状态，1：使用；0：不使用 1
subDesc String/NO 权益明细
  • abortInfo说明
参数 类型/是否必传 说明 示例
deductAmount Integer(8)/NO 扣款金额，单位：分 0
abortType Integer(8)/NO 取消发起人，详见下方枚举 1
punishType Integer(8)/NO 取消责任人，详见下方枚举 1
abortReason String(64)/NO 取消原因 客户主动取消订单
  • deliveryProcessTrail说明
参数 类型/是否必传 说明 示例
longitude String(20)/YES 闪送员位置经度（百度坐标系） 116.289263
latitude String(20)/YES 闪送员位置纬度（百度坐标系） 40.055091
datetime String(24)/YES 闪送员位置所处的当前时间 2021-10-14 13:30:31
  • 订单状态枚举
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 已取消 已经取消订单
  • abortType枚举
类型 描述
1 客户发起取消
3 闪送员发起取消
10 系统自动发起取消
  • punishType枚举
类型 描述
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 品质专送
  • 订单状态流转图
    订单状态流转 7.png
  • 入参示例
clientId:sssHhHPkzCNWG1sFs
shopId:20000000000001715
timestamp:1634095503814
data:{"issOrderNo":"TDH2021101414762697","thirdOrderNo":"C1119A000013053981"}
sign:F91A3CB29F3BC44261A118067BAFFA97
  • 出参示例
{
    "status":200,
    "msg":"订单信息",
    "data":{
        "orderNo":"C1119A000013053981",
        "orderStatus":60,
        "orderStatusDesc":"已取消",
        "subOrderStatus":null,
        "subOrderStatusDesc":null,
        "abortInfo":{
            "deductAmount":0,
            "abortType":1,
            "punishType":1,
            "abortReason":"客户主动取消订单"
        },
        "pickupPassword":"",
        "deliveryPassword":"",
        "courier":{
            "latitude":null,
            "longitude":null,
            "name":"测师傅",
            "mobile":"19000000000",
            "time":null,
            "type":1,
            "orderCount":3398,
            "headIcon":"",
            "id":"SSBJ000000001",
            "blacklisted":0,
            "deliveryProcessTrail":null,
            "estimateDeliveryTimeTip":null,
            "pickupTimeout": "2023-11-01 15:36:24"
        },
        "statusChangeLog":[
            {
                "orderStatus":20,
                "updateTime":"2021-10-14 14:24:18"
            },
            {
                "orderStatus":30,
                "updateTime":"2021-10-14 14:28:19"
            },
            {
                "orderStatus":60,
                "updateTime":"2021-10-15 11:15:11"
            }
        ],
        "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
            }
        ]
    }
}
关键词：