美亚航旅机票B2B接口

用户工具

站点工具

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

差别

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

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版 		前一修订版
3.4_航段询价_国际机票_iticketfarepolicybytrips [2023/09/21 12:01]
tiny [表] 		3.4_航段询价_国际机票_iticketfarepolicybytrips [2025/03/19 05:50] (当前版本)
doku
行 1: 行 1:
 3.4 航段询价(ITicketFarePolicyByTrips)  3.4 航段询价(ITicketFarePolicyByTrips) 
 +\\ 返回<color #ed1c24>一组最低</color>国际运价;
  
 ==== 3.4.1请求参数 ==== ==== 3.4.1请求参数 ====
  
  
-^参数         ^类型   ^说明        ^必填        ^备注^ +^参数         ^类型   ^说明          ^必填         ^备注^ 
-|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请求样例 ====
行 57: 行 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:
-^ 参数                               ^ 类型           ^ 说明                                     ^ 备注                                 ^ +^ 参数                                      ^ 类型           ^ 说明                               ^ 备注                                 ^ 
-| officeNumber                     | String       | 出票OFFICE号                              | 编码下单需授权                            | +| officeNumber                            | String       | 出票OFFICE号                        | 编码下单需授权                            | 
-| agencyPolicyRemark               | String       | 代理费政策限制                                |                                    | +| agencyPolicyRemark                      | String       | 代理费政策限制                          |                                    | 
-| rewardPolicyRemark               | String       | 奖励政策限制                                 |                                    | +| rewardPolicyRemark                      | String       | 奖励政策限制                           |                                    | 
-| agencyPolicyRemarkOut            | String       | 代理费政策备注                                |                                    | +| agencyPolicyRemarkOut                   | String       | 代理费政策备注                          |                                    | 
-| rewardPolicyRemarkOut            | String       | 奖励政策备注                                 |                                    | +| rewardPolicyRemarkOut                   | String       | 奖励政策备注                           |                                    | 
-| financeList                      | Array        | 价格组                                    | 每种乘客类型一条数据                         | +| financeList                             | Array        | 价格组                              | 每种乘客类型一条数据                         | 
-| IsConvert                        | Int          | 是否需转编码                                 | 0：不需要 \\ 1：需要                      | +| IsConvert                               | Int          | 是否需转编码                           | 0：不需要 \\ 1：需要                      | 
-| isItinerary                      | int          | 行程单                                    | 1：有行程单 \\ 0：无行程单                   | +| isItinerary                             | int          | 行程单                              | 1：有行程单 \\ 0：无行程单                   | 
-| FareRuleRef                      | Object       | 行李额等信息                                 |                                    | +| FareRuleRef                             | Object       | 行李额等信息                           |                                    | 
-| carrier                          | String       | 出票航司                                   |                                    | +| carrier                                 | String       | 出票航司                             |                                    | 
-| ticketType                       | int          | 票证类型                                   | 查询保险时使用                            | +| ticketType                              | int          | 票证类型                             | 查询保险时使用                            | 
-| flights                          | ObjectArray  | 行程                                     |                                    | +| flights                                 | ObjectArray  | 行程                               |                                    | 
-| <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>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  | 结算价     | 票面价+税金-代理费金额-奖励金额+服务费-促销合计金额                                                                             | 
-|productType  | String  | 产品类型   |   <color #ed1c24>20210813新增</color>   BSP、NDC、合作商 \\ 合作商：目前为PK、航路的数据 \\ NDC：目前为AGG、TF的数据 \\ BSP：非上述的其它数据         |+| productType                               | String   | 产品类型    |  <color #ed1c24>20210813新增</color>   BSP、NDC、合作商 \\ 合作商：目前为PK、航路的数据 \\ NDC：目前为AGG、TF的数据 \\ BSP：非上述的其它数据  | 
 +| saleAdditionRate                          | String   | 促销返点    |                                                                                                          | 
 +| saleAdditionMoney                         | String   | 促销直减金额  |                                                                                                          | 
 +| saleAdditionFare                          | String   | 促销合计金额  |                                                                                                          | 
 +| <color #ed1c24>limitingCondition</color>  | Object   | 乘客限制条件  | 202408新增                                                                                                 |
  
 FareRuleRef： FareRuleRef：
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|passenger_rule|Array|乘客规则 | |+|passenger_rule|Array|乘客规则  | |
  
 flights： flights：
行 121: 行 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:
行 134: 行 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>  |
行 151: 行 159:
 |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.4.4返回样例 ==== ==== 3.4.4返回样例 ====
3.4_航段询价_国际机票_iticketfarepolicybytrips.1695297705.txt.gz · 最后更改: 2023/09/21 12:01 由 tiny

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： 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