文档中心 > API类目 > 国际机票运价采购

alitrip.ie.ticket.service.buyer.applychange (买家改签申请)

给B端采购商提供机票改签接口申请服务功能

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
buyer_memo String 可选 希望改到2017-01-01 00:00:00出发 买家改签意向
change_passengers ChangePassengerVo [] 必须
  • 最大列表长度:20
  • 乘机人信息
    • └ passenger_name
    • String
    • 必须
    • TaoBao
    • 姓名
    dst_itinerary ChangeItineraryVo [] 必须
  • 最大列表长度:20
  • 改签目标行程
    • └ arr_city_code
    • String
    • 必须
    • PEK
    • 到达城市三字码
    • └ dep_city_code
    • String
    • 必须
    • SHA
    • 出发城市三字码
    • change_flights
    • ChangeFlightSegmentVo []
    • 可选
    • 改签航班
    • └ arr_airport
    • String
    • 可选
    • PEK
    • 到达机场
    • └ arr_city
    • String
    • 必须
    • BJS
    • 到达城市
    • └ arr_terminal
    • String
    • 可选
    • 1
    • 到达航站楼
    • └ arr_time
    • Date
    • 可选
    • 2016-10-01 00:00:00
    • 到达时间
    • └ cabin_class_code
    • String
    • 可选
    • Y
    • 仓位等级
    • └ cabin_code
    • String
    • 可选
    • Q
    • 仓位代码
    • └ code_share
    • Boolean
    • 可选
    • true
    • 是否共享
    • └ dep_airport
    • String
    • 可选
    • SHA
    • 出发机场
    • └ dep_city
    • String
    • 必须
    • SHA
    • 出发城市
    • └ dep_terminal
    • String
    • 可选
    • 2
    • 到达航站楼
    • └ dep_time
    • Date
    • 必须
    • 2016-10-01 00:00:00
    • 出发日期
    • └ marketing_flight_number
    • String
    • 可选
    • CZ100
    • 市场航班号
    • └ operating_flight_number
    • String
    • 必须
    • CZ100
    • 承运航班号
    • └ segment_index
    • Number
    • 必须
    • 1
    • 航段序号
    order_id Number 必须 12345678 订单号
    trace_id String 必须 1234567 traceId
    change_reason_type Number 必须 0 改签 0-因乘客个人原因(自愿改签) ,1-因航班取消/延误(非自愿)

    响应参数

    名称 类型 示例值 描述
    result ApplyExchangeRs {"success":true} result
    • └ change_order_id
    • Number
    • 123456
    • 改签申请单号
    • └ error_code
    • String
    • -2002
    • 错误码
    • └ error_msg
    • String
    • 不支持在线改签
    • errorMsg
    • └ success
    • Boolean
    • true
    • success

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlitripIeTicketServiceBuyerApplychangeRequest req = new AlitripIeTicketServiceBuyerApplychangeRequest();
    req.setBuyerMemo("希望改到2017-01-01 00:00:00出发");
    List<AlitripIeTicketServiceBuyerApplychangeRequest.ChangePassengerVo> list2 = new ArrayList<AlitripIeTicketServiceBuyerApplychangeRequest.ChangePassengerVo>();
    AlitripIeTicketServiceBuyerApplychangeRequest.ChangePassengerVo obj3 = new AlitripIeTicketServiceBuyerApplychangeRequest.ChangePassengerVo();
    list2.add(obj3);
    obj3.setPassengerName("TaoBao");
    req.setChangePassengers(list2);
    List<AlitripIeTicketServiceBuyerApplychangeRequest.ChangeItineraryVo> list5 = new ArrayList<AlitripIeTicketServiceBuyerApplychangeRequest.ChangeItineraryVo>();
    AlitripIeTicketServiceBuyerApplychangeRequest.ChangeItineraryVo obj6 = new AlitripIeTicketServiceBuyerApplychangeRequest.ChangeItineraryVo();
    list5.add(obj6);
    obj6.setArrCityCode("PEK");
    obj6.setDepCityCode("SHA");
    List<AlitripIeTicketServiceBuyerApplychangeRequest.ChangeFlightSegmentVo> list9 = new ArrayList<AlitripIeTicketServiceBuyerApplychangeRequest.ChangeFlightSegmentVo>();
    AlitripIeTicketServiceBuyerApplychangeRequest.ChangeFlightSegmentVo obj10 = new AlitripIeTicketServiceBuyerApplychangeRequest.ChangeFlightSegmentVo();
    list9.add(obj10);
    obj10.setArrAirport("PEK");
    obj10.setArrCity("BJS");
    obj10.setArrTerminal("1");
    obj10.setArrTime(StringUtils.parseDateTime("2016-10-01 00:00:00"));
    obj10.setCabinClassCode("Y");
    obj10.setCabinCode("Q");
    obj10.setCodeShare(true);
    obj10.setDepAirport("SHA");
    obj10.setDepCity("SHA");
    obj10.setDepTerminal("2");
    obj10.setDepTime(StringUtils.parseDateTime("2016-10-01 00:00:00"));
    obj10.setMarketingFlightNumber("CZ100");
    obj10.setOperatingFlightNumber("CZ100");
    obj10.setSegmentIndex(1L);
    list7.setChangeFlights(list9);
    req.setDstItinerary(list5);
    req.setOrderId(12345678L);
    req.setTraceId("1234567");
    req.setChangeReasonType(0L);
    AlitripIeTicketServiceBuyerApplychangeResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alitrip_ie_ticket_service_buyer_applychange_response>
        <result>
            <change_order_id>123456</change_order_id>
            <error_code>-2002</error_code>
            <error_msg>不支持在线改签</error_msg>
            <success>true</success>
        </result>
    </alitrip_ie_ticket_service_buyer_applychange_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

    返回
    顶部