alitrip.btrip.flight.distribution.modify.flightsearch (改签航班列表)

商旅分销改签航班列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_btrip_flight_modify_search_price_rq BtripFlightModifySearchPriceRq 可选 改签航班列表入参
  • └ arr_city
  • String
  • 必须
  • HGH
  • 到达城市三字码
  • └ cabin_class
  • String
  • 可选
  • F
  • 舱等
  • └ dep_city
  • String
  • 必须
  • BJS
  • 出发城市三字码
  • └ dep_date
  • String
  • 必须
  • 2021-08-02
  • 出发日期
  • └ flight_no
  • String
  • 可选
  • MU8765
  • 航班号
  • └ dis_order_id
  • String
  • 必须
  • test908773
  • 外部订单
  • └ sub_channel
  • String
  • 必须
  • jianhang001
  • 分销子渠道,通常为corpId
  • traveler_info_list
  • TravelerInfo []
  • 可选
  • 乘客列表
  • └ name
  • String
  • 可选
  • 张三
  • 乘客姓名
  • └ user_id
  • String
  • 可选
  • 用户编号
  • 用户id
  • └ dep_airport
  • String
  • 可选
  • PKX
  • 出发机场三字码
  • └ arr_airport
  • String
  • 可选
  • HGH
  • 到达机场三字码
  • └ is_voluntary
  • Number
  • 必须
  • 1
  • 0:非自愿 1:自愿

响应参数

