美亚航旅机票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	退保单信息

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	证件类型	0护照 1其他有效证件 2身份证/港澳台居民居住证
IDNumber	String	证件号码
IDExpiration	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退保单详情

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

页面工具