美亚航旅机票B2B接口

用户工具

站点工具

5.7_国内改签航班查询_itcdomesticticketshopping

目录

5.7 国内改签航班搜索(ITCDomesticTicketShopping)

5.7.1请求参数

参数 类型 说明 必填 备注
TOOrderID String 原单订单号 Y
TOFlightID String 原单航段编号 Y 改签航段，若多段需查询多次
depDate String 出发日期Y
passengers Array 改签乘客 Y

passengers:

参数 类型 说明 必填 备注
passengerType String 乘客类型 Y ADT/CHD/INF

5.7.2请求样例

{

  "TOOrderID": "TO20210303001",
  "TOFlightID": "123456",
  "depDate": "2021-08-26",
   "passengers":[
     { 
        "passengerType":"ADT"
     }
    ]
}

5.7.3返回参数

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

detail:

参数 类型 说明 备注
serialNumber String 缓存key 下单时回传给接口
flightList Array 行程组

flightList：

参数 类型 说明 备注
flight_id String 行程ID 唯一标示
cabin_fares Array 舱位信息列表
trips Array 行程信息列表

cabin_fares：

参数 类型 说明 备注
psg_fares Array 旅客票价信息列表
cabin_name String 舱等
cabin_fare_id String 舱位id
class_code String 舱位
sub_class_code String 子舱位
seat String 座位数 A则座位数>9 <9则为具体数量
rule_obj Object 条款
cabin_fare_Number String 价格序号
valueAddedProducts String 增值产品 该舱位可能存在的其它增值产品运价说明(多个,号隔开)，此处列出该舱位可能存在的其它增值产品;并非指运价已包括这些增值产品;需再从询价接口获取价格
tripsOrder String 行程单 无行程单：空值或=“30”

rule_obj：

参数 类型 说明 备注
rules Array 退改条款

rules：

参数 类型 说明 备注
change_conditionsString 是否可签转
rule_remarkString 备注
rules_itemArray退改明细
baggage_allowanceString行李额
baggage_remarkString行李额说明

rule_item:

参数 类型 说明 备注
operator_hour_textString 适用条件
change_pricedecimal 同舱改签费
refund_pricedecimal 退票费用
hourString (起飞前OR起飞后)小时
operator_thString 对hour的标注 10:距离起飞前hour
20:距离起飞前（含）hour
30:起飞前X小时后hour
40:起飞前X小时后（含）hour

psg_fares：

参数 类型 说明 备注
passenger_type String 乘客类型 ADT:成人 CHD:儿童 INF:婴儿
discount decimal折扣 折扣
base_fare decimal票面价
airport_tax decimal机场建设费
oil_tax decimal燃油费
l_reward_fare decimal奖励费用
m_commission decimal 代理费
m_fare String 奖励
service_fare decimal 服务费
total_fare decimal 总价
fare_type int 运价类型1：普通
2：航司官网
3：特殊
4：特价
is_need_apply bool 是否需申请True：是;需人工跟进 false：否
trips_order String 行程单 普通、中性、无
trips_order_remarkString 行程单说明
meal String 餐食 一般是按航班flights，若特殊舱位有不同，则该字段会有对应说明
serviceinfoObject 工作时间说明
baggage String 行李额

service_time：

参数 类型 说明 备注
start_issue_time String 出票开始工作时间
end_issue_timeString 出票截止工作时间
start_void_time String 废票开始工作时间
end_void_timeString 废票截止工作时间
start_refund_change_time String 退改开始工作时间
end_refund_change_time String 退改截止工作时间

trips:

参数 类型 说明 备注
origin String 出发地
arrivalString 目的地
flights Array 航班信息集合

flights：

参数 类型 说明 备注
departure_airportString 出发机场
departure_dateString 出发日期
departure_time String 出发时间
arrival_airport String 到达机场
arrival_date String 到达日期
arrival_time String 到达时间
airlineString 航司
flight_numberString 航班号
code_shareObject 共享航班信息
equipmentString 机型
dep_termString 出发航站楼
arr_termString 到达航站楼
mealString 餐食
weekString 星期
stopString 经停
stopInfosArray 经停信息

code_share：

参数 类型 说明 备注
carrier String 航司
flight_number String 航班号

stopInfo：

参数 类型 说明 备注
stop_city String 经停机场
stop_time String 经停时间

5.7.4返回样例

{
    "code": "20000",
    "detail": {
        "flightList": [
            {
                "flight_id": 3,
                "cabin_fares": [
                    {
                        "psg_fares": [
                            {
                                "passenger_type": "ADT",
                                "discount": 6.5,
                                "base_fare": 1160,
                                "airport_tax": 50,
                                "oil_tax": 0,
                                "total_fare": "1712",
                                "l_reward_fare": 78,
                                "service_fare": 10,
                                "fare_type": 3,
                                "trips_order": "10",
                                "trips_order_remark": "20元",
                                "is_need_apply": false,
                                "meal": "10",
                                "serviceinfo": {
                                    "service_time": {
                                        "end_issue_time": "10:09:59",
                                        "end_void_time": "23:59:00",
                                        "start_issue_time": "00:00:00",
                                        "start_void_time": "00:00:00",
                                        "end_refund_change_time": "23:59:59",
                                        "start_refund_change_time": "11:00:00"
                                    }
                                }
                            }
                        ],
                        "cabin": "Y",
                        "cabin_fare_id": "01010101_V",
                        "cabin_name": "经济舱",
                        "class_code": "V",
                        "rule_obj": {
                            "rules": [
                                {
                                    "change_conditions": "",
                                    "rule_remark": "",
                                    "rule_item": [],
                                    "baggage_allowance": "",
                                    "baggage_remark": "20kg"
                                }
                            ]
                        },
                        "seat": "A",
                        "sub_class_code": "",
                        "cabin_fare_Number": 0
                    }
                ],
                "trips": [
                    {
                        "origin": "CAN",
                        "arrival": "SHA",
                        "flights": {
                            "airline": "CA",
                            "airline_cnname": "国航",
                            "arr_term": "T2",
                            "arrival_airport": "SHA",
                            "arrival_airport_cnname": "上海虹桥国际机场",
                            "arrival_airport_short_cnname": "上海虹桥国际机场",
                            "arrival_city": "SHA",
                            "arrival_city_cnname": "上海",
                            "arrival_date": "2020-08-31",
                            "arrival_time": "11:20",
                            "code_share": {
                                "carrier": "",
                                "carrier_cnname": null,
                                "flight_number": ""
                            },
                            "dep_term": "T1",
                            "departure_airport": "CAN",
                            "departure_airport_cnname": "广州白云国际机场",
                            "departure_airport_short_cnname": "广州白云国际机场",
                            "departure_city": "CAN",
                            "departure_city_cnname": "广州",
                            "departure_date": "2020-08-31",
                            "departure_time": "08:55",
                            "equipment": "747",
                            "flight_id": "01010101",
                            "flight_number": "1838",
                            "meal": "FS|JS|YR",
                            "stop": 0,
                            "week": "MON"
                        }
                    }
                ]
            }
        ],
        "serialNumber": "f8f412f6-6407-3b43-f9cc-23822590861c"
    }
}
5.7_国内改签航班查询_itcdomesticticketshopping.txt · 最后更改: 2021/05/14 03:25 由 tiny

页面工具

除额外注明的地方外，本维基上的内容按下列许可协议发布： 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