美亚航旅机票B2B接口

这是本文档旧的修订版！

4.5.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且成功时生效
contact	Object	联系信息	Y/N	订单联系信息，若不传则按默认联系方式
fareId	String	价格id	Y/N	使用IDPricingBySeg接口计价必填
insuranceProductSerialNumber	String	保险key	N	购保时必传 IInsuranceProductsQuery接口的serialNumber
insuranceList	Array	购买的保险集合	N	IInsuranceProductsQuery按航段选择保险产品查询保险产品时需按下单乘客类型传递一旦选择则默认全部的乘客都购买若下单和保险查询的乘客类型不一致则会提示

passengerList:

参数	类型	说明	必填	备注
Name	String	乘客姓名	Y
PsgType	Int	乘客类型	Y	0：成人 1：儿童 2：婴儿
Nationality	String	国籍代码	Y	非身份证、非港澳台居民居住证必传
IDType	Int	证件类型	Y	0：护照 1：其他有效证件（注：含军人证、回乡证、台胞证、户口簿、出生证明、学生证、外国人永久居留证、民航局规定的其他有效乘机身份证件长度不超过15位）身份证:2 港澳通行证:3 回乡证:4 户口簿:5 出生证明:6 台湾通行证:7 台胞证:8 军人证:9 港澳台居民居住证 : 10 外国人永久居留身份证:11 其他有效证件 : 12 电子护照:13 海员证:14
IDNumber	String	证件号码	Y
IDNationality	String	证件签发国	N	不传则默认为国籍代码 2023/02
IDExpiration	String	证件有效期	N	证件有效期非身份证、非港澳台居民居住证必传
Gender	Int	性别	N	1：男 0：女非身份证、非港澳台居民居住证必传
Birthday	String	出生日期	N	儿童、婴儿必传，非身份证、非港澳台居民居住证必传
PhoneNumber	String	手机号	Y/N	航司规定，多成人不可重复，目前MU,HU,SQ,MI限制必输
Email	String	邮箱	Y/N	根据航司规定,部分航司必须录入 2022/05
EnName	String	英文名	Y/N	旅客英文名：证件类型为非“身份证”、非“港澳居民居住证”时，必传 2023/07

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	若订单生编，则作为编码OSI CTCM项
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；航变信息只通知订票人，收到航变通知请及时通知乘机人，以免造成损失及投诉；

4.5.2请求样例

{
  "createOrderType": "1",
  "policySerialNumber": "fa88d07a-68f0-3a78-739c-9f8c1d072cea",
  "PNR":"KQJX8F",
  "isConvert": "0",
  "QDOrderID": "1",
"APIAntiOffice": "CAN826",
"FlightChangeNoticeMobileNumber": "13512345678",
  "passengerList": [
    {
      "Name": "TEST/A",
      "PsgType": "0",
      "Nationality": "CN",
      "IDType": "0",
      "IDNumber": "123456",
      "IDExpiration": "2020-01-01",
      "Gender": "1",
      "Birthday": "1980-08-08",
      "PNR": "XXXXXX",
      "PhoneNumber": "13745678900"
    }
  ],
"contact":
        {
          "linker":"联系人A",
          "phone":"13888888888",
          "email":"",
          "flightChangeNoticeMobileNumber":"13899999999",
          "content":"",
          "isEmail":"0",
          "isSMS":"0"

        }
    ,
    "fareId":"ADT0100-0-0",
}

4.5.3返回参数

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

detail:

参数	类型	说明	备注
DepCityName	String	出发机场
DesCityName	String	到达机场
TOOrderID	String	单号	若返回空，则该单下单不成功
PNR	String	PNR
Desc	String	说明
OrderStatus	Int	订单状态	状态仅供参考，不作为订单实际状态的依据
IOOrderInfoList	Array	保险下单信息

IOOrderInfoList：

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

4.5.4返回样例

{
  "code": "20000",
  "detail": [{
    "OrderStatus": 10,
    "PNR": "XXXXXX",
    "DepCityName": "广州白云国际机场",
    "DesCityName": "井冈山机场",
    "TOOrderID": "TO18071834650"
  }]
}

美亚航旅机票B2B接口

用户工具

站点工具

目录

4.5.1请求参数

4.5.2请求样例

4.5.3返回参数

4.5.4返回样例

页面工具