美亚航旅机票B2B接口

用户工具

站点工具

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

差别

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

到此差别页面的链接

后一修订版 		前一修订版
4.8_国内实时航班退改条款_idomesticshoppingrulequeryv2 [2021/02/07 08:26]
louis 创建 		4.8_国内实时航班退改条款_idomesticshoppingrulequeryv2 [2025/07/02 09:48] (当前版本)
alan_luo
行 3: 行 3:
  
  
-^参数         ^类型   ^说明        ^必填        ^备注^ +^ 参数                                          ^ 类型      ^ 说明                                ^ 必填  ^ 备注                                                                                  ^ 
-|shoppingSerialNumber|String |航班查询key   |Y |字符串 ,来自 IDomesticTicketShopping接口返回。shopping缓存失效后查询会失败 。 | +| shoppingSerialNumber                        | String  | 航班查询key                           | N   | 来自 IDomesticTicketShopping / IGetDomesticShoppingData \\ 接口返回。shopping缓存失效后查询会失败 。  | 
-|flightId|String|实时航班flight_id         |Y         |  来自 IDomesticTicketShopping接口返回| +| flightId                                    | String  | 实时航班flight_id                     | N   | 来自 IDomesticTicketShopping / IGetDomesticShoppingData  \\ 接口返回                      | 
-|cabinFareId|String |实时航班舱位ID   |Y | 来自 IDomesticTicketShopping接口返回|  +| cabinFareId                                 | String  | 实时航班舱位ID                          | N   | 来自 IDomesticTicketShopping / IGetDomesticShoppingData  \\ 接口返回                      | 
 +| 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>
行 27: 行 39:
 detail: detail:
  
-^参数    ^类型 ^说明    ^备注^ +^ 参数                                   ^ 类型      ^ 说明        ^ 备注                                  ^ 
-|change_conditions|String |签转条件|  | +| changeConditions                     | String  | 签转条件      |                                     | 
-|rule_remark|String |备注 |  | +| ruleRemark                           | String  | 备注        |                                     | 
-|baggage_allowance|String |行李额 |  |  +| baggageAllowance                     | String  | 行李额       |   例：免费托运行李：每件20KG，每人1件，每件体积不超过40×60×100CM；免费手提行李：每件12KG，每人1件，每件体积不超过40×60×100CM                                  | 
-|rule_id|String |退改条款id |  |  +| ruleId                               | String  | 退改条款id    |                                     | 
-|rule_item|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  | 同舱改签费                                                                     |             | 
 +| 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   | 退款                                                                        |             | 
 +| <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  | 退票保底金额                                                                    |             |
  
-rule_item: 
  
-^参数    ^类型 ^说明    ^备注^ +ticketLuggageRule:
-|change_price|Decimal|同舱改签费|  | +
-|operator_hour_text|String|适用条件|  | +
-|operator_th|Decimal|| 10:距离起飞前hour \\ 20:距离起飞前（含）hour \\  30:起飞后hour \\  40:起飞后（含）hour | +
-|refund_price|Decimal|退票费用|  | +
-|unit|String|时间单位|  10:小时 20:天 | +
-|dep_time|String|起飞前时间  | +
-|text|String|文本型条款|  | +
-|change_tips|String|改签|  | +
-|refund_tips|String|退款|  |+
  
 +^ 参数                  ^ 类型   ^ 说明                             ^ 备注 ^
 +| 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返回样例 ====
  
行 54: 行 94:
     "detail": [     "detail": [
         {         {
-            "change_conditions": "", +            "changeConditions": "", 
-            "rule_remark": " 供参考，具体以航司规则为准", +            "ruleRemark": " 供参考，具体以航司规则为准", 
-            "baggage_allowance": null, +            "baggageAllowance": null, 
-            "rule_id": "", +            "ruleId": "", 
-            "rule_item": [+            "ruleItem": [
                 {                 {
-                    "change_price": "0", +                    "changePrice": "0", 
-                    "refund_price": "0", +                    "refundPrice": "0", 
-                    "operator_th": "0", +                    "operatorTh": "0", 
-                    "dep_time": "0", +                    "depTime": "0", 
-                    "operator_hour_text": "", +                    "operatorHourText": "", 
-"text": "", +                    "text": "", 
-"change_tips": "", +                    "changeTips": "", 
-"refund_tips": "",+                    "refundTips": "",
                 }                 }
             ]             ]
4.8_国内实时航班退改条款_idomesticshoppingrulequeryv2.1612686413.txt.gz · 最后更改: 2021/02/07 08:26 由 louis

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki