文档中心 > API类目 > 国内机票京杭API

alitrip.flight.change.order.search (新京杭机票改签搜索)

新京杭机票改签搜索

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
change_search_request ChangeSearchRequest 必须 改签搜索请求
  • reshop_search_segment_params
  • ReshopSearchSegmentParam []
  • 必须
  • 改签搜索目标航段
  • └ arr_city_code
  • String
  • 必须
  • BJS
  • 到达城市三字码
  • └ dep_date
  • String
  • 必须
  • 2024-02-28
  • 起飞时间 格式yyyy-MM-dd
  • └ dep_city_code
  • String
  • 必须
  • HGH
  • 出发城市三字码
  • └ order_id
  • Number
  • 必须
  • 123456
  • 正向订单号
  • reshop_change_segment_params
  • ReshopChangeSegmentParam []
  • 必须
  • 改签搜索原航段列表
  • └ dep_airport_code
  • String
  • 必须
  • HGH
  • 出发机场三字码
  • └ operating_flight_no
  • String
  • 可选
  • MU5147
  • 共享航班号
  • └ arr_city_code
  • String
  • 必须
  • BJS
  • 到达城市三字码
  • └ marketing_flight_no
  • String
  • 必须
  • MU5147
  • 市场航班号
  • └ arr_airport_code
  • String
  • 必须
  • PEK
  • 到达机场三字码
  • └ journey_seq
  • Number
  • 必须
  • 1
  • 当前航段所属航程的序号,从1开始
  • └ dep_city_code
  • String
  • 必须
  • HGH
  • 出发城市三字码
  • └ dep_date_time
  • String
  • 必须
  • 2024-02-27 10:30:00
  • 出发时间,格式yyyy-MM-dd HH:mm:ss
  • └ change_reason_type
  • Number
  • 必须
  • 0
  • 0:自愿改期; 1:航班变动/航班取消
  • └ solution_id
  • String
  • 可选
  • eJwzmBRdrZRYVOScWVLpnJ+SqmSl5OHuoaSjlJJagCTm5BUMEXNJLEkNycwFiRkZGJnoGhjrGhooGJhbGRtYGRgA1WTllxblpVYGpxYqWRnqKOUmFmWnlmTmpbvlZKZnlPjlAzX6hpoaWhoD1eYXpBYlokkq1cYCAB9lLXg=
  • listing搜索无需传入,ota搜索必传;solutionId由listing搜索给出,代表了选中的改签目的航班
  • change_passenger_params
  • ChangePassengerParam []
  • 必须
  • 改签乘机人列表
  • └ passenger_name
  • String
  • 必须
  • 王五
  • 乘机人姓名
  • └ credential_no
  • String
  • 必须
  • 123456
  • 乘机人身份证号

响应参数

