曹操出行开放平台

修改目的地接口

支持行程中修改目的地，修改目的地限制条件：
1、支持修改目的地的订单状态：已派单、司机已到达、乘客上车开始计费、开始服务，其他状态不支持修改目的地
2、企业拼车订单、日租/半日租订单、尊享一口价订单、路线一口价订单，不支持修改目的地
3、每笔订单只能修改一次目的地
4、修改的目的地禁止与订单终点经纬度重复

请求地址： /v2/common/modifyEndLocation

服务协议： HTTP/POST

请求参数：

参数名称 类型 必选 说明
client_id string Y 申请时的client_id
timestamp long Y 时间戳
sign string Y 签名
order_no long Y 订单号
end_location string Y 终点地址详细信息
lg double Y 终点经度
lt double Y 终点纬度
end_poi_id string N 终点POI (高德地图)，下单时传入了终点POI的订单必传

响应data参数：

参数名 类型 必有 说明
pass boolean Y 修改目的地是否成功
estimateInfo object N 到新终点的预估信息，修改成功必有
estimateInfo.carType int Y 服务车型code
estimateInfo.name string Y 车型名称
estimateInfo.price int Y 预估价格，单位分，允许拼车时为拼成一口价
estimateInfo.originPrice int Y 预估价格打折前原价，单位分，允许拼车时为未拼成一口价
estimateInfo.distance int Y 预估行程距离，单位米
estimateInfo.duration int Y 预估行程时间，单位秒
estimateInfo.priceKey string Y 预估金额的key，订单会对预估金额做校验，priceKey有效期为10分钟，如果priceKey过期或出发地经纬度有变化必须重新预估
estimateInfo.derateType int N 折扣类型 1：企业折扣，2：动态折扣
estimateInfo.dynamicRuleId int N 动态折扣ID（企业具备此权限，derateType值为2时才有值），下单时值原样传入
estimateInfo.detail list Y 价格明细列表
estimateInfo.detail.amount int Y 价格，单位分
estimateInfo.detail.chargeCode string Y 价格类型code,，start_fee：订单起步价；travel_km_fee：里程费用；travel_minute_fee：时长费用；long_km_fee：长途费；long_km2_fee：超远长途费；night_fix, 夜间起步费用;night_fee：夜间行驶超长费用；lowest_cost_fee：最低消费补充差额（预约单最低消费30元，例如一笔预约单初始预估18元，则最低消费补充差额为12元）；discount_fee：折扣金额；park_fee：停车费用；bridge_fee：路桥费；other_fee：其他费用；refund_fee：退款金额（客服改价/免单产生的退款金额）；hight_speed_fee：高速费;cross_city_fee:跨城费
estimateInfo.detail.chargeDesc string Y 价格描述（最低消费补充差额：曹操预约单最低消费为30元，若预约单预估价超过30元则最低消费补充差额为0元）

结果示例：

{
  "code": 200,
  "success": true,
  "data": {
    "pass": true,
    "estimateInfo": {
      "carType": 2,
      "detail": [
        {
          "amount": 1000,
          "chargeCode": "start_fee",
          "chargeDesc": "订单起步价"
        },
        {
          "amount": 800,
          "chargeCode": "travel_km_fee",
          "chargeDesc": "里程费用"
        },
        {
          "amount": 450,
          "chargeCode": "travel_minute_fee",
          "chargeDesc": "时间费用"
        },
        {
          "amount": 0,
          "chargeCode": "discount_fee",
          "chargeDesc": "折扣金额"
        },
        {
          "amount": 0,
          "chargeCode": "night_fix",
          "chargeDesc": "夜间费用"
        },
        {
          "amount": 0,
          "chargeCode": "long_km_fee",
          "chargeDesc": "订单长途费用"
        },
        {
          "amount": 0,
          "chargeCode": "lowest_cost_fee",
          "chargeDesc": "最低消费补充差额"
        }
      ],
      "distance": 12759,
      "duration": 1200,
      "name": "新能源",
      "price": 2250,
      "priceKey": "64f6681a-7a77-4ebd-8e36-e7175612559f"
    }
  }
}








