Query Product

Point-to-point support: Mandatory

Update Date: 2024-03-26 Mandatory Online test(Sandbox)

Summary

1. This interface is used to query prices, You should return the available car types and corresponding quotes.
2. Performance requirements: The response must be within 2000ms, preferably within 1000ms.

API address

API address Format:  {Domain}/{Channel}/productquery/2.0/{timeStamp}/{sign}

Request Payload

QueryProductRequest

OrderWayPoint

Note:

1. categoryCode: Service Type
2. fromType: 1-Ctrip；2-flight；3-Corp
3. fixedLocation: Required for airport/station scenarios only. Not required for point-to-point and taxi-on-demand
4. flightNumber: Required for airport/station scenarios only
5. language: Please use it as a hint for both customer service and driver language. Site Language list
6. vehicleTypeList: Vehicle Type List. Empty means all
7. estimation: Required for taxi-on-demand scenarios. For reference only in other scenarios

GeoDTO

We will prioritize providing address information based on the site language selected by the user. For example, if a customer places an order on the Korean site, we will prioritize providing Korean address information, but in some cases, we can only provide Chinese or English address information. If you only need English address information, please contact Ctrip PM

FixedLocationDTO

Ctrip will specify the terminal as much as possible when querying products. If we are unable to obtain the specific terminal, we will transmit the airport latitude and longitude, which you should handle on your own. If you do not allow this situation, please contact Ctrip R&D, and we will block requests in this scenario.

EstimationStandardDTO

This estimated information only for reference.

Response Payload

QueryProductResponse

If you find that Trip.com does not display your price, please go to "https://vbooking.ctrip.com/micro/carwork/ota/logSystem" to inquire about the specific reason

ShoppingQueryProductDTO

AddServiceDTO

We will calculate the additional service price based on these parameters and the sku information configured by VBK

FeeItemDTO

Request Example

{
  "orderWayPoint": [
    {
      "seq": 1,
      "address": "Hongqiao Railway Station",
      "detailAddress": "1500 Shengui Rd, Minhang, Shanghai",
      "longitude": 121.320170,
      "latitude": 31.194360,
      "geoType": "GCJ02",
      "cityId": 2,
      "cityName": "Shanghai",
      "status": 0
    }
  ],
  "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
}

Response Example

{
  "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"
        }
      ]
    }
  ]
}

Error Example

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