美亚航旅机票B2B接口

这是本文档旧的修订版！

3.12.1请求参数

参数	类型	说明	必填	备注
airline	String	出票航司	Y	不同出票航司将影响价格， NDC产品计价只能使用航班查询接口返回的flightDetailList模型下的airline作为计价航司
passengerTypeList	Array	乘客类型及数量组	Y
bookingOffice	String	预订OFFICE	N
serialNumber	string	航班查询缓存KEY	N	20210813新增对应实时航班搜索(ITicketShoppingV2)返回的serialNumber,如果实时航班查询下单的计价，需指定此参数和flightIdList参数。如果非实时航班下单的计价无需传入这两个参数 ,此参数的判断优先级最高对应下单方式:1实时航班下单
flightID	string	行程ID	N	20210813新增对应实时航班搜索(ITicketShoppingV2)返回的flightID,如果实时航班查询下单的计价，需指定此参数和serialNumber参数。如果非实时航班下单的计价无需传入这两个参数
PNR	String	PNR编码	N	若传入该参数，优先级次于serialNumber 对应下单方式:2PNR下单
flightList	Array	航段信息	N	若传入该参数，优先级最低对应下单方式:3航段下单

passengerTypeList:

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

flightList：

参数	类型	说明	必填	备注
airline	String	航司二字码	Y
flightNumber	String	航班号	Y
departureAirportCode	String	出发机场编码	Y
destinationAirportCode	String	到达机场编码	Y
departureDateTime	String	出发日期时间	Y
arrivalDateTime	String	到达日期时间	Y
classNo	String	舱位	Y
isShare	String	是否共享	N	0否 1是
shareCode	String	共享航班号	N
equipment	String	机型	N

3.12.2请求样例

{
    "airline":"PG",
    "PNR":"",
    "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.12.3返回参数

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

detail:

参数	类型	说明	备注
serialNumber	String	缓存key	下单时回传给接口
financeDetail	Object	价格详情
workBeginTime	String	工作开始时间	格式如：”08:01:00”
workEndTime	String	工作结束时间	格式如：”08:01:00”

financeDetail:

参数	类型	说明	备注
officeNumber	String	出票OFFICE号	编码下单需授权
agencyPolicyRemark	String	代理费政策限制
rewardPolicyRemark	String	奖励政策限制
agencyPolicyRemarkOut	String	代理费政策备注
rewardPolicyRemarkOut	String	奖励政策备注
financeList	Array	价格组	每种乘客类型一条数据
IsConvert	Int	是否需转编码	0：不需要 1：需要
isItinerary	int	行程单	1：有行程单 0：无行程单
FareRuleRef	Object	行李额等信息
carrier	String	出票航司
ticketType	int	票证类型	查询保险产品时使用
flights	ObjectArray	行程

financeList：

参数	类型	说明	备注
passengerType	String	乘客类型	0：成人 1：儿童 2：婴儿 3：老人 4：学生 5：劳务 6：移民 7：海员 8：青年
salePrice	String	票面价
tax	String	税金
beforeReturn	String	代理费点数
beforeReturnPrice	String	代理费金额
afterReturnBase	String	奖励基数
afterReturn	String	奖励点数
afterReturnPrice	String	奖励金额
serviceFee	String	服务费
saleTotal	String	结算价	票面价+税金-代理费金额-奖励金额+服务费
beforeReturnMoney	String	代理费直减金额
afterReturMoney	String	奖励直减金额
productType	String	产品类型	20210813新增 BSP、NDC、合作商合作商：目前为PK、航路的数据 NDC：目前为AGG、TF的数据 BSP：非上述的其它数据

FareRuleRef：

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

flights：

参数	类型	说明
airline	String	航司二字码
flightNumber	String	航班号
departureAirportCode	String	出发机场编码
destinationAirportCode	String	到达机场编码
departureDateTime	String	出发日期时间
classNo	String	舱位
classAvl	String	舱位数量，如果没有返回就空；如果是核价时底层接口有返回，则显示对应 classNo 的数量
isShare	String	是否共享
shareCode	String	共享航班号
equipment	String	机型

passenger_rule:

参数	类型	说明	备注
passenger_type	String	乘客类型	ADT：成人 [CNN/CHD]：儿童 INF: 婴儿
fare_rule	Array	规则

fare_rule:

参数	类型	说明
fareBasisCode	String	运价基础
luggageRaw	String	行李额
index	Int	序号
origin	String	出发地
destination	String	目的地
minStay	String	最短停留
maxStay	String	最长停留
refund	String	退票说明
change	String	改签说明
noShow	String	误机说明

3.12.4返回样例

{
    "code": "20000",
    "detail": [
        {
            "serialNumber": "c83907382a4fdca1cc2638c69e4789d3",
            "workBeginTime": "06:55:00",
            "workEndTime": "23:56:26",
            "financeDetail": {
                "officeNumber": "CAN826",
                "agencyPolicyRemark": "",
                "rewardPolicyRemark": "",
                "agencyPolicyRemarkOut": "",
                "rewardPolicyRemarkOut": "",
                "financeList": [
                    {
                        "passengerType": "0",
                        "salePrice": 3070,
                        "tax": 190,
                        "beforeReturn": 0,
                        "beforeReturnPrice": 0,
                        "afterReturnBase": 3070,
                        "afterReturn": 0,
                        "afterReturnPrice": 0,
                        "serviceFee": 49,
                        "saleTotal": 3309,
                        "beforeReturnMoney": 0,
                        "afterReturMoney": 0
                    }
                ],
                "IsConvert": 0,
                "isItinerary": 1,
                "FareRuleRef": {
                    "passenger_rule": [
                        {
                            "passenger_type": "ADT",
                            "fare_rule": [
                                {
                                    "fareBasisCode": "W2TR24",
                                    "luggageRaw": "20K",
                                    "index": 0,
                                    "origin": "CAN",
                                    "destination": "SIN",
                                    "refund": "1.退票: 不允许。",
                                    "change": "2.更改: 机票仅在韩国出售，允许，每张客票收取手续费 90800韩元暬  允许，每张客票收取手续费 110.00新加坡元/110.00澳大利亚元暬  允许，每张客票收取手续费 550人民币/77.00欧元暬  允许，每张客票收取手续费 660港币/5700印度卢比暬 允许，每张客票收取手续费 1155000印尼盾/9100日元暬   允许，每张客票收取手续费 330.00马来西亚林吉特/4400菲律宾比索暬  允许，每张客票收取手续费 320.00沙特里亚尔/90800韩元暬   允许，每张客票收取手续费 2640新台币/2750泰铢暬  允许，每张客票收取手续费 1898000越南盾/88.00美元。  ",
                                    "maxStay": "最长停留:   12个月。",
                                    "minStay": "最短停留:   无限制。",
                                    "noShow": "3.误机: 无限制。"
                                }
                            ]
                        }
                    ]
                }
            }
        }
    ]
}

美亚航旅机票B2B接口

用户工具

站点工具

目录

3.12.1请求参数

3.12.2请求样例

3.12.3返回参数

3.12.4返回样例

页面工具