用户工具

站点工具


4.8_国内实时航班退改条款_idomesticshoppingrulequeryv2

4.8 国内实时航班退改条款(/IDomesticShoppingRuleQueryV2)

4.8.1请求参数

参数 类型 说明 必填 备注
shoppingSerialNumber String 航班查询key N 来自 IDomesticTicketShopping / IGetDomesticShoppingData
接口返回。shopping缓存失效后查询会失败 。
flightId String 实时航班flight_id N 来自 IDomesticTicketShopping / IGetDomesticShoppingData
接口返回
cabinFareId String 实时航班舱位ID N 来自 IDomesticTicketShopping / IGetDomesticShoppingData
接口返回
isAsyn Bool 是否IGetDomesticShoppingData接口航班数据 N
PNR String PNR N 若传该值则查询PNR计价的退改
pricingSerialNumber String 计价缓存 N 若传该值则取计价结果退改 来自IDomesticTicketFinanceQueryV2 IDPricingBySeg 接口返回
(实时航班计价暂不支持)计价缓存失效后查询会失败
fareId String 计价价格id N 若传pricingSerialNumber&多价格必传 来自IDomesticTicketFinanceQueryV2 IDPricingBySeg 接口返回
计价缓存失效后查询会失败

4.8.2请求样例

实时航班退改:
{
    "shoppingSerialNumber":"5668b9a3-6dcf-fc04-7fed-0b2bb1ac62fa",
    "flightId":"8",
    "cabinFareId":"11"
}
计价退改:
{
    "pricingSerialNumber": "84f022105bbf90840b4f7c828a5c5f657f",
    "fareId": "ADT0_0_0-0-0",
    "PNR": ""
}

4.8.3返回参数

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

detail:

参数 类型 说明 备注
changeConditionsString 签转条件
ruleRemarkString 备注
baggageAllowanceString 行李额
ruleIdString 退改条款id
ruleItemArray退改明细
airlineString 航司 PNR查询返回
flightNumberString 航班号 PNR查询返回
depAirportString 出发机场 PNR查询返回
arrAirportString 目的机场 PNR查询返回
payCurrency String 币种 20250318 新增

ruleItem:

参数 类型 说明 备注
changePrice Decimal 同舱改签费
operatorHourText String 适用条件
operatorTh Decimal 10:距离起飞前hour
20:距离起飞前(含)hour
30:起飞前X小时后hour
40:起飞前X小时后(含)hour
refundPrice Decimal 退票费用
unit String 时间单位 10:小时 20:天
depTime String 起飞前时间
text String 文本型条款
changeTips String 改签
refundTips String 退款
refund_percent decimal 退票百分比
change_percent decimal 改签百分比
change_price_base decimal 改签费保底金额
refund_price_base decimal 退票保底金额

4.8.4返回样例

{
    "code": "20000",
    "detail": [
        {
            "changeConditions": "",
            "ruleRemark": " 供参考,具体以航司规则为准",
            "baggageAllowance": null,
            "ruleId": "",
            "ruleItem": [
                {
                    "changePrice": "0",
                    "refundPrice": "0",
                    "operatorTh": "0",
                    "depTime": "0",
                    "operatorHourText": "",
                    "text": "",
                    "changeTips": "",
                    "refundTips": "",
                }
            ]
        }
    ]
}
4.8_国内实时航班退改条款_idomesticshoppingrulequeryv2.txt · 最后更改: 2025/03/20 01:56 由 tiny