美亚航旅机票B2B接口

用户工具

站点工具

4.5_国内采购生单v2_idomesticticketbookingv2

差别

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

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版 		前一修订版
4.5_国内采购生单v2_idomesticticketbookingv2 [2021/11/24 02:58]
tiny 		4.5_国内采购生单v2_idomesticticketbookingv2 [2023/11/22 11:17] (当前版本)
tiny
行 3: 行 3:
  
  
-^参数         ^类型   ^说明        ^必填        ^备注^ +^ 参数                              ^ 类型      ^ 说明             ^ 必填   ^ 备注                                                                                             ^ 
-|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 | <color #ed1c24>参数已弃用11.23</color>  | +|<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  | 订单联系信息，若不传则按默认联系方式                                                                             | 
-|<color #ed1c24>insuranceProductSerialNumber</color>|String  |保险key      |N  | 购保时必传 IInsuranceProductsQuery接口的serialNumber | +| fareId                          | String  |  价格id          | Y/N  | 使用IDPricingBySeg接口计价 必填                                                                        | 
-|<color #ed1c24>insuranceList</color>|Array |购买的保险集合 |N  |IInsuranceProductsQuery按航段选择保险产品  \\  查询保险产品时需按下单乘客类型传递 一旦选择则默认全部的乘客都购买  若下单和保险查询的乘客类型不一致则会提示 |+| 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 | 0：护照 \\  1：其他有效证件（注：含军人证、回乡证、台胞证、户口簿、出生证明、学生证、外国人永久居留证、民航局规定的其他有效乘机身份证件 长度不超过15位） \\ 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: insuranceList:
行 34: 行 42:
 |fid  |String |保险航段标识ID  |Y  | IInsuranceProductsQuery接口：fid  | |fid  |String |保险航段标识ID  |Y  | IInsuranceProductsQuery接口：fid  |
 |insuranceids    |Array |选择的保险产品id集合   |Y  | IInsuranceProductsQuery接口：insuranceList集合的id| |insuranceids    |Array |选择的保险产品id集合   |Y  | IInsuranceProductsQuery接口：insuranceList集合的id|
 +
 +PassengerCardList:
 +
 +^ 参数        ^ 类型      ^ 说明    ^ 必填  ^ 备注                    ^
 +| Carrier   | String  | 承运航司  | Y   | 长度不能超过2，当有常旅客卡信息时，必填  |
 +| Issuance  | String  | 发卡航司  | Y   | 长度不能超过2，当有常旅客卡信息时，必填  |
 +| CardNo    | String  | 卡号    | Y   | 当有常旅客卡信息时，必填          |
  
 contact: contact:
行 39: 行 54:
 ^参数         ^类型   ^说明        ^必填        ^备注^ ^参数         ^类型   ^说明        ^必填        ^备注^
 |linker|String |联系人 |Y | | |linker|String |联系人 |Y | |
-|phone|String |联系人手机 |Y |若订单生编，则作为编码OSI CTCT项、 航变手机号 |+|phone|String |联系人手机 |Y |若订单生编，则作为编码OSI CTCT项 |
 |email|String |邮箱 |N | | |email|String |邮箱 |N | |
-|flightChangeNoticeMobileNumber|String |航变通知手机号 |N | <color #ed1c24>参数已弃用11.23</color>|+|flightChangeNoticeMobileNumber|String |航变通知手机号 |N | 若订单生编，则作为编码OSI CTCM项|
 |content|String |备注 |N | | |content|String |备注 |N | |
 |isEmail|Int|出票邮件通知 |N | 默认为“0”；若“1”则出票成功发送邮件至上面参数邮箱| |isEmail|Int|出票邮件通知 |N | 默认为“0”；若“1”则出票成功发送邮件至上面参数邮箱|
 |isSMS|Int|出票短信通知 |N |默认为“0”；若“1”则出票成功发送短信至上面参数联系人手机 | |isSMS|Int|出票短信通知 |N |默认为“0”；若“1”则出票成功发送短信至上面参数联系人手机 |
-|<color #ed1c24>isEmail_VoyageChange</color>|Int|航变邮件通知 |N  | 默认为“0”；若“1”则发生航变发送邮件至上面参数邮箱| 
-|<color #ed1c24>isSMS_VoyageChange</color>|Int|航变短信通知   |N  |默认为“0”；若“1”则发生航变发送短信至上面参数联系人手机 | 
 ==== 4.5.2请求样例 ==== ==== 4.5.2请求样例 ====
  
行 105: 行 118:
 |Desc|String |说明 |  |  |Desc|String |说明 |  | 
 |OrderStatus|Int|订单状态 |状态仅供参考，不作为订单实际状态的依据  |  |OrderStatus|Int|订单状态 |状态仅供参考，不作为订单实际状态的依据  | 
-|<color #ed1c24>IOOrderInfoList</color>|Array    |保险下单信息 |  |+|IOOrderInfoList|Array    |保险下单信息 |  |
  
 IOOrderInfoList： IOOrderInfoList：
行 127: 行 140:
     "DepCityName": "广州白云国际机场",     "DepCityName": "广州白云国际机场",
     "DesCityName": "井冈山机场",     "DesCityName": "井冈山机场",
-    "TOOrderID": "TO18071834650", +    "TOOrderID": "TO18071834650"
-    "IOOrderInfoList":[]+
   }]   }]
 } }
 </code> </code>
4.5_国内采购生单v2_idomesticticketbookingv2.1637722730.txt.gz · 最后更改: 2021/11/24 02:58 由 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