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