功能概述
用户通过渠道app指定车辆供应商下单后,如该供应商无司机应答,那么渠道可以发起换舱功能。渠道可以向其他车辆供应商发起换舱下单(同普通的出租车及时下单的区别在于多了两个参数 "changeSPFlag" 和 "changeSPLockDuration", 具体含义请查看下单接口),当首汽出租车系统收到此类下单请求时(下单参数中有changeSPFLag标志和changeSPLockDuration时长且值有效),在成功派单给某个司机后,会锁定该司机一定时长(依据下单时传递的锁定时长参数),并通知渠道侧该司机的信息(此通知与正常订单状态变化通知可能会并行或者有重复,渠道需要视情况来处理)。渠道侧内部决策,如果觉得选用首汽的该司机,那么需要调用新的接口(渠道换舱派单决策通知接口)来通知。
注:此功能需要联系商务和产品进行开通
渠道换舱-派单决策通知接口
注:当订单为换舱订单且渠道决定选择首汽出租车时才需要调用此接口
1、接口路径
/v1/common/dispatched/notify
2、请求方式
http method: post
content-type: application/x-www-form-urlencoded
charset: utf8
3、参数
参数名称 | 参数类型 | 是否必传 | 参数说明 |
---|---|---|---|
orderId | 字符串 | 是 | 首汽订单号 |
channel | 字符串 | 是 | 渠道号,请求来源标识 |
partnerOrderId | 字符串 | 是 | 渠道订单号 |
notifyTime | 字符串 | 是 | 渠道侧内部决策成功毫秒时间戳 |
sign | 字符串 | 是 | 签名 |
4、响应
字段名称 | 字段类型 | 字段说明 |
---|---|---|
result | int | 0-成功,1-失败 |
errmsg | string | 失败原因说明 |
data | Object | null |
{
"result": 0,
"errmsg": "success !",
"data": null
}