美亚航旅机票B2B接口

这是本文档旧的修订版！

6.3.1请求参数

参数	类型	说明	必填	备注
TROrderID	String	退票订单号	Y

6.3.2请求样例

{
"TROrderID":"TR16011800368"
}

6.3.3返回参数

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

detail:

参数	类型	说明
TROrderInfo	Object	退票单信息
TRFlightList	Array	退票单航段组
TRPassengerList	Array	退票单乘客组
TRFinanceList	Array	退票单财务信息组
contact	Object	联系信息
IROrderList	Array	退保单信息

TROrderInfo:

参数	类型	说明	备注
TOOrderID	String	原机票订单单号(TO/TC单单号)
TROrderID	String	退票单编号
orderStatus	Int	退票单状态	0：已取消 1：待确认 2、3、6待审核 4、待退票 5、已退票 7、待价格确认 8、待取消座位
createDate	DateTime	退票单下单时间
TROrderTimeliness	String	确认退票时效

TRFlightList:

参数	类型	说明
departTime	String	出发时间
destTime	String	到达时间
airline	String	航司码
flightNo	String	航班号
classNo	String	舱位
depAir	String	出发机场编号
depAirCN	String	出发机场名
desAir	String	到达机场编号
desAirCN	String	到达机场名

TRPassengerList:

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

TRFinanceList:

参数	类型	说明	备注
passengerType	Int	乘客类型	0：成人 1：儿童 2：婴儿 3：老人 4：学生 5：劳务 6：移民 7：海员 8：青年
toPrice	Decimal	原单退款金额
originOrderFee	Decimal	原单手续费
usePrice	Decimal	已使用航段费
returnFee	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”则退票成功发送短信至上面参数联系人手机

6.3.4返回样例

{
    "code": "20000",
    "detail": {
        "TROrderInfo": {
            "TOOrderId": "TO20101555840",
            "TROrderId": "TR20101573647",
            "orderStatus": 5,
            "createDate": "2020-10-15 16:26"
        },
        "TRFlightList": [
            {
                "departTime": "2020-12-11 08:30",
                "destTime": "2020-12-11 11:30",
                "airline": "CA",
                "flightNo": "1943",
                "classNo": "P",
                "depAir": "PVG",
                "depAirCN": "上海浦东国际机场",
                "desAir": "CKG",
                "desAirCN": "重庆江北国际机场"
            }
        ],
        "TRPassengerList": [
            {
                "name": "王振",
                "passengerType": 0,
                "nationality": "",
                "IDType": 2,
                "IDNumber": "341224198710288211",
                "IDExpiration": "1900-01-01",
                "gender": "1",
                "birthday": "1987-10-28",
                "PNR": "XXXXXX",
                "ticketNo": "168-2020101503"
            }
        ],
        "TRFinanceList": [
            {
                "passengerType": 0,
                "usePrice": 0,
                "returnFee": 0,
                "serviceFee": 2,
                "saleTotal": -448,
                "originOrderFee": 20,
                "toPrice": "-470"
            }
        ],
        "TRCustomServer": {
            "EnName": "COSMO_",
            "QQ": null,
            "Mobile": null,
            "WorkPhone": "020-22382204"
        }
    }
}

美亚航旅机票B2B接口

用户工具

站点工具

目录

6.3.1请求参数

6.3.2请求样例

6.3.3返回参数

6.3.4返回样例

页面工具