推送订单状态


接口说明: 回调接口

接口提供方: 美团

请求地址: 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.preDestName string 是 上一笔单终点名称
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 是 位置经度
navigationSummary object 否 导航信息,举手时需要
navigationSummary.pickupDistance int 是 接驾距离 米
navigationSummary.pickupSecond int 是 接驾时长 秒
status string 是 订单状态,具体值参见订单状态定义,赋值为英文名称

账单费用计算说明:

订单完成履约行为费用计算公式:

非出租车场景下:totalprice = initPrice + driveDistancePrice + driveTimePrice + longDistancePrice + dynamicPrice + waitingPrice + servicePrice - discountPrice

订单完成履约行为一口价场景费用计算公式:

非出租车场景下:totalprice = fixedPrice + servicePrice

出租车场景下:totalprice = eDispatchPrice + taxiMeterFee

订单未完成履约行为(取消场景下)费用计算公式:

cancelPay = cancelPrice + waitingPrice

响应参数:

参数名称 类型 必选 说明
result int 是 0:成功;非0:失败原因编号
message string 否 失败原因描述,若成功值可为空

results matching ""

    No results matching ""