用户工具

站点工具


3.4_航段询价_国际机票_iticketfarepolicybytrips

这是本文档旧的修订版!


3.4 航段询价(ITicketFarePolicyByTrips)

3.4.1请求参数

参数 类型 说明 必填 备注
airlineString 出票航司 Y 不同出票航司将影响价格
passengerTypeListArray乘客类型及数量组 Y
flightListArray航段信息 Y
serialNumberstring航班查询缓存KEYN 20210813新增 对应实时航班搜索(ITicketShoppingV2)返回的serialNumber,如果实时航班查询下单的计价,需指定此参数和flightIdList参数。如果非实时航班下单的计价无需传入这两个参数 ,此参数的判断优先级最高
flightIDstring行程IDN 20210813新增 对应实时航班搜索(ITicketShoppingV2)返回的flightID,如果实时航班查询下单的计价,需指定此参数和serialNumber参数。如果非实时航班下单的计价无需传入这两个参数

passengerTypeList:

参数 类型 说明 必填 备注
passengerTypeInt乘客类型 Y 0:成人
1:儿童
2:婴儿
3:老人
4:学生
5:劳务
6:移民
7:海员
8:青年
passengerCountInt乘客人数 Y 该乘客类型对应的人数

flightList: passengerTypeList:

参数 类型 说明 必填 备注
airlineString航司二字码 Y
flightNumberString航班号 Y
departureAirportCodeString出发机场编码 Y
destinationAirportCodeString到达机场编码 Y
departureDateTimeString出发日期时间 Y
arrivalDateTimeString到达日期时间 Y
classNoString舱位 Y
isShareString是否共享 N 0否 1是
shareCodeString共享航班号 N
equipmentString机型 N

3.4.2请求样例

{
    "airline":"PG",
    "flightList":[
        {
            "airline":"PG",
            "arrivalDateTime":"2018-12-27 15:55",
            "classNo":"M",
            "departureAirportCode":"USM",
            "epartureDateTime":"2018-12-27 11:35",
            "destinationAirportCode":"HKG",
            "flightNumber":"805"
        }
    ],
    "passengerTypeList":[
        {
            "passengerCount":"1",
            "passengerType":"0"
        }
    ]
}

3.4.3返回参数

参数 类型 说明 备注
code String 是否调用接口成功 20000表示成功,非20000表异常
detail Object 结果集 空值
description String 描述 当异常时记录异常信息

detail:

参数 类型 说明 备注
serialNumberString 缓存key 下单时回传给接口
financeDetailObject价格详情
workBeginTimeString工作开始时间 格式如:”08:01”
workEndTimeString工作结束时间格式如:”08:01”

financeDetail:

参数 类型 说明 备注
officeNumberString出票OFFICE号 编码下单需授权
agencyPolicyRemarkString代理费政策限制
rewardPolicyRemarkString奖励政策限制
agencyPolicyRemarkOutString代理费政策备注
rewardPolicyRemarkOutString奖励政策备注
financeListArray价格组 每种乘客类型一条数据
IsConvertInt是否需转编码 0:不需要
1:需要
isItineraryString行程单 1:有行程单
0:无行程单
FareRuleRefObject行李额等信息
carrierString出票航司
ticketType String 票证类型 查询保险时使用

financeList:

参数 类型 说明 备注
passengerTypeInt 乘客类型 0:成人
1:儿童
2:婴儿
3:老人
4:学生
5:劳务
6:移民
7:海员
8:青年
salePriceDecimal 票面价
taxDecimal 税金
beforeReturnfloat代理费点数
beforeReturnPriceDecimal代理费金额
afterReturnBaseDecimal奖励基数
afterReturnfloat奖励点数
afterReturnPriceDecimal奖励金额
serviceFeeDecimal服务费
saleTotalDecimal结算价 票面价+税金-代理费金额-奖励金额+服务费
productType String 产品类型 20210813新增 BSP、NDC、合作商
合作商:目前为PK、航路的数据
NDC:目前为AGG、TF的数据
BSP:非上述的其它数据

FareRuleRef:

参数 类型 说明 备注
passenger_ruleArray乘客规则

passenger_rule:

参数 类型 说明 备注
passenger_typeString乘客类型 ADT:成人
[CNN/CHD]: 儿童
INF: 婴儿
fare_ruleArray规则

fare_rule:

参数 类型 说明 备注
fare_basis_codeString运价基础
luggageRawString行李额
indexInt序号
originString出发地
destinationString目的地

3.4.4返回样例

{
    "code":"20000",
    "detail":{
        "serialNumber":"19ccf97f54a6a7d5e614a21b027cdf87",
        "workBeginTime":"",
        "workEndTime":"",
        "financeDetail":{
            "officeNumber":"CAN826",
            "agencyPolicyRemark":"",
            "rewardPolicyRemark":"",
            "agencyPolicyRemarkOut":"",
            "rewardPolicyRemarkOut":"",
            "financeList":[
                {
                    "passengerType":"0",
                    "salePrice":"2780",
                    "tax":"445",
                    "beforeReturn":"0",
                    "beforeReturnPrice":"0",
                    "afterReturnBase":"2780",
                    "afterReturn":"0",
                    "afterReturnPrice":"0",
                    "serviceFee":"13",
                    "saleTotal":"3238"
                }
            ],
            "IsConvert":0,
            "isItinerary":1,
            "FareRuleRef":{
                "passenger_rule":[
                    {
                        "passenger_type":"ADT",
                        "fare_rule":[
                            {
                                "fare_basis_code":"MOWW",
                                "luggageRaw":"20K",
                                "index":0
                            }
                        ]
                    }
                ]
            }
        }
    }
}
3.4_航段询价_国际机票_iticketfarepolicybytrips.1628834209.txt.gz · 最后更改: 2021/08/13 05:56 由 tiny