开发者中心

预估服务

预估服务

交通行程费用预估

交通行程费用预估接口，用于预估国内机票、国际机票和国内火车票的行程费用。
预估金额无法保证100%准确，数据仅作为出差审批单交通行程预算的参考。

接口URL

/traffic/cost_predict/query

请求参数定义

参数名参数说明必选参数类型长度值举例备注
CorpCode企业账号YString1000慧通提供的企业账号
Timestamp时间戳YString1420240516113019服务方仅允许20分钟内的时间误差。
Version版本号YString3.0固定为3.0
BusinessTypeList业务类型列表YList<String>10CAIR：国内机票，IAIR：国际机票，TRAIN：火车票最多支持10个
TravellerList出行人列表YList<TravellerInfo>20最多支持20个

TravellerInfo出行人信息

参数名参数说明必填参数类型长度值举例备注
TravellerUniqueKey出行人唯一键YString1一个出差申请单里如果有多个人，使用唯一键进行区分不同的人
FlightCabinLevel国内机票舱位限定NString0：头等舱，1：商务舱，2：经济舱，3：高端经济舱，9：不允许乘坐如果三个业务的舱位限定都没传值，预估金额是0
InterFlightCabinLevel国际机票舱位限定NString0：头等舱，1：商务舱，2：经济舱，3：高端经济舱，9：不允许乘坐如果三个业务的舱位限定都没传值，预估金额是0
TrainSeatLevel火车座席限定NString0：G商务座，10：G特等座，20：D商务座，30：D特等座，35：G优选一等座、D优选一等座，40：G一等座，50：高级软卧，60：D动卧，70：D一等座，80：软卧，90：软座，95：G二等卧、D二等卧，98：G多功能座，100：G二等座，110：硬卧，115：D多功能座，120：D二等座，130：硬座，999：不允许乘坐如果三个业务的舱位限定都没传值，预估金额是0
TripList行程列表YList<TripInfo>50最多支持50个
TripInfo行程信息
参数名参数说明必填参数类型长度值举例备注
DepartureCityId出发城市IdYString156110100使用慧通的城市ID
ArrivalCityId到达城市IdYString156310100使用慧通的城市ID

响应参数定义

参数名参数说明类型举例是否必选备注
ResultCode返回码String0Y
Description返回描述StringSuccessY
PredictTravellerList预估出行人列表List<PredictTraveller>Y

PredictTraveller预估出行人

参数名参数说明必选参数类型长度值举例备注
TravellerUniqueKey出行人唯一键YString1数值从请求参数获取
PredictTripList预估行程列表YList<PredictTrip>
PredictTrip预估行程
参数名参数说明必选参数类型长度值举例备注
DepartureCityId出发城市IdYString156110100信息取自入参
ArrivalCityId到达城市IdYString156310100信息取自入参
PredictCost预估费用YString1800单位：人民币
PredictBusinessType预估业务类型NStringCAIR根据哪个业务预估出来的费用 CAIR：国内机票，IAIR：国际机票，TRAIN：火车票。空代表没预估出来

样例

请求样例

{
    "CorpCode": "1234",
    "Timestamp": "20240524211345",
    "Version": "3.0",
    "BusinessTypeList": [
        "CAIR",
        "IAIR",
        "CTRAIN"
    ],
    "TravellerList": [
        {
            "TravellerUniqueKey": "1",
            "FlightCabinLevel": "0",
            "InterFlightCabinLevel": "0",
            "TrainSeatLevel": "100",
            "TripList": [
                {
                    "DepartureCityId": "156110100",
                    "ArrivalCityId": "156310100"
                },
                {
                    "DepartureCityId": "156310100",
                    "ArrivalCityId": "156440300"
                },
                {
                    "DepartureCityId": "156440300",
                    "ArrivalCityId": "156110100"
                }
            ]
        },
        {
            "TravellerUniqueKey": "2",
            "FlightCabinLevel": "0",
            "InterFlightCabinLevel": "0",
            "TrainSeatLevel": "100",
            "TripList": [
                {
                    "DepartureCityId": "156120100",
                    "ArrivalCityId": "156110100"
                },
                {
                    "DepartureCityId": "156110100",
                    "ArrivalCityId": "34400001"
                },
                {
                    "DepartureCityId": "34400001",
                    "ArrivalCityId": "82600074"
                },
                {
                    "DepartureCityId": "82600074",
                    "ArrivalCityId": "156110100"
                }
            ]
        }
    ]
}

响应样例

{
  "ResultCode": "0",
  "Description": "Success",
  "PredictTravellerList": [
    {
      "TravellerUniqueKey": "1",
      "PredictTripList": [
        {
          "DepartureCityId": "156110100",
          "ArrivalCityId": "156310100",
          "PredictCost": 914,
          "PredictBusinessType": "CAIR"
        },
        {
          "DepartureCityId": "156310100",
          "ArrivalCityId": "156440300",
          "PredictCost": 987,
          "PredictBusinessType": "CAIR"
        },
        {
          "DepartureCityId": "156440300",
          "ArrivalCityId": "156110100",
          "PredictCost": 1390,
          "PredictBusinessType": "CAIR"
        }
      ]
    },
    {
      "TravellerUniqueKey": "2",
      "PredictTripList": [
        {
          "DepartureCityId": "156120100",
          "ArrivalCityId": "156110100",
          "PredictCost": 54.5,
          "PredictBusinessType": "CTRAIN"
        },
        {
          "DepartureCityId": "156110100",
          "ArrivalCityId": "34400001",
          "PredictCost": 1500,
          "PredictBusinessType": "IAIR"
        },
        {
          "DepartureCityId": "34400001",
          "ArrivalCityId": "82600074",
          "PredictCost": 4487,
          "PredictBusinessType": "IAIR"
        },
        {
          "DepartureCityId": "82600074",
          "ArrivalCityId": "156110100",
          "PredictCost": 3390,
          "PredictBusinessType": "IAIR"
        }
      ]
    }
  ]
}