行程中更改目的地
接口说明
- 行程中更改目的地接口,支持修改目的地和途经点，如果changeType为1（只修改途经点）或3（既修改途经点也修改目的地），需要将所有途经点和目的地信息都传给首约；如果changeType为2（只修改目的地），只需要将目的地信息传给首约；
- changeType=1时, 仅修改途经点时, 允许修改的订单状态为15(司机接单)<=status<=30(行程中)
changeType为其他值时, 允许修改的订单状态status=30(服务中) - 特惠和特快只允许修改目的地, 不允许修改途经点
接口地址
https:// <SQYC_DOMAIN>/carapi/partner/modifyDestination
请求方式
POST
请求参数
| 名称 | 类型 | 是否必输 | 说明 |
|---|---|---|---|
| channel | String | yes | 渠道名称（由首汽约车给定） |
| sign | String | yes | 请求签名，根据签名生成规则计算 |
| orderNo | String | yes | 首汽订单号 |
| partnerOrderNo | String | yes | 合作方订单号 |
| bookingEndAddr | String | yes | 到达地址 |
| bookingEndShortAddr | String | yes | 到达短地址 |
| bookingEndAddrEn | String | no | 英文到达地址 |
| bookingEndShortAddrEn | String | no | 英文到达短地址 |
| bookingEndPointLo | String | yes | 下车地点经度坐标 |
| bookingEndPointLa | String | yes | 下车地点纬度坐标 |
| changeType | Integer | yes | 修改类型，1-修改途经点；2-修改目的地；3-同时修改, 为空则算作按照修改目的地 |
| passingPoints | List<Object> | no | 途经点列表change_type为1 3时有效, 目前只支持两个途经点,已经通过的不能修改或者删除 List参数传递按照form形式:如下所示 第一个n=0,第二个途经点n=1 如: passingPoints[0].bookingPassingLng |
| buyoutPrice | String | no | 渠道方一口价预估价(特惠/特快一口价必传) |
| buyoutPriceFactor | String | no | 渠道方一口价干预比例(buyoutPrice/预估价报价)(特惠/特快一口价必传) |
| priceToken | String | no | 修改目的地预估时的priceToken |
passingPoints请求参数
| 名称 | 类型 | 是否必选 | 说明 |
|---|---|---|---|
| index | int | yes | 0:第一个途径点, 1.第二个途经点 |
| status | int | yes | 0未前往,2.司机点击到达途径点 |
| bookingPassingLng | String | yes | 途经点经度如:"118.59252" |
| bookingPassingLat | String | yes | 途经点纬度如:"24.800137" |
| bookingPassingPointAddr | String | yes | 途经点地址如:"晋江机场航站楼" |
| bookingPassingPointShortAddr | String | no | 途经点短地址:"航站楼" |
返回参数
| 名称 | 类型 | 说明 |
|---|---|---|
| result | Integer | 0：成功；非0：失败原因编号 |
| errmsg | String | 失败原因描述，若成功则值为空,失败原因:见result与errmsg枚举 |
| data | Map<String, Object> | 成功返回,见下面data内容 |
result与errmsg枚举:
| result | errmsg |
|---|---|
| 104 | 司机回家模式，暂不支持修改终点 |
| 105 | 司机暂不支持修改功能 |
| 106 | 途径点最多支持两个 |
| 107 | 该订单状态不支持修改途径点/终点 |
| 108 | 途径点已到达，不支持变更操作 |
| 109 | 修改失败 |
| 110 | 一口价订单不支持该项功能 |
| 111 | 途径点一已经到达，不支持变更操作 |
| 112 | 途径点二已经到达，不支持变更操作 |
| 113 | 途径点均已到达，不支持变更操作 |
data 内容
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| distance | String | 否 | 距离, 单位:公里 |
| duration | String | 否 | 时间, 单位:分钟 |
| actualAmount | String | 否 | 车费预估(优惠后金额), 单位：元 |