名称 类型 示例值 描述
is_success Boolean true 是否成功
reshop_solution_list ReshopSolution [] 改签解决方案列表
  • └ refund_change_details
  • String
  • {\"changeDetails\":[{\"index\":0,\"refundSubItems\":[{\"isStruct\":true,\"ptc\":\"ADT\",\"refundSubContents\":[{\"feeDesc\":\"¥46/人\",\"feeRange\":\"3月3日 08:15 前\",\"style\":0},{\"feeDesc\":\"¥138/人\",\"feeRange\":\"3月8日 08:15 前\",\"style\":1},{\"feeDesc\":\"¥230/人\",\"feeRange\":\"3月10日 04:15 前\",\"style\":1},{\"feeDesc\":\"¥322/人\",\"feeRange\":\"3月10日 04:15 后\",\"style\":1}],\"title\":\"成人\"},{\"isStruct\":true,\"ptc\":\"CHD\",\"refundSubContents\":[{\"feeDesc\":\"¥46/人\",\"feeRange\":\"3月3日 08:15 前\",\"style\":0},{\"feeDesc\":\"¥138/人\",\"feeRange\":\"3月8日 08:15 前\",\"style\":1},{\"feeDesc\":\"¥230/人\",\"feeRange\":\"3月10日 04:15 前\",\"style\":1},{\"feeDesc\":\"¥322/人\",\"feeRange\":\"3月10日 04:15 后\",\"style\":1}],\"title\":\"儿童\"}],\"title\":\"同舱改期规则\",\"type\":1},{\"index\":0,\"refundSubItems\":[{\"content\":\"不可签转\",\"isStruct\":false}],\"title\":\"签转条件\",\"type\":2}],\"refundDetails\":[{\"extraContents\":[{\"content\":\"客票变更时,需同时收取票价价差和变更手续费。除另有规定外,客票有效期自旅客开始第一段旅行开始之日起,一年内运输有效;如果客票全部未使用,则从填开客票之日起,一年内运输有效。\",\"title\":\"特殊说明\"}],\"index\":0,\"refundSubItems\":[{\"isStruct\":true,\"ptc\":\"ADT\",\"refundSubContents\":[{\"feeDesc\":\"¥92/人\",\"feeRange\":\"3月3日 08:15 前\",\"style\":0},{\"feeDesc\":\"¥184/人\",\"feeRange\":\"3月8日 08:15 前\",\"style\":1},{\"feeDesc\":\"¥322/人\",\"feeRange\":\"3月10日 04:15 前\",\"style\":1},{\"feeDesc\":\"¥414/人\",\"feeRange\":\"3月10日 04:15 后\",\"style\":1}],\"title\":\"成人\"},{\"isStruct\":true,\"ptc\":\"CHD\",\"refundSubContents\":[{\"feeDesc\":\"¥92/人\",\"feeRange\":\"3月3日 08:15 前\",\"style\":0},{\"feeDesc\":\"¥184/人\",\"feeRange\":\"3月8日 08:15 前\",\"style\":1},{\"feeDesc\":\"¥322/人\",\"feeRange\":\"3月10日 04:15 前\",\"style\":1},{\"feeDesc\":\"¥414/人\",\"feeRange\":\"3月10日 04:15 后\",\"style\":1}],\"title\":\"儿童\"}],\"title\":\"退票收费规则\",\"type\":0}]}
  • 退改规则信息
  • reshop_flight_passenger_item_list
  • ReshopFlightPassengerItem []
  • 乘机人类型价格信息
  • └ passenger_type
  • String
  • ADT
  • 乘客类型,成人:ADT 儿童:CHD 婴儿:INFANT
  • flight_segment_item_list
  • FlightSegmentItem []
  • 每个乘客类型航段舱位说明
  • └ cabin_class
  • String
  • Y
  • 舱位等级(Y:经济舱;S:超值经济舱;C:公务舱;F:头等舱)
  • └ cabin_quantity
  • String
  • 2
  • 舱位剩余座位数:0~9:剩余0~9个座位;A:大于9个座位(个别航司大于4是A)
  • └ cabin
  • String
  • N
  • 舱位
  • └ flight_segment_id
  • String
  • CZ8957PKXXMN0310
  • 航段id,航班号+出发机场+达到机场+起飞日期(MMdd)
  • reshop_price_info
  • ReshopPriceInfo
  • 改签价格信息
  • └ reshop_price_gap
  • Number
  • 0
  • 改签票价差
  • └ ticket_price
  • Number
  • 1000
  • 改签后票价
  • └ reshop_tax_gap
  • Number
  • 0
  • 改签税差
  • └ reshop_price
  • Number
  • 100
  • 改签需支付的总金额(改签票价差+改签税差+改签服务费)
  • └ reshop_change_fee
  • Number
  • 100
  • 改签服务费
  • └ tax
  • Number
  • 120
  • 改签后税价(机建加燃油)
  • └ solution_id
  • String
  • eJwzmBRdrZRYVOScWVLpnJ+SqmSl5OHuoaSjlJJagCTm5BUMEXNJLEkNycwFiRkZGJnoGpjoGhooGBlaGZlaGRgA1WTllxblpVYGpxYqWRnqKOUmFmWnlmTmpbvlZKZnlPjlAzX6ulkYmoLU5hekFiWiSSrVxgIAHXUtZg==&&&d1a9d7c286284041ae9650f6485a34d2
  • 改签方案id,lisitng搜索中代表一个航班,ota搜索中代表一个商品
  • └ baggage_details
  • String
  • "{\"baggageDetails\":[{\"baggageSubItems\":[{\"baggageSubContentVisualizes\":[{\"baggageDesc\":[\"免费手提行李额规则以航司为准\"],\"baggageSubContentType\":0,\"description\":{\"desc\":\"您可以随身携带上飞机客舱内的行李物品,由旅客自行负责保管。具体尺寸、重量、类型等以各航空公司规定为准。\",\"title\":\"手提行李说明\"},\"subTitle\":\"免费手提行李\"},{\"baggageDesc\":[\"免费托运行李额规则以航司为准\"],\"baggageSubContentType\":1,\"description\":{\"desc\":\"您需要在登机前将行李在值机柜台办理托运,领取托运凭证,该行李在飞机货舱中随飞机到达目的地,抵达后您凭托运凭证在行李领取处领取。\",\"title\":\"托运行李说明\"},\"subTitle\":\"免费托运行李\"}],\"isStruct\":false,\"ptc\":\"ADT\"}],\"index\":0,\"title\":\"行李规定\",\"type\":0}]}"
  • 改签后行李规则
  • flight_route
  • FlightRoute
  • 改签后行程信息
  • flight_journey_list
  • FlightJourney []
  • 航程列表
  • flight_segment_list
  • FlightSegment []
  • 航段列表
  • └ marketing_airline
  • String
  • CZ
  • 市场航司
  • └ operating_flight_no
  • String
  • CZ8957
  • 承运航班号,无承运航班时为空
  • └ dep_time_string
  • String
  • 2022-03-30 08:45:00
  • 航班起飞日期时间,字符串格式yyyy-MM-dd HH:mm:ss
  • └ dep_term
  • String
  • T1
  • 出发航站楼,可能为空
  • └ marketing_flight_no
  • String
  • CZ8957
  • 市场航班号
  • └ dep_airport
  • String
  • PKX
  • 出发机场三字码
  • └ arr_time_string
  • String
  • 2022-03-30 11:35:00
  • 航班到达日期时间,字符串格式yyyy-MM-dd HH:mm:ss
  • └ code_share
  • Boolean
  • true
  • 是否共享
  • └ equip_type
  • String
  • 321
  • 机型
  • └ arr_airport
  • String
  • XMN
  • 到达机场
  • └ id
  • String
  • CZ8957PKXXMN0310
  • 航段唯一标示航班号+出发机场+达到机场+起飞日期(MMdd)
  • └ arr_term
  • String
  • T3
  • 到达航站楼,,可能为空
error_code_info String INPUT_PARAM_ERROR 错误码
error_msg String 入参错误 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripFlightChangeOrderSearchRequest req = new AlitripFlightChangeOrderSearchRequest();
AlitripFlightChangeOrderSearchRequest.ChangeSearchRequest obj1 = new AlitripFlightChangeOrderSearchRequest.ChangeSearchRequest();
List<AlitripFlightChangeOrderSearchRequest.ReshopSearchSegmentParam> list3 = new ArrayList<AlitripFlightChangeOrderSearchRequest.ReshopSearchSegmentParam>();
AlitripFlightChangeOrderSearchRequest.ReshopSearchSegmentParam obj4 = new AlitripFlightChangeOrderSearchRequest.ReshopSearchSegmentParam();
list3.add(obj4);
obj4.setArrCityCode("BJS");
obj4.setDepDate("2024-02-28");
obj4.setDepCityCode("HGH");
obj1.setReshopSearchSegmentParams(list3);
obj1.setOrderId(123456L);
List<AlitripFlightChangeOrderSearchRequest.ReshopChangeSegmentParam> list6 = new ArrayList<AlitripFlightChangeOrderSearchRequest.ReshopChangeSegmentParam>();
AlitripFlightChangeOrderSearchRequest.ReshopChangeSegmentParam obj7 = new AlitripFlightChangeOrderSearchRequest.ReshopChangeSegmentParam();
list6.add(obj7);
obj7.setDepAirportCode("HGH");
obj7.setOperatingFlightNo("MU5147");
obj7.setArrCityCode("BJS");
obj7.setMarketingFlightNo("MU5147");
obj7.setArrAirportCode("PEK");
obj7.setJourneySeq(1L);
obj7.setDepCityCode("HGH");
obj7.setDepDateTime("2024-02-27 10:30:00");
obj1.setReshopChangeSegmentParams(list6);
obj1.setChangeReasonType(0L);
obj1.setSolutionId("eJwzmBRdrZRYVOScWVLpnJ+SqmSl5OHuoaSjlJJagCTm5BUMEXNJLEkNycwFiRkZGJnoGhjrGhooGJhbGRtYGRgA1WTllxblpVYGpxYqWRnqKOUmFmWnlmTmpbvlZKZnlPjlAzX6hpoaWhoD1eYXpBYlokkq1cYCAB9lLXg=");
List<AlitripFlightChangeOrderSearchRequest.ChangePassengerParam> list9 = new ArrayList<AlitripFlightChangeOrderSearchRequest.ChangePassengerParam>();
AlitripFlightChangeOrderSearchRequest.ChangePassengerParam obj10 = new AlitripFlightChangeOrderSearchRequest.ChangePassengerParam();
list9.add(obj10);
obj10.setPassengerName("王五");
obj10.setCredentialNo("123456");
obj1.setChangePassengerParams(list9);
req.setChangeSearchRequest(obj1);
AlitripFlightChangeOrderSearchResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_flight_change_order_search_response>
    <is_success>true</is_success>
    <reshop_solution_list>
        <reshop_solution>
            <refund_change_details>{\&quot;changeDetails\&quot;:[{\&quot;index\&quot;:0,\&quot;refundSubItems\&quot;:[{\&quot;isStruct\&quot;:true,\&quot;ptc\&quot;:\&quot;ADT\&quot;,\&quot;refundSubContents\&quot;:[{\&quot;feeDesc\&quot;:\&quot;¥46/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月3日 08:15 前\&quot;,\&quot;style\&quot;:0},{\&quot;feeDesc\&quot;:\&quot;¥138/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月8日 08:15 前\&quot;,\&quot;style\&quot;:1},{\&quot;feeDesc\&quot;:\&quot;¥230/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月10日 04:15 前\&quot;,\&quot;style\&quot;:1},{\&quot;feeDesc\&quot;:\&quot;¥322/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月10日 04:15 后\&quot;,\&quot;style\&quot;:1}],\&quot;title\&quot;:\&quot;成人\&quot;},{\&quot;isStruct\&quot;:true,\&quot;ptc\&quot;:\&quot;CHD\&quot;,\&quot;refundSubContents\&quot;:[{\&quot;feeDesc\&quot;:\&quot;¥46/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月3日 08:15 前\&quot;,\&quot;style\&quot;:0},{\&quot;feeDesc\&quot;:\&quot;¥138/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月8日 08:15 前\&quot;,\&quot;style\&quot;:1},{\&quot;feeDesc\&quot;:\&quot;¥230/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月10日 04:15 前\&quot;,\&quot;style\&quot;:1},{\&quot;feeDesc\&quot;:\&quot;¥322/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月10日 04:15 后\&quot;,\&quot;style\&quot;:1}],\&quot;title\&quot;:\&quot;儿童\&quot;}],\&quot;title\&quot;:\&quot;同舱改期规则\&quot;,\&quot;type\&quot;:1},{\&quot;index\&quot;:0,\&quot;refundSubItems\&quot;:[{\&quot;content\&quot;:\&quot;不可签转\&quot;,\&quot;isStruct\&quot;:false}],\&quot;title\&quot;:\&quot;签转条件\&quot;,\&quot;type\&quot;:2}],\&quot;refundDetails\&quot;:[{\&quot;extraContents\&quot;:[{\&quot;content\&quot;:\&quot;客票变更时,需同时收取票价价差和变更手续费。除另有规定外,客票有效期自旅客开始第一段旅行开始之日起,一年内运输有效;如果客票全部未使用,则从填开客票之日起,一年内运输有效。\&quot;,\&quot;title\&quot;:\&quot;特殊说明\&quot;}],\&quot;index\&quot;:0,\&quot;refundSubItems\&quot;:[{\&quot;isStruct\&quot;:true,\&quot;ptc\&quot;:\&quot;ADT\&quot;,\&quot;refundSubContents\&quot;:[{\&quot;feeDesc\&quot;:\&quot;¥92/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月3日 08:15 前\&quot;,\&quot;style\&quot;:0},{\&quot;feeDesc\&quot;:\&quot;¥184/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月8日 08:15 前\&quot;,\&quot;style\&quot;:1},{\&quot;feeDesc\&quot;:\&quot;¥322/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月10日 04:15 前\&quot;,\&quot;style\&quot;:1},{\&quot;feeDesc\&quot;:\&quot;¥414/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月10日 04:15 后\&quot;,\&quot;style\&quot;:1}],\&quot;title\&quot;:\&quot;成人\&quot;},{\&quot;isStruct\&quot;:true,\&quot;ptc\&quot;:\&quot;CHD\&quot;,\&quot;refundSubContents\&quot;:[{\&quot;feeDesc\&quot;:\&quot;¥92/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月3日 08:15 前\&quot;,\&quot;style\&quot;:0},{\&quot;feeDesc\&quot;:\&quot;¥184/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月8日 08:15 前\&quot;,\&quot;style\&quot;:1},{\&quot;feeDesc\&quot;:\&quot;¥322/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月10日 04:15 前\&quot;,\&quot;style\&quot;:1},{\&quot;feeDesc\&quot;:\&quot;¥414/人\&quot;,\&quot;feeRange\&quot;:\&quot;3月10日 04:15 后\&quot;,\&quot;style\&quot;:1}],\&quot;title\&quot;:\&quot;儿童\&quot;}],\&quot;title\&quot;:\&quot;退票收费规则\&quot;,\&quot;type\&quot;:0}]}</refund_change_details>
            <reshop_flight_passenger_item_list>
                <reshop_flight_passenger_item>
                    <passenger_type>ADT</passenger_type>
                    <flight_segment_item_list>
                        <flight_segment_item>
                            <cabin_class>Y</cabin_class>
                            <cabin_quantity>2</cabin_quantity>
                            <cabin>N</cabin>
                            <flight_segment_id>CZ8957PKXXMN0310</flight_segment_id>
                        </flight_segment_item>
                    </flight_segment_item_list>
                    <reshop_price_info>
                        <reshop_price_gap>0</reshop_price_gap>
                        <ticket_price>1000</ticket_price>
                        <reshop_tax_gap>0</reshop_tax_gap>
                        <reshop_price>100</reshop_price>
                        <reshop_change_fee>100</reshop_change_fee>
                        <tax>120</tax>
                    </reshop_price_info>
                </reshop_flight_passenger_item>
            </reshop_flight_passenger_item_list>
            <solution_id>eJwzmBRdrZRYVOScWVLpnJ+SqmSl5OHuoaSjlJJagCTm5BUMEXNJLEkNycwFiRkZGJnoGpjoGhooGBlaGZlaGRgA1WTllxblpVYGpxYqWRnqKOUmFmWnlmTmpbvlZKZnlPjlAzX6ulkYmoLU5hekFiWiSSrVxgIAHXUtZg==&amp;&amp;&amp;d1a9d7c286284041ae9650f6485a34d2</solution_id>
            <baggage_details>&quot;{\&quot;baggageDetails\&quot;:[{\&quot;baggageSubItems\&quot;:[{\&quot;baggageSubContentVisualizes\&quot;:[{\&quot;baggageDesc\&quot;:[\&quot;免费手提行李额规则以航司为准\&quot;],\&quot;baggageSubContentType\&quot;:0,\&quot;description\&quot;:{\&quot;desc\&quot;:\&quot;您可以随身携带上飞机客舱内的行李物品,由旅客自行负责保管。具体尺寸、重量、类型等以各航空公司规定为准。\&quot;,\&quot;title\&quot;:\&quot;手提行李说明\&quot;},\&quot;subTitle\&quot;:\&quot;免费手提行李\&quot;},{\&quot;baggageDesc\&quot;:[\&quot;免费托运行李额规则以航司为准\&quot;],\&quot;baggageSubContentType\&quot;:1,\&quot;description\&quot;:{\&quot;desc\&quot;:\&quot;您需要在登机前将行李在值机柜台办理托运,领取托运凭证,该行李在飞机货舱中随飞机到达目的地,抵达后您凭托运凭证在行李领取处领取。\&quot;,\&quot;title\&quot;:\&quot;托运行李说明\&quot;},\&quot;subTitle\&quot;:\&quot;免费托运行李\&quot;}],\&quot;isStruct\&quot;:false,\&quot;ptc\&quot;:\&quot;ADT\&quot;}],\&quot;index\&quot;:0,\&quot;title\&quot;:\&quot;行李规定\&quot;,\&quot;type\&quot;:0}]}&quot;</baggage_details>
            <flight_route>
                <flight_journey_list>
                    <flight_journey>
                        <flight_segment_list>
                            <flight_segment>
                                <marketing_airline>CZ</marketing_airline>
                                <operating_flight_no>CZ8957</operating_flight_no>
                                <dep_time_string>2022-03-30 08:45:00</dep_time_string>
                                <dep_term>T1</dep_term>
                                <marketing_flight_no>CZ8957</marketing_flight_no>
                                <dep_airport>PKX</dep_airport>
                                <arr_time_string>2022-03-30 11:35:00</arr_time_string>
                                <code_share>true</code_share>
                                <equip_type>321</equip_type>
                                <arr_airport>XMN</arr_airport>
                                <id>CZ8957PKXXMN0310</id>
                                <arr_term>T3</arr_term>
                            </flight_segment>
                        </flight_segment_list>
                    </flight_journey>
                </flight_journey_list>
            </flight_route>
        </reshop_solution>
    </reshop_solution_list>
    <error_code_info>INPUT_PARAM_ERROR</error_code_info>
    <error_msg>入参错误</error_msg>
</alitrip_flight_change_order_search_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

返回
顶部