美亚航旅机票B2B接口

这是本文档旧的修订版！

8.10.1请求参数

参数	类型	说明	必填	备注
OrderID	String	订单号	N
OrderNo	String	业务系统单号	N
OrderType	String	航班订单类别	Y	TO/TR/TC/TV
BeginDate	Int	订单创建时间	N	格式：yyyy-MM-dd
EndDate	Int	订单创建时间	N	格式：yyyy-MM-dd HH:mm:ss
IsService	Int	下单来源	N	0 中台 1 前台 2 APP 3 H5 4 美亚黑屏 5 API 6 未知 7 芯斗云（默认）
OutSupplierOrderNo	String	供应商订单号	N
PageIndex	String	页索引	Y
PageSize	String	分页大小	Y

8.10.2请求样例

申请单

{
    "OrderID": "TO21120265377",
    "OrderNo": "TO202112022663929",
    "OrderType": "TO",
    "BeginDate": "2021-01-02 18:09:42.620",
    "EndDate": "2022-10-02 18:09:42.620",
    "IsService": "16",
    "OutSupplierOrderNo": "D21336180940210358",
    "PageIndex":"1",
    "PageSize":"10"
}

改签单

{
    "OrderID": "TC21120359182",
    "OrderNo": "TC202112030141197",
    "OrderType": "TC",
    "BeginDate": "2021-01-02 18:09:42.620",
    "EndDate": "2022-10-02 18:09:42.620",
    "IsService": "16",
    "OutSupplierOrderNo": "D21336180940210358",
    "PageIndex":"1",
    "PageSize":"10"
}

作废单

{
    "OrderID": "TV22092425988",
    "OrderNo": "TV202209240083203",
    "OrderType": "TV",
    "BeginDate": "2022-01-24 10:11:08.683",
    "EndDate": "2022-10-02 18:09:42.620",
    "IsService": "16",
    "PageIndex":"1",
    "PageSize":"10"
}

退票单

{
    "OrderID": "TR21030574175",
    "OrderNo": "TR202103050225077",
    "OrderType": "TR",
    "BeginDate": "2021-01-02 20:01:43.147",
    "EndDate": "2022-10-02 18:09:42.620",
    "IsService": "16",
    "PageIndex":"1",
    "PageSize":"10"
}

8.10.3返回参数

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

detail:

参数	类型	说明	备注
TotalCount	int	总条数
OrderList	Array	通用航班订单信息组

OrderList：

参数	类型	说明	备注
OrderID	String	订单编号
OrderNO	String	长单号
MiddleOutTradeNo	String	第三方订单号	供应商订单号
Status	int	订单状态	0 已取消 1 待确认 2 待一审 3 待二审 4 待支付 5 待出票 6 已出票 7 审核退回 8 已支付 9 待确认价格 10 申请 11 暂存 12 待定位
PNR	String	PNR
CreateDate	DateTime	下单时间
FlightDetailList	Array	航段组
PassengerList	Array	乘客组
SalePriceInfoList	Array	价格明细组

financeDetail：

参数	类型	说明	备注
FlightId	Int	航段编号
DepartTime	DateTime	出发时间
DestTime	DateTime	到达时间
Airline	String	航司码
FlightNo	String	航班号
ClassNo	String	舱位
DepAir	String	出发机场编号
DesAir	String	目的机场编号
Cabin	String	舱位等级	1 经济舱 2 商务舱 3 头等舱 4 超级经济舱

financeList：

参数	类型	说明	备注
PsgId	String	乘客编号
Name	String	乘客姓名
PsgType	Int	乘客类型	-1 其他 0 成人 1 儿童 2 婴儿 3 老人 4 学生 5 劳务 6 移民 7 海员 8 青年 9 免票
IDType	Int	证件类型	-1 请选择 0 护照 1 无法识别证件 2 身份证_港澳台居民居住证 3 港澳通行证 4 回乡证 5 户口簿 6 出生证明 7 台湾通行证 8 台胞证 9 军人证 11 外国人永久居留身份证 12 其他有效证件
IDNumber	String	证件号码

tripList

参数	类型	说明	备注
PsgType	Int	乘客类型	-1 其他 0 成人 1 儿童 2 婴儿 3 老人 4 学生 5 劳务 6 移民 7 海员 8 青年 9 免票
SalePrice	decimal	票面价
SaleTax	decimal	税金
SaleTotal	decimal	收入合计
BaseSalePrice	decimal	成本金额
BaseTax	decimal	成本税金
BaseTotal	decimal	成本合计
Profit	decimal	利润

flightList：

