美亚航旅机票B2B接口

这是本文档旧的修订版！

7.2.1请求参数

参数	类型	说明	必填	备注
TVOrderID	String	作废订单号	Y

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	退保单信息
OROrderList	Array	辅营单信息

TVOrderInfo:

参数	类型	说明	备注
TOOrderID	String	原机票订单单号(TO/TC单单号)
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	到达机场名

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	作废手续费
serviceFee	Decimal	服务费
saleTotal	Decimal	合计

IROrderList：

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

OROrderList：

参数	类型	说明	备注
OROrderID	String	辅营退订单号
OOOrderID	String	辅营OO单号
status	String	状态	0:已取消 1,2,3,4:待处理 5:已处理
saleTotal	Decimal	金额
NDCProducts	Array	NDC产品详情

NDCProducts：

参数	类型	说明	必填	备注
psgId	int	关联乘客编号	N	购买NDC产品的乘客，如果是整单购买的，则不指定特定乘客
psgType	string	关联乘客类型	N	购买NDC产品的乘客类型，如果是整单购买的，则不指定特定乘客
psgName	string	关联乘客姓名	N	购买NDC产品的乘客姓名，如果是整单购买的，则不指定特定乘客
tripNumber	int	行程类型	Y	0：全程，1：去程 2：回程
name	string	NDC产品	N	1：去程 2：回程
text	string	NDC产品描述	N	描述
content	string	NDC产品说明	N	说明
salePrice	string	销售价	N
currency	string	销售价货币类型	N
weight	string	规格	N	tf类型辅营产品有值
quantity	string	行李额	N	tf类型辅营产品有值
proType	string	辅营产品类型	N	tf，agg
orgcity	string	出发城市	N
descity	string	到达城市	N

contact：

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

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返回样例

页面工具