开发者中心

预估服务

预估服务

交通行程费用预估

交通行程费用预估接口适用于预估国内及国际机票、国内火车票的行程费用，主要面向使用慧通出差申请、差旅预订的企业用户，作为预算参考依据。该接口提供的预估金额仅供参考，不保证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/S/C商务座，10:G/S/C特等座，20:D商务座，30:D特等座、D高级动卧、特等软座，35:G/S/C优选一等座、D优选一等座，40:G/S/C一等座，50:一人软包、高级软卧，60:G/S/C一等双软、G/S/C二等双软、G/S/C一等卧、G/S/C动卧、D一等双软、D一等卧、D动卧、D二等双软，70:D一等座，80:软卧、一等双软、二等双软、一等卧、二等卧，90:G/S/C软座、软座、软卧代软座、一等软座，95:G/S/C二等卧、D二等卧，98:G/S/C多功能座，100:G/S/C二等座，102：G/S/C硬座，105:二等软座，110:硬卧，115:D多功能座，120:D二等座、D动卧代二等座、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：火车票。空代表没预估出来
PredictReasonRemark预估原因备注NString差旅平台，本城市对(座席下钻)，火车票业务，G/S/C优选一等座、D优选一等座说明预估费用来源，格式：数据来源，行程范围，业务类型，舱等/座席

样例

请求样例

{
    "CorpCode": "1234",
    "Timestamp": "20240524211345",
    "Version": "3.0",
    "BusinessTypeList": [
        "CAIR",
        "IAIR",
        "TRAIN"
    ],
    "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",
          "PredictReasonRemark": "本集团，本城市对，国内机票业务，头等舱"
        },
        {
          "DepartureCityId": "156310100",
          "ArrivalCityId": "156440300",
          "PredictCost": 987,
          "PredictBusinessType": "CAIR",
          "PredictReasonRemark": "差旅平台，所有城市对，国内机票业务，头等舱"
        },
        {
          "DepartureCityId": "156440300",
          "ArrivalCityId": "156110100",
          "PredictCost": 1390,
          "PredictBusinessType": "CAIR",
          "PredictReasonRemark": "差旅平台，所有城市对，国内机票业务，头等舱"
        }
      ]
    },
    {
      "TravellerUniqueKey": "2",
      "PredictTripList": [
        {
          "DepartureCityId": "156120100",
          "ArrivalCityId": "156110100",
          "PredictCost": 54.5,
          "PredictBusinessType": "TRAIN",
          "PredictReasonRemark": "差旅平台，本城市对，火车票业务，G/S/C二等座"
        },
        {
          "DepartureCityId": "156110100",
          "ArrivalCityId": "34400001",
          "PredictCost": 1500,
          "PredictBusinessType": "IAIR",
          "PredictReasonRemark": "差旅平台，所有城市对，国际机票业务，头等舱"
        },
        {
          "DepartureCityId": "34400001",
          "ArrivalCityId": "82600074",
          "PredictCost": 4487,
          "PredictBusinessType": "IAIR",
          "PredictReasonRemark": "差旅平台，所有城市对，国际机票业务，头等舱"
        },
        {
          "DepartureCityId": "82600074",
          "ArrivalCityId": "156110100",
          "PredictCost": 3390,
          "PredictBusinessType": "IAIR",
          "PredictReasonRemark": "差旅平台，所有城市对，国际机票业务，头等舱"
        }
      ]
    }
  ]
}