美亚航旅机票B2B接口

用户工具

站点工具

4.5_国内采购生单v2_idomesticticketbookingv2_inside

差别

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

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版 		前一修订版
4.5_国内采购生单v2_idomesticticketbookingv2_inside [2021/04/06 09:20]
tiny 		4.5_国内采购生单v2_idomesticticketbookingv2_inside [2024/04/01 10:55] (当前版本)
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 |需生成PNR且成功时生效  | +| ETTJAuthOffice                  | String  | 票号授权office     | N    | 票号需要授权的OFFICE号，仅限传一个OFFICE                                                                           | 
-|contact|Object|  联系信息 |Y/N |订单联系信息，若不传则按默认联系方式 | +| FlightChangeNoticeMobileNumber  | String  |  航变通知手机号       | N    | 需生成PNR且成功时生效(<color #ed1c24>参数已弃用</color>)                                                           | 
-|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按航段选择保险产品  \\  查询保险产品时需按下单乘客类型传递 一旦选择则默认全部的乘客都购买  若下单和保险查询的乘客类型不一致则会提示        | 
 +| <color #ed1c24>qCom</color>     | Array   | 指令信息           | N    | 订单需拆单时按拆单价格顺序传入 <color #22b14c>20220510</color>                                                      | 
 +| <color #ed1c24>rules</color>    | Array   | 退改条款           | N    |  传递该参数时将替换原退改条款  <color #ed1c24>未上线</color>\\ 请求参数同返回:4.8 国内实时航班退改条款(/IDomesticShoppingRuleQueryV2)  |
  
 passengerList: passengerList:
行 21: 行 26:
 |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 | |
 +|<color #ed1c24>IDNationality</color>|String |<color #ed1c24>证件签发国</color> |  |
 |Gender|Int|性别 |Y | 1：男 \\ 0：女| |Gender|Int|性别 |Y | 1：男 \\ 0：女|
 |Birthday|String |出生日期 |Y | | |Birthday|String |出生日期 |Y | |
-|PhoneNumber|String |手机号 |Y |航司规定，多成人不可重复，目前MU,HU,SQ,MI限制必输 |+|PhoneNumber|String |手机号 |Y |航司规定，多成人不可重复，目前MU,HU,SQ,MI限制必输   \\ 购买保险产品时必填 | 
 +| <color #ed1c24>Email</color>  | String  | 邮箱     | Y/N  | 根据航司规定,部分航司必须录入 <color #ed1c24>2022/05</color>                                     | 
 + 
 +insuranceList: 
 + 
 +^参数         ^类型   ^说明          ^必填         ^备注^ 
 +|fid  |String |保险航段标识ID  |Y  | IInsuranceProductsQuery接口：fid  | 
 +|insuranceids    |Array |选择的保险产品id集合   |Y  | IInsuranceProductsQuery接口：insuranceList集合的id|
  
 contact: contact:
  
-^参数         ^类型   ^说明        ^必填        ^备注^ +^ 参数                              ^ 类型      ^ 说明       ^ 必填  ^ 备注                                               ^ 
-|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 | 若订单生编，则作为编码OSI CTCM项| +| flightChangeNoticeMobileNumber  | String  | 航变通知手机号  | N   | 若订单生编，则作为编码OSI CTCM项(<color #ed1c24>弃用</color>)  | 
-|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”则出票成功发送短信至上面参数联系人手机                   | 
 +| isEmail_VoyageChange            | Int     | 航变邮件通知   | N   | 默认为“0”；若“1”则发生航变发送邮件至上面参数邮箱                      | 
 +| isSMS_VoyageChange              | Int     | 航变短信通知   | N   | 默认为“0”；若“1”则发生航变发送短信至上面参数联系人手机                   | 
 + 
 +qCom: 
 + 
 +^ 参数        ^ 类型      ^ 说明               ^ 必填  ^ 备注                             ^ 
 +| index     | Int     | 订单顺序标识           | N   | 0/1 拆单时不填默认第一张或按顺序获取           | 
 +| pat       | String  | PAT指令            | N   | 若有accountCode，需带accountCode指令  | 
 +| integral  | String  | 积量指令             | N   | RMK 或 SSR 或 OSI 指令             | 
 +| other     | String  | 其它指令             | N   | 多个逗号隔开；EI、TC指令                 | 
 +| code      | String  | 大客户account_code  | N   | 下单核价时需要  accountCode           | 
 +| office    | String  | 出票OFFICE         | N   | 下单核价时需要                        | 
 +| carrier   | String  | 出票航司             | N   | 下单核价时需要                        | 
 +| fareTag   | String  | 大客户价格标签          | N   | 1:协议 2:特惠                      | 
 + 
 +rules: 
 + 
 +^参数    ^类型 ^说明    ^备注^ 
 +|index     | Int     | 订单顺序标识             |0/1 拆单时不填默认第一张或按顺序获取  | 
 +|changeConditions|String |签转条件|  | 
 +|ruleRemark|String |备注 |  | 
 +|baggageAllowance|String |行李额 |  |  
 +|ruleItem|Array|退改明细 |  |   
 + 
 +ruleItem: 
 + 
 +^参数    ^类型 ^说明    ^备注^ 
 +|changePrice|Decimal|同舱改签费|  | 
 +|refundPrice|Decimal|退票费用|  | 
 +|operatorHourText|String|适用条件|  | 
 +|depTime|String|起飞前时间  | 
 +|text|String|文本型条款|  | 
 ==== 4.5.2请求样例 ==== ==== 4.5.2请求样例 ====
  
行 46: 行 92:
   "isConvert": "0",   "isConvert": "0",
   "QDOrderID": "1",   "QDOrderID": "1",
-"APIAntiOffice": "CAN826", +  "APIAntiOffice": "CAN826", 
-"FlightChangeNoticeMobileNumber": "13512345678",+  "FlightChangeNoticeMobileNumber": "13512345678", 
 +  "insuranceProductSerialNumber": "145d34d096fa49f36999999999999", 
 +  "insuranceList":[ 
 +     { 
 +         "fid": "API0", 
 +         "insuranceids": ["13458"], 
 +     } 
 +   ],
   "passengerList": [   "passengerList": [
     {     {
行 60: 行 113:
       "PNR": "XXXXXX",       "PNR": "XXXXXX",
       "PhoneNumber": "13745678900"       "PhoneNumber": "13745678900"
-    }+     }
   ],   ],
-"contact":+  "contact":
         {         {
           "linker":"联系人A",           "linker":"联系人A",
行 88: 行 141:
 detail: detail:
  
-^参数    ^类型 ^说明    ^备注^ +^ 参数               ^ 类型      ^ 说明       ^ 备注                   ^ 
-|DepCityName|String |出发机场 |  | +| DepCityName      | String  | 出发机场     |                      | 
-|DesCityName|String |到达机场 |  | +| DesCityName      | String  | 到达机场     |                      | 
-|DepAir|String |出发机场三字码 |  | +| DepAir           | String  | 出发机场三字码  |                      | 
-|DesAir|String |到达机场三字码 |  | +| DesAir           | String  | 到达机场三字码  |                      | 
-|TOOrderID|String |单号 |  若返回空，则该单下单不成功|  +| TOOrderID        | String  | 单号       |        若返回空，则该单下单不成功 | 
-|PNR|String |PNR |  | +| PNR              | String  | PNR      |                      | 
-|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返回样例 ====
行 110: 行 175:
     "DepCityName": "广州白云国际机场",     "DepCityName": "广州白云国际机场",
     "DesCityName": "井冈山机场",     "DesCityName": "井冈山机场",
-    "TOOrderID": "TO18071834650"+    "TOOrderID": "TO18071834650", 
 +    "IOOrderInfoList":[]
   }]   }]
 } }
 </code> </code>
4.5_国内采购生单v2_idomesticticketbookingv2_inside.1617700837.txt.gz · 最后更改: 2021/04/06 09:20 由 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