名称 类型 示例值 描述
result HisvResult HisvResult 响应信息
  • module
  • BtripFlightModifySearchPriceRs
  • BtripFlightModifySearchPriceRs
  • 子模块
  • flight_info_list
  • FlightInfoDto []
  • FlightInfoDto
  • 航班列表
  • airline_info
  • AirlineInfo
  • AirlineInfo
  • 航司信息
  • └ airline_code
  • String
  • MU
  • 航司编码
  • └ airline_name
  • String
  • demo
  • 航司名称
  • └ airline_simple_name
  • String
  • demo
  • 航司简称
  • arr_airport_info
  • AirportInfo
  • AirportInfo
  • 到达机场信息
  • └ airport_code
  • String
  • PKX
  • 到达机场编码
  • └ airport_name
  • String
  • 大兴国际机场
  • 到达机场名称
  • └ city_code
  • String
  • BJS
  • 到达城市编码
  • └ city_name
  • String
  • 北京
  • 到达城市名称
  • └ terminal
  • String
  • --
  • 航站楼
  • cabin_list
  • CabinInfo []
  • CabinInfo
  • 舱位列表
  • └ cabin
  • String
  • S
  • 舱位
  • └ cabin_class
  • String
  • Y
  • 舱等
  • └ cabin_desc
  • String
  • 明珠经济舱
  • 舱位描述
  • └ child_cabin
  • String
  • W1
  • 子舱位
  • └ left_num
  • String
  • A
  • 剩余数量 取值:1:剩余1 2:剩余2 3:剩余3 4:剩余4 5:剩余5 6:剩余6 7:剩余7 8:剩余8 A:剩余10及以上(注:剩余10个位子及以上) S:限制销售(注:因达到限制销售数而没有可利用座位,但可以候补) Q:申请状态(注:永久申请状态,没有可利用座位,但可以申请(HN)) L:没有可利用座位(注:没有可利用座位,但旅客可以候补) C:彻底关闭(注:该等级彻底关闭,不允许候补或申请) X:该等级取消(注:该等级取消, 不允许候补或申请) Z:可利用情况不明(注:可利用情况不明,这种情况有可能在外航航班上出现)
  • modify_price_list
  • ModifyPrice []
  • ModifyPrice
  • 改签价格列表
  • └ passenger_type
  • Number
  • 1
  • 乘客类型 取值:1:普通成人 2:学生 4:教师 8:青年 16:老年 32:儿童 64:婴儿
  • └ upgrade_fee
  • Number
  • 10000
  • 改签费用
  • └ upgrade_price
  • Number
  • 10000
  • 升舱费用
  • └ ticket_price
  • Number
  • 10000
  • 票价(分)
  • └ cabin_discount
  • Number
  • 2
  • 舱位折扣
  • └ carrier_airline
  • String
  • ZH
  • 共享航司
  • └ carrier_no
  • String
  • ZH1234
  • 共享航班号
  • dep_airport_info
  • AirportInfo
  • AirportInfo
  • 出发机场信息
  • └ airport_code
  • String
  • PKX
  • 机场编码
  • └ airport_name
  • String
  • 大兴国际机场
  • 机场名称
  • └ city_code
  • String
  • BJS
  • 城市编码
  • └ city_name
  • String
  • 北京
  • 城市名称
  • └ terminal
  • String
  • --
  • 航站楼
  • └ flight_no
  • String
  • MU8471
  • 航班号
  • └ is_share
  • Boolean
  • true
  • 是否共享
  • └ is_stop
  • Boolean
  • true
  • 是否经停
  • └ lowest_cabin
  • String
  • N
  • 最低价舱位
  • └ lowest_cabin_class
  • String
  • Y
  • 最低价舱等
  • └ lowest_cabin_num
  • String
  • A
  • 最低价舱位数量
  • lowest_cabin_price_list
  • ModifyPrice []
  • ModifyPrice
  • 低价舱位价格列表
  • └ passenger_type
  • Number
  • 1
  • 乘客类型
  • └ upgrade_fee
  • Number
  • 10000
  • 改签费
  • └ upgrade_price
  • Number
  • 10000
  • 升舱费
  • └ secret_params
  • String
  • df5%1de
  • 加密参数
  • └ stop_arr_time
  • String
  • 2021-01-01 10:10:00
  • 经停到达时间
  • └ stop_city
  • String
  • 南京
  • 经停城市
  • └ stop_dep_time
  • String
  • 2021-01-01 10:10:00
  • 经停出发时间
  • └ modify_flight_arr_time
  • String
  • 2021-01-01 10:10:00
  • 到达时间
  • └ modify_flight_dep_time
  • String
  • 2021-01-01 10:10:00
  • 出发时间
  • └ modify_flight_dep_date
  • String
  • 2021-01-01 10:10:00
  • 出发日期
  • flight_rule_list
  • FlightRule []
  • 规则列表
  • upgrade_rule
  • TgqNodeDo
  • 升舱规则
  • └ able
  • Boolean
  • true
  • 是否支持
  • detail_list
  • TimeNodeDo []
  • 规则列表
  • └ title
  • String
  • --
  • 标题
  • └ content
  • String
  • --
  • 内容
  • └ time_stamp
  • Number
  • --
  • 时间
  • └ time_type
  • String
  • --
  • 时间类型
  • └ cost
  • Number
  • 100
  • 费用
  • └ cost_percent
  • Number
  • 10
  • 费率
  • refund_rule
  • TgqNodeDo
  • 退票规则
  • └ able
  • Boolean
  • true
  • 是否支持
  • detail_list
  • TimeNodeDo []
  • 规则列表
  • └ title
  • String
  • --
  • 标题
  • └ content
  • String
  • --
  • 内容
  • └ time_stamp
  • Number
  • --
  • 时间
  • └ time_type
  • String
  • --
  • 时间类型
  • └ cost
  • Number
  • 100
  • 费用
  • └ cost_percent
  • Number
  • 10
  • 费率
  • change_rule
  • TgqNodeDo
  • 改签规则
  • └ able
  • Boolean
  • true
  • 是否支持
  • detail_list
  • TimeNodeDo []
  • 规则列表
  • └ title
  • String
  • --
  • 标题
  • └ content
  • String
  • --
  • 内容
  • └ time_stamp
  • Number
  • --
  • 时间
  • └ time_type
  • String
  • --
  • 时间类型
  • └ cost
  • Number
  • 100
  • 费用
  • └ cost_percent
  • Number
  • 10
  • 费率
  • sign_rule
  • TgqNodeDo
  • 签转规则
  • └ able
  • Boolean
  • true
  • 是否支持
  • detail_list
  • TimeNodeDo []
  • 规则列表
  • └ title
  • String
  • --
  • 标题
  • └ content
  • String
  • --
  • 内容
  • └ time_stamp
  • Number
  • --
  • 时间
  • └ time_type
  • String
  • --
  • 时间类型
  • └ cost
  • Number
  • 100
  • 费用
  • └ cost_percent
  • Number
  • 10
  • 费率
  • └ baggage_info
  • String
  • --
  • 行李额信息
  • └ tuigaiqian_info
  • String
  • --
  • 退改签信息
  • └ extra
  • String
  • --
  • 额外信息
  • └ meal_desc
  • String
  • 有餐食
  • 餐食
  • └ flight_size
  • String
  • 中型机
  • 机型
  • └ flight_type
  • String
  • demo
  • 机型代码
  • └ lowest_cabin_desc
  • String
  • 经济舱
  • 最低价舱位描述
  • └ result_code
  • Number
  • 0
  • 错误编码
  • └ result_msg
  • String
  • demo
  • 错误信息
  • └ success
  • Boolean
  • true
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBtripFlightDistributionModifyFlightsearchRequest req = new AlitripBtripFlightDistributionModifyFlightsearchRequest();
AlitripBtripFlightDistributionModifyFlightsearchRequest.BtripFlightModifySearchPriceRq obj1 = new AlitripBtripFlightDistributionModifyFlightsearchRequest.BtripFlightModifySearchPriceRq();
obj1.setArrCity("HGH");
obj1.setCabinClass("F");
obj1.setDepCity("BJS");
obj1.setDepDate("2021-08-02");
obj1.setFlightNo("MU8765");
obj1.setDisOrderId("test908773");
obj1.setSubChannel("jianhang001");
List<AlitripBtripFlightDistributionModifyFlightsearchRequest.TravelerInfo> list3 = new ArrayList<AlitripBtripFlightDistributionModifyFlightsearchRequest.TravelerInfo>();
AlitripBtripFlightDistributionModifyFlightsearchRequest.TravelerInfo obj4 = new AlitripBtripFlightDistributionModifyFlightsearchRequest.TravelerInfo();
list3.add(obj4);
obj4.setName("张三");
obj4.setUserId("用户编号");
obj4.setDepAirport("PKX");
obj4.setArrAirport("HGH");
obj1.setTravelerInfoList(list3);
obj1.setIsVoluntary(1L);
req.setParamBtripFlightModifySearchPriceRq(obj1);
AlitripBtripFlightDistributionModifyFlightsearchResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_btrip_flight_distribution_modify_flightsearch_response>
    <result>
        <module>
            <flight_info_list>
                <flight_info_dto>
                    <airline_info>
                        <airline_code>MU</airline_code>
                        <airline_name>demo</airline_name>
                        <airline_simple_name>demo</airline_simple_name>
                    </airline_info>
                    <arr_airport_info>
                        <airport_code>PKX</airport_code>
                        <airport_name>大兴国际机场</airport_name>
                        <city_code>BJS</city_code>
                        <city_name>北京</city_name>
                        <terminal>--</terminal>
                    </arr_airport_info>
                    <cabin_list>
                        <cabin_info>
                            <cabin>S</cabin>
                            <cabin_class>Y</cabin_class>
                            <cabin_desc>明珠经济舱</cabin_desc>
                            <child_cabin>W1</child_cabin>
                            <left_num>A</left_num>
                            <modify_price_list>
                                <modify_price>
                                    <passenger_type>1</passenger_type>
                                    <upgrade_fee>10000</upgrade_fee>
                                    <upgrade_price>10000</upgrade_price>
                                    <ticket_price>10000</ticket_price>
                                </modify_price>
                            </modify_price_list>
                            <cabin_discount>2</cabin_discount>
                        </cabin_info>
                    </cabin_list>
                    <carrier_airline>ZH</carrier_airline>
                    <carrier_no>ZH1234</carrier_no>
                    <dep_airport_info>
                        <airport_code>PKX</airport_code>
                        <airport_name>大兴国际机场</airport_name>
                        <city_code>BJS</city_code>
                        <city_name>北京</city_name>
                        <terminal>--</terminal>
                    </dep_airport_info>
                    <flight_no>MU8471</flight_no>
                    <is_share>true</is_share>
                    <is_stop>true</is_stop>
                    <lowest_cabin>N</lowest_cabin>
                    <lowest_cabin_class>Y</lowest_cabin_class>
                    <lowest_cabin_num>A</lowest_cabin_num>
                    <lowest_cabin_price_list>
                        <modify_price>
                            <passenger_type>1</passenger_type>
                            <upgrade_fee>10000</upgrade_fee>
                            <upgrade_price>10000</upgrade_price>
                        </modify_price>
                    </lowest_cabin_price_list>
                    <secret_params>df5%1de</secret_params>
                    <stop_arr_time>2021-01-01 10:10:00</stop_arr_time>
                    <stop_city>南京</stop_city>
                    <stop_dep_time>2021-01-01 10:10:00</stop_dep_time>
                    <modify_flight_arr_time>2021-01-01 10:10:00</modify_flight_arr_time>
                    <modify_flight_dep_time>2021-01-01 10:10:00</modify_flight_dep_time>
                    <modify_flight_dep_date>2021-01-01 10:10:00</modify_flight_dep_date>
                    <flight_rule_list>
                        <flight_rule>
                            <upgrade_rule>
                                <able>true</able>
                                <detail_list>
                                    <time_node_do>
                                        <title>--</title>
                                        <content>--</content>
                                        <time_stamp>--</time_stamp>
                                        <time_type>--</time_type>
                                        <cost>100</cost>
                                        <cost_percent>10</cost_percent>
                                    </time_node_do>
                                </detail_list>
                            </upgrade_rule>
                            <refund_rule>
                                <able>true</able>
                                <detail_list>
                                    <time_node_do>
                                        <title>--</title>
                                        <content>--</content>
                                        <time_stamp>--</time_stamp>
                                        <time_type>--</time_type>
                                        <cost>100</cost>
                                        <cost_percent>10</cost_percent>
                                    </time_node_do>
                                </detail_list>
                            </refund_rule>
                            <change_rule>
                                <able>true</able>
                                <detail_list>
                                    <time_node_do>
                                        <title>--</title>
                                        <content>--</content>
                                        <time_stamp>--</time_stamp>
                                        <time_type>--</time_type>
                                        <cost>100</cost>
                                        <cost_percent>10</cost_percent>
                                    </time_node_do>
                                </detail_list>
                            </change_rule>
                            <sign_rule>
                                <able>true</able>
                                <detail_list>
                                    <time_node_do>
                                        <title>--</title>
                                        <content>--</content>
                                        <time_stamp>--</time_stamp>
                                        <time_type>--</time_type>
                                        <cost>100</cost>
                                        <cost_percent>10</cost_percent>
                                    </time_node_do>
                                </detail_list>
                            </sign_rule>
                            <baggage_info>--</baggage_info>
                            <tuigaiqian_info>--</tuigaiqian_info>
                            <extra>--</extra>
                        </flight_rule>
                    </flight_rule_list>
                    <meal_desc>有餐食</meal_desc>
                    <flight_size>中型机</flight_size>
                    <flight_type>demo</flight_type>
                    <lowest_cabin_desc>经济舱</lowest_cabin_desc>
                </flight_info_dto>
            </flight_info_list>
        </module>
        <result_code>0</result_code>
        <result_msg>demo</result_msg>
        <success>true</success>
    </result>
</alitrip_btrip_flight_distribution_modify_flightsearch_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

返回
顶部