用户工具

站点工具


3.4_航段询价_国际机票_iticketfarepolicybytrips

差别

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

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
3.4_航段询价_国际机票_iticketfarepolicybytrips [2024/08/08 06:58]
tiny
3.4_航段询价_国际机票_iticketfarepolicybytrips [2025/03/19 05:50] (当前版本)
doku
行 5: 行 5:
  
  
-^参数         ^类型   ^说明        ^必填        ^备注^ +^参数         ^类型   ^说明          ^必填         ^备注^ 
-|airline|String |出票航司   |Y |不同出票航司将影响价格 |  +|airline|String |出票航司   |Y  |不同出票航司将影响价格 |  
-|passengerTypeList|Array|乘客类型及数量组  |Y | |  +|passengerTypeList|Array|乘客类型及数量组   |Y  | |  
-|flightList|Array|航段信息   |Y | |  +|flightList|Array|航段信息      |Y  | |  
-|serialNumber|string|航班查询缓存KEY|N | <color #ed1c24>20210813新增</color> 对应实时<color #22b14c>航班搜索(ITicketShoppingV2)</color>返回的serialNumber,如果实时航班查询下单的计价,需指定此参数和flightIdList参数。如果非实时航班下单的计价无需传入这两个参数 ,此参数的判断优先级最高 | +|serialNumber|string|航班查询缓存KEY|N    | <color #ed1c24>20210813新增</color> 对应实时<color #22b14c>航班搜索(ITicketShoppingV2)</color>返回的serialNumber,如果实时航班查询下单的计价,需指定此参数和flightIdList参数。如果非实时航班下单的计价无需传入这两个参数 ,此参数的判断优先级最高 | 
-|flightID|string|行程ID|N | <color #ed1c24>20210813新增</color> 对应<color #22b14c>实时航班搜索(ITicketShoppingV2)</color>返回的flightID,如果实时航班查询下单的计价,需指定此参数和serialNumber参数。如果非实时航班下单的计价无需传入这两个参数 |+|flightID|string|行程ID|N | <color #ed1c24>20210813新增</color> 对应<color #22b14c>实时航班搜索(ITicketShoppingV2)</color>返回的flightID,如果实时航班查询下单的计价,需指定此参数和serialNumber参数。如果非实时航班下单的计价无需传入这两个参数 |
  
 passengerTypeList: passengerTypeList:
-^参数         ^类型   ^说明        ^必填        ^备注^ +^参数         ^类型   ^说明          ^必填         ^备注^ 
-|passengerType|Int|乘客类型  |Y | 0:成人 \\ 1:儿童 \\ 2:婴儿 \\ 3:老人 \\ 4:学生 \\ 5:劳务 \\ 6:移民 \\ 7:海员 \\ 8:青年|  +|passengerType|Int|乘客类型     |Y  | 0:成人 \\ 1:儿童 \\ 2:婴儿 \\ 3:老人 \\ 4:学生 \\ 5:劳务 \\ 6:移民 \\ 7:海员 \\ 8:青年|  
-|passengerCount|Int|乘客人数  |Y | 该乘客类型对应的人数| +|passengerCount|Int|乘客人数    |Y  | 该乘客类型对应的人数| 
  
 flightList: flightList:
 passengerTypeList: passengerTypeList:
-^参数         ^类型   ^说明        ^必填        ^备注^ +^参数         ^类型   ^说明          ^必填         ^备注^ 
-|airline|String|航司二字码  |Y |  |  +|airline|String|航司二字码   |Y  |  |  
-|flightNumber|String|航班号  |Y |  |  +|flightNumber|String|航班号    |Y  |  |  
-|departureAirportCode|String|出发机场编码  |Y |  |  +|departureAirportCode|String|出发机场编码     |Y  |  |  
-|destinationAirportCode|String|到达机场编码  |Y |  |  +|destinationAirportCode|String|到达机场编码   |Y  |  |  
-|departureDateTime|String|出发日期时间 |Y |  |  +|departureDateTime|String|出发日期时间    |Y  |  |  
-|arrivalDateTime|String|到达日期时间  |Y |  |  +|arrivalDateTime|String|到达日期时间  |Y  |  |  
-|classNo|String|舱位  |Y |  |  +|classNo|String|舱位  |Y  |  |  
-|isShare|String|是否共享 |N | 0否  1是 |  +|isShare|String|是否共享    |N  | 0否  1是 |  
-|shareCode|String|共享航班号  |N |  |  +|shareCode|String|共享航班号     |N  |  |  
-|equipment|String|机型  |N |  | +|equipment|String|机型    |N  |  | 
  
 ==== 3.4.2请求样例 ==== ==== 3.4.2请求样例 ====
