用户工具

站点工具


4.5_国内采购生单v2_idomesticticketbookingv2

差别

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

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
4.5_国内采购生单v2_idomesticticketbookingv2 [2021/02/08 05:45]
louis
4.5_国内采购生单v2_idomesticticketbookingv2 [2023/11/22 11:17] (当前版本)
tiny
行 1: 行 1:
-4.54国内采购生单(/IDomesticTicketBooking)+4.国内采购生单(/IDomesticTicketBookingV2)
 ==== 4.5.1请求参数 ==== ==== 4.5.1请求参数 ====
  
  
-^参数         ^类型   ^说明        ^必填        ^备注^ +^ 参数                              ^ 类型      ^ 说明             ^ 必填   ^ 备注                                                                                             
-|policySerialNumber|String |计价key   |Y | | +| policySerialNumber              | String  | 计价key          | Y                                                                                                   
-|createOrderType|Int |下单方式         |Y         |1:实时班下单 \\ 2:PNR下单 \\ 3:航段下单 | +| createOrderType                 | Int     | 下单方式           | Y    | 1:实时班下单 \\ 2:PNR下单 \\ 3:航段下单                                                                  
-|PNR|String |PNR   |N | 下单方式为2、3该字段必填 且需先授权给出票 OFFICE号|   +| PNR                             | String  | PNR            | N    | 下单方式为2、3该字段必填 且需先授权给出票 OFFICE号                                                                 
-|isConvert|int|是否转编码   |N | 当下单方式为2、3 \\ 是否自动转编码:1:转0:不转 \\ (计价结果isConvert为1) \\(若不转生单为申请单,人工跟进)|   +| isConvert                       | int     | 是否转编码          | N    | 当下单方式为2、3  \\  是否自动转编码:1:转0:不转 \\ (计价结果isConvert为1) \\ (若不转生单为申请单,人工跟进)                        
-|passengerList|Array|  乘客列表 |Y/N | 当下单方式为1、3必填| +| passengerList                   | Array   |  乘客列表          | Y/N  | 当下单方式为1、3必填                                                                                    
-|QDOrderID|String|  第三方订单号 |N |  +| QDOrderID                       | String  |  第三方订单号        | N                                                                                                   
-|APIAntiOffice|String|  API反授权office |N |  +| APIAntiOffice                   | String  |  API反授权office  | N                                                                                                   | 
-|FlightChangeNoticeMobileNumber|String|  航变通知手机号 |N |需生成PNR且成功时生效  +|<color #ed1c24>ETTJAuthOffice</color>|String|票号授权office |N | 票号需要授权的office号,仅限传1个   11.22 |  
-|contact|Object|  联系信息 |Y/N |订单联系信息,若不传则按默认联系方式 | +| FlightChangeNoticeMobileNumber  | String  |  航变通知手机号       | N    | 需生成PNR且成功时生效                                                                                   
-|fareId|String|  价格id |Y/N |使用IDPricingBySeg接口计价 必填 |+| contact                         | Object  |  联系信息          | Y/N  | 订单联系信息,若不传则按默认联系方式                                                                             
 +| fareId                          | String  |  价格id          | Y/N  | 使用IDPricingBySeg接口计价 必填                                                                        | 
 +| insuranceProductSerialNumber    | String  | 保险key          | N    | 购保时必传 IInsuranceProductsQuery接口的serialNumber                                                   | 
 +| insuranceList                   | Array   | 购买的保险集合        | N    | IInsuranceProductsQuery按航段选择保险产品  \\  查询保险产品时需按下单乘客类型传递 一旦选择则默认全部的乘客都购买  若下单和保险查询的乘客类型不一致则会提示 
  
 passengerList: passengerList:
  
