查询订单详情(轮询接口)
接口说明: 订单详情接口
接口提供方: 合作方
请求地址: https://{$domain}/partner/pollingOrderStatus
服务协议: HTTPS/GET
请求参数:
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
channel | string | 是 | 分配的合作方的标识,每个合作方一个,对应分配给合作方的client_id |
timestamp | long | 是 | 请求时间,UnixTimestamp单位毫秒 |
sign | string | 是 | 签名 |
mtOrderId | string | 是 | 美团订单号 |
partnerOrderId | string | 是 | 合作方订单号 |
响应参数:
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
result | int | 是 | 0:成功;非0:失败原因编号 |
message | string | 否 | 失败原因描述,若成功值可为空 |
data | object | 是 | 订单详情信息 |
data.bill | object | 是 | 账单,金额单位为分,状态编码为90、95、100情况下必传,其他情况不传 |
data.bill.fixedPriceType | int | 否 | 0:实时计价模式。1:一口价模式 |
data.bill.fixedPrice | int | 否 | 一口价价格,单位分 |
data.bill.totalPrice | int | 是 | 行程基础类费用总额,单位分。完成履约行为后,除去高速费、停车费、感谢费、其他费用四项附加类费用项外订单产生的行程费用总和 |
data.bill.driveDistance | int | 是 | 行驶里程,单位m |
data.bill.driveTime | int | 是 | 行驶时长,单位ms |
data.bill.initPrice | int | 是 | 起步价。订单开始履约需要收取的费用,包含一定的里程和时长。注:当时长费和里程费不满起步价,但需要按照起步价金额收取的时候,里程费和时长费不需要传递,只传起步价金额。 |
data.bill.driveDistancePrice | int | 是 | 里程费。行驶里程产生的费用总额,里程费=正常里程费+夜间里程费 |
data.bill.driveTimePrice | int | 是 | 时长费。行驶时间产生的费用总额 |
data.bill.normalTimePrice | int | 否 | 正常时长费。非高峰及夜间时段行驶时间产生的费用总额 |
data.bill.normalDistancePrice | int | 否 | 正常里程费。非高峰及夜间时段行驶里程产生的费用总额 |
data.bill.longDistancePrice | int | 否 | 远程费。超过一定里程之后收取的远途行驶里程费用总和 |
data.bill.longDistance | int | 否 | 远程里程,单位m |
data.bill.nightPrice | int | 否 | 夜间里程费。夜间时段行驶里程产生的费用总额 |
data.bill.nightDistance | int | 否 | 夜间里程。单位m |
data.bill.highwayPrice | int | 否 | 高速费。订单履约过程产生的高速类费用,此费用为代收代付类费用不能开票,不能抽佣,不能使用红包抵扣 |
data.bill.tollPrice | int | 否 | 通行费。订单履约过程产生的过路过桥类费用,此费用为代收代付类费用不能开票,不能抽佣,不能使用红包抵扣 |
data.bill.parkPrice | int | 否 | 停车费。订单履约过程产生的停车类费用,此费用为代收代付类费用不能开票,不能抽佣,不能使用红包抵扣 |
data.bill.otherPrice | int | 否 | 其他费。订单履约过程中产生的其他代收代付类费用,如:清洁费等费用项,此费用为代收代付类费用不能开票,不能抽佣,不能使用红包抵扣 |
data.bill.dynamicPrice | int | 否 | 动态调价费。根据供需关系对订单费用进行实时调价的金额。(此值可正可负,当为正值时美团会处展示成溢价费;当为负值时美团会展示为动态折扣) |
data.bill.suspectStatus | int | 否 | 费用是否可异议:0-否,1-是 |
data.bill.cancelPay | int | 否 | 应收取消费。取消状态下等于waitingPrice+cancelPrice |
data.bill.discountPrice | int | 否 | 合作方折扣金额。合作方给美团渠道提供的优惠金额,此字段需要传正值 |
data.bill.waitingPrice | int | 否 | 等待费。等待时间产生的费用总和 |
data.bill.waitingTime | int | 否 | 等待时长,单位ms |
data.bill.cancelPrice | int | 否 | 取消费 |
data.bill.eDispatchPrice | int | 否 | 电调费金额,单位:分。出租车场景下,国家允许收取的加价费用 |
data.bill.taxiMeterFee | int | 否 | 计价器费金额,单位:分。出租车场景下,打表计费产生的费用 |
data.bill.servicePriceType | int | 否 | 服务费类型,默认传0,收取节假日服务费时传1 |
data.bill.servicePrice | int | 否 | 服务费金额 单位:分 |
data.bill.preSettlePrice | int | 否 | 预计商应收的结算金额 单位:分 |
data.carInfo | object | 是 | 接单后车辆信息,状态编码为30~100情况下必传,接单后取消的场景也必须传,其他情况不传 |
data.carInfo.carColor | string | 是 | 颜色 |
data.carInfo.carNumber | string | 是 | 车牌 |
data.carInfo.brandName | string | 是 | 车型 |
data.carInfo.carPic | string | 否 | 车辆图片地址 |
data.carInfo.carId | string | 否 | 车辆ID |
data.customerServiceInfo | object | 是 | 客服等合作方取消订单相关信息,取消状态必传,其他状态不传 |
data.customerServiceInfo.cancelReason | string | 是 | 取消原因 |
data.customerServiceInfo.opName | string | 是 | 操作人名称 |
data.chargeInfo | object | 否 | 乘客线下支付信息,线下支付后状态必传,状态95及后续状态100必传,其他情况不传 |
data.chargeInfo.offlinePayAmount | int | 是 | 用户线下付款金额 |
data.driverInfo | object | 是 | 接单后司机信息,状态编码为30~100情况下必传,接单后取消的场景也必须传,其他情况不传 |
data.driverInfo.driverLastName | string | 是 | 司机姓氏 |
data.driverInfo.driverMobile | string | 是 | 司机电话 |
data.driverInfo.driverName | string | 是 | 司机名称 |
data.driverInfo.driverVirtualMobile | string | 是 | 司机虚拟电话 |
data.driverInfo.partnerDriverId | string(64) | 是 | 合作方司机ID,必须保证每个司机唯一 |
data.driverInfo.driverRate | string | 否 | 司机等级 |
data.driverInfo.driverPic | string | 否 | 司机头像url |
data.driverInfo.continuousAssign | object | 否 | 司机上一单信息(连环派模式) |
data.driverInfo .continuousAssign.preDestLng |
double | 是 | 上一笔单终点经度 |
data.driverInfo .continuousAssign.preDestLat |
double | 是 | 上一笔单终点纬度 |
data.driverInfo .continuousAssign.preOrderId |
string | 是 | 上一笔单美团订单号 |
data.driverInfo .continuousAssign.preRemainDistance |
int | 是 | 上一笔单剩余送驾距离,单位米 |
data.driverInfo .continuousAssign.preRemainSecond |
int | 是 | 上一笔单剩余送驾时间,单位秒 |
data.driverInfo .continuousAssign.wholePickupDistance |
int | 是 | 当前单接驾距离(算上上一笔单送驾距离),单位米 |
data.driverInfo .continuousAssign.wholePickupSecond |
int | 是 | 当前单接驾时间(算上上一笔单送驾时间),单位秒 |
data.eventTime | long | 是 | unix时间戳,ms |
data.mtOrderId | string | 是 | 美团订单号 |
data.partnerOrderId | string(64) | 是 | 合作方订单Id |
data.product | object | 是 | 接单后运力信息 |
data.product.partnerCarTypeId | int | 是 | 合作方运力类型ID:美团快车,美团出租车,首汽出租车,首汽专车等,(新合作方接入,待美团分配) |
data.product.outCarTypeId | string | 否 | 合作方内部运力类型ID |
data.driverLocation | object | 是 | 司机当前经纬度 |
data.driverLocation.lat | double | 是 | 位置纬度 |
data.driverLocation.lng | double | 是 | 位置经度 |
data.status | string | 是 | 订单状态,具体值参见订单状态定义 |
data.driverFingerprint | string | 否 | 运力指纹信息,格式为json,但需要转义为string后赋值 |
data.driverFingerprint.wifimac | string | 是 | 如果连wifi,则连接wifi的地址 |
data.driverFingerprint.dm | string | 是 | 机型 |
data.driverFingerprint.root | bool | 否 | 是否root,android必填 |
data.driverFingerprint.wifimac_name | string | 否 | 如果连wifi,则连接wifi的名称 |
data.driverFingerprint.net | string | 否 | 使用网络 |
data.driverFingerprint.ip | string | 否 | 联网ip地址 |
data.driverFingerprint.blue | bool | 否 | 是否打开蓝牙 |
data.driverFingerprint.imei | string | 否 | 移动设备唯一标识,android必填 |
data.driverFingerprint.imsi | string | 否 | 国际移动用户识别码,android必填 |
data.driverFingerprint.iccid | string | 否 | sim卡手机号,android必填 |
data.driverFingerprint.sim_mobile | string | 否 | sim卡识别码,android必填 |
data.driverFingerprint.androidid | string | 否 | 安卓系统生成时的id,基带id,android必填 |
data.driverFingerprint.mac | string | 否 | mac地址,android必填 |
data.driverFingerprint.idfa | string | 否 | 广告表标识符,ios必填 |
data.driverFingerprint.phonename | string | 否 | 写在系统文件中用户名称,ios必填 |
data.driverFingerprint.keychain | string | 否 | 生成的钥匙串,ios必填 |
账单费用计算说明:
请参考「订单状态回调接口」费用计算说明。
{
"result":0,
"message":"success",
"data":{
"bill":{
"multiple":0,
"cancelPay":0,
"driveTime":2,
"initPrice":1000,
"parkPrice":0,
"tollPrice":0,
"nightPrice":0,
"otherPrice":0,
"totalPrice":1314,
"rewardPrice":0,
"dynamicPrice":0,
"highwayPrice":0,
"longDistance":0,
"driveDistance":0,
"nightDistance":0,
"suspectStatus":0,
"driveTimePrice":0,
"additionalPrice":0,
"dynamicMaxPrice":0,
"normalTimePrice":60,
"longDispatchPrice":0,
"longDistancePrice":0,
"driveDistancePrice":0,
"normalDistancePrice":0,
"platformDispatchPrice":0,
"preSettlePrice":1200,
},
"status":"WAIT_PAY",
"carInfo":{
"carId":"900006354",
"carPic":"",
"carColor":"红色",
"brandName":"帝豪",
"carNumber":"浙A1750"
},
"product":{
"partnerCarTypeId":9
},
"eventTime":1553082564746,
"driverInfo":{
"driverPic":"http://ccimgs.oss.aliyuncs.com/null",
"driverName":"m师傅",
"driverRate":"5.0",
"driverMobile":"18910338868",
"driverLastName":"m",
"partnerDriverId":"190001078"
},
"mtOrderId":"110833397117283538352459100000_0",
"partnerOrderId":"8519502000",
"driverLocation":{
"lat":40.022022,
"lng":116.472244
},
"driverFingerprint":"{\"mac\":\"c4:b3:01:cb:f6:cf\",\"root\":false}"
}