3.6_采购生单_国际机票

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
ETTJAuthOffice	String	票号授权office	N	票号需要授权的office号，仅限传1个 11.22
FlightChangeNoticeMobileNumber	String	航变通知手机号	N	参数已弃用
contact	Object	联系信息	Y/N	订单联系信息
insuranceProductSerialNumber	String	保险key	N	购保时必传 IInsuranceProductsQuery接口的serialNumber
insuranceList	Array	购买的保险集合	N	IInsuranceProductsQuery按航段选择保险产品查询保险产品时需按下单乘客类型传递一旦选择则默认全部的乘客都购买若下单和保险查询的乘客类型不一致则会提示
ndcSerialNumber	String	辅营产品key	N	2021-08-13新增非必填，仅当调用辅营产品接口获取到辅营产品并选择了辅营产品时必须填写
NDCChoseInfo	Array	辅营产品选择信息	N	2021-08-13新增非必填，仅当调用辅营产品接口获取到辅营产品并选择了辅营产品时必须将选择的情况传入
attachmentList	Array	附件信息	N	2024-08新增 9.5 附件上传(IFileUpload)的requestkey集合[“aaa”,“bbb”] 特殊乘客类型(非成人、儿童、婴儿)及计价有乘客限制条件(国籍/地区、年龄限制)时必传

NDCChoseInfo:

参数	类型	说明	必填	备注
psgNumber	String	乘客序号	N	2021-08-13新增，对应乘客在passengerList中的序号，序号需从0开始计算，当选择AGG产品或者选择TF产品的perpassenger为归属个人的产品时必填，选择TF的perpassenger为归属订单的产品时不可填写
paxid	String	aggsky辅营产品旅客ID	N	2021-08-13新增非必填，仅当调用辅营产品获取到辅营产品并为此乘客选择了AGG辅营产品时必须填写，值必须是辅营产品接口返回的pax_ids中的值
ndcInfoId	Array	为此旅客选择的辅营产品	N	2021-08-13新增非必填，仅当调用辅营产品获取到辅营产品并为此乘客选择了辅营产品时必须填写，值必须是辅营产品接口返回的id

passengerList:

参数	类型	说明	必填	备注
name	String	乘客姓名	Y
passengerType	Int	乘客类型	Y	0：成人 1：儿童 2：婴儿 3：老人 4：学生 5：劳务 6：移民 7：海员 8：青年
nationality	String	国籍或地区代码	Y	二字代码中国香港:HK
IDType	Int	证件类型	Y	0：护照 1：其他有效证件（注：民航局规定的其他有效乘机身份证件长度不超过15位） 3：港澳通行证 4：回乡证 7：台湾通行证 8：台胞证 9：军人证 11：外国人永久居留身份证 14：海员证 15：外交部签发的驻华外交人员证 2024-08
IDNumber	String	证件号码	Y
IDNationality	String	证件签发国二字码	Y	如中国:CN 不传则默认为国籍代码
IDExpiration	String	证件有效期	Y
gender	Int	性别	Y	1：男 0：女
birthday	String	出生日期	Y
PhoneNumber	String	手机号	Y	根据航司规定,部分航司必须录入
Email	String	邮箱	Y/N	根据航司规定,部分航司必须录入 2022/05
PassengerCardList	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:

参数	类型	说明	必填	备注
linker	String	联系人	Y
phone	String	联系人手机	Y	若订单生编，则作为编码OSI CTCT项、航变手机号
email	String	邮箱	N
flightChangeNoticeMobileNumber	String	航变通知手机号	N	参数已弃用 11.23
content	String	备注	N
isEmail	Int	出票邮件通知	N	默认为“0”；若“1”则出票成功发送邮件至上面参数邮箱
isSMS	Int	出票短信通知	N	默认为“0”；若“1”则出票成功发送短信至上面参数联系人手机
isEmail_VoyageChange	Int	航变邮件通知	N	默认为“0”；若“1”则发生航变发送邮件至上面参数邮箱如不填入，则不通知，请自行前往美亚官网查看
isSMS_VoyageChange	Int	航变短信通知	N	默认为“0”；若“1”则发生航变发送短信至上面参数联系人手机如不填入，则不通知，请自行前往美亚官网查看

3.6.2请求样例

实时航班下单

{
    "createOrderType": "1",
    "policySerialNumber": "145d34d096fa49f361f39cc2824e7ca4",
    "isConvert": "0",
    "QDOrderID": "1",
    "APIAntiOffice": "CAN826",
    "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"
        }
    ]
}



====PNR下单====
{ 
    "PNR":"JXHX8X",
    "createOrderType": "2",
    "policySerialNumber": "8b658fef590b6c535629596bc5ae9d5d",
    "isConvert": "0",
    "QDOrderID": "1",
    "FlightChangeNoticeMobileNumber": "13512345678"
}

4.5.3返回参数

参数	类型	说明	备注
code	String	是否调用接口成功	20000表示成功，非20000表异常
detail	Object	结果集
description	String	描述	当异常时记录异常信息

detail:

参数	类型	说明	备注
TOOrderID	String	单号	若返回空，则该单下单不成功
PNR	String	PNR
Desc	String	说明
OrderStatus	Int	订单状态	状态仅供参考，不作为订单实际状态的依据
IOOrderInfoList	Array	保险下单信息
OOOrderInfo	Array	其他订单列表（辅营产品订单）	2021-08-13新增

IOOrderInfoList：

参数	类型	说明	备注
OrderId	String	保险单号	若返回空，则该单下单不成功
ProductNameID	String	保险名称ID
ProductName	String	保险名称
EffectDateStr	String	生效时间
ExpiryDateStr	String	失效时间
SaleTotal	Decimal	金额
Description	String	说明

OOOrderInfo:

参数	类型	说明	备注
OrderId	String	OO单号

3.6.4返回样例

{
  "code": "20000",
  "detail": {
    "TOOrderID": "TO17113024895",
    "PNR": "XXXXXX",
    "status": 1
}
}

目录

3.6.1请求参数

3.6.2请求样例

实时航班下单

4.5.3返回参数

3.6.4返回样例