用户工具

站点工具


3.5_pnr询价_国际机票_iticketfarepolicybypnr

差别

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

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
3.5_pnr询价_国际机票_iticketfarepolicybypnr [2024/03/19 01:55]
tiny
3.5_pnr询价_国际机票_iticketfarepolicybypnr [2025/03/19 05:50] (当前版本)
doku
行 6: 行 6:
  
  
-^参数         ^类型   ^说明        ^必填        ^备注^ +^参数         ^类型   ^说明          ^必填         ^备注^ 
-|PNR|String |PNR编码   |Y | |  +|PNR|String |PNR编码      |Y  | |  
-|airline|String |出票航司   |Y |不同出票航司将影响价格 |  +|airline|String |出票航司   |Y  |不同出票航司将影响价格 |  
-|passengerTypeList|Array|乘客类型及数量组  |Y | | +|passengerTypeList|Array|乘客类型及数量组   |Y  | | 
  
 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  | 该乘客类型对应的人数| 
  
  
行 34: 行 34:
 ==== 3.5.3返回参数 ==== ==== 3.5.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:
行 63: 行 64:
 | <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       | 产品标签                        | 美亚优选 美亚自营 航司直连 官网直销 精选特惠  |
  
  
 financeList: financeList:
  
-^参数 ^类型 ^说明 ^备注^ +^ 参数                                        ^ 类型       ^ 说明      ^ 备注                                                                    
-|passengerType|Int |乘客类型 |0:成人 \\ 1:儿童 \\ 2:婴儿 \\ 3:老人 \\ 4:学生 \\ 5:劳务 \\ 6:移民 \\ 7:海员 \\ 8:青年 | +| passengerType                             | Int      | 乘客类型    | 0:成人 \\ 1:儿童 \\ 2:婴儿 \\ 3:老人 \\ 4:学生 \\ 5:劳务 \\ 6:移民 \\ 7:海员 \\ 8:青年  
-|salePrice|Decimal |票面价 | | +| salePrice                                 | Decimal  | 票面价                                                                           
-|tax|Decimal |税金 | | +| tax                                       | Decimal  | 税金                                                                            
-|beforeReturn|float|代理费点数 | | +| beforeReturn                              | float    | 代理费点数                                                                         
-|beforeReturnPrice|Decimal|代理费金额 | | +| beforeReturnPrice                         | Decimal  | 代理费金额                                                                         
-|afterReturnBase|Decimal|奖励基数 | | +| afterReturnBase                           | Decimal  | 奖励基数                                                                          
-|afterReturn|float|奖励点数 | | +| afterReturn                               | float    | 奖励点数                                                                          
-|afterReturnPrice|Decimal|奖励金额 | | +| afterReturnPrice                          | Decimal  | 奖励金额                                                                          
-|serviceFee|Decimal|服务费 | | +| serviceFee                                | Decimal  | 服务费                                                                           
-|saleTotal|Decimal|结算价 |票面价+税金-代理费金额-奖励金额+服务费-促销合计金额 |  +| saleTotal                                 | Decimal  | 结算价     | 票面价+税金-代理费金额-奖励金额+服务费-促销合计金额                                          
-|saleAdditionRate|String|促销返点  | | +| saleAdditionRate                          | String   | 促销返点                                                                          
-|saleAdditionMoney|String|促销直减金额  | | +| saleAdditionMoney                         | String   | 促销直减金额                                                                       
-|saleAdditionFare|String|促销合计金额  | |+| saleAdditionFare                          | String   | 促销合计金额                                                                       | 
 +| <color #ed1c24>limitingCondition</color>  | Object   | 乘客限制条件  | 202408新增                                                              |
  
  
 flights: flights:
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|airline|String|航司二字码 | | +|airline|String|航司二字码   | | 
-|flightNumber|String|航班号 | | +|flightNumber|String|航班号    | | 
-|departureAirportCode|String|出发机场编码 | | +|departureAirportCode|String|出发机场编码 | | 
-|destinationAirportCode|String|到达机场编码 | | +|destinationAirportCode|String|到达机场编码   | | 
-|departureDateTime|String|出发日期时间 | | +|departureDateTime|String|出发日期时间    | | 
-|classNo|String|舱位 | | +|classNo|String|舱位  | | 
-|classAvl|String|舱位数量,如果没有返回就空;如果是核价时底层接口有返回,则显示对应 classNo 的数量 | | +|classAvl|String|舱位数量,如果没有返回就空;如果是核价时底层接口有返回,则显示对应 classNo 的数量  | | 
-|isShare|String|是否共享 | | +|isShare|String|是否共享    | | 
-|shareCode|String|共享航班号 | | +|shareCode|String|共享航班号 | | 
-|equipment|String|机型 | |+|equipment|String|机型    | |
 |cabinType|String  | 舱位等级    |  0 经济舱 1 豪华经济舱 3 商务舱 4 头等舱  <color #ed1c24>20230921新增</color> | |cabinType|String  | 舱位等级    |  0 经济舱 1 豪华经济舱 3 商务舱 4 头等舱  <color #ed1c24>20230921新增</color> |
  
  
 FareRuleRef: FareRuleRef:
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|passenger_rule|Array|乘客规则 | |+|passenger_rule|Array|乘客规则  | |
  
 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:
行 116: 行 120:
 | 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> |
行 132: 行 136:
 |depCityCN|String|出发城市中文  | | |depCityCN|String|出发城市中文  | |
 |desCityCN|String|到达城市中文  | | |desCityCN|String|到达城市中文  | |
 +
 +limitingCondition
 +^参数 ^类型 ^说明 ^备注^
 +|nationalityOrArea|Object|国籍/地区限制| | 
 +|certificate|Object|证件限制| |
 +|availableAge|Object|年龄限制| |
 +|availablePassagerCount|Object|人数限制| |
 +
 +
 +nationalityOrArea/certificate
 +^参数 ^类型 ^说明 ^备注^
 +|isAllow|Boolean|是否允许|true:则允许codes的国籍/地区(证件类型) false:则禁止codes的国籍/地区(证件类型) | 
 +|codes|Array|国家/地区二字码(证件类型参考下单IDType)|该参数有值时isAllow有效 |
 +|names|Array|国家/地区(证件类型)中文名称| |
 +
 +availableAge
 +^参数 ^类型 ^说明 ^备注^
 +|minAge|Int|最小年龄限制|默认值:-1(无限制) 
 +|maxAge|Int|最大年龄限制|默认值:-1(无限制) | 
 +
 +availablePassagerCount
 +^参数 ^类型 ^说明 ^备注^
 +|minCount|Int|最小人数限制 |默认值:-1(无限制) 
 +|maxCount|Int|最大人数限制 |默认值:-1(无限制)  |  | 
 +|beEvenNumber|Boolean|是否偶数人数限制 | 
 +
 +RCVServiceFee
 +^参数 ^类型 ^说明 ^备注^
 +|ChangeFeeCNY|Float|改签加收服务费 |无数据则以退票时为准 | 
 +|RefundFeeCNY|Float|退票加收服务费 |无数据则以退票时为准 | 
 +|VoidFeeCNY|Float|废票加收服务费 | 无数据则以退票时为准| 
  
 ==== 3.5.4返回样例 ==== ==== 3.5.4返回样例 ====
3.5_pnr询价_国际机票_iticketfarepolicybypnr.1710813349.txt.gz · 最后更改: 2024/03/19 01:55 由 tiny