淘宝开放平台

登录
文档中心 > API类目 > 商旅API

商旅API

alitrip.btrip.flight.distribution.change.newquery (改签航班询价V2)

商旅机票改签航班询价

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_btrip_flight_modify_flight_info_rq BtripFlightModifyFlightInfoRq 可选 改签询价入参
  • └ dis_order_id
  • String
  • 必须
  • jianhang123
  • 分销外部订单号
  • └ modify_flight_no
  • String
  • 必须
  • Ck1231
  • 改签航班号
  • └ modify_depart_date
  • String
  • 必须
  • 2021-01-01 10:10:00
  • 改签日期
  • └ dep_city
  • String
  • 必须
  • BJS
  • 出发城市三字码
  • └ arr_city
  • String
  • 必须
  • HGH
  • 到达城市三字码
  • └ is_voluntary
  • Number
  • 必须
  • 1
  • 是否是自愿改签
  • └ sub_channel
  • String
  • 必须
  • jianhang
  • 分销子渠道
  • └ supplier_code
  • String
  • 必须
  • fliggy
  • 供应商标识
  • └ session_id
  • String
  • 必须
  • demo
  • 航班搜索出来的session

响应参数

名称 类型 示例值 描述
result HisvResult 响应结果
  • module
  • BtripFlightModifyFlightInfoRs
  • 响应子模块
  • flight_info_list
  • FlightInfoDTO []
  • 改签航班信息列表
  • └ flight_no
  • String
  • CK1232
  • 航班号
  • airline_info
  • AirlineInfo
  • 航司信息
  • └ airline_code
  • String
  • MU
  • 航司编码
  • └ airline_name
  • String
  • demo
  • 航司名称
  • └ airline_simple_name
  • String
  • demo
  • 航司简称
  • dep_airport_info
  • AirportInfo
  • 出发机场信息
  • └ airport_code
  • String
  • HGH
  • 机场编码
  • └ airport_name
  • String
  • 萧山国际机场
  • 机场名称
  • └ terminal
  • String
  • --
  • 航站楼
  • arr_airport_info
  • AirportInfo
  • 到达机场信息
  • └ airport_code
  • String
  • PKX
  • 机场编码
  • └ airport_name
  • String
  • 大兴国际机场
  • 机场名称
  • └ terminal
  • String
  • --
  • 航站楼
  • └ is_share
  • Boolean
  • true
  • 是否共享
  • └ carrier_no
  • String
  • CK1241
  • 共享航班号（共享航班时有值）
  • └ carrier_airline
  • String
  • demo
  • 共享航班（共享航班时有值）
  • lowest_cabin_price
  • ModifyPrice []
  • 最低舱位价格列表
  • └ passenger_type
  • Number
  • 1
  • 乘客类型
  • └ upgrade_fee
  • Number
  • demo
  • 改签手续费
  • └ upgrade_price
  • Number
  • demo
  • 升舱差价
  • └ change_payment_price
  • Number
  • demo
  • 改签支付价格
  • └ lowest_cabin_num
  • String
  • 1
  • 最低舱数量
  • └ lowest_cabin
  • String
  • Y
  • 最低舱位
  • └ lowest_cabin_class
  • String
  • Y
  • 最低舱等
  • cabin_list
  • CabinInfo []
  • 舱位列表
  • modify_price_list
  • ModifyPrice []
  • 改签费用信息
  • └ passenger_type
  • Number
  • 1
  • 乘客类型
  • └ upgrade_fee
  • Number
  • demo
  • 改签手续费
  • └ upgrade_price
  • Number
  • demo
  • 升舱差价
  • └ change_payment_price
  • Number
  • demo
  • 改签支付价格
  • └ left_num
  • String
  • 1
  • av
  • └ cabin
  • String
  • demo
  • 舱位代码
  • └ cabin_class
  • String
  • demo
  • 舱等
  • └ cabin_desc
  • String
  • demo
  • 舱位描述
  • └ child_cabin
  • String
  • 80
  • 舱等折扣，八折用80表示
  • └ ota_itemid
  • String
  • demo
  • 商品Id
  • change_ota_item_rule_rq
  • ChangeOtaItemRuleRQ
  • 改签航班的退改签规则
  • refund_details
  • ChangeOtaItemRuleRQ []
  • 退票规则
  • └ title
  • String
  • 退票规则
  • 表格标题
  • └ table_head
  • String
  • 去程 北京-上海
  • 表格首行内容
  • └ type
  • Number
  • 0
  • 内容类型
  • └ index
  • Number
  • 0
  • 排序使用
  • refund_sub_items
  • RefundSubItem []
  • 退改表达内容
  • └ title
  • String
  • 特殊说明
  • 行标题
  • └ ptc
  • String
  • 0
  • 乘客类型
  • └ content
  • String
  • 如允许改期的客票在变更时产生票价差价，需加收差价费用，换开后客票提交退票，已收取的变更手续费不退。改期后提交退票，客票自填开之日起，一年内必须开始旅行，自首次旅行开始之日起，一年内运输有效；客票全部未使用的，则从填开客票之日起，一年内有效。
  • 非结构化文本
  • └ is_struct
  • Boolean
  • false
  • 是否结构化
  • refund_sub_contents
  • RefundSubContent []
  • 退改结构化表达
  • └ fee_range
  • String
  • 费用范围
  • 2020-06-02 20:20 前/起飞前/起飞后
  • └ fee_desc
  • String
  • 费用描述
  • 256元/人
  • └ style
  • Number
  • 前端样式
  • 0
  • extra_contents
  • RefundSubItem []
  • 纯文字段落
  • └ title
  • String
  • 备注题目
  • 特殊说明/转签说明
  • └ content
  • String
  • 费用描述
  • xxx
  • └ icon
  • String
  • 头像
  • 链接
  • change_details
  • RefundDetailShowVO []
  • 改签规则
  • └ title
  • String
  • 退票规则/同舱改期规则/行李规则"
  • 表格标题
  • └ table_head
  • String
  • 去程 北京-上海
  • 表格首行内容
  • └ type
  • Number
  • 1
  • 内容类型
  • └ index
  • Number
  • 0
  • 排序使用
  • refund_sub_items
  • RefundSubItem []
  • 退改表达内容
  • └ title
  • String
  • 特殊说明
  • 行标题
  • └ ptc
  • String
  • 0
  • 乘客类型
  • └ content
  • String
  • 如允许改期的客票在变更时产生票价差价，需加收差价费用，换开后客票提交退票，已收取的变更手续费不退。改期后提交退票，客票自填开之日起，一年内必须开始旅行，自首次旅行开始之日起，一年内运输有效；客票全部未使用的，则从填开客票之日起，一年内有效。
  • 非结构化文本
  • └ is_struct
  • Boolean
  • false
  • 是否结构化
  • refund_sub_contents
  • RefundSubContent []
  • 退改结构化表达
  • └ fee_range
  • String
  • 费用范围
  • 2020-06-02 20:20 前/起飞前/起飞后
  • └ fee_desc
  • String
  • 费用描述
  • 256元/人
  • └ style
  • Number
  • 前端样式
  • 0
  • extra_contents
  • RefundSubItem []
  • 纯文字段落
  • └ title
  • String
  • 备注题目
  • 特殊说明/转签说明
  • └ content
  • String
  • 费用描述
  • xxx
  • └ icon
  • String
  • 头像
  • 链接
  • baggage_details
  • RefundDetailShowVO []
  • 行李额
  • └ title
  • String
  • 退票规则/同舱改期规则/行李规则
  • 表格标题
  • └ table_head
  • String
  • 去程 北京-上海
  • 表格首行内容
  • └ type
  • Number
  • 1
  • 内容类型
  • └ index
  • Number
  • 1
  • 排序使用
  • baggage_sub_items
  • BaggageSubItem []
  • 行李表达内容
  • └ title
  • String
  • 成人/儿童/备注/说明
  • 行标题
  • └ ptc
  • String
  • ADT
  • 乘客类型
  • └ content
  • String
  • demo
  • 非结构化文本
  • └ is_struct
  • Boolean
  • true
  • 是否结构化
  • baggage_sub_contents
  • BaggageSubContent []
  • 结构化表达,优先展示
  • └ icon
  • String
  • 链接
  • 图标
  • └ sub_title
  • String
  • 托运/手提
  • 子标题
  • └ baggage_desc
  • String
  • 每人2件，每件20公斤，体积不可超过20*30*40厘米
  • 行李描述额
  • └ style
  • Number
  • 0
  • 样式
  • baggage_sub_content_visualizes
  • BaggageSubContentVisualize []
  • 行李可视化，有手提/托运俩种
  • └ sub_title
  • String
  • 子标题
  • 儿童 免费手提行李
  • └ baggage_sub_content_type
  • Number
  • 1
  • 行李类型
  • └ is_highlight
  • Boolean
  • true
  • 子标题的高亮
  • image_d_o
  • ImageDO
  • 图像信息
  • └ image
  • String
  • 链接
  • https://gw.alicdn.com/imgextra/i3/O1CN01kLt3m923XsUs6WVif_!!6000000007266-2-tps-280-300.png
  • └ largest
  • String
  • 最大数量
  • 50
  • └ middle
  • String
  • 中间
  • 40
  • └ smallest
  • String
  • 最低
  • 20
  • └ baggage_desc
  • String []
  • 子行李额标题
  • description
  • String []
  • 行李说明
  • └ icon
  • String
  • demo
  • 头像链接
  • └ image
  • String
  • demo
  • 图片链接
  • └ title
  • String
  • 手提行李说明
  • 图像标题
  • └ desc
  • String
  • 您可以随身携带上飞机客舱内的行李物品，由旅客自行负责保管。具体尺寸、重量、类型等以各航空公司规定为准
  • 描述
  • tips
  • Tips
  • 提示
  • └ logo
  • String
  • https://gw.alicdn.com/imgextra/i1/O1CN019zl3WZ22fNLxzx2cR_!!6000000007147-2-tps-125-45.png
  • 头像链接
  • └ tips_desc
  • String
  • 各个尺寸的行李箱有多大
  • 提示描述
  • └ tips_image
  • String
  • https://gw.alicdn.com/imgextra/i3/O1CN01rJxjw61f3bXNHAmlk_!!6000000003951-2-tps-1050-675.png
  • 图片链接
  • └ modify_flight_dep_date
  • String
  • 2021-08-01
  • 改签航班出发日期
  • └ modify_flight_dep_time
  • String
  • 2021-08-01 00:00:00
  • 改签航班出发时间
  • └ modify_flight_arr_time
  • String
  • 2021-08-01 00:00:00
  • 改签航班到达时间
  • └ session_id
  • String
  • demo
  • 会话Id
  • └ result_code
  • Number
  • 01
  • 错误码
  • └ result_msg
  • String
  • demo
  • 错误信息
  • └ success
  • Boolean
  • true
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBtripFlightDistributionChangeNewqueryRequest req = new AlitripBtripFlightDistributionChangeNewqueryRequest();
AlitripBtripFlightDistributionChangeNewqueryRequest.BtripFlightModifyFlightInfoRq obj1 = new AlitripBtripFlightDistributionChangeNewqueryRequest.BtripFlightModifyFlightInfoRq();
obj1.setDisOrderId("jianhang123");
obj1.setModifyFlightNo("Ck1231");
obj1.setModifyDepartDate("2021-01-01 10:10:00");
obj1.setDepCity("BJS");
obj1.setArrCity("HGH");
obj1.setIsVoluntary(1L);
obj1.setSubChannel("jianhang");
obj1.setSupplierCode("fliggy");
obj1.setSessionId("demo");
req.setParamBtripFlightModifyFlightInfoRq(obj1);
AlitripBtripFlightDistributionChangeNewqueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
<alitrip_btrip_flight_distribution_change_newquery_response>
    <result>
        <module>
            <flight_info_list>
                <flight_info_d_t_o>
                    <flight_no>CK1232</flight_no>
                    <airline_info>
                        <airline_code>MU</airline_code>
                        <airline_name>demo</airline_name>
                        <airline_simple_name>demo</airline_simple_name>
                    </airline_info>
                    <dep_airport_info>
                        <airport_code>HGH</airport_code>
                        <airport_name>萧山国际机场</airport_name>
                        <terminal>--</terminal>
                    </dep_airport_info>
                    <arr_airport_info>
                        <airport_code>PKX</airport_code>
                        <airport_name>大兴国际机场</airport_name>
                        <terminal>--</terminal>
                    </arr_airport_info>
                    <is_share>true</is_share>
                    <carrier_no>CK1241</carrier_no>
                    <carrier_airline>demo</carrier_airline>
                    <lowest_cabin_price>
                        <modify_price>
                            <passenger_type>1</passenger_type>
                            <upgrade_fee>demo</upgrade_fee>
                            <upgrade_price>demo</upgrade_price>
                            <change_payment_price>demo</change_payment_price>
                        </modify_price>
                    </lowest_cabin_price>
                    <lowest_cabin_num>1</lowest_cabin_num>
                    <lowest_cabin>Y</lowest_cabin>
                    <lowest_cabin_class>Y</lowest_cabin_class>
                    <cabin_list>
                        <cabin_info>
                            <modify_price_list>
                                <modify_price>
                                    <passenger_type>1</passenger_type>
                                    <upgrade_fee>demo</upgrade_fee>
                                    <upgrade_price>demo</upgrade_price>
                                    <change_payment_price>demo</change_payment_price>
                                </modify_price>
                            </modify_price_list>
                            <left_num>1</left_num>
                            <cabin>demo</cabin>
                            <cabin_class>demo</cabin_class>
                            <cabin_desc>demo</cabin_desc>
                            <child_cabin>80</child_cabin>
                            <ota_itemid>demo</ota_itemid>
                            <change_ota_item_rule_rq>
                                <refund_details>
                                    <change_ota_item_rule_r_q>
                                        <title>退票规则</title>
                                        <table_head>去程 北京-上海</table_head>
                                        <type>0</type>
                                        <index>0</index>
                                        <refund_sub_items>
                                            <refund_sub_item>
                                                <title>特殊说明</title>
                                                <ptc>0</ptc>
                                                <content>如允许改期的客票在变更时产生票价差价，需加收差价费用，换开后客票提交退票，已收取的变更手续费不退。改期后提交退票，客票自填开之日起，一年内必须开始旅行，自首次旅行开始之日起，一年内运输有效；客票全部未使用的，则从填开客票之日起，一年内有效。</content>
                                                <is_struct>false</is_struct>
                                                <refund_sub_contents>
                                                    <refund_sub_content>
                                                        <fee_range>费用范围</fee_range>
                                                        <fee_desc>费用描述</fee_desc>
                                                        <style>前端样式</style>
                                                    </refund_sub_content>
                                                </refund_sub_contents>
                                            </refund_sub_item>
                                        </refund_sub_items>
                                        <extra_contents>
                                            <refund_sub_item>
                                                <title>备注题目</title>
                                                <content>费用描述</content>
                                                <icon>头像</icon>
                                            </refund_sub_item>
                                        </extra_contents>
                                    </change_ota_item_rule_r_q>
                                </refund_details>
                                <change_details>
                                    <refund_detail_show_v_o>
                                        <title>退票规则/同舱改期规则/行李规则&quot;</title>
                                        <table_head>去程 北京-上海</table_head>
                                        <type>1</type>
                                        <index>0</index>
                                        <refund_sub_items>
                                            <refund_sub_item>
                                                <title>特殊说明</title>
                                                <ptc>0</ptc>
                                                <content>如允许改期的客票在变更时产生票价差价，需加收差价费用，换开后客票提交退票，已收取的变更手续费不退。改期后提交退票，客票自填开之日起，一年内必须开始旅行，自首次旅行开始之日起，一年内运输有效；客票全部未使用的，则从填开客票之日起，一年内有效。</content>
                                                <is_struct>false</is_struct>
                                                <refund_sub_contents>
                                                    <refund_sub_content>
                                                        <fee_range>费用范围</fee_range>
                                                        <fee_desc>费用描述</fee_desc>
                                                        <style>前端样式</style>
                                                    </refund_sub_content>
                                                </refund_sub_contents>
                                            </refund_sub_item>
                                        </refund_sub_items>
                                        <extra_contents>
                                            <refund_sub_item>
                                                <title>备注题目</title>
                                                <content>费用描述</content>
                                                <icon>头像</icon>
                                            </refund_sub_item>
                                        </extra_contents>
                                    </refund_detail_show_v_o>
                                </change_details>
                                <baggage_details>
                                    <refund_detail_show_v_o>
                                        <title>退票规则/同舱改期规则/行李规则</title>
                                        <table_head>去程 北京-上海</table_head>
                                        <type>1</type>
                                        <index>1</index>
                                        <baggage_sub_items>
                                            <baggage_sub_item>
                                                <title>成人/儿童/备注/说明</title>
                                                <ptc>ADT</ptc>
                                                <content>demo</content>
                                                <is_struct>true</is_struct>
                                                <baggage_sub_contents>
                                                    <baggage_sub_content>
                                                        <icon>链接</icon>
                                                        <sub_title>托运/手提</sub_title>
                                                        <baggage_desc>每人2件，每件20公斤，体积不可超过20*30*40厘米</baggage_desc>
                                                        <style>0</style>
                                                    </baggage_sub_content>
                                                </baggage_sub_contents>
                                                <baggage_sub_content_visualizes>
                                                    <baggage_sub_content_visualize>
                                                        <sub_title>子标题</sub_title>
                                                        <baggage_sub_content_type>1</baggage_sub_content_type>
                                                        <is_highlight>true</is_highlight>
                                                        <image_d_o>
                                                            <image>链接</image>
                                                            <largest>最大数量</largest>
                                                            <middle>中间</middle>
                                                            <smallest>最低</smallest>
                                                        </image_d_o>
                                                        <description>
                                                            <string>
                                                                <icon>demo</icon>
                                                                <image>demo</image>
                                                                <title>手提行李说明</title>
                                                                <desc>您可以随身携带上飞机客舱内的行李物品，由旅客自行负责保管。具体尺寸、重量、类型等以各航空公司规定为准</desc>
                                                            </string>
                                                        </description>
                                                    </baggage_sub_content_visualize>
                                                </baggage_sub_content_visualizes>
                                            </baggage_sub_item>
                                        </baggage_sub_items>
                                        <tips>
                                            <logo>https://gw.alicdn.com/imgextra/i1/O1CN019zl3WZ22fNLxzx2cR_!!6000000007147-2-tps-125-45.png</logo>
                                            <tips_desc>各个尺寸的行李箱有多大</tips_desc>
                                            <tips_image>https://gw.alicdn.com/imgextra/i3/O1CN01rJxjw61f3bXNHAmlk_!!6000000003951-2-tps-1050-675.png</tips_image>
                                        </tips>
                                    </refund_detail_show_v_o>
                                </baggage_details>
                            </change_ota_item_rule_rq>
                        </cabin_info>
                    </cabin_list>
                    <modify_flight_dep_date>2021-08-01</modify_flight_dep_date>
                    <modify_flight_dep_time>2021-08-01 00:00:00</modify_flight_dep_time>
                    <modify_flight_arr_time>2021-08-01 00:00:00</modify_flight_arr_time>
                    <session_id>demo</session_id>
                </flight_info_d_t_o>
            </flight_info_list>
        </module>
        <result_code>01</result_code>
        <result_msg>demo</result_msg>
        <success>true</success>
    </result>
</alitrip_btrip_flight_distribution_change_newquery_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部