查询产品接口

更新时间： 2022-11-06 必须接入 在线调试（沙箱环境）

接口概述

1、该接口用来向供应商询价，供应商应返回可提供的车型以及对应的基础报价。
2、性能要求：建议在500ms以内返回信息，最长不超过1000ms。除去网络因素，建议自身系统的处理时间控制在150ms以内。以上衡量标准为10分钟压力测试，询价频率500ms/次。

请求地址

地址格式:  {Domain}/{Channel}/productquery/2.0/{timeStamp}/{sign}

请求内容

QueryProductRequest

GeoDTO

FixedLocationDTO

注

2.机场使用IATA代码，火车站为携程内部代码，如需要请线下联系携程商务。
3.携程在传机场地址时通常会将机场与具体的航站楼传给供应商，此时经纬度为具体航站楼的经纬度，方便供应商进行报价和接驳。有极小概率拿不到具体的航站楼数据，此时接口会传递机场经纬度，需要供应商自行兼容。如果不接受无航站楼报价，请联系技术同学，屏蔽无航站楼报价。

EstimationStandardDTO

注

预估里程和时间仅供参考

返回内容

QueryProductResponse

注

1、当下单时的起终点、用车时间参数与查询产品时的请求参数完全一致时，请保留该次询价请求的日志，便于线上排障，至少保留2小时。
2、前端未展示报价的原因有多种，请供应商先行查看查价日志处理，如果仍然定位为携程侧的问题，请联系商务或产品解决。
用车开放平台日志系统：https://vbooking.ctrip.com/carwork/ota/logSystem

ShoppingQueryProductDTO

AddServiceDTO

FeeItemDTO

请求示例

{
  "categoryCode": "airport-dropoff",
  "duseLocation": {
    "address": "清华大学",
    "detailAddress": "海淀区 双清路30号",
    "longitude": 116.32676694616,
    "latitude": 40.003909840453,
    "geoType": "GCJ02"
  },
  "auseLocation": {
    "address": "首都国际机场",
    "detailAddress": "首都国际机场",
    "longitude": 116.588057,
    "latitude": 40.080519,
    "geoType": "GCJ02"
  },
  "useTime": "2020-10-29 18:26",
  "fixedLocation": {
    "fixedCode": "PEK",
    "fixedLocationName": "首都国际机场",
    "cityId": "1",
    "cityName": "北京"
  },
  "fromType": 1
}

响应示例

{
  "msgCode": "OK",
  "message": "成功",
  "priceMark": "B3730C27FE83FC8B",
  "currency":"CNY",
  "queryResultList": [
    {
      "price": 195,
      "vehicleType": 118,
      "addServices": [
        {
          "maxCount": 1,
          "vendorAddServiceCode": "DR-ZH"
        }
      ]
    },
    {
      "price": 268,
      "vehicleType": 125,
      "addServices": [
        {
          "maxCount": 1,
          "vendorAddServiceCode": "DR-ZH"
        }
      ]
    },
    {
      "price": 278,
      "vehicleType": 129,
      "addServices": [
        {
          "maxCount": 1,
          "vendorAddServiceCode": "DR-ZH"
        }
      ]
    },
    {
      "price": 536,
      "vehicleType": 131,
      "addServices": [
        {
          "maxCount": 1,
          "vendorAddServiceCode": "DR-ZH"
        }
      ]
    },
    {
      "price": 692,
      "vehicleType": 135,
      "addServices": [
        {
          "maxCount": 1,
          "vendorAddServiceCode": "DR-ZH"
        }
      ]
    },
    {
      "price": 854,
      "vehicleType": 140,
      "addServices": [
        {
          "maxCount": 1,
          "vendorAddServiceCode": "DR-ZH"
        }
      ]
    }
  ]
}

异常示例

{
  "msgCode": "NO_TIMESERVICE",
  "message": "提前预定时间过短",
  "priceMark": "",
  "currency":"",
  "queryResultList": []
}