-^参数         ^类型   ^说明        ^必填        ^备注^ +^ 参数                                    ^ 类型      ^ 说明                            ^ 必填   ^ 备注                                                                                                                                                                                                                                                                                                                                                                                            
-|Name|String |乘客姓名  |Y | | +| Name                                  | String  | 乘客姓名                          | Y                                                                                                                                                                                                                                                                                                                                                                                                  
-|PsgType|Int |乘客类型  |Y | 0:成人 \\ 1:儿童 \\ 2:婴儿| +| PsgType                               | Int     | 乘客类型                          | Y    | 0:成人 \\ 1:儿童 \\ 2:婴儿                                                                                                                                                                                                                                                                                                                                                                          
-|Nationality|String |国籍代码 |Y | | +| Nationality                           | String  | 国籍代码                          | Y    非身份证、非港澳台居民居住证 必传                                                                                                                                                                                                                                                                                                                                                                             
-|IDType|Int |证件类型|Y | 1:其他 \\ 2身份证 | +| IDType                                | Int     | 证件类型                          | Y    0:护照 \\ <del><color #ed1c24> 1:其他有效证件(注:含军人证、回乡证、台胞证、户口簿、出生证明、学生证、外国人永久居留证、民航局规定的其他有效乘机身份证件 长度不超过15位)</color></del> \\  <color #ed1c24>身份证:2</color> \\ 港澳通行证:3 \\  回乡证:4 \\ 户口簿:5 \\ 出生证明:6 \\ 台湾通行证:7 \\ 台胞证:8 \\ 军人证:9 \\ <color #ed1c24>港澳台居民居住证 : 10</color> \\ 外国人永久居留身份证:11 \\ <color #ed1c24>其他有效证件 : 12</color> \\ <color #ed1c24>电子护照:13</color> \\  <color #ed1c24>海员证:14</color>  
-|IDNumber|String |证件号码 |Y | | +| IDNumber                              | String  | 证件号码                          | Y                                                                                                                                                                                                                                                                                                                                                                                                  | 
-|Gender|Int|性别 |Y | 1:男 \\ 0:女| +| <color #ed1c24>IDNationality</color>  | String  | <color #ed1c24>证件签发国</color>  | N    | 不传则默认为国籍代码  <color #ed1c24>2023/02</color>                                                                                                                                                                                                                                                                                                                                                    | 
-|Birthday|String |出生日期 |Y | | +| <color #ed1c24>IDExpiration</color>   | String  | 证件有效期                         | N    | 证件有效期 \\ 非身份证、非港澳台居民居住证 必传                                                                                                                                                                                                                                                                                                                                                                    
-|PhoneNumber|String |手机号 |Y |航司规定,多成人不可重复,目前MU,HU,SQ,MI限制必输 |+| Gender                                | Int     | 性别                            N    | 1:男 0:女 \\ 非身份证、非港澳台居民居住证 必传                                                                                                                                                                                                                                                                                                                                                                  
 +| Birthday                              | String  | 出生日期                          N    儿童、婴儿必传,非身份证、非港澳台居民居住证 必传                                                                                                                                                                                                                                                                                                                                                                     
 +| PhoneNumber                           | String  | 手机号                           | Y/N  | 航司规定,多成人不可重复,目前MU,HU,SQ,MI限制必输                                                                                                                                                                                                                                                                                                                                                                | 
 +| <color #ed1c24>Email</color>          | String  | 邮箱                            | Y/N  | 根据航司规定,部分航司必须录入 <color #ed1c24>2022/05</color>                                                                                                                                                                                                                                                                                                                                                | 
 +| <color #ed1c24>EName</color>          | String  | 英文名称                          | Y/N  | 当证件类型为非“身份证”、非“港澳居民居住证”时,必传 2023/05/05                                                                                                                                                                                                                                                                                                                                                        | 
 +| <color #ed1c24>PassengerCardList</color>                     | Array   | 常旅客卡                          | N    | 2023-11-08                                                                                                                                                                                                                                                                                                                                                                             | 
 + 
 + 
 +insuranceList: 
 + 
 +^参数         ^类型   ^说明          ^必填         ^备注^ 
 +|fid  |String |保险航段标识ID  |Y  | IInsuranceProductsQuery接口:fid 
 +|insuranceids    |Array |选择的保险产品id集合   |Y  | IInsuranceProductsQuery接口:insuranceList集合的id| 
 + 
 +PassengerCardList: 
 + 
 +^ 参数        ^ 类型      ^ 说明    ^ 必填  ^ 备注                    ^ 
 +| Carrier   | String  | 承运航司  | Y   | 长度不能超过2,当有常旅客卡信息时,必填 
 +| Issuance  | String  | 发卡航司  | Y   | 长度不能超过2,当有常旅客卡信息时,必填 
 +| CardNo    | String  | 卡号    | Y   | 当有常旅客卡信息时,必填          |
  
 contact: contact:
行 81: 行 104:
 ==== 4.5.3返回参数 ==== ==== 4.5.3返回参数 ====
  
-^参数 ^类型 ^说明 ^备注^ +^ 参数           ^ 类型      ^ 说明        ^ 备注                   
-|code |String |是否调用接口成功 |20000表示成功,非20000表异常 | +| code         | String  | 是否调用接口成功  | 20000表示成功,非20000表异常  
-|detail |Object |结果集   +| detail       | Object  | 结果集       存在多个下单结果返回           
-|description |String |描述 |当异常时记录异常信息 |+| description  | String  | 描述        | 当异常时记录异常信息           |
  
 detail: detail:
行 95: 行 118:
 |Desc|String |说明 |  |  |Desc|String |说明 |  | 
 |OrderStatus|Int|订单状态 |状态仅供参考,不作为订单实际状态的依据  |OrderStatus|Int|订单状态 |状态仅供参考,不作为订单实际状态的依据 
 +|IOOrderInfoList|Array    |保险下单信息 |  |
 +
 +IOOrderInfoList:
 +^ 参数             ^ 类型       ^ 说明      ^ 备注             ^
 +| OrderId        | String   | 保险单号    |  若返回空,则该单下单不成功 |
 +| ProductNameID  | String   | 保险名称ID  |                |
 +| ProductName    | String   | 保险名称    |                |
 +| EffectDateStr  | String   | 生效时间    |                |
 +| ExpiryDateStr  | String   | 失效时间    |                |
 +| SaleTotal      | Decimal  | 金额      |                |
 +| Description    | String   | 说明      |                |
  
 ==== 4.5.4返回样例 ==== ==== 4.5.4返回样例 ====
4.5_国内采购生单v2_idomesticticketbookingv2.1612763129.txt.gz · 最后更改: 2021/02/08 05:45 由 louis