行前修改路线通知
接口说明
渠道侧确认选路结果有效时间5min,超过5min需重新调用[行前选路预估]接口;
允许选路的订单状态为15(司机接单)<=status<=25(已到达);
一口价、预约单、拼车单、特享单、行程中选路不支持该功能;
顺路单、回家模式、连环单、即时用车支持该功能;
选路预估有效期5min,超时则无法选路;
接口地址
https:// <SQYC_DOMAIN>/carapi/partner/select/routes/confirm
请求方式
POST
请求参数
名称 | 类型 | 是否必输 | 说明 |
---|---|---|---|
channel | String | yes | 渠道名称(由首汽约车给定) |
sign | String | yes | 请求签名,根据签名生成规则计算 |
orderNo | String | yes | 首汽订单号 |
partnerOrderNo | String | yes | 合作方订单号 |
priceToken | String | yes | 价格唯一标识(选路预估) |
返回数据
名称 | 类型 | 说明 |
---|---|---|
result | String | 0:成功非0 :失败原因编号 |
errmsg | String | 失败原因描述,若成功则值为空 |
失败result与errmsg枚举:
result | errmsg | 说明 |
---|---|---|
118 | 该订单状态不支持选路 | 非15(司机接单)<=status<=25((已到达)订单状态,不支持选路 |
119 | 订单司机不支持选路 | 该司机不接受选路 |
120 | 该订单类型不支持选路 | 一口价、预约单、拼车单、特享单不支持选路 |
121 | 路线修改失败 | 路线修改失败 |
122 | 路线预估超时修改失败 | 路线预估超时修改失败 |
返回示例
{
"result": 0,
"errmsg": "SUCCESS",
"data":
}