差别

这里会显示出您选择的修订版和当前版本之间的差别。

--- 4.8_国内实时航班退改条款_idomesticshoppingrulequeryv2 [2022/02/23 08:49]
tiny
+++ 4.8_国内实时航班退改条款_idomesticshoppingrulequeryv2 [2025/07/02 09:48] (当前版本)
alan_luo
@@ 行 3: / 行 3: @@
-^参数	        ^类型	  ^说明	       ^必填	       ^备注^
+^ 参数                                          ^ 类型      ^ 说明                                ^ 必填  ^ 备注                                                                                  ^
-|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请求样例 ====
 <code>
+实时航班退改:
 {
     "shoppingSerialNumber":"5668b9a3-6dcf-fc04-7fed-0b2bb1ac62fa",
     "flightId":"8",
     "cabinFareId":"11"
+}
+计价退改:
+{
+    "pricingSerialNumber": "84f022105bbf90840b4f7c828a5c5f657f",
+    "fareId": "ADT0_0_0-0-0",
+    "PNR": ""
 }
 </code>
@@ 行 28: / 行 39: @@
 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:
-^参数	   ^类型	^说明	   ^备注^
+^ 参数                                        ^ 类型       ^ 说明                                                                        ^ 备注          ^
-|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  | 退票百分比                                                                     |             |
+| <color #ed1c24>change_percent</color>     | decimal  | 改签百分比                                                                     |             |
+| <color #ed1c24>change_price_base</color>  | decimal  | 改签费保底金额                                                                   |             |
+| <color #ed1c24>refund_price_base</color>  | decimal  | 退票保底金额                                                                    |             |
+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返回样例 ====

美亚航旅机票B2B接口

用户工具

站点工具

差别

页面工具