美亚航旅机票B2B接口

7.2.1请求参数

参数	类型	说明	必填	备注
TVOrderID	String	作废订单号	Y/N	TVOrderID、QDOrderID 2个参数必传1个传了TVOrderID时则只根据TVOrderID查询
QDOrderID	String	第三方订单号	N	20231018新增

7.2.2请求样例

{
"TVOrderID":"TV16011800608"
}

7.2.3返回参数

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

detail:

参数	类型	说明	备注
TVOrderInfo	Object	作废单信息
TVFlightList	Array	作废单航段组
TVPassengerList	Array	作废单乘客组
TVFinanceList	Array	作废单财务信息组
contact	Object	联系信息
IROrderList	Array	退保单信息
AttachmentList	Array	附件信息	2024-08新增

TVOrderInfo:

参数	类型	说明	备注
TOOrderID	String	原机票订单单号(TO单单号)
TVOrderID	String	作废单编号
orderStatus	Int	作废单状态	0: 已取消 1: 待提交 2: 待审核 3: 待审核 4: 待废票 5: 已废票 6: 审核退回
createDate	DateTime	作废单下单时间

TVFlightList:

参数	类型	说明	备注
departTime	String	出发时间
destTime	String	到达时间
airline	String	航司码
flightNo	String	航班号
classNo	String	舱位
depAir	String	出发机场编号
depAirCN	String	出发机场名
desAir	String	到达机场编号
desAirCN	String	到达机场名
class	String	舱等	F:头等舱 C:商务舱 Y:经济舱 W:豪华经济舱

TVPassengerList:

参数	类型	说明	备注
name	String	乘客姓名
passengerType	Int	乘客类型	0：成人 1：儿童 2：婴儿 3：老人 4：学生 5：劳务 6：移民 7：海员 8：青年
nationality	String	国籍代码
IDType	Int	证件类型	Y	0：护照 1：其他有效证件（注：含军人证、回乡证、台胞证、户口簿、出生证明、学生证、外国人永久居留证、民航局规定的其他有效乘机身份证件长度不超过15位）身份证:2 港澳通行证:3 回乡证:4 户口簿:5 出生证明:6 台湾通行证:7 台胞证:8 军人证:9 港澳台居民居住证 : 10 外国人永久居留身份证:11 其他有效证件 : 12 电子护照:13 海员证:14 旧单按原含义展示
IDNumber	String	证件号码
IDExpiration	String	证件有效期
IDNationality	String	证件签发国二字码
gender	Int	性别	1：男 0：女
birthday	String	出生日期
PNR	String	PNR
ticketNo	String	票号

TVFinanceList:

参数	类型	说明	备注
passengerType	Int	乘客类型	0：成人 1：儿童 2：婴儿 3：老人 4：学生 5：劳务 6：移民 7：海员 8：青年
toPrice	Decimal	原单退款金额
voidedFee	Decimal	作废手续费
saleTotal	Decimal	合计

contact：

参数	类型	说明	必填	备注
linker	String	联系人	Y
phone	String	联系人手机	Y
email	String	邮箱	N
content	String	备注	N
isEmail	Boolean	废票邮件通知	N	默认为“false”；若“true”则废票成功发送邮件至上面参数邮箱
isSMS	Boolean	废票短信通知	N	默认为“false”；若“true”则废票成功发送短信至上面参数联系人手机

IROrderList：

参数	类型	说明	备注
IROrderID	String	退保单号
productName	String	保险产品名称
status	String	退保状态	参考IR退保单详情

AttachmentList：

参数	类型	说明	必填
id	string	附件id	N
name	string	附件名称	N
path	string	附件地址	N

7.1.4返回样例

{
    "code": "20000",
    "detail": {
        "TVOrderInfo": {
            "TOOrderId": "TO16011874806",
            "TVOrderId": "TV16011800608",
            "orderStatus": 4,
            "createDate": "2016-01-18 14:19"
        },
        "TVFlightList": [
            {
                "departTime": "2016-05-06 01:45",
                "destTime": "2016-05-07 05:00",
                "airline": "CX",
                "flightNo": "829",
                "classNo": "M",
                "depAir": "YYZ",
                "depAirCN": "帕尔森国际机场",
                "desAir": "HKG",
                "desAirCN": "赤腊角国际机场"
            },
            {
                "departTime": "2016-05-07 08:00",
                "destTime": "2016-05-07 08:55",
                "airline": "KA",
                "flightNo": "782",
                "classNo": "M",
                "depAir": "HKG",
                "depAirCN": "赤腊角国际机场",
                "desAir": "CAN",
                "desAirCN": "白云机场"
            }
        ],
        "TVPassengerList": [
            {
                "name": "ZHANG/JIAQI MR",
                "passengerType": 0,
                "nationality": "",
                "IDType": 1,
                "IDNumber": "",
                "IDExpiration": "1900-01-01",
                "gender": true,
                "birthday": "1900-01-01",
                "PNR": "JDFBL1",
                "ticketNo": "020-5895484516"
            },
            {
                "name": "MAHLIG/MANJA",
                "passengerType": 0,
                "nationality": "",
                "IDType": 0,
                "IDNumber": "",
                "IDExpiration": "1900-01-01",
                "gender": true,
                "birthday": "1900-01-01",
                "PNR": "HE7GBB",
                "ticketNo": "020-5895484517"
            },
            {
                "name": "MAHLIG/MANJA2",
                "passengerType": 0,
                "nationality": "",
                "IDType": 0,
                "IDNumber": "",
                "IDExpiration": "1900-01-01",
                "gender": true,
                "birthday": "1900-01-01",
                "PNR": "HE7GBB",
                "ticketNo": "020-5895484518"
            },
            {
                "name": "MAHLIG/MANJA3",
                "passengerType": 0,
                "nationality": "",
                "IDType": 0,
                "IDNumber": "",
                "IDExpiration": "1900-01-01",
                "gender": true,
                "birthday": "1900-01-01",
                "PNR": "HE7GBB",
                "ticketNo": "020-5895484519"
            },
            {
                "name": "MAHLIG/MANJA4",
                "passengerType": 0,
                "nationality": "",
                "IDType": 0,
                "IDNumber": "",
                "IDExpiration": "1900-01-01",
                "gender": true,
                "birthday": "1900-01-01",
                "PNR": "HE7GBB",
                "ticketNo": "020-5895484520"
            }
        ],
        "TVFinanceList": [
            {
                "passengerType": 0,
                "salePrice": 0,
                "tax": 0,
                "beforeReturn": 0,
                "beforeReturnPrice": 0,
                "afterReturn": 0,
                "afternReturnPrice": 0,
                "TOServiceFee": 0,
                "voidefFee": 0,
                "saleTotal": 0
            }
        ]
    }
}

美亚航旅机票B2B接口

用户工具

站点工具

目录

7.2.1请求参数

7.2.2请求样例

7.2.3返回参数

7.1.4返回样例

页面工具