差别

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

--- 3.4_航段询价_国际机票_iticketfarepolicybytrips [2023/07/31 03:54]
tiny
+++ 3.4_航段询价_国际机票_iticketfarepolicybytrips [2025/03/19 05:50] (当前版本)
doku
@@ 行 1: / 行 1: @@
 .4 航段询价(ITicketFarePolicyByTrips)
+\\ 返回<color #ed1c24>一组最低</color>国际运价;
 ==== 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:
-^参数	        ^类型	  ^说明	       ^必填	       ^备注^
+^参数         ^类型   ^说明          ^必填         ^备注^
-|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：
 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请求样例 ====
@@ 行 57: / 行 58: @@
 ==== 3.4.3返回参数 ====
-^参数	^类型	^说明	^备注^
+^参数 ^类型 ^说明 ^备注^
-|code	|String	|是否调用接口成功	|20000表示成功，非20000表异常 |
+|code   |String |是否调用接口成功   |20000表示成功，非20000表异常 |
-|detail	|Object	|结果集	 | 空值  |
+|detail |Object |结果集     | 空值  |
-|description |String	|描述	|当异常时记录异常信息 |
+|description |String    |描述 |当异常时记录异常信息 |
 detail:
-^参数	^类型	^说明	^备注^
+^参数 ^类型 ^说明 ^备注^
-|serialNumber|String	|缓存key	| 下单时回传给接口|
+|serialNumber|String    |缓存key  | 下单时回传给接口|
-|financeDetail|Object|价格详情	| |
+|financeDetail|Object|价格详情  | |
-|workBeginTime|String|工作开始时间	| 格式如：”08:01”|
+|workBeginTime|String|工作开始时间    | 格式如：”08:01”|
 |workEndTime|String|工作结束时间|格式如：”08:01” |
+|payCurrency |String  |币种  |  <color #ed1c24>20250318 新增预留字段,暂未启用</color>  |
 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>authorizeOffice</color>  | String       | String                           | 授权office                           |
+| <color #ed1c24>RCVServiceFee</color>                              | Object| 退改废服务费 <color #ed1c24>20241017新增</color>                     |                       |
+| productLabel                            | String       | 产品标签                        | 美亚优选 美亚自营 航司直连 官网直销 精选特惠  |
 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：
-^参数	^类型	^说明	^备注^
+^参数 ^类型 ^说明 ^备注^
-|passenger_rule|Array|乘客规则	| |
+|passenger_rule|Array|乘客规则  | |
 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  | 机型                                             |                             |
+| <color #ed1c24>cabinType</color>  | String  | 舱位等级                                           |  0 经济舱 1 豪华经济舱 3 商务舱 4 头等舱  |
 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_basis_code|String|运价基础	| |
+| fare_basis_code                        | String  | 运价基础  |                                    |
-|luggageRaw|String|行李额	| |
+| luggageRaw                             | String  | 行李额   |                                    |
-|index|Int|序号	| |
+| index                                  | Int     | 序号    |                                    |
-|origin|String|出发地	| |
+| origin                                 | String  | 出发地   |                                    |
-|destination|String|目的地	| |
+| destination                            | String  | 目的地   |                                    |
+| minStay                                | String  | 最短停留  |                                    |
+| maxStay                                | String  | 最长停留  |                                    |
+| refund                                 | String  | 退票说明  |已停用 请求3.2 退改签条款获取|
+| change                                 | String  | 改签说明  |已停用 请求3.2 退改签条款获取|
+| noShow                                 | String  | 误机说明  |已停用 请求3.2 退改签条款获取|
+| <color #ed1c24>baggageCarryon</color>  | Array   | 手持行李  | <color #ed1c24>20230921新增</color>  |
+| <color #ed1c24>baggageChecked</color>  | Array   | 托运行李  | <color #ed1c24>20230921新增</color>  |
+baggageCarryon / baggageChecked:
+^参数 ^类型 ^说明 ^备注^
+|depAirport|String|出发机场编码  | |
+|desAirport|String|到达机场编码  | |
+|demision|String|每件长宽高  | |
+|pieces|String|件数  | |
+|weight|String|重量  | |
+|description|String|描述  | |
+|depCityCN|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返回样例 ====

美亚航旅机票B2B接口

用户工具

站点工具

差别

页面工具