参数	类型	说明	备注
airline	String	航司编码
airlineName	String	航司名
flightNo	String	航班号
classNo	String	舱位
departureCityName	String	出发城市
destinationCityName	String	到达城市
departureCityCode	String	出发城市编码
destinationCityCode	String	到达城市编码
departureAirportCode	String	出发机场编码
destinationAirportCode	String	到达机场编码
departureAirportName	String	出发机场名
destinationAirportName	String	到达机场名
departureDateTime	String	出发日期时间
arrivalDateTime	String	到达日期时间
seatNumber	String	剩余座位数	A:>9 9:>=9 1-8:对应具体数量
equipment	String	机型
departureTerm	String	出发机场航站楼
destinationTerm	String	到达机场航站楼
duration	String	飞行时长	HH:mm
codeShare	String	共享航班
stopOver	Array	经停机场码

refs

参数	类型	说明
fare_basis_code	String	运价基础
free_baggage_allowance	String	行李信息
origin	String	出发机场
destination	String	到达机场

8.10.4返回样例

{
    "code":"20000",
    "detail":{
        "serialNumber":"c36d6c9f1e054618a61edba5510e52d5",
        "flightDetailList":[
            {
                "flightID":"b8ac217c60398342",
                "airline":"CZ",
                "airline_cn":"南方航空",
                "financeDetail":{
                    "officeNumber":"SIA227",
                    "airline":"CZ",
                    "agencyPolicyRemark":"",
                    "rewardPolicyRemark":",",
                    "financeList":[
                        {
                            "passengerType":"0",
                            "salePrice":"2990",
                            "tax":"683",
                            "beforeReturn":"0",
                            "afterReturn":"0.5",
                            "beforeReturnPrice":"0",
                            "afterReturnPrice":"15",
                            "serviceFee":"0",
                            "saleTotal":"3658",
                            "fare_type":"Published",
                            "refs" : 
                            [
                                {
                                    "fare_basis_code" : "MOWCN",
                                    "free_baggage_allowance" : "30K",
                                    "origin":"WUH",
                                    "destination":"KHH",
								},
								{
                                    "fare_basis_code" : "OOWPROMO",
                                    "free_baggage_allowance" : "30K",
                                    "origin":"TPE",
                                    "destination":"CAN"
								}
							]

                        }
                    ]
                },
                "tripList":[
                    {
                        "departureCode":"WUH",
                        "destinationCode":"KHH",
                        "flightList":[
                            {
                                "airline":"CZ",
                                "airlineName":"南方航空",
                                "flightNo":"3093",
                                "classNo":"K",
                                "departureCityName":"武汉",
                                "destinationCityName":"高雄",
                                "departureCityCode":"WUH",
                                "destinationCityCode":"KHH",
                                "departureAirportCode":"WUH",
                                "destinationAirportCode":"KHH",
                                "departureAirportName":"武汉天河国际机场",
                                "destinationAirportName":"高雄国际机场",
                                "departureDateTime":"2019-01-31 14:30",
                                "arrivalDateTime":"2019-01-31 17:15",
                                "seatNumber":"A",
                                "duration":"02:45",
                                "equipment":"737",
                                "departureTerm":"T3",
                                "destinationTerm":"",
                                "codeShare":"",
                                "stopOver":[

                                ]
                            }
                        ]
                    },
                    {
                        "departureCode":"TPE",
                        "destinationCode":"WUH",
                        "flightList":[
                            {
                                "airline":"CZ",
                                "airlineName":"南方航空",
                                "flightNo":"3098",
                                "classNo":"Q",
                                "departureCityName":"台北",
                                "destinationCityName":"广州",
                                "departureCityCode":"TPE",
                                "destinationCityCode":"CAN",
                                "departureAirportCode":"TPE",
                                "destinationAirportCode":"CAN",
                                "departureAirportName":"台湾桃园国际机场",
                                "destinationAirportName":"广州白云国际机场",
                                "departureDateTime":"2019-02-07 14:35",
                                "arrivalDateTime":"2019-02-07 17:00",
                                "seatNumber":"4",
                                "duration":"02:25",
                                "equipment":"330",
                                "departureTerm":"2",
                                "destinationTerm":"T2",
                                "codeShare":"",
                                "stopOver":[

                                ]
                            },
                            {
                                "airline":"CZ",
                                "airlineName":"南方航空",
                                "flightNo":"6589",
                                "classNo":"Q",
                                "departureCityName":"广州",
                                "destinationCityName":"武汉",
                                "departureCityCode":"CAN",
                                "destinationCityCode":"WUH",
                                "departureAirportCode":"CAN",
                                "destinationAirportCode":"WUH",
                                "departureAirportName":"广州白云国际机场",
                                "destinationAirportName":"武汉天河国际机场",
                                "departureDateTime":"2019-02-07 19:25",
                                "arrivalDateTime":"2019-02-07 21:25",
                                "seatNumber":"A",
                                "duration":"02:00",
                                "equipment":"737",
                                "departureTerm":"T2",
                                "destinationTerm":"T3",
                                "codeShare":"",
                                "stopOver":[

                                ]
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

美亚航旅机票B2B接口

用户工具

站点工具

目录

8.10.1请求参数

8.10.2请求样例

申请单

改签单

作废单

退票单

8.10.3返回参数

8.10.4返回样例

页面工具