轮询订单状态

接口说明

  1. 可订单状态回调的补偿,不可作为主要获取订单状态的方式
  2. 请确认相同订单号的访问频次,超过频次会提示请求频繁。访问频次:10s限制,即10s请求一次。
  3. 一口价忽略返回的费用明细
  4. 此接口请渠道方务必接入
  5. 最多查询三个月内的订单(派前取消的订单仅支持3天以内)

接口地址

https:// <SQYC_DOMAIN>/touch/partner/v2/pollingOrderStatus

请求方式

POST

请求参数

名称 类型 是否必选 说明
orderNo string yes 订单号
partnerOrderNo string yes 合作方订单号
sign string yes 参考sign生成算法
channel string yes 渠道名称,由首汽约车给定

返回数据

名称 类型 说明
result string 0:成功;非0:失败原因编号
errmsg string 失败原因描述,若成功则值为空
data PollingOrderStatusDTO 参见数据节点PollingOrderStatusDTO

返回示例

1、orderStatus <15

{
    "status": 10,
    "enStatus":"place" //见注意事项表
}

{
    "status": 13,  //进入订单池
    "enStatus":"order_pool" //见注意事项表
}

2、15<=orderStatus <43

{
        "driverInfo":{
        "driverId":32891,
        "driverRate":"5",
        "groupName":"舒适型",
        "licensePlates":"黑AA51E5",
        "modelName":"迈腾",
        "name":"李师傅",
        "phone":"17758816774",
        "callerDriverPhone":"17758816774",
        "vehiclePic":"",
        "vehicleColor":"黑色",
        "groupId":43,
        "costGroupId":34,
        "interlinkOrderInfo":{
        "remainEda":2000,
        "remainEta":300,
        "pickUpEda":300,
        "pickUpEta":120,
        "interlinkOrder":"1",
            "prevOrderBookingEndPoint":"116.33333,39.333333"
        },
        "extInfo":{
             "driverType": 1,
             "deviceInfo": "imei",
             "idCard": "110229190001010913"
        }
    },
    "orderNo": "B5516123704226082",
    "partnerOrderNo": "1516123704094359",
    "status": 15,
    "cityId": 44,//特定渠道返回,上车点城市ID
    "bookingDate": "2021-01-13 10:43:04",//特定渠道返回,预约用车时间
    "bookingEndAddr": "",//特定渠道返回,预定下车地址
    "bookingStartAddr": "",//特定渠道返回,预定上车地址
    "riderPhone": "13333333333",//特定渠道返回,乘车人手机号
    "enStatus": "accepted" //见注意事项表
}

3、orderStatus = 43 | 45 | 50

