| 两侧同时换到之前的修订记录
前一修订版
后一修订版
|
前一修订版
|
3.6_采购生单_国际机票_itoordersave [2023/03/13 03:03]
tiny |
3.6_采购生单_国际机票_itoordersave [2024/08/08 06:54] (当前版本)
tiny |
| |
| |
| ^ 参数 ^ 类型 ^ 说明 ^ 必填 ^ 备注 ^ | ^参数 ^类型 ^说明 ^必填 ^备注^ |
| | 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>参数已弃用 2021.11.23</color> | | |<color #ed1c24>ETTJAuthOffice</color>|String|票号授权office |N | 票号需要授权的office号，仅限传1个 11.22| |
| | contact | Object | 联系信息 | Y/N | 订单联系信息 | | |FlightChangeNoticeMobileNumber|String| 航变通知手机号 |N | <color #ed1c24>参数已弃用 </color> | |
| | insuranceProductSerialNumber | String | 保险key | N | 购保时必传 IInsuranceProductsQuery接口的serialNumber | | |contact|Object| 联系信息 |Y/N |订单联系信息 | |
| | insuranceList | Array | 购买的保险集合 | N | IInsuranceProductsQuery按航段选择保险产品 \\ 查询保险产品时需按下单乘客类型传递 一旦选择则默认全部的乘客都购买 若下单和保险查询的乘客类型不一致则会提示 | | |insuranceProductSerialNumber|String |保险key |N | 购保时必传 IInsuranceProductsQuery接口的serialNumber | |
| | ndcSerialNumber | String | 辅营产品key | N | <color #ed1c24>2021-08-13新增</color>非必填，仅当调用辅营产品接口获取到辅营产品并选择了辅营产品时必须填写 | | |insuranceList|Array |购买的保险集合 |N |IInsuranceProductsQuery按航段选择保险产品 \\ 查询保险产品时需按下单乘客类型传递 一旦选择则默认全部的乘客都购买 若下单和保险查询的乘客类型不一致则会提示 | |
| | NDCChoseInfo | Array | 辅营产品选择信息 | N | <color #ed1c24>2021-08-13新增</color>非必填，仅当调用辅营产品接口获取到辅营产品并选择了辅营产品时必须将选择的情况传入 | | |ndcSerialNumber|String |辅营产品key |N |<color #ed1c24>2021-08-13新增</color>非必填，仅当调用辅营产品接口获取到辅营产品并选择了辅营产品时必须填写 | |
| | |NDCChoseInfo| Array| 辅营产品选择信息 |N |<color #ed1c24>2021-08-13新增</color>非必填，仅当调用辅营产品接口获取到辅营产品并选择了辅营产品时必须将选择的情况传入 | |
| | |<color #ed1c24>attachmentList</color>|Array| 附件信息 |N |2024-08新增 9.5 附件上传(IFileUpload)的requestkey集合["aaa","bbb"] 特殊乘客类型(非成人、儿童、婴儿)及计价有乘客限制条件(国籍/地区、年龄限制)时必传 | |
| |
| NDCChoseInfo: | NDCChoseInfo: |
| |
| ^参数 ^类型 ^说明 ^必填 ^备注^ | ^参数 ^类型 ^说明 ^必填 ^备注^ |
| |psgNumber|String |乘客序号 |N |<color #ed1c24>2021-08-13新增</color>，对应乘客在passengerList中的序号，序号需从0开始计算，当选择AGG产品或者选择TF产品的perpassenger为归属个人的产品时必填，选择TF的perpassenger为归属订单的产品时不可填写 | | |psgNumber|String |乘客序号 |N |<color #ed1c24>2021-08-13新增</color>，对应乘客在passengerList中的序号，序号需从0开始计算，当选择AGG产品或者选择TF产品的perpassenger为归属个人的产品时必填，选择TF的perpassenger为归属订单的产品时不可填写 | |
| |paxid|String |aggsky辅营产品旅客ID |N |<color #ed1c24>2021-08-13新增</color>非必填，仅当调用辅营产品获取到辅营产品 并为此乘客选择了AGG辅营产品时必须填写，值必须是辅营产品接口返回的pax_ids中的值 | | |paxid|String |aggsky辅营产品旅客ID |N |<color #ed1c24>2021-08-13新增</color>非必填，仅当调用辅营产品获取到辅营产品 并为此乘客选择了AGG辅营产品时必须填写，值必须是辅营产品接口返回的pax_ids中的值 | |
| |ndcInfoId|Array |为此旅客选择的辅营产品 |N |<color #ed1c24>2021-08-13新增</color>非必填，仅当调用辅营产品获取到辅营产品 并为此乘客选择了辅营产品时必须填写，值必须是辅营产品接口返回的id | | |ndcInfoId|Array |为此旅客选择的辅营产品 |N |<color #ed1c24>2021-08-13新增</color>非必填，仅当调用辅营产品获取到辅营产品 并为此乘客选择了辅营产品时必须填写，值必须是辅营产品接口返回的id | |
| |
| |
| 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 |二字代码 中国香港:HK | | | nationality | String | 国籍或地区代码 | Y | 二字代码 中国香港:HK | |
| |IDType|Int |证件类型|Y | 0：护照 \\ 1：其他有效证件（注：含军人证、回乡证、台胞证、户口簿、出生证明、学生证、外国人永久居留证、民航局规定的其他有效乘机身份证件 长度不超过15位）| | | IDType | Int | 证件类型 | Y | 0：护照 \\ 1：其他有效证件（注：民航局规定的其他有效乘机身份证件 长度不超过15位）\\ 3：港澳通行证 \\ 4：回乡证 \\ 7：台湾通行证 \\ 8：台胞证 \\ 9：军人证 \\ 11：外国人永久居留身份证 \\ 14：海员证 \\ 15：外交部签发的驻华外交人员证 <color #ed1c24>2024-08</color> | |
| |IDNumber|String |证件号码 |Y | | | | IDNumber | String | 证件号码 | Y | | |
| |IDExpiration|String |证件有效期 |Y | | | | <color #ed1c24>IDNationality</color> | String | <color #ed1c24>证件签发国二字码</color> | Y | <color #ed1c24>如 中国:CN 不传则默认为国籍代码</color> | |
| |gender|Int|性别 |Y | 1：男 \\ 0：女| | | IDExpiration | String | 证件有效期 | Y | | |
| |birthday|String |出生日期 |Y | | | | gender | Int | 性别 | Y | 1：男 \\ 0：女 | |
| |PhoneNumber|String |手机号 |Y |根据航司规定,部分航司必须录入 | | | birthday | String | 出生日期 | Y | | |
| |<color #ed1c24>Email</color> | String | 邮箱 | Y/N | 根据航司规定,部分航司必须录入 <color #ed1c24>2022/05</color> | | | PhoneNumber | String | 手机号 | Y | 根据航司规定,部分航司必须录入 | |
| |<color #ed1c24>IDNationality</color> | String | 证件签发地代码 | N |不传则默认为国籍代码 <color #ed1c24>2023/02</color> | | | <color #ed1c24>Email</color> | String | 邮箱 | Y/N | 根据航司规定,部分航司必须录入 <color #ed1c24>2022/05</color> | |
| | | <color #ed1c24>PassengerCardList</color> | Array | 常旅客卡 | N | 2023-11-08 | |
| insuranceList: | insuranceList: |
| |
| |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: |
| |
| ^参数 ^类型 ^说明 ^必填 ^备注^ | ^ 参数 ^ 类型 ^ 说明 ^ 必填 ^ 备注 ^ |
| |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 | <color #ed1c24>参数已弃用 11.23</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”则发生航变发送邮件至上面参数邮箱 11.23| | | <color #ed1c24>isEmail_VoyageChange</color> | Int | 航变邮件通知 | N | 默认为“0”；若“1”则发生航变发送邮件至上面参数邮箱 如不填入，则不通知，请自行前往美亚官网查看 | |
| |<color #ed1c24>isSMS_VoyageChange</color>|Int|航变短信通知 |N |默认为“0”；若“1”则发生航变发送短信至上面参数联系人手机 11.23 | | | <color #ed1c24>isSMS_VoyageChange</color> | Int | 航变短信通知 | N | 默认为“0”；若“1”则发生航变发送短信至上面参数联系人手机 如不填入，则不通知，请自行前往美亚官网查看 | |
| | |
| | |
| ==== 3.6.2请求样例 ==== | ==== 3.6.2请求样例 ==== |
| |
| <code> | <code> |
| { | { |
| "createOrderType": "1", | "createOrderType": "1", |
| "policySerialNumber": "145d34d096fa49f361f39cc2824e7ca4", | "policySerialNumber": "145d34d096fa49f361f39cc2824e7ca4", |
| "isConvert": "0", | "isConvert": "0", |
| "QDOrderID": "1", | "QDOrderID": "1", |
| "APIAntiOffice": "CAN826", | "APIAntiOffice": "CAN826", |
| "passengerList": [ | "passengerList": [ |
| { | { |
| "name": "TEST/A", | "name": "TEST/A", |
| "passengerType": "0", | "passengerType": "0", |
| "nationality": "CN", | "nationality": "CN", |
| "IDType": "0", | "IDType": "0", |
| "IDNumber": "123456", | "IDNumber": "123456", |
| "IDExpiration": "2020-01-01", | "IDExpiration": "2020-01-01", |
| "gender": "1", | "gender": "1", |
| "birthday": "1980-08-08", | "birthday": "1980-08-08", |
| "PNR": "XXXXXX", | "PNR": "XXXXXX", |
| "PhoneNumber": "12345678900" | "PhoneNumber": "12345678900" |
| } | } |
| ] | ] |
| } | } |
| |
| ====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返回参数 ==== | ==== 4.5.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|订单状态 |状态仅供参考，不作为订单实际状态的依据 | |
| |IOOrderInfoList|Array |保险下单信息 | | | |IOOrderInfoList|Array |保险下单信息 | | |
| OOOrderInfo: | OOOrderInfo: |
| |
| ^参数 ^类型 ^说明 ^备注^ | ^参数 ^类型 ^说明 ^备注^ |
| |OrderId|String |OO单号 | | | |OrderId|String |OO单号 | | |
| |
| ==== 3.6.4返回样例 ==== | ==== 3.6.4返回样例 ==== |
| "code": "20000", | "code": "20000", |
| "detail": { | "detail": { |
| "TOOrderID": "TO17113024895", | "TOOrderID": "TO17113024895", |
| "PNR": "XXXXXX", | "PNR": "XXXXXX", |
| "status": 1 | "status": 1 |
| } | } |
| } | } |
| </code> | </code> |
