司机状态推送接口

Point-to-point支持：必须接入 更新时间： 2022-10-17 必须接入在线调试（沙箱环境）

接口概述

1、该接口用来在接单后推送司机状态信息，当供应商未收到携程的响应结果时应主动发起重试，最多重试三次，每次间隔5秒。
2、请供应商要求司机按顺序操作行程，携程会校验司机状态的推送顺序。
3、特别地，立即打车场景下，司机接单后系统即认为已出发接乘客，可以不推该状态，但预约打车是要推的。

请求地址

地址格式: {Domain}/{Channel}-{vendorId}/driver/inplace/2.0/{ctripPurchaseOrderID}/{timeStamp}/{sign}

请求内容

PushDriverStatusRequest

参数	类型	必传	描述	示例	备注
ctripPurchaseOrderID	Long	是	携程采购单号	881823967638342968	18位
vendorOrderID	String	是	供应商订单id
vehicleStatus	Integer	是	司机状态	1	司机状态列表
waypoints	List<Waypoint>	否	途经点列表		最多2个；仅带途经点的打车订单回传，不传表示无途经点

Waypoint

参数	类型	必传	描述	示例	备注
no	Integer	是	途经点序号	1	按途经顺序从0开始递增，最多2个
status	Integer	是	途经点状态	0	0-未到达；1-已到达；2-已离开
latitude	BigDecimal	否	纬度	31.194360	精确到小数点后6位，不足6位补0
longitude	BigDecimal	否	经度	121.320170	精确到小数点后6位，不足6位补0
coordinate	String	否	坐标系类型	GCJ02	GCJ02；WGS84
time	String	否	点位时间	2020-08-28 14:46	格式为yyyy-MM-dd HH:mm；途经点到达/离开时间

返回内容

PushDriverStatusResponse

参数	类型	必传	描述	示例	备注
msgCode	String	是	响应码	OK	响应码
message	String	否	响应详情	成功	响应码

请求示例

{
  "waypoints": [
    {
      "no": 1,
      "status": 0,
      "latitude": 31.194360,
      "longitude": 121.320170,
      "coordinate": "GCJ02",
      "time": "2020-08-28 14:46"
    }
  ],
    "ctripPurchaseOrderID": 881824212456774814,
    "vendorOrderID": "1232423",
    "vehicleStatus": 1
}

响应示例

{
  "msgCode": "OK",
  "message": "成功",
}

异常示例

{
  "msgCode": "ERROR_NO_ORDERID",
  "message": "找不到订单"
}

results matching ""

No results matching ""