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

alitrip.flight.refund.create (新京杭退票单创建)

新京杭退票单创建

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
refund_create_req RefundCreateReq 必须 创建请求参数
  • └ order_id
  • Number
  • 必须
  • 3960040419329
  • 订单号
  • refund_group_param_list
  • FlightRefundGroupParam []
  • 必须
  • 提退商品分组模型列表
  • passenger_fee_param_list
  • RefundPassengerFeeParam []
  • 必须
  • 乘机人及费用模型
  • └ passenger_name
  • String
  • 可选
  • 森春
  • 乘机人姓名
  • └ credential_no
  • String
  • 可选
  • 41272519880923829X
  • 证件号
  • └ all_refund_fee
  • Number
  • 可选
  • 1000
  • 退改所有手续费
  • flight_item_param
  • RefundFlightItemParam
  • 必须
  • 提退商品
  • flight_journey_param_list
  • FlightJourneyParam []
  • 必须
  • 行程列表
  • segment_param_list
  • FlightSegmentParam []
  • 必须
  • 航段列表
  • └ dep_airport_code
  • String
  • 必须
  • PEK
  • 出发机场三字码
  • └ flight_no
  • String
  • 必须
  • MU3439
  • 航班号
  • └ arr_airport_code
  • String
  • 必须
  • SHA
  • 到达机场三字码
  • └ dep_date
  • String
  • 必须
  • 2022-09-01 09:22:12
  • 起飞时间
  • └ refund_attachment_urls
  • String []
  • 可选
  • 请求附件地址列表
  • └ refund_apply_type
  • Number
  • 必须
  • 2
  • 申请类型:2:自愿;5:航变;6:病退;100:非自愿疫情
  • └ refund_apply_reason
  • String
  • 必须
  • 航司取消航班
  • 提退理由

响应参数

名称 类型 示例值 描述
is_success Boolean true 是否成功
refund_result_list RefundCreateResult [] 提退结果模型
  • └ apply_id_list
  • Number []
  • 退票单列表
  • └ refund_group_key
  • String
  • PEK-HKG-MU3435
  • 提退分组关键字KEY,由行程、航段信息拼接而成
  • └ is_success
  • Boolean
  • true
  • 当前商品,是否成功
error_code_info String SYSTEM_ERROR 错误码
error_msg String 系统失败 错误提醒

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripFlightRefundCreateRequest req = new AlitripFlightRefundCreateRequest();
AlitripFlightRefundCreateRequest.RefundCreateReq obj1 = new AlitripFlightRefundCreateRequest.RefundCreateReq();
obj1.setOrderId(3960040419329L);
List<AlitripFlightRefundCreateRequest.FlightRefundGroupParam> list3 = new ArrayList<AlitripFlightRefundCreateRequest.FlightRefundGroupParam>();
AlitripFlightRefundCreateRequest.FlightRefundGroupParam obj4 = new AlitripFlightRefundCreateRequest.FlightRefundGroupParam();
list3.add(obj4);
List<AlitripFlightRefundCreateRequest.RefundPassengerFeeParam> list7 = new ArrayList<AlitripFlightRefundCreateRequest.RefundPassengerFeeParam>();
AlitripFlightRefundCreateRequest.RefundPassengerFeeParam obj8 = new AlitripFlightRefundCreateRequest.RefundPassengerFeeParam();
list7.add(obj8);
obj8.setPassengerName("森春");
obj8.setCredentialNo("41272519880923829X");
obj8.setAllRefundFee(1000L);
list5.setPassengerFeeParamList(list7);
AlitripFlightRefundCreateRequest.RefundFlightItemParam obj10 = new AlitripFlightRefundCreateRequest.RefundFlightItemParam();
List<AlitripFlightRefundCreateRequest.FlightJourneyParam> list12 = new ArrayList<AlitripFlightRefundCreateRequest.FlightJourneyParam>();
AlitripFlightRefundCreateRequest.FlightJourneyParam obj13 = new AlitripFlightRefundCreateRequest.FlightJourneyParam();
list12.add(obj13);
List<AlitripFlightRefundCreateRequest.FlightSegmentParam> list16 = new ArrayList<AlitripFlightRefundCreateRequest.FlightSegmentParam>();
AlitripFlightRefundCreateRequest.FlightSegmentParam obj17 = new AlitripFlightRefundCreateRequest.FlightSegmentParam();
list16.add(obj17);
obj17.setDepAirportCode("PEK");
obj17.setFlightNo("MU3439");
obj17.setArrAirportCode("SHA");
obj17.setDepDate("2022-09-01 09:22:12");
list14.setSegmentParamList(list16);
obj10.setFlightJourneyParamList(list12);
list9.setFlightItemParam(obj10);
obj4.setRefundAttachmentUrls("");
obj4.setRefundApplyType(2L);
obj4.setRefundApplyReason("航司取消航班");
obj1.setRefundGroupParamList(list3);
req.setRefundCreateReq(obj1);
AlitripFlightRefundCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_flight_refund_create_response>
    <is_success>true</is_success>
    <refund_result_list>
        <refund_create_result>
            <refund_group_key>PEK-HKG-MU3435</refund_group_key>
            <is_success>true</is_success>
        </refund_create_result>
    </refund_result_list>
    <error_code_info>SYSTEM_ERROR</error_code_info>
    <error_msg>系统失败</error_msg>
</alitrip_flight_refund_create_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

返回
顶部