修改目的地接口(支持修改前获取修改后的预估价)

新增是否实际修改目的地字段

请求地址： /v2/common/modifyEndLocationV2

服务协议： HTTP/POST

请求参数：

参数名称 类型 必选 说明
client_id string Y 申请时的client_id
timestamp long Y 时间戳
sign string Y 签名
order_no long Y 订单号
modify Boolean Y 是否实际修改目的地 true - 修改目的地 false - 预修改（预估）
end_location string Y 终点地址详细信息
lg double Y 终点经度
lt double Y 终点纬度
end_poi_id string N 终点POI (高德地图)，下单时传入了终点POI的订单必传

响应data参数：

参数名 类型 必有 说明
pass boolean Y 修改目的地是否成功
estimateInfo object N 到新终点的预估信息，修改成功必有
estimateInfo.carType int Y 服务车型code
estimateInfo.name string Y 车型名称
estimateInfo.price int Y 预估价格，单位分，允许拼车时为拼成一口价
estimateInfo.originPrice int Y 预估价格打折前原价，单位分，允许拼车时为未拼成一口价
estimateInfo.distance int Y 预估行程距离，单位米
estimateInfo.duration int Y 预估行程时间，单位秒
estimateInfo.priceKey string Y 预估金额的key，订单会对预估金额做校验，priceKey有效期为10分钟，如果priceKey过期或出发地经纬度有变化必须重新预估
estimateInfo.derateType int N 折扣类型 1：企业折扣，2：动态折扣
estimateInfo.dynamicRuleId int N 动态折扣ID（企业具备此权限，derateType值为2时才有值），下单时值原样传入
estimateInfo.detail list Y 价格明细列表
estimateInfo.detail.amount int Y 价格，单位分
estimateInfo.detail.chargeCode string Y 价格类型code,，start_fee：订单起步价；travel_km_fee：里程费用；travel_minute_fee：时长费用；long_km_fee：长途费；long_km2_fee：超远长途费；night_fix, 夜间起步费用;night_fee：夜间行驶超长费用；lowest_cost_fee：最低消费补充差额（预约单最低消费30元，例如一笔预约单初始预估18元，则最低消费补充差额为12元）；discount_fee：折扣金额；park_fee：停车费用；bridge_fee：路桥费；other_fee：其他费用；refund_fee：退款金额（客服改价/免单产生的退款金额）；hight_speed_fee：高速费;cross_city_fee:跨城费
estimateInfo.detail.chargeDesc string Y 价格描述（最低消费补充差额：曹操预约单最低消费为30元，若预约单预估价超过30元则最低消费补充差额为0元）

结果示例：

{
  "code": 200,
  "success": true,
  "data": {
    "pass": true,
    "estimateInfo": {
      "carType": 2,
      "detail": [
        {
          "amount": 1000,
          "chargeCode": "start_fee",
          "chargeDesc": "订单起步价"
        },
        {
          "amount": 800,
          "chargeCode": "travel_km_fee",
          "chargeDesc": "里程费用"
        },
        {
          "amount": 450,
          "chargeCode": "travel_minute_fee",
          "chargeDesc": "时间费用"
        },
        {
          "amount": 0,
          "chargeCode": "discount_fee",
          "chargeDesc": "折扣金额"
        },
        {
          "amount": 0,
          "chargeCode": "night_fix",
          "chargeDesc": "夜间费用"
        },
        {
          "amount": 0,
          "chargeCode": "long_km_fee",
          "chargeDesc": "订单长途费用"
        },
        {
          "amount": 0,
          "chargeCode": "lowest_cost_fee",
          "chargeDesc": "最低消费补充差额"
        }
      ],
      "distance": 12759,
      "duration": 1200,
      "name": "新能源",
      "price": 2250,
      "priceKey": "64f6681a-7a77-4ebd-8e36-e7175612559f"
    }
  }
}

不可修改目的地的报错
1100050 订单仅可修改一次目的地
1100051 订单类型不可以修改目的地
25011 订单状态不正确
1100054 修改的目的地与订单终点经纬度重复
1100055 终点在司机限行区，暂不支持修改