用户工具

站点工具


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:

参数 类型 说明 备注
officeNumber String 出票OFFICE
airline String 出票航司
agencyPolicyRemark String 代理费政策限制
rewardPolicyRemark String 奖励政策限制
financeList Array 价格组 每种乘客类型一条数据
refs Array 扩展信息

financeList:

参数 类型 说明 备注
passengerType String 乘客类型 0成人 1儿童 2婴儿
salePrice String 票面价
tax String 税金
beforeReturn String 代理费点数
beforeReturnPrice String 代理费金额
afterReturnPrice String 奖励金额
serviceFee String 服务费
saleTotal String 结算价
travelItinerary String 是否有行程单 0:无 1:有
beforeReturnMoney String 代理费直减金额
afterReturMoney String 奖励直减金额
productType String 产品类型 20210813新增 产品类型:BSP、NDC、合作商

tripList

参数 类型 说明 备注
departureCode String 出发地
destinationCode String 目的地
flightList Array 航班信息集合

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

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