美亚航旅机票B2B接口

用户工具

站点工具

3.6_采购生单_国际机票_itoordersave_inside

差别

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

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版 		前一修订版
3.6_采购生单_国际机票_itoordersave_inside [2021/04/06 09:21]
tiny 		3.6_采购生单_国际机票_itoordersave_inside [2023/03/13 03:03] (当前版本)
tiny
行 1: 行 1:
-3.6  7采购生单(ITOOrderSave)+3.6  采购生单(ITOOrderSave)
  
  
 ==== 3.6.1请求参数 ==== ==== 3.6.1请求参数 ====
  
 +
 +^ 参数                                                   ^ 类型      ^ 说明             ^ 必填   ^ 备注                                                                                             ^
 +| policySerialNumber                                   | String  | 计价key          | Y    |                                                                                                |
 +| createOrderType                                      | Int     | 下单方式           | Y    | 1：实时航班下单 \\ 2：PNR下单 \\ 3：航段下单                                                                  |
 +| PNR                                                  | String  | PNR            | N    | 下单方式为2、3该字段必填 且需先授权给出票 OFFICE号                                                                 |
 +| isConvert                                            | int     | 是否转编码          | N    | 当下单方式为2、3  \\  是否自动转编码：1-转 0-不转  \\ （计价结果isConvert为1） \\ （若不转生单为申请单，人工跟进）                      |
 +| passengerList                                        | Array   |           乘客列表 | Y/N  | 当下单方式为1、3必填                                                                                    |
 +| QDOrderID                                            | String  |  第三方订单号        | N    |                                                                                                |
 +| APIAntiOffice                                        | String  |  API反授权office  | N    |                                                                                                |
 +| FlightChangeNoticeMobileNumber                       | String  |  航变通知手机号       | N    | 需生成PNR且成功时生效(<color #ed1c24>参数已弃用</color>)                                                     |
 +| contact                                              | Object  |  联系信息          | Y/N  | 订单联系信息，若不传则按默认联系方式                                                                             |
 +| <color #ed1c24>insuranceProductSerialNumber</color>  | String  | 保险key          | N    | 购保时必传 IInsuranceProductsQuery接口的serialNumber                                                   |
 +| <color #ed1c24>insuranceList</color>                 | Array   | 购买的保险集合        | N    | IInsuranceProductsQuery按航段选择保险产品  \\  查询保险产品时需按下单乘客类型传递 一旦选择则默认全部的乘客都购买  若下单和保险查询的乘客类型不一致则会提示  |
 +| <color #ed1c24>ndcSerialNumber</color>               | String  | 辅营产品key        | N    | <color #ed1c24>2021-06-03新增</color>非必填，仅当调用辅营产品接口获取到辅营产品并选择了辅营产品时必须填写                          |
 +| <color #ed1c24>NDCChoseInfo</color>                  |   Array | 辅营产品选择信息       | N    | <color #ed1c24>2021-06-03新增</color>非必填，仅当调用辅营产品接口获取到辅营产品并选择了辅营产品时必须将选择的情况传入                    |
 +
 +
 +NDCChoseInfo:
  
 ^参数         ^类型   ^说明        ^必填        ^备注^ ^参数         ^类型   ^说明        ^必填        ^备注^
-|policySerialNumber|String |计价key  |Y | | +|psgNumber|String |乘客序号 |N |<color #ed1c24>2021-06-03新增</color>，对应乘客在passengerList中的序号，序号需从0开始计算，当选择AGG产品或者选择TF产品的perpassenger为归属个人的产品时必填，选择TF的perpassenger为归属订单的产品时不可填写 | 
-|createOrderType|Int |下单方式         |Y         |1：实时抗班下单 \\ 2：PNR下单 \\ 3：航段下单 | +|paxid|String |aggsky辅营产品旅客ID |N |<color #ed1c24>2021-06-03新增</color>非必填，仅当调用辅营产品获取到辅营产品 并为此乘客选择了AGG辅营产品时必须填写，值必须是辅营产品接口返回的pax_ids中的值  | 
-|PNR|String |PNR  |N | 下单方式为2、3该字段必填 且需先授权给出票 OFFICE号|   +|ndcInfoId|Array |为此旅客选择的辅营产品 |N |<color #ed1c24>2021-06-03新增</color>非必填，仅当调用辅营产品获取到辅营产品 并为此乘客选择了辅营产品时必须填写，值必须是辅营产品接口返回的id  | 
-|isConvert|int|是否转编码  |N | 当下单方式为2、3  \\  是否自动转编码：1-转 0-不转  \\ （计价结果isConvert为1） \\ （若不转生单为申请单，人工跟进）|   +
-|passengerList|Array|  乘客列表 |Y/N | 当下单方式为1、3必填| +
-|QDOrderID|String|  第三方订单号 |N |  | +
-|APIAntiOffice|String|  API反授权office |N |  | +
-|FlightChangeNoticeMobileNumber|String|  航变通知手机号 |N |需生成PNR且成功时生效  | +
-|contact|Object|  联系信息 |Y/N |订单联系信息，若不传则按默认联系方式 | +
  
 passengerList: passengerList:
  
-^参数         ^类型   ^说明        ^必填        ^备注^ +^参数         ^类型   ^说明          ^必填         ^备注^ 
-|name|String |乘客姓名  |Y | | +|name|String    |乘客姓名   |Y  | | 
-|passengerType|Int |乘客类型  |Y | 0：成人 \\ 1：儿童 \\ 2：婴儿 \\ 3：老人 \\ 4：学生 \\ 5：劳务 \\ 6：移民 \\ 7：海员 \\ 8：青年| +|passengerType|Int |乘客类型    |Y  | 0：成人 \\ 1：儿童 \\ 2：婴儿 \\ 3：老人 \\ 4：学生 \\ 5：劳务 \\ 6：移民 \\ 7：海员 \\ 8：青年| 
-|nationality|String |国籍代码 |Y | | +|nationality|String |国籍或地区代码   |Y  |二字代码 中国香港:HK |  
-|IDType|Int |证件类型|Y | 0：护照 \\ 1：其他有效证件| +|IDType|Int |证件类型|Y | 0：护照 \\ 1：其他有效证件| 
-|IDNumber|String |证件号码 |Y | | +|IDNumber|String    |证件号码   |Y  | | 
-|IDExpiration|String |证件有效期 |Y | | +|IDExpiration|String    |证件有效期  |Y  | | 
-|gender|Int|性别 |Y | 1：男 \\ 0：女| +|gender|Int|性别  |Y  | 1：男 \\ 0：女| 
-|birthday|String |出生日期 |Y | | +|birthday|String    |出生日期   |Y  | | 
-|PhoneNumber|String |手机号 |Y |根据航司规定,部分航司必须录入 |+|PhoneNumber|String |手机号    |Y  |根据航司规定,部分航司必须录入  \\ 购买保险产品时必填 | 
 +|<color #ed1c24>Email</color>  | String  | 邮箱     | Y/N  | 根据航司规定,部分航司必须录入 <color #ed1c24>2022/05</color>                                   | 
 +|<color #ed1c24>IDNationality</color>  | String  | 证件签发地代码  | N  |不传则默认为国籍代码  <color #ed1c24>2023/02</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”则出票成功发送短信至上面参数联系人手机 | 
 +|<color #ed1c24>isEmail_VoyageChange</color>|Int|航变邮件通知 |N  | 默认为“0”；若“1”则发生航变发送邮件至上面参数邮箱| 
 +|<color #ed1c24>isSMS_VoyageChange</color>|Int|航变短信通知   |N  |默认为“0”；若“1”则发生航变发送短信至上面参数联系人手机 |
 ==== 3.6.2请求样例 ==== ==== 3.6.2请求样例 ====
  
行 48: 行 72:
 <code> <code>
 { {
- "createOrderType": "1", +    "createOrderType": "1", 
- "policySerialNumber": "145d34d096fa49f361f39cc2824e7ca4", +    "policySerialNumber": "145d34d096fa49f361f39cc2824e7ca4", 
- "isConvert": "0", +    "isConvert": "0", 
- "QDOrderID": "1", +    "QDOrderID": "1", 
- "APIAntiOffice": "CAN826", +    "APIAntiOffice": "CAN826", 
- "passengerList": [ +    "insuranceProductSerialNumber": "145d34d096fa49f36999999999999", 
- { +    "insuranceList":[ 
- "name": "TEST/A", +        { 
- "passengerType": "0", +            "fid": "API0", 
- "nationality": "CN", +            "insuranceids": ["13458"], 
- "IDType": "0", +        }, 
- "IDNumber": "123456", +        { 
- "IDExpiration": "2020-01-01", +            "fid": "API1", 
- "gender": "1", +            "insuranceids": ["13458","13459"], 
- "birthday": "1980-08-08", +        } 
- "PNR": "XXXXXX", +    ], 
- "PhoneNumber": "12345678900" +    "passengerList": [ 
- } +        { 
- ]+            "name": "TEST/A", 
 +            "passengerType": "0", 
 +            "nationality": "CN", 
 +            "IDType": "0", 
 +            "IDNumber": "123456", 
 +            "IDExpiration": "2020-01-01", 
 +            "gender": "1", 
 +            "birthday": "1980-08-08", 
 +            "PNR": "XXXXXX", 
 +            "PhoneNumber": "12345678900" 
 +        } 
 +    ]
 } }
  
行 73: 行 108:
 ====PNR下单==== ====PNR下单====
 {  { 
- "PNR":"JXHX8X", +    "PNR":"JXHX8X", 
- "createOrderType": "2", +    "createOrderType": "2", 
- "policySerialNumber": "8b658fef590b6c535629596bc5ae9d5d", +    "policySerialNumber": "8b658fef590b6c535629596bc5ae9d5d", 
- "isConvert": "0", +    "isConvert": "0", 
- "QDOrderID": "1", +    "QDOrderID": "1", 
- "FlightChangeNoticeMobileNumber": "13512345678"+    "FlightChangeNoticeMobileNumber": "13512345678"
 } }
 </code> </code>
  
-==== 4.5.3返回参数 ====+==== 3.6.3返回参数 ====
  
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|code |String |是否调用接口成功 |20000表示成功，非20000表异常 | +|code   |String |是否调用接口成功   |20000表示成功，非20000表异常 | 
-|detail |Object |结果集  |  | +|detail |Object |结果集     |  | 
-|description |String |描述 |当异常时记录异常信息 |+|description |String    |描述 |当异常时记录异常信息 |
  
 detail: detail:
  
-^参数    ^类型 ^说明    ^备注^  +^参数    ^类型  ^说明    ^备注^  
-|TOOrderID|String |单号 |  若返回空，则该单下单不成功|  +|TOOrderID|String   |单号 |  若返回空，则该单下单不成功|  
-|PNR|String |PNR |  | +|PNR|String |PNR |  | 
-|Desc|String |说明 |  | +|Desc|String    |说明 |  | 
 |OrderStatus|Int|订单状态 |状态仅供参考，不作为订单实际状态的依据  |  |OrderStatus|Int|订单状态 |状态仅供参考，不作为订单实际状态的依据  | 
 +|<color #ed1c24>IOOrderInfoList</color>|Array    |保险下单信息 |  | 
 +
 +IOOrderInfoList：
 +^ 参数             ^ 类型       ^ 说明      ^ 备注             ^
 +| OrderId        | String   | 保险单号    |  若返回空，则该单下单不成功 |
 +| ProductNameID  | String   | 保险名称ID  |                |
 +| ProductName    | String   | 保险名称    |                |
 +| EffectDateStr  | String   | 生效时间    |                |
 +| ExpiryDateStr  | String   | 失效时间    |                |
 +| SaleTotal      | Decimal  | 金额      |                |
 +| Description    | String   | 说明      |                |
 +
 +
  
 ==== 3.6.4返回样例 ==== ==== 3.6.4返回样例 ====
行 103: 行 151:
   "code": "20000",   "code": "20000",
   "detail": {   "detail": {
- "TOOrderID": "TO17113024895", +    "TOOrderID": "TO17113024895", 
- "PNR": "XXXXXX", +    "PNR": "XXXXXX", 
- "status": 1+    "status": 1, 
 +    "IOOrderInfoList":[]
   }   }
 } }
 </code> </code>
3.6_采购生单_国际机票_itoordersave_inside.1617700865.txt.gz · 最后更改: 2021/04/06 09:21 由 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