目录

3.5 PNR询价(ITicketFarePolicyByPNR)
返回一组最低国际运价;

注：PNR需先通过指令 PUSH PNR/CAN826/NI/CT 授权，或使用美亚商旅集团配置生成的PNR。

3.5.1请求参数

参数 类型 说明 必填 备注
PNRString PNR编码 Y
airlineString 出票航司 Y 不同出票航司将影响价格
passengerTypeListArray乘客类型及数量组 Y

passengerTypeList:

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

3.5.2请求样例

{
    "PNR":"JGM1NF",
    "airline":"CZ",
    "passengerTypeList":[
        {
            "passengerType":0,
            "passengerCount":1
        }
    ]
}

3.5.3返回参数

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

detail:

参数 类型 说明 备注
serialNumberString 缓存key 下单时回传给接口
financeDetailObject价格详情
workBeginTimeString工作开始时间 格式如：”08:01”
workEndTimeString工作结束时间格式如：”08:01”
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 Int 乘客类型 0：成人
1：儿童
2：婴儿
3：老人
4：学生
5：劳务
6：移民
7：海员
8：青年
salePrice Decimal 票面价
tax Decimal 税金
beforeReturn float 代理费点数
beforeReturnPrice Decimal 代理费金额
afterReturnBase Decimal 奖励基数
afterReturn float 奖励点数
afterReturnPrice Decimal 奖励金额
serviceFee Decimal 服务费
saleTotal Decimal 结算价 票面价+税金-代理费金额-奖励金额+服务费-促销合计金额
saleAdditionRate String 促销返点
saleAdditionMoney String 促销直减金额
saleAdditionFare String 促销合计金额
limitingCondition Object 乘客限制条件 202408新增

flights：

参数 类型 说明 备注
airlineString航司二字码
flightNumberString航班号
departureAirportCodeString出发机场编码
destinationAirportCodeString到达机场编码
departureDateTimeString出发日期时间
classNoString舱位
classAvlString舱位数量，如果没有返回就空；如果是核价时底层接口有返回，则显示对应 classNo 的数量
isShareString是否共享
shareCodeString共享航班号
equipmentString机型
cabinTypeString 舱位等级 0 经济舱 1 豪华经济舱 3 商务舱 4 头等舱 20230921新增

FareRuleRef：

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

passenger_rule:

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

fare_rule:

参数 类型 说明 备注
fare_basis_code 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.5.4返回样例

{
    "code":"20000",
    "detail":{
        "serialNumber":"ed8b9c175fc4ec97f1396361c8b366a6",
        "workBeginTime":"",
        "workEndTime":"",
        "financeDetail":{
            "officeNumber":"WUH134",
            "agencyPolicyRemark":"",
            "rewardPolicyRemark":"",
            "agencyPolicyRemarkOut":"",
            "rewardPolicyRemarkOut":"",
            "financeList":[
                {
                    "passengerType":"0",
                    "salePrice":"940",
                    "tax":"132",
                    "beforeReturn":"3",
                    "beforeReturnPrice":"28",
                    "afterReturnBase":"912",
                    "afterReturn":"38.9",
                    "afterReturnPrice":"360",
                    "serviceFee":"0",
                    "saleTotal":"684"
                }
            ],
            "IsConvert":0,
            "isItinerary":0,
            "FareRuleRef":{
                "passenger_rule":[
                    {
                        "passenger_type":"ADT",
                        "fare_rule":[
                            {
                                "fare_basis_code":"QBCOWCN",
                                "luggageRaw":"20K",
                                "index":0
                            }
                        ]
                    }
                ]
            }
        }
    }
}