两侧同时换到之前的修订记录
前一修订版
后一修订版
|
前一修订版
|
4.8_国内实时航班退改条款_idomesticshoppingrulequeryv2 [2024/03/21 11:17] tiny [表] |
4.8_国内实时航班退改条款_idomesticshoppingrulequeryv2 [2025/03/20 01:56] (当前版本) tiny |
| |
| |
^参数 ^类型 ^说明 ^必填 ^备注^ | ^ 参数 ^ 类型 ^ 说明 ^ 必填 ^ 备注 ^ |
|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> |
|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> | |
| |
| |
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 新增 | | |
| |
==== 4.8.4返回样例 ==== | ==== 4.8.4返回样例 ==== |