{
    "result": "0",
    "errmsg": "SUCCESS",
    "data": {
        "feeInfo": {
            "min": "0",
            "mileage": "0.00",
            "total": "14.10",
            "actualPayAmount": "14.10",
            "buyoutTravelFlag": "1", //特价/特快使用, 一口价行程费为1, 其他为空
            "customerPayPrice": "14.10",
            "decimalsFees": "0.00",
            "endDate": "2023-01-01 17:14:34", // 仅仅部分渠道返回
            "basePrice": "14.00",
            "includeMinute": "12",
            "includeMileage": "2",
            "timePrice": null,
            "mileagePrice": null,
            "overTimePrice": "0.00",
            "overMilagePrice": "0.00",
            "overTimeNum": "0.00",
            "overMilageNum": "0.00",
            "overMilageNumTotal": "0.00",
            "overTimeNumTotal": "0.00",
            "longDistanceNum": "0.00",
            "longDistancePrice": "0.00",
            "longPrice": "0",
            "hotDuration": "0",
            "hotDurationFees": "0.00",
            "hotMileage": "0.00",
            "hotMileageFees": "0.00",
            "peakPrice": "0",
            "peakPriceTime": "0",
            "nightDistanceNum": "0.00",
            "nightDistancePrice": "0.00",
            "nighitDuration": "0",
            "nighitDurationFees": "0.00",
            "nightPrice": "0",
            "nightPriceTime": "0",
            "couponAmount": "0",
            "couponSettleAmout": "0.00",
            "waitingMinutes": "0.00",
            "waitingFee": "0.00",
            "reducePrice": 0,
            "reducePriceDesc": null,
            "otherCost": [ // 该项内的费用不可开票
                {
                    "cost": "0.10",
                    "typeName": "高速服务费"
                },
                {
                    "cost": "0",
                    "typeName": "停车费"
                },
                {
                    "cost": "0",
                    "typeName": "机场服务费"
                },
                {
                    "cost": "0",
                    "typeName": "食宿费"
                },
                {
                    "cost": "0.00",
                    "typeName": "语音费"
                }
            ],
            "extPriceInfo": [ // 该项内的费用可开票
                {
                    "name": "dynamicDoublyAmount",
                    "value": "184.51",
                    "desc": "动态加价金额"
                },
                {
                    "name": "costTypeAmount",
                    "value": "184.51",
                    "desc": "司机过节费"
                },
                {
                    "name": "crossCityFee",
                    "value": "184.51",
                    "desc": "跨城费"
                }
            ],
            "aliPay": "0",
            "wxPay": "0",
            "creditPay": "0",
            "accountPay": "0",
            "driverPay": "0",
            "designatedDriverFee": "0.00",
            "dynamic_price": "0.0",
            "serviceType": "1",
            "riderName": null,
            "groupName": "舒适型",
            "startDate": "2021-01-13 10:43:04",
            "endDate": "2021-01-13 10:43:07",
            "startPlace": "中山国际广场",
            "endPlace": "上海虹桥国际机场",
            "status": 1,
            "cancelAmount": 0,
            "estimatedAmount": 0,
            "channelDiscountAmount": 0,
            "channelDiscountPercent": 0,
            "channelDiscountType": 0,
            "hasCoupon": 0,
            "reductionPrice": 0,
            "reductionReason": "",
            "reductionDate": null,
            "reductionPerson": 0,
            "languageServiceFee": "0.00",
            "carpool": null,
            "minHour": null,
            "channelFlodAmount": 0,
            "energyDiscountAmount": "0.0",
            "businessActualPayAmount": "0.0",
            "paymentDiscountAmount": "0",
            "cancelOrderDamageAmount": "0",
            "generalActualPayAmount": "0.0",
            "payType": null,
            "otherSettleAmount": "0",
            "isOfflinePay": "2",
            "isEndWaitSettle": null,
            "includeMinuteHour": null,
            "channelsNum": "partner-tuniu",
            "carImage": "",
            "factDriverId": "100025649",
            "groupId": 34,
            "costGroupId": 43,
            "settleChannelRefund": "1.22",
            "channelDepositAmount": "321.00",
            "passengerPendingPay": "0.00",
            "factStartPoint": "121.35504,31.218;121.346233,31.202241",
            "factEndPoint": "121.339785,31.196056;121.346233,31.202241"
        },
        "orderNo": "B210113104043907000",
        "partnerOrderNo": "a2ea2f75-8f7f-41ea-a11d-bcbc4efab02c",
        "driverName": "测师傅",
        "driverPhone": "15510740920",
        "callerDriverPhone": "17758816774",//日租半日租业务,如果有代叫人,则此字段对应代叫人对应的司机虚拟号信息
        "hideDriverPhone": null,
        "enStatus": "order_finished",
        "status": 50,
        "isSensitiveOrder": 0,//特定渠道使用,是否敏感订单:1-是,0-否
        "sensitiveRemark": "敏感订单",//特定渠道使用,敏感原因
        "bookingEndAddr": "",
        "bookingStartAddr": "",
        "passingPoints": [
            {
                "bookingPassingPoint": "118.59252,24.800137",
                "bookingPassingPointAddr": "晋江机场航站楼(途经点1)",
                "factPassingPoint": "118.573291061013,24.920850780804",
                "factPassingPointAddr": "泉州市丰泽区江滨北路",
                "factPassingPointTime": "2020-11-19 16:59:00"
            },{
                "bookingPassingPoint": "118.59252,24.800137",
                "bookingPassingPointAddr": "晋江机场航站楼(途经点2)",
                "factPassingPoint": "118.573291061013,24.920850780804",
                "factPassingPointAddr": "泉州市丰泽区江滨北路",
                "factPassingPointTime": "2020-11-19 16:59:00"
            }
        ]
    }
}

4、orderStatus = 60

{
    "cancelFee": "0.0",
    "enStatus": "self_canceled",
    "status": 60
    "finishTime": "2022-05-19 00:02:13" // 结算时间, 特定渠道 且 取消费不为0的情况返回,默认不返回
}

状态说明

enStatus状态 待支付(后付)(原司机代收)模式

status值 状态说明
10 place 下单
15 accepted 司机接单
15 reassign 改派
20 setout 已出发
25 arriving 已到达
30 in_progress 服务中
40 end_trip 司机服务完成
43 completed 司机确认结算
45 offline_pay 服务结束已结算,司机代收
45 third_pay 服务结束已结算,三方支付
60 sys_canceled 系统取消
60 cs_canceled 客服取消
60 driver_overtime_canceled 司机无责取消
60 self_canceled 乘客自己取消
50 order_finished 订单确认
50 cs_refund 退款

enStatus状态 无司机代收模式

status值 状态说明
10 place 下单
15 accepted 司机接单
15 reassign 改派
20 setout 已出发
25 arriving 已到达
30 in_progress 服务中
40 end_trip 服务完成待结算
45 completed 服务结束已结算已支付
60 sys_canceled 系统取消
60 cs_canceled 客服取消
60 driver_overtime_canceled 司机无责取消
60 self_canceled 乘客自己取消
50 order_finished 订单确认
50 cs_refund 退款
Copyright © 首约科技(北京)有限公司 2020 all right reserved,powered by Gitbook该文件修订时间: 2024-09-10 08:31:45

results matching ""

    No results matching ""