美亚航旅机票B2B接口

这是本文档旧的修订版！

5.3.1请求参数

参数	类型	说明	必填	备注
TCOrderID	String	改签单订单号	Y/N	TCOrderID、QDOrderID 2个参数必传1个传了TCOrderID时则只根据TCOrderID查询
QDOrderID	String	第三方订单号	N	20231018新增
IsApplyOperate	Bool	是否申请操作	N	例如用TC单申请改签、退票、作废时传true,其他情况传false

5.3.2请求样例

{
"TCOrderID":"TC16011900422",
"IsApplyOperate":true
}

5.3.3返回参数

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

detail:

参数	类型	说明	备注
TCOrderInfo	Object	改签单信息
TCFlightList	Array	改签单航段组
TCPassengerList	Array	改签单乘客组
TCFinanceList	Array	改签单财务信息组
contact	Object	联系信息
AttachmentList	Array	附件信息	2024-08新增

TCOrderInfo:

参数	类型	说明	备注
TOOrderID	String	原机票订单单号(TO/TC单单号)
TCOrderID	String	改签单编号
orderStatus	Int	改签单状态	0：已取消 1：待确认 2、3、7：待审核 4：待支付 5：待改签 6：已改签 9：待确认价格 12：待定位
createDate	DateTime	改签单下单时间
PNR	String	原单PNR
TCPNR	String	TCPNR
groupTag	Bool	true代表该运价为小团价产品若退改废必须全部旅客一起申请	20230921新增

TCFlightList:

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

TCPassengerList:

参数	类型	说明	备注
passengerID	Int	改签单乘客编号
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	票号

TCFinanceList:

参数	类型	说明	备注
passengerType	Int	乘客类型	0：成人 1：儿童 2：婴儿 3：老人 4：学生 5：劳务 6：移民 7：海员 8：青年
tax	Decimal	税金	税+改签费
salePrice	Decimal	改签金额
serviceFee	Decimal	服务费
taxFee	Decimal	税
changeFee	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”则改签成功发送短信至上面参数联系人手机
isEmail_VoyageChange	Int	航变邮件通知	N	默认为”0”; 着”1则发生航变发送邮件至上面参数邮箱 11.23；航变信息只通知订票人，收到航变通知请及时通知乘机人，以免造成损失及投诉；
isSMS_VoyageChange	Int	航变短信通知	N	默认为“0”;着”1“则发生航变发送短信至上面参数联系人手机 11.23；航变信息只通知订票人，收到航变通知请及时通知乘机人，以免造成损失及投诉；

AttachmentList：

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

5.3.4返回样例

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

美亚航旅机票B2B接口

用户工具

站点工具

目录

5.3.1请求参数

5.3.2请求样例

5.3.3返回参数

5.3.4返回样例

页面工具