推送订单状态


接口说明: 回调接口

接口提供方: 美团

请求地址: 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 失败原因描述,若成功值可为空

results matching ""

    No results matching ""