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
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示例
<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示例
<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

FAQ

返回
顶部