| 两侧同时换到之前的修订记录
前一修订版
后一修订版
|
前一修订版
|
4.8_国内实时航班退改条款_idomesticshoppingrulequeryv2 [2024/03/21 11:17]
tiny [表] |
4.8_国内实时航班退改条款_idomesticshoppingrulequeryv2 [2025/07/02 09:48] (当前版本)
alan_luo |
| |
| |
| ^参数 ^类型 ^说明 ^必填 ^备注^ | ^ 参数 ^ 类型 ^ 说明 ^ 必填 ^ 备注 ^ |
| |shoppingSerialNumber|String |航班查询key |Y|来自 IDomesticTicketShopping / IGetDomesticShoppingData \\ 接口返回。shopping缓存失效后查询会失败 。 | | | shoppingSerialNumber | String | 航班查询key | N | 来自 IDomesticTicketShopping / IGetDomesticShoppingData \\ 接口返回。shopping缓存失效后查询会失败 。 | |
| |flightId|String|实时航班flight_id |Y|来自 IDomesticTicketShopping / IGetDomesticShoppingData \\ 接口返回| | | flightId | String | 实时航班flight_id | N | 来自 IDomesticTicketShopping / IGetDomesticShoppingData \\ 接口返回 | |
| |cabinFareId|String |实时航班舱位ID |Y|来自 IDomesticTicketShopping / IGetDomesticShoppingData \\ 接口返回| | | cabinFareId | String | 实时航班舱位ID | N | 来自 IDomesticTicketShopping / IGetDomesticShoppingData \\ 接口返回 | |
| |isAsyn|Bool |是否IGetDomesticShoppingData接口航班数据 |N| | | | isAsyn | Bool | 是否IGetDomesticShoppingData接口航班数据 | N | | |
| | | <color #ed1c24>PNR</color> | String | PNR | N | 若传该值则查询PNR计价的退改 | |
| | | <color #ed1c24>pricingSerialNumber</color> | String | 计价缓存 | N | 若传该值则取计价结果退改 来自IDomesticTicketFinanceQueryV2 IDPricingBySeg 接口返回 \\ (<color #ed1c24>实时航班计价暂不支持</color>)计价缓存失效后查询会失败 | |
| | | <color #ed1c24>fareId</color> | String | 计价价格id | N | 若传pricingSerialNumber&多价格必传 来自IDomesticTicketFinanceQueryV2 IDPricingBySeg 接口返回 \\ 计价缓存失效后查询会失败 | |
| |
| ==== 4.8.2请求样例 ==== | ==== 4.8.2请求样例 ==== |
| |
| <code> | <code> |
| | 实时航班退改: |
| { | { |
| "shoppingSerialNumber":"5668b9a3-6dcf-fc04-7fed-0b2bb1ac62fa", | "shoppingSerialNumber":"5668b9a3-6dcf-fc04-7fed-0b2bb1ac62fa", |
| "flightId":"8", | "flightId":"8", |
| "cabinFareId":"11" | "cabinFareId":"11" |
| | } |
| | 计价退改: |
| | { |
| | "pricingSerialNumber": "84f022105bbf90840b4f7c828a5c5f657f", |
| | "fareId": "ADT0_0_0-0-0", |
| | "PNR": "" |
| } | } |
| </code> | </code> |
| detail: | detail: |
| |
| ^参数 ^类型 ^说明 ^备注^ | ^ 参数 ^ 类型 ^ 说明 ^ 备注 ^ |
| |changeConditions|String |签转条件| | | | changeConditions | String | 签转条件 | | |
| |ruleRemark|String |备注 | | | | ruleRemark | String | 备注 | | |
| |baggageAllowance|String |行李额 | | | | baggageAllowance | String | 行李额 | 例：免费托运行李：每件20KG，每人1件，每件体积不超过40×60×100CM；免费手提行李：每件12KG，每人1件，每件体积不超过40×60×100CM | |
| |ruleId|String |退改条款id | | | | ruleId | String | 退改条款id | | |
| |ruleItem|Array|退改明细 | | | | ruleItem | Array | 退改明细 | | |
| | | <color #ed1c24>airline</color> | String | 航司 | PNR查询返回 | |
| | | <color #ed1c24>flightNumber</color> | String | 航班号 | PNR查询返回 | |
| | | <color #ed1c24>depAirport</color> | String | 出发机场 | PNR查询返回 | |
| | | <color #ed1c24>arrAirport</color> | String | 目的机场 | PNR查询返回 | |
| | | payCurrency | String | 币种 | <color #ed1c24>20250318 新增</color> | |
| | | ticketLuggageRule | Object | 行李额结构化信息 | <color #ed1c24>20250428 新增</color> | |
| |
| ruleItem: | ruleItem: |
| |
| ^ 参数 ^ 类型 ^ 说明 ^ 备注 ^ | ^ 参数 ^ 类型 ^ 说明 ^ 备注 ^ |
| | changePrice | Decimal | 同舱改签费 | | | | changePrice | Decimal | 同舱改签费 | | |
| | operatorHourText | String | 适用条件 | | | | operatorHourText | String | 适用条件 | | |
| | operatorTh | Decimal | 10:距离起飞前hour \\ 20:距离起飞前（含）hour \\ 30:起飞前X小时后hour \\ 40:起飞前X小时后(含)hour | | | | operatorTh | Decimal | 10:距离起飞前hour \\ 20:距离起飞前（含）hour \\ 30:起飞前X小时后hour \\ 40:起飞前X小时后(含)hour | | |
| | refundPrice | Decimal | 退票费用 | | | | refundPrice | Decimal | 退票费用 | | |
| | unit | String | 时间单位 | 10:小时 20:天 | | | unit | String | 时间单位 | 10:小时 20:天 | |
| | depTime | String | 起飞前时间 | | | | depTime | String | 起飞前时间 | | |
| | text | String | 文本型条款 | | | | text | String | 文本型条款 | | |
| | changeTips | String | 改签 | | | | changeTips | String | 改签 | | |
| | refundTips | String | 退款 | | | | refundTips | String | 退款 | | |
| | <color #ed1c24>refund_percent</color> | decimal | 退票百分比 | 2024/03/18 新增 | | | <color #ed1c24>refund_percent</color> | decimal | 退票百分比 | | |
| | <color #ed1c24>change_percent</color> | decimal | 改签百分比 | 2024/03/18 新增 | | | <color #ed1c24>change_percent</color> | decimal | 改签百分比 | | |
| | <color #ed1c24>change_price_base</color> | decimal | 改签费保底金额 | 2024/03/18 新增 | | | <color #ed1c24>change_price_base</color> | decimal | 改签费保底金额 | | |
| | <color #ed1c24>refund_price_base</color> | decimal | 退票保底金额 | 2024/03/18 新增 | | | <color #ed1c24>refund_price_base</color> | decimal | 退票保底金额 | | |
| | <color #ed1c24>cabin_code_base</color> | String | 计算退改基础舱位 | 2024/03/18 新增 | | |
| | |
| | ticketLuggageRule: |
| |
| | ^ 参数 ^ 类型 ^ 说明 ^ 备注 ^ |
| | | checkRuleInfo | String | 托运行李额完整信息 | 例：免费托运行李：每件20KG，每人1件，每件体积不超过40×60×100CM | |
| | | freeCheckCount | String | 免费托运行李重量 | 例：20 | |
| | | freeCheckUnit | String | 免费托运行李单位 | 例：KG | |
| | | freeCheckPcCount | String | 免费托运行李数量 | 例：1 | |
| | | freeCheckLuggage | String | 托运行李额 | 例：20KG | |
| | | checkDescription | String | 托运行李额说明 | 例：每件体积不超过40×60×100CM | |
| | | handRuleInfo | String | 手提行李额完整信息 | 例：免费手提行李：每件20KG，每人1件，每件体积不超过40×60×100CM | |
| | | freehandCount | String | 免费手提行李重量 | 例：20 | |
| | | freehandUnit | String | 免费手提行李单位 | 例：KG | |
| | | freehandPcCount | String | 免费手提行李数量 | 例：1 | |
| | | freehandLuggage | String | 手提行李额 | 例：20KG | |
| | | handDescription | String | 手提行李额说明 | 例：每件体积不超过40×60×100CM | |
| | | freeCheckSource | String | 托运行李额是否是航信的（ibeplus），否则不是 | 例：ibeplus | |
| ==== 4.8.4返回样例 ==== | ==== 4.8.4返回样例 ==== |
| |
