美亚航旅机票B2B接口

用户工具

站点工具

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

这是本文档旧的修订版！

目录

3.6 采购生单(ITOOrderSave)

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 参数已弃用 2021.11.23
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新增非必填，仅当调用辅营产品接口获取到辅营产品并选择了辅营产品时必须将选择的情况传入

NDCChoseInfo:

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

passengerList:

参数 类型 说明 必填 备注
nameString 乘客姓名 Y
passengerTypeInt 乘客类型 Y 0：成人
1：儿童
2：婴儿
3：老人
4：学生
5：劳务
6：移民
7：海员
8：青年
nationalityString 国籍或地区代码 Y 二字代码 中国香港:HK
IDTypeInt 证件类型Y 0：护照
1：其他有效证件（注：含军人证、回乡证、台胞证、户口簿、出生证明、学生证、外国人永久居留证、民航局规定的其他有效乘机身份证件 长度不超过15位）
IDNumberString 证件号码 Y
IDExpirationString 证件有效期 Y
genderInt性别 Y 1：男
0：女
birthdayString 出生日期 Y
PhoneNumberString 手机号 Y 根据航司规定,部分航司必须录入
Email String 邮箱 Y/N 根据航司规定,部分航司必须录入 2022/05
IDNationality String 证件签发地代码 N 不传则默认为国籍代码 2023/02

insuranceList:

参数 类型 说明 必填 备注
fid String 保险航段标识ID Y IInsuranceProductsQuery接口：fid
insuranceids Array 选择的保险产品id集合 Y IInsuranceProductsQuery接口：insuranceList集合的id

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”则发生航变发送邮件至上面参数邮箱 11.23；注：航变信息只通知订票人，收到航变通知请及时通知乘机人，以免造成损失及投诉
isSMS_VoyageChange Int 航变短信通知 N 默认为“0”；若“1”则发生航变发送短信至上面参数联系人手机 11.23；注：航变信息只通知订票人，收到航变通知请及时通知乘机人，以免造成损失及投诉

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:

参数 类型 说明 备注
TOOrderIDString 单号 若返回空，则该单下单不成功
PNRString PNR
DescString 说明
OrderStatusInt订单状态 状态仅供参考，不作为订单实际状态的依据
IOOrderInfoListArray 保险下单信息
OOOrderInfoArray其他订单列表（辅营产品订单） 2021-08-13新增

IOOrderInfoList：

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

OOOrderInfo:

参数 类型 说明 备注
OrderIdString OO单号

3.6.4返回样例

{
  "code": "20000",
  "detail": {
	"TOOrderID": "TO17113024895",
	"PNR": "XXXXXX",
	"status": 1
}
}
3.6_采购生单_国际机票_itoordersave.1681296032.txt.gz · 最后更改: 2023/04/12 10:40 由 huldrin_peng

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： 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