美亚航旅机票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：

参数 类型 说明 必填 备注
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:

参数 类型 说明 备注
serialNumberString 缓存key 下单时回传给接口，isAsync为true，只会返回这个序列号，以下实体不返回
financeDetailObject价格详情
workBeginTimeString工作开始时间 格式如：”08:01:00”
workEndTimeString工作结束时间格式如：”08:01:00”
payCurrency String 币种 20250318 新增预留字段,暂未启用

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
RCVServiceFee Object 退改废服务费 20241017新增
productLabel String 产品标签 美亚优选 美亚自营 航司直连 官网直销 精选特惠

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：非上述的其它数据
saleAdditionRate String 促销返点
saleAdditionMoney String 促销直减金额
saleAdditionFare String 促销合计金额
limitingCondition Object 乘客限制条件 202408新增

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 退票说明 已停用 请求3.2 退改签条款获取
change String 改签说明 已停用 请求3.2 退改签条款获取
noShow String 误机说明 已停用 请求3.2 退改签条款获取
baggageCarryon Array 手持行李 20230921新增
baggageChecked Array 托运行李 20230921新增

baggageCarryon / baggageChecked:

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

limitingCondition

参数 类型 说明 备注
nationalityOrAreaObject国籍/地区限制
certificateObject证件限制
availableAgeObject年龄限制
availablePassagerCountObject人数限制

nationalityOrArea/certificate

参数 类型 说明 备注
isAllowBoolean是否允许true:则允许codes的国籍/地区(证件类型) false:则禁止codes的国籍/地区(证件类型)
codesArray国家/地区二字码(证件类型参考下单IDType)该参数有值时isAllow有效
namesArray国家/地区(证件类型)中文名称

availableAge

参数 类型 说明 备注
minAgeInt最小年龄限制默认值:-1(无限制)
maxAgeInt最大年龄限制默认值:-1(无限制)

availablePassagerCount

参数 类型 说明 备注
minCountInt最小人数限制 默认值:-1(无限制)
maxCountInt最大人数限制 默认值:-1(无限制)
beEvenNumberBoolean是否偶数人数限制

RCVServiceFee

参数 类型 说明 备注
ChangeFeeCNYFloat改签加收服务费 无数据则以退票时为准
RefundFeeCNYFloat退票加收服务费 无数据则以退票时为准
VoidFeeCNYFloat废票加收服务费 无数据则以退票时为准

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.1742363537.txt.gz · 最后更改: 2025/03/19 05:52 由 doku

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： 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