用户工具

站点工具


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:

参数 类型 说明 备注
changeConditions String 签转条件
ruleRemark String 备注
baggageAllowance String 行李额
ruleId String 退改条款id
ruleItem Array 退改明细
airline String 航司 PNR查询返回
flightNumber String 航班号 PNR查询返回
depAirport String 出发机场 PNR查询返回
arrAirport String 目的机场 PNR查询返回
payCurrency String 币种 20250318 新增
ticketLuggageRule Object 行李额结构化信息 20250428 新增

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.1749799709.txt.gz · 最后更改: 2025/06/13 07:28 由 alan_luo