美亚航旅机票B2B接口

这是本文档旧的修订版！

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

passengerList:

参数	类型	说明	必填	备注
name	String	乘客姓名	Y
passengerType	Int	乘客类型	Y	0：成人 1：儿童 2：婴儿 3：老人 4：学生 5：劳务 6：移民 7：海员 8：青年
nationality	String	国籍代码	Y
IDType	Int	证件类型	Y	0：护照 1：其他有效证件
IDNumber	String	证件号码	Y
IDExpiration	String	证件有效期	Y
gender	Int	性别	Y	1：男 0：女
birthday	String	出生日期	Y
PhoneNumber	String	手机号	Y	根据航司规定,部分航司必须录入购买保险产品时必填

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”则出票成功发送短信至上面参数联系人手机

3.6.2请求样例

实时航班下单

{
    "createOrderType": "1",
    "policySerialNumber": "145d34d096fa49f361f39cc2824e7ca4",
    "isConvert": "0",
    "QDOrderID": "1",
    "APIAntiOffice": "CAN826",
    "insuranceProductSerialNumber": "145d34d096fa49f36999999999999",
    "insuranceList":[
        {
            "fid": "API0",
            "insuranceids": ["13458"],
        },
        {
            "fid": "API1",
            "insuranceids": ["13458","13459"],
        }
    ],
    "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"
}

3.6.3返回参数

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

detail:

参数	类型	说明	备注
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	说明

3.6.4返回样例

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

美亚航旅机票B2B接口

用户工具

站点工具

目录

3.6.1请求参数

3.6.2请求样例

实时航班下单

3.6.3返回参数

3.6.4返回样例

页面工具