差别

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

--- 3.12_国际pricing_国际机票_ipricingbyseg [2023/05/26 07:52]
doku
+++ 3.12_国际pricing_国际机票_ipricingbyseg [2025/03/25 08:09] (当前版本)
tiny [表]
@@ 行 1: / 行 1: @@
 .12 国际Pricing(IPricingBySeg)
- \\ 返回多组国际运价;
+ \\ 返回<color #ed1c24>多组</color>国际运价;
 当PNR不为空时，则使用PNR计价，否则使用行段计价
@@ 行 14: / 行 14: @@
 | PNR                | String  | PNR编码      | N   | 若传入该参数，<color #ff7f27>优先级次于serialNumber</color>    对应下单方式:2PNR下单           |
 | flightList         | Array   | 航段信息       | N   | 若传入该参数，<color #ffc90e>优先级最低</color>     对应下单方式:3航段下单   |
+| <color #ed1c24>isAsync</color>         | bool   | 是否异步获取价格       | N   | <color #ed1c24>默认不异步，如果该参数为true，则接口只会返回缓存serialNumber，并需要三十分钟内调用IPricingBySegAsnyc接口获取价格</color>   |
 passengerTypeList:
@@ 行 22: / 行 22: @@
 flightList：
-^参数         ^类型   ^说明          ^必填         ^备注^
+^ 参数                      ^ 类型      ^ 说明      ^ 必填  ^ 备注      ^
-|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   |         |
@@ 行 67: / 行 67: @@
 |detail |Object |结果集     | 空值  |
 |description |String    |描述 |当异常时记录异常信息 |
 detail:
 ^参数 ^类型 ^说明 ^备注^
-|serialNumber|String    |缓存key  | 下单时回传给接口|
+|<color #ed1c24>serialNumber</color>|String    |缓存key  | 下单时回传给接口<color #ed1c24>，isAsync为true，只会返回这个序列号，以下实体不返回</color> |
 |financeDetail|Object|价格详情  | |
 |workBeginTime|String|工作开始时间    | 格式如：”08:01:00”|
 |workEndTime|String|工作结束时间|格式如：”08:01:00” |
+|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|Object|行程  | |
+| 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       | 产品标签                                          | 美亚优选 美亚自营 航司直连 官网直销 精选特惠           |
+| <color #ed1c24>canBeVoid</color>                    | Boolean      | 是否可作废(true-可作废,false-不可作废)                    |                                    |
+| <color #ed1c24>latestVoidTicketingDeadline</color>  | String       | 最晚作废时间格式 yyyy-MM-ddTHH:mm:ss                  |                                    |
 financeList：
-^参数 ^类型 ^说明 ^备注^
+^ 参数                                        ^ 类型      ^ 说明       ^ 备注                                                                                                       ^
-|passengerType|String |乘客类型 |0：成人 \\ 1：儿童 \\ 2：婴儿 \\ 3：老人 \\ 4：学生 \\ 5：劳务 \\ 6：移民 \\ 7：海员 \\ 8：青年 |
+| passengerType                             | String  | 乘客类型     | 0：成人 \\ 1：儿童 \\ 2：婴儿 \\ 3：老人 \\ 4：学生 \\ 5：劳务 \\ 6：移民 \\ 7：海员 \\ 8：青年                                     |
-|salePrice|String |票面价  | |
+| salePrice                                 | String  | 票面价      |                                                                                                          |
-|tax|String |税金 | |
+| tax                                       | String  | 税金       |                                                                                                          |
-|beforeReturn|String|代理费点数  | |
+| beforeReturn                              | String  | 代理费点数    |                                                                                                          |
-|beforeReturnPrice|String|代理费金额 | |
+| beforeReturnPrice                         | String  | 代理费金额    |                                                                                                          |
-|afterReturnBase|String|奖励基数    | |
+| afterReturnBase                           | String  | 奖励基数     |                                                                                                          |
-|afterReturn|String|奖励点数    | |
+| afterReturn                               | String  | 奖励点数     |                                                                                                          |
-|afterReturnPrice|String|奖励金额   | |
+| afterReturnPrice                          | String  | 奖励金额     |                                                                                                          |
-|serviceFee|String|服务费  | |
+| serviceFee                                | String  | 服务费      |                                                                                                          |
-|saleTotal|String|结算价   |票面价+税金-代理费金额-奖励金额+服务费 |
+| saleTotal                                 | String  | 结算价      | 票面价+税金-代理费金额-奖励金额+服务费-促销合计金额                                                                             |
-|beforeReturnMoney|String|代理费直减金额   | |
+| beforeReturnMoney                         | String  | 代理费直减金额  |                                                                                                          |
-|afterReturMoney|String|奖励直减金额  | |
+| afterReturMoney                           | String  | 奖励直减金额   |                                                                                                          |
-| 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：
@@ 行 114: / 行 131: @@
 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 头等舱    <color #ed1c24>20230921 新增</color>  |
 passenger_rule:
@@ 行 132: / 行 150: @@
 fare_rule:
+^ 参数                                     ^ 类型      ^ 说明    ^ 备注          ^
+| fareBasisCode                          | String  | 运价基础  |             |
+| luggageRaw                             | String  | 行李额   |             |
+| index                                  | Int     | 序号    |             |
+| origin                                 | 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:
 ^参数 ^类型 ^说明 ^备注^
-|fareBasisCode|String|运价基础  | |
+|depAirport|String|出发机场编码  | |
-|luggageRaw|String|行李额  | |
+|desAirport|String|到达机场编码  | |
-|index|Int|序号   | |
+|demision|String|每件长宽高  | |
-|origin|String|出发地  | |
+|pieces|String|件数  | |
-|destination|String|目的地 | |
+|weight|String|重量  | |
-|minStay|String|最短停留    | |
+|description|String|描述  | |
-|maxStay|String|最长停留    | |
+|depCityCN|String|出发城市中文  | |
-|refund|String|退票说明 | |
+|desCityCN|String|到达城市中文  | |
-|change|String|改签说明 | |
-|noShow|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|废票加收服务费 |无数据则以退票时为准 |

美亚航旅机票B2B接口

用户工具

站点工具

差别

页面工具