美亚航旅机票B2B接口

用户工具

站点工具

3.12_国际pricing_国际机票_ipricingbyseg

这是本文档旧的修订版！

目录

3.12 国际Pricing(IPricingBySeg)
返回多组国际运价; 当PNR不为空时，则使用PNR计价，否则使用行段计价

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航段下单
isAsync bool 是否异步获取价格 N 默认不异步，如果该参数为true，则接口只会返回缓存serialNumber，并需要三十分钟内调用IPricingBySegAsnyc接口获取价格

passengerTypeList:

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

flightList：

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

参数 类型 说明 备注
serialNumberString 缓存key 下单时回传给接口，isAsync为true，只会返回这个序列号，以下实体不返回
financeDetailObject价格详情
workBeginTimeString工作开始时间 格式如：”08:01:00”
workEndTimeString工作结束时间格式如：”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 行程
groupTag Bool true代表该运价为小团价产品 若退改废必须全部旅客一起申请 20230921新增
authorizeOffice String String 授权office

financeList：

参数 类型 说明 备注
passengerTypeString 乘客类型 0：成人
1：儿童
2：婴儿
3：老人
4：学生
5：劳务
6：移民
7：海员
8：青年
salePriceString 票面价
taxString 税金
beforeReturnString代理费点数
beforeReturnPriceString代理费金额
afterReturnBaseString奖励基数
afterReturnString奖励点数
afterReturnPriceString奖励金额
serviceFeeString服务费
saleTotalString结算价 票面价+税金-代理费金额-奖励金额+服务费
beforeReturnMoneyString代理费直减金额
afterReturMoneyString奖励直减金额
productType String 产品类型 20210813新增 BSP、NDC、合作商
合作商：目前为PK、航路的数据
NDC：目前为AGG、TF的数据
BSP：非上述的其它数据

FareRuleRef：

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

flights：

参数 类型 说明 备注
airline String 航司二字码
flightNumber String 航班号
departureAirportCode String 出发机场编码
destinationAirportCode String 到达机场编码
departureDateTime String 出发日期时间
classNo String 舱位
classAvl String 舱位数量，如果没有返回就空；如果是核价时底层接口有返回，则显示对应 classNo 的数量
isShare String 是否共享
shareCode String 共享航班号
equipment String 机型
cabinType String 舱位等级 0 经济舱 1 豪华经济舱 3 商务舱 4 头等舱 20230921 新增

passenger_rule:

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

fare_rule:

参数 类型 说明 备注
fareBasisCode String 运价基础
luggageRaw String 行李额
index Int 序号
origin String 出发地
destination String 目的地
minStay String 最短停留
maxStay String 最长停留
refund String 退票说明
change String 改签说明
noShow String 误机说明
baggageCarryon Array 手持行李 20230921新增
baggageChecked Array 托运行李 20230921新增

baggageCarryon / baggageChecked:

参数 类型 说明 备注
depAirportString出发机场编码
desAirportString到达机场编码
demisionString每件长宽高
piecesString件数
weightString重量
descriptionString描述
depCityCNString出发城市中文
desCityCNString到达城市中文

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.误机: 无限制。"
                                }
                            ]
                        }
                    ]
                }
            }
        }
    ]
}
3.12_国际pricing_国际机票_ipricingbyseg.1704879801.txt.gz · 最后更改: 2024/01/10 09:43 由 tiny

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki