订单全量信息回调

说明

  1. 订单状态变化,同步合作方,数据同步采取推送为主,拉取补偿,推拉结合保证同步成功率
  2. 此为推送方式,拉取方式参见:订单全量信息
  3. 烦请合作伙伴尽量通过回调方式获取订单信息,避免高频调用拉接口取影响服务性能

地址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状态,要支持多次回调,因为若有客诉,判司机有责的话,客服会操作订单重新结算,订单金额会变化

Copyright © 红旗智行科技(北京)有限公司 2018 all right reserved,powered by Gitbook该文件修订时间: 2024-05-15 17:10:34

results matching ""

    No results matching ""