行 58: 行 58:
 ==== 3.4.3返回参数 ==== ==== 3.4.3返回参数 ====
  
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|code |String |是否调用接口成功 |20000表示成功,非20000表异常 | +|code   |String |是否调用接口成功   |20000表示成功,非20000表异常 | 
-|detail |Object |结果集  | 空值 +|detail |Object |结果集     | 空值 
-|description |String |描述 |当异常时记录异常信息 |+|description |String    |描述 |当异常时记录异常信息 |
    
 detail: detail:
  
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|serialNumber|String |缓存key | 下单时回传给接口| +|serialNumber|String    |缓存key  | 下单时回传给接口| 
-|financeDetail|Object|价格详情 | | +|financeDetail|Object|价格详情  | | 
-|workBeginTime|String|工作开始时间 | 格式如:”08:01”|+|workBeginTime|String|工作开始时间    | 格式如:”08:01”|
 |workEndTime|String|工作结束时间|格式如:”08:01” |  |workEndTime|String|工作结束时间|格式如:”08:01” | 
 +|payCurrency |String  |币种  |  <color #ed1c24>20250318 新增预留字段,暂未启用</color>  |
 financeDetail: financeDetail:
 ^ 参数                                      ^ 类型           ^ 说明                               ^ 备注                                 ^ ^ 参数                                      ^ 类型           ^ 说明                               ^ 备注                                 ^
行 87: 行 87:
 | <color #ed1c24>groupTag</color>         | Bool         | true代表该运价为小团价产品  若退改废必须全部旅客一起申请  | <color #ed1c24>20230921新增</color>  | | <color #ed1c24>groupTag</color>         | Bool         | true代表该运价为小团价产品  若退改废必须全部旅客一起申请  | <color #ed1c24>20230921新增</color>  |
 | <color #ed1c24>authorizeOffice</color>  | String       | String                           | 授权office                           | | <color #ed1c24>authorizeOffice</color>  | String       | String                           | 授权office                           |
 +| <color #ed1c24>RCVServiceFee</color>                              | Object| 退改废服务费 <color #ed1c24>20241017新增</color>                                           |
 +| productLabel                            | String       | 产品标签                        | 美亚优选 美亚自营 航司直连 官网直销 精选特惠  |
  
  
行 109: 行 111:
  
 FareRuleRef: FareRuleRef:
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|passenger_rule|Array|乘客规则 | |+|passenger_rule|Array|乘客规则  | |
  
 flights: flights:
行 127: 行 129:
  
 passenger_rule: passenger_rule:
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|passenger_type|String|乘客类型 |ADT:成人 \\ [CNN/CHD]: 儿童  \\ INF: 婴儿 | +|passenger_type|String|乘客类型 |ADT:成人 \\ [CNN/CHD]: 儿童  \\ INF: 婴儿 | 
-|fare_rule|Array|规则 | |+|fare_rule|Array|规则 | |
  
 fare_rule: fare_rule:
行 140: 行 142:
 | minStay                                | String  | 最短停留  |                                    | | minStay                                | String  | 最短停留  |                                    |
 | maxStay                                | String  | 最长停留  |                                    | | maxStay                                | String  | 最长停留  |                                    |
-| refund                                 | String  | 退票说明                                    +| refund                                 | String  | 退票说明  |已停用 请求3.2 退改签条款获取
-| change                                 | String  | 改签说明                                    +| change                                 | String  | 改签说明  |已停用 请求3.2 退改签条款获取
-| noShow                                 | String  | 误机说明                                    |+| noShow                                 | String  | 误机说明  |已停用 请求3.2 退改签条款获取|
 | <color #ed1c24>baggageCarryon</color>  | Array   | 手持行李  | <color #ed1c24>20230921新增</color>  | | <color #ed1c24>baggageCarryon</color>  | Array   | 手持行李  | <color #ed1c24>20230921新增</color>  |
 | <color #ed1c24>baggageChecked</color>  | Array   | 托运行李  | <color #ed1c24>20230921新增</color>  | | <color #ed1c24>baggageChecked</color>  | Array   | 托运行李  | <color #ed1c24>20230921新增</color>  |
行 182: 行 184:
 |beEvenNumber|Boolean|是否偶数人数限制 |  |beEvenNumber|Boolean|是否偶数人数限制 | 
  
 +RCVServiceFee
 +^参数 ^类型 ^说明 ^备注^
 +|ChangeFeeCNY|Float|改签加收服务费 |无数据则以退票时为准 | 
 +|RefundFeeCNY|Float|退票加收服务费 |无数据则以退票时为准 | 
 +|VoidFeeCNY|Float|废票加收服务费 | 无数据则以退票时为准| 
  
 ==== 3.4.4返回样例 ==== ==== 3.4.4返回样例 ====
3.4_航段询价_国际机票_iticketfarepolicybytrips.1723100296.txt.gz · 最后更改: 2024/08/08 06:58 由 tiny