预估价格带明细

预估价格只是下单前参考价格,除了一口价订单类型外,最终支付费用以实际产生费用为准,会返回具体的价格明细。提示:目前曹操线上城市未开通服务的车型可以获取预估价格,城市的开通车型以“2.1开通城市服务查询接口”数据为准

请求地址: /v2/common/estimatePriceWithDetail

服务协议: HTTP/GET

请求参数:

参数名称 类型 必选 说明
client_id string Y 申请的client_id
timestamp long Y 时间戳
sign string Y 签名
from_latitude double Y 出发地纬度
from_longitude double Y 出发地经度
to_latitude double Y 目的地纬度
to_longitude double Y 目的地经度
passenger_phone string N 乘客手机号
car_type String Y 服务车型:2 新能源;3 舒适型;5 商务型;7 优选; 14 智能大白车;15 礼帽专车;多种车型用英文逗号分隔,如 1,2
city_code string Y 城市编码(与起点对应的citycode保持一致)
order_type int Y 订单类型,请参照《1.5 订单状态及类型》
departure_time string N 出发时间,非实时单必填(格式:yyyy-MM-dd HH:mm:ss),预约单出发时间必须大于等于当前时间30分钟
order_tags string N 尊享一口价时才需要传递,值为 1 (尊享一口价需与商务确认开通权限)
carpool_type int N 是否允许拼车:0 不拼车;1 允许拼车,默认为不拼车
count_person int N 拼车乘车人数,允许拼车时必填,必须为1或2
waypointList List N 途径点(最多2个途经点)


途经点waypointList 描述 (待上线)

参数名称 类型 必选 说明
orderIndex int Y 途经点到达顺序,有途经点必传
longitude string Y 途经点经度,有途经点必传
latitud string Y 途经点纬度,有途经点必传
poiId string N 高德POI
locationName string Y 途经点地址名称,显示在司机端 ;有途经点必传

响应data参数:

参数名 类型 必有 说明
carType int Y 服务车型code
name string Y 车型名称
price int Y 预估价格,单位分,允许拼车时为拼成一口价
originPrice int Y 预估价格打折前原价,单位分,允许拼车时为未拼成一口价
distance int Y 预估行程距离,单位米
duration int Y 预估行程时间,单位秒
priceKey string Y 预估金额的key,订单会对预估金额做校验,priceKey有效期为10分钟,如果priceKey过期或出发地经纬度有变化必须重新预估
derateType int N 折扣类型 1:企业折扣,2:动态折扣
dynamicRuleId int N 动态折扣ID(企业具备此权限,derateType值为2时才有值),下单时值原样传入
lineType int Y 订单专线类型:0 - 普通类型,1 - 一口价类型
doubleHighSpeedFeeFlag int N 当预估路线存在高速路段时:0 代表高速费正常收取。其中一口价类型订单高速费直接计入一口价内,普通类型价订单不计入预估价,仅做提示
detail.amount int Y 价格,单位分
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:高速费;festival_fee:节假日服务费;cross_city_fee:跨城费
detail.chargeDesc string Y 价格描述(基础费用补充额:曹操预约单基础费为30元,若预约单预估价超过30元则基础费用补充额为0元)
billAreaInfoVO.areaCode string N 区域编码
billAreaInfoVO.areaName string N 区域名称
billAreaInfoVO.areaType int N 区域类型,0-城市,1-行政区,2-围栏

结果示例:

{
  "code": 200,
  "success": true,
  "data": [
         {
           "billAreaInfoVO": {
             "areaCode": "330108",
             "areaName": "滨江区",
             "areaType": 1
           }, 
           "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,
            "lineType": 0,
            "name": "新能源",
            "price": 2250,
            "priceKey": "64f6681a-7a77-4ebd-8e36-e7175612559f"
          },
         {
           "billAreaInfoVO": {
             "areaCode": "330108",
             "areaName": "滨江区",
             "areaType": 1
           },
           "carType": 3,
            "detail": [
                    {
                    "amount": 1400,
                    "chargeCode": "start_fee",
                    "chargeDesc": "订单起步价"
                    },
                    {
                    "amount": 56,
                    "chargeCode": "travel_km_fee",
                    "chargeDesc": "路长费用"
                    },
                    {
                    "amount": 0,
                    "chargeCode": "discount_fee",
                    "chargeDesc": "折扣金额"
                     },
                     {
                     "amount": 0,
                     "chargeCode": "night_fix",
                     "chargeDesc": "夜间费用"
                     },
                     {
                     "amount": 0,
                     "chargeCode": "long_km_fee",
                     "chargeDesc": "订单长途费用"
                     }
                        ],
            "distance": 12759,
            "duration": 1200,  
            "lineType": 0,
            "name": "优选",
            "originPrice":1460,
            "price": 1456,
            "priceKey": "6e56bdb4-3bb0-4482-b3fb-bc2fc78fa428"
         }
          ]
}