美亚航旅机票B2B接口

用户工具

站点工具

8.10_航班相关订单查询_iorderlistquery

这是本文档旧的修订版！

目录

8.10 航班相关订单查询(IOrderListQuery)

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 利润

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":[

                                ]
                            }
                        ]
                    }
                ]
            }
        ]
    }
}
8.10_航班相关订单查询_iorderlistquery.1665482998.txt.gz · 最后更改: 2022/10/11 10:09 由 zhangnuopeng

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki