美亚航旅机票B2B接口

用户工具

站点工具

3.12_国际pricing_国际机票_ipricingbyseg

差别

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

到此差别页面的链接

后一修订版 		前一修订版
3.12_国际pricing_国际机票_ipricingbyseg [2021/03/03 09:48]
tiny 创建 		3.12_国际pricing_国际机票_ipricingbyseg [2025/03/25 08:09] (当前版本)
tiny [表]
行 1: 行 1:
 3.12 国际Pricing(IPricingBySeg)  3.12 国际Pricing(IPricingBySeg) 
-返回多组国际运价;+ \\ 返回<color #ed1c24>多组</color>国际运价;
 当PNR不为空时，则使用PNR计价，否则使用行段计价 当PNR不为空时，则使用PNR计价，否则使用行段计价
  
行 6: 行 6:
  
  
-^参数         ^类型   ^说明        ^必填        ^备注^ +^ 参数                 ^ 类型      ^ 说明         ^ 必填  ^ 备注                                                                                                                                                                                                 | 
-|airline|String |出票航司   |Y |不同出票航司将影响价格 |  +| airline            | String  | 出票航司       | Y   | 不同出票航司将影响价格 ， NDC产品计价只能使用航班查询接口返回的flightDetailList模型下的airline作为计价航司                                                                                                                                | 
-|passengerTypeList|Array|乘客类型及数量组  |Y | |  +| passengerTypeList  | Array   | 乘客类型及数量组   | Y   |                                                                                                                                                                                                       | 
-|flightList|Array|航段信息  |Y | |  +| bookingOffice      | String  | 预订OFFICE   | N   |                                                                                                                                                                                                    |  
-|PNR|String|PNR编码   |N | |  +| serialNumber       | string  | 航班查询缓存KEY  | N   | <color #ed1c24>20210813新增</color> 对应实时<color #22b14c>航班搜索(ITicketShoppingV2)</color>返回的serialNumber,如果实时航班查询下单的计价，需指定此参数和flightIdList参数。如果非实时航班下单的计价无需传入这两个参数 ,此参数的判断<color #ed1c24>优先级最高</color>     对应下单方式:1实时航班下单| 
-|bookingOffice|String|预订OFFICE  |N | |  +| flightID           | string  | 行程ID       | N   | <color #ed1c24>20210813新增</color> 对应<color #22b14c>实时航班搜索(ITicketShoppingV2)</color>返回的flightID,如果实时航班查询下单的计价，需指定此参数和serialNumber参数。如果非实时航班下单的计价无需传入这两个参数                                          | 
 +| 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: passengerTypeList:
-^参数         ^类型   ^说明        ^必填        ^备注^ +^参数         ^类型   ^说明          ^必填         ^备注^ 
-|passengerType|String|乘客类型  |Y | 0：成人 \\ 1：儿童 \\ 2：婴儿 \\ 3：老人 \\ 4：学生 \\ 5：劳务 \\ 6：移民 \\ 7：海员 \\ 8：青年|  +|passengerType|String|乘客类型  |Y  | 0：成人 \\ 1：儿童 \\ 2：婴儿 \\ 3：老人 \\ 4：学生 \\ 5：劳务 \\ 6：移民 \\ 7：海员 \\ 8：青年|  
-|passengerCount|String|乘客人数  |Y | 该乘客类型对应的人数| +|passengerCount|String|乘客人数     |Y  | 该乘客类型对应的人数| 
  
 flightList： 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 |  | +
  
  
行 62: 行 63:
 ==== 3.12.3返回参数 ==== ==== 3.12.3返回参数 ====
  
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|code |String |是否调用接口成功 |20000表示成功，非20000表异常 | +|code   |String |是否调用接口成功   |20000表示成功，非20000表异常 | 
-|detail |Object |结果集  | 空值  | +|detail |Object |结果集     | 空值  | 
-|description |String |描述 |当异常时记录异常信息 |+|description |String    |描述 |当异常时记录异常信息 | 
 +  
    
 detail: detail:
  
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|serialNumber|String |缓存key | 下单时回传给接口| +|<color #ed1c24>serialNumber</color>|String    |缓存key  | 下单时回传给接口<color #ed1c24>，isAsync为true，只会返回这个序列号，以下实体不返回</color> | 
-|financeDetail|Object|价格详情 | | +|financeDetail|Object|价格详情  | | 
-|workBeginTime|String|工作开始时间 | 格式如：”08:01:00”|+|workBeginTime|String|工作开始时间    | 格式如：”08:01:00”|
 |workEndTime|String|工作结束时间|格式如：”08:01:00” |  |workEndTime|String|工作结束时间|格式如：”08:01:00” | 
 +|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|String|行程单| 1：有行程单 \\ 0：无行程单| +| isItinerary                                         | int          | 行程单                                           | 1：有行程单 \\ 0：无行程单                   | 
-|FareRuleRef|Object|行李额等信息 | | +| FareRuleRef                                         | Object       | 行李额等信息                                        |                                    | 
 +| carrier                                             | String       | 出票航司                                          |                                    | 
 +| ticketType                                          | int          | 票证类型                                          | 查询保险产品时使用                          | 
 +| 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： 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：非上述的其它数据  | 
 +| saleAdditionRate                          | String  | 促销返点     |                                                                                                          | 
 +| saleAdditionMoney                         | String  | 促销直减金额   |                                                                                                          | 
 +| saleAdditionFare                          | String  | 促销合计金额   |                                                                                                          | 
 +| <color #ed1c24>limitingCondition</color>  | Object  | 乘客限制条件   | 202408新增                                                                                                 | 
 + 
  
  
 FareRuleRef： FareRuleRef：
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|passenger_rule|Array|乘客规则 | |+|passenger_rule|Array|乘客规则  | | 
 + 
 +flights： 
 +^ 参数                                ^ 类型      ^ 说明                                             ^ 备注                                                                ^ 
 +| airline                           | String  | 航司二字码                                          |                                                                   | 
 +| flightNumber                      | String  | 航班号                                            |                                                                   | 
 +| departureAirportCode              | String  | 出发机场编码                                         |                                                                   | 
 +| destinationAirportCode            | String  | 到达机场编码                                         |                                                                   | 
 +| departureDateTime                 | String  | 出发日期时间                                         |                                                                   | 
 +| classNo                           | String  | 舱位                                             |                                                                   | 
 +| classAvl                          | String  | 舱位数量，如果没有返回就空；如果是核价时底层接口有返回，则显示对应 classNo 的数量  |                                                                   | 
 +| isShare                           | String  | 是否共享                                           |                                                                   | 
 +| shareCode                         | String  | 共享航班号                                          |                                                                   | 
 +| equipment                         | String  | 机型                                             |                                                                   | 
 +| <color #ed1c24>cabinType</color>  | String  | 舱位等级                                           |  0 经济舱 1 豪华经济舱 3 商务舱 4 头等舱    <color #ed1c24>20230921 新增</color>  |
  
 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:
-^参数 ^类型 ^说明 ^备注^ +^ 参数                                     ^ 类型      ^ 说明    ^ 备注          ^ 
-|fareBasisCode|String|运价基础 | | +| fareBasisCode                          | String  | 运价基础  |             | 
-|luggageRaw|String|行李额 | | +| luggageRaw                             | String  | 行李额   |             | 
-|index|Int|序号 | | +| index                                  | Int     | 序号    |             | 
-|origin|String|出发地 | | +| origin                                 | String  | 出发地   |             | 
-|destination|String|目的地 | | +| destination                            | String  | 目的地   |             | 
-|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>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.12_国际pricing_国际机票_ipricingbyseg.1614764882.txt.gz · 最后更改: 2021/03/03 09:48 由 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