订单全量信息回调
说明
- 订单状态变化,同步合作方,数据同步采取推送为主,拉取补偿,推拉结合保证同步成功率
- 此为推送方式,拉取方式参见:订单全量信息
- 烦请合作伙伴尽量通过回调方式获取订单信息,避免高频调用拉接口取影响服务性能
地址URL
合作方提供
HTTP请求方式
POST
推送数据说明
名称 | 类型 | 说明 |
---|---|---|
orderNo | String | 订单号 |
status | int | 订单状态,参见:订单状态 |
orderInfo | JOSN | 订单信息,参见:订单详情 |
driverInfo | JOSN | 司机信息,相应状态有返回,参见:司机信息 |
feeInfo | JOSN | 费用信息,相应状态有返回,参见:订单费用 |
cancelReasonInfo | JOSN | 取消原因,相应状态有返回,参见:取消原因 |
推送数据示例
{
"orderNo": "XXX",
"status": 50,
"orderInfo": {
"channelsNum": "partner-XXX",
"orderNo": "XXX",
"partnerOrderNo": "XXX",
"type": 3,
"status": 50,
"serviceTypeId": 1,
"serviceTypeName": "即时用车",
"cityId": 44,
"cityName": "北京",
"riderName": "旗妙用户",
"riderPhone": "18801480000",
"bookingDate": "2020-03-03 19:20:00",
"bookingStartAddr": "北京市通州区台湖镇榕城家园同辉家园",
"bookingStartPoint": "116.544202,39.81673;116.544049,39.816738",
"bookingEndAddr": "朝阳区亮马桥",
"bookingEndPoint": "116.46343,39.949958;116.46343,39.949958",
"bookingCarGroupids": "34",
"factDate": "2020-03-03 16:18:53",
"factStartAddr": "北京市 昌平区 太平庄中二街 162号 ",
"factStartPoint": "11.41622016059027,40.07491400824653;11.422636,40.081143",
"factEndAddr": "北京市 昌平区 太平庄中二街 162号",
"factEndPoint": "11.41622016059027,40.07491400824653;11.422636,40.081143",
"factEndDate": "2020-03-03 16:18:57",
"driverId": 1010000,
"licensePlates": "京BA0000",
"carGroupId": 34,
"carGroupName": "专享",
"riderSign": "超级vip",
"wayList": [{
"wayPoint": "116.512841,39.79381",
"wayAddr": "欢乐谷"
}],
"airportId": null,
"airlineNo": null,
"airlineStatus": null,
"airlinePlanDate": null,
"airlineArrDate": null,
"airlineDepCode": null,
"airlineArrCode": null,
"createDate": "2020-03-03 16:17:56"
},
"driverInfo": {
"driverId": 123,
"driverName": "张三",
"driverPhone": "13800138000",
"driverGrade": 4.8,
"licensePlates": "京BA0004",
"vehicleBrand": "红旗H7",
"vehicleColor": "黑色",
"driverPoint": {
"point": "116.519178,116.519178",
"timestamp": 1669777868105
}
},
"feeInfo": {
"distance": 0,
"duration": 1,
"totalAmount": 10,
"orderFee": 10,
"cancelFee": 0,
"settleAmount": 9.5,
"otherFee": {
"highSpeedFee": 0,
"parkingFee": 0,
"airportFee": 0,
"boardLodgingFee": 0
}
},
"cancelReasonInfo": null
}
回调结果说明
1、标准返回格式
名称 | 类型 | 说明 |
---|---|---|
code | int | 返回结果状态码 0失败,1成功 |
msg | String | 返回信息提示,成功默认:SUCCESS,错默认:ERROR |
data | Object | 根据不同接口,返回不同结果集 |
{
"code": 1,
"msg": "SUCCESS",
"data": null
}
2、非标准返回
考虑到合作伙伴系统出入参返回格式不尽相同,如果特殊需求,可双方协商约定返回结果格式
3、重试幂等说明
订单状态同步回调,目前,回调结果返回失败,或请求超时,有3次重试(加初始1次,共计4次),需要友商支持重复回调幂等;
需特别注意的是,45和50状态,要支持多次回调,因为若有客诉,判司机有责的话,客服会操作订单重新结算,订单金额会变化