两侧同时换到之前的修订记录
前一修订版
后一修订版
|
前一修订版
|
4.5_国内采购生单v2_idomesticticketbookingv2 [2021/02/08 01:34] tiny [4.5.1请求参数] |
4.5_国内采购生单v2_idomesticticketbookingv2 [2023/11/22 11:17] (当前版本) tiny |
4.5国内经停(/IDomesticTicketStopoverQuery) | 4.5 国内采购生单(/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: |
==== 4.5.3返回参数 ==== | ==== 4.5.3返回参数 ==== |
| |
^参数 ^类型 ^说明 ^备注^ | ^ 参数 ^ 类型 ^ 说明 ^ 备注 ^ |
|code |String |是否调用接口成功 |20000表示成功,非20000表异常 | | | code | String | 是否调用接口成功 | 20000表示成功,非20000表异常 | |
|detail |Object |结果集 | | | | detail | Object | 结果集 | 存在多个下单结果返回 | |
|description |String |描述 |当异常时记录异常信息 | | | description | String | 描述 | 当异常时记录异常信息 | |
| |
detail: | detail: |
|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返回样例 ==== |