司机信息推送接口

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

接口概述

1、该接口用来推送司机信息（对接前请先确认接单模式）。
2、携程会对请求内容中的国家码、电话、车型、车牌号等信息进行合法性校验。当供应商未收到携程的返回值时应当发起重试，该接口最多重试三次，每次间隔5秒。该接口也可以用来在订单开始服务前更新司机信息。

请求地址

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

请求内容

PushDriverRequest

参数	类型	必传	描述	示例	备注
ctripPurchaseOrderID	Long	是	携程采购单号	881823967638342968	18位
vendorOrderID	String	是	供应商订单号
externalDriver	Bool	否	非自营运力		Ture 非自营；False 自营
driverId	String	否	司机ID
driverName	String	是	司机名字	李四
driverPhone	String	是	司机真实电话	13161453199	仅在虚拟号码失败等应急场景使用
driverPhoneCode	String	是	司机真实电话国家码	+86
driverVirtualPhone	String	否	司机虚拟电话	13177777777	对接前请和携程产品沟通虚拟号码绑定逻辑
driverVirtualPhoneCode	String	否	司机虚拟电话国家码	+86
driverAgentVirtualPhone	String	否	代订人绑定的司机虚拟号	13177777777	对接前请和携程产品沟通虚拟号码绑定逻辑
driverAgentVirtualPhoneCode	String	否	代订人绑定的司机虚拟号国家码	+86
driverPhoneLangauge	String	是	司机语言	DR-ZH	司机语言
vehicleNumber	String	是	车牌号码	沪A501Z9
vehicleBrand	String	是	车辆品牌	别克	如果无法区分品牌与车系可以通过这个字段上传输品牌+车系。如：别克GL8
vehicleBrandDetail	String	否	车系	GL8
vehicleColor	String	是	车辆颜色	黑色
driverEmail	String	否	司机邮箱
driverAvaterURL	String	否	司机头像URL
driverImType	String	否	司机IM类别
driverImNo	String	否	司机IM号码
dispatcher	Boolean	否	是否是调度人员
level	BigDecimal	否	司机星级（最高5.0）
pickUpLocationDesc	String	否	接驳点详细信息
pickUpLocationImgUrl	String	否	接驳点图片详细信息
extend	ExtendDTO	否	扩展字段

ExtendDTO

参数	类型	必传	描述	示例	备注
nucleicFlag	Integer	否	核酸检测标签	1	1-是；0-否
vaccineFlag	Integer	否	新冠疫苗标签	0	1-是；0-否
compliance	Integer	否	双证合规标签	0	1-合规 0-不合规

返回内容

PushDriverResponse

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

请求示例

{
    "ctripPurchaseOrderID":881824251234566368,
    "vendorOrderID":"42434223",
    "driverName":"黎师傅",
    "driverPhone":"17817123456",
    "driverPhoneCode":"+86",
    "driverPhoneLangauge":"中文",
    "driverVirtualPhone":"17721111111",
    "driverVirtualPhoneCode":"86",
    "vehicleNumber":"沪A888888",
    "vehicleBrand":"别克",
    "vehicleBrandDetail":"君威",
    "vehicleColor":"白色",
    "driverEmail":"",
    "driverAvaterURL":"",
    "driverImType":"",
    "driverImNo":"",
    "pickUpLocationDesc":"",
    "pickUpLocationImgUrl":"",
    "extend":{
        "nucleicFlag":1,
        "vaccineFlag":0
    }
}

响应示例

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

异常示例

{
    "msgCode": "ERROR_ORDER_NOT_FOUND",
    "massage": "找不到携程单号"
}

results matching ""

No results matching ""