淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
flight_refund_request	FlightRefundRequest	可选			退票对象
refund_applys FlightRefundApplyDto [] 可选退票申请单对象 └ account_ou_code String 可选 A55 financeInfo中的accountOuCode └ bu_code String 可选 AD financeInfo中的buCode └ buyer_xuser_employee_no String 可选 123123 操作人工号 └ buyer_xuser_id Number 可选 123213 操作人欢行用户id └ buyer_xuser_name String 可选管亥操作人姓名 └ costcenter_code String 可选成本中心code financeInfo中的costcenterCode └ current_status String 可选已退票退票单状态 └ fin_region_code String 可选财务区域 financeInfo中的finRegionCode └ item_id String 可选 itemid 供应商预定订单回传时的itemId，保持和预定一样 └ online_flag Number 可选 1 线上线下标记0线下 1线上 └ ou_code String 可选 A51 financeInfo中的ouCode └ out_apply_id String 可选 00123213213 供应商退票单号 └ out_order_id String 可选 123213asdsa 供应商预定订单号 └ payment_ou_code String 可选 A50 financeInfo中的paymentOuCode └ project_code String 可选项目段 financeInfo中的projectCode └ quality_check_flag String 可选 y QC标记，y,n └ tes_head_id Number 可选 23423424 欢行差旅单id └ tes_line_id Number 可选 123123213 欢行差旅单行程行id └ total_airline_refund_service_amount String 可选 100.00 退票航司收取的总服务费 └ total_refund_amount String 可选 600.00 总退还给用户的金额=refundTicketAmount+refundTaxAmount+refundOilAmount+refundUpgradeAmount+refundAirlineRiseServiceAmount └ total_refund_amount_currency_code String 可选 CNY 币种 └ total_refund_amount_decimal_places String 可选 2 金额小数点位数 └ refund_reason_code String 可选 G cwt退票原因编码 └ refund_reason_describe String 可选因航班取消或延误导致改签，费用无需差旅人承担 cwt退票原因描述 refund_books FlightBookDto [] 可选退票关联对象 └ big_pnr String 可选 ABC12 航司大编 └ book_type String 可选 book 预定记录类型，book,rise └ flight_segment_state String 可选 open for use 航段状态，open for use,used └ out_origin_book_id String 可选 12321321 被退的bookId，也就是对应出票改升的bookId └ out_refund_apply_id String 可选 12312312 供应商本次退票对应的退票申请单ID └ out_refund_book_id String 可选 12312313 供应商本次退票生成的bookId └ out_refund_fee_id String 可选 123123 供应商本次退票的费用id，FlightRefundFeeDto对象的outRefundFeeId └ out_refund_flight_id String 可选 123213 供应商本次退票的flight_id，ResourceFlightDto的flight_id └ out_refund_ticket_id String 可选 123213 供应商本次退票的ticket_id,FlightTicketDto的ticket_id └ pnr String 可选 BVC12 航信小编 └ tourist_id String 可选 123123 出行人id,tourist对象的outPassengerId refund_fees FlightRefundFeeDto [] 可选退票费用对象 └ airline_refund_service_amount String 可选 200.00 航司收取用户的退票手续费 └ out_refund_apply_id String 可选 00123213213 供应商本次退票单号，refundApplys的out_apply_id └ out_refund_fee_id String 可选 123123 供应商本次退票的费用id └ refund_airline_rise_service_amount String 可选 23.65 退还给用户的改升航司服务费 └ refund_oil_amount String 可选 50.00 退还的燃油费用 └ refund_tax_amount String 可选 1000.00 退还给用户的税（不含燃油），国内是机建 └ refund_ticket_amount String 可选 500.00 退还给用户的票差金额 └ refund_upgrade_amount String 可选 100.00 退还给用户的升舱费 └ total_refund_amount String 可选 1950.00 总退还给用户的金额=refundTicketAmount+refundTaxAmount+refundOilAmount+refundUpgradeAmount+refundAirlineRiseServiceAmount refund_flights ResourceFlightDto [] 可选航班信息 └ airline_code String 可选 MU 实际承运航司编码 └ airline_name String 可选中国东方航空实际承运航司名称 └ arrival_country_code String 可选 CN 目的地国家码 └ arrival_country_name String 可选中国目的地国家名称 └ arrival_state_code String 可选 320000 目的地省/州代码，没有留空 └ arrival_state_name String 可选江苏省目的地省/州名称 └ arrival_terminal String 可选 T1 目的地航站楼 └ arrive_airport_code String 可选 NKG 目的地机场三字码 └ arrive_airport_name String 可选南京禄口机场目的地机场名称 └ arrive_city_code String 可选 NKG 目的地城市三字码 └ arrive_city_name String 可选南京目的地城市名称 └ arrive_date String 可选 2019-08-19 到达日期 └ arrive_datetime String 可选 2019-08-19 16:40:00 到达日期时间 └ arrive_day_of_week String 可选 WE 到达日期的周几，MO\TU\WE\TH\FR\SA\SU └ arrive_time String 可选 16:40 到达时间 └ arrive_transfer_flag String 可选 y 是否为中转点 └ arrive_transfer_info String 可选停留时间2小时45分钟中转描述 └ baggage String 可选 demo 行李额信息，业务不适用不传 └ cabin_class_code String 可选 Y 舱等代码，Y,C,F，业务不适用不传 └ cabin_code String 可选 M 舱位代码，A,M,K,U,H等，业务不适用不传 └ cabin_code_desc String 可选经济舱舱位等级描述，业务不适用不传 └ departure_airport_code String 可选 PEK 出发机场三字码 └ departure_airport_name String 可选北京首都机场出发机场名称 └ departure_city_code String 可选 BJS 出发城市三字码 └ departure_city_name String 可选北京出发城市名称 └ departure_country_code String 可选 CN 出发国家码 └ departure_country_name String 可选中国出发国家名称 └ departure_date String 可选 2019-08-19 出发日期 └ departure_datetime String 可选 2019-08-19 16:40:00 出发日期时间 └ departure_day_of_week String 可选 SU 出发日期在一周的周几，MO\TU\WE\TH\FR\SA\SU └ departure_state_code String 可选 110000 出发省/州代码（没有留空） └ departure_state_name String 可选北京出发省/州名称 └ departure_terminal String 可选 T1 出发航站楼 └ departure_time String 可选 18:40 出发时间 └ distance String 可选 1200 飞行距离（公里） └ duration String 可选 120 飞行时长 └ flight_id String 可选 12312321 供应商本次退票的航班Id └ flight_num String 可选 MU1701 航班号（带航司二字码） └ flight_num_without_airlinecode String 可选 1701 航班号（没有航司二字码） └ item_id String 可选 123123123 供应商预定订单回传时的itemId，保持和预定一样 └ journey_number Number 可选 1 行程序号 └ meal String 可选 y 餐食信息，y,n └ memo String 可选 demo 航班备注 └ out_origin_flight_id String 可选 123213 供应商本次退票，被退票的原始的flight_id └ out_refund_apply_id String 可选 123213123 供应商本次退票的申请单id，FlightRefundApplyDto对象的outApplyId └ plane_type String 可选 737-MAX 机型 └ segment_type String 可选 G 航段类型，G-去程,B-回程,M-多程 └ share_airline_code String 可选 CA 共享航司2字码 └ share_airline_name String 可选中国南方航空共享航司名称 └ share_flag String 可选 nonshared 是否共享航班,share,nonshared └ share_flight_num String 可选 CA130 共享航班号（带航司二字码） └ share_flight_num_without_airlinecode String 可选 130 共享航班号（没有航司二字码） └ stop_airport_code String 可选 TSN 经停机场代码 └ stop_airport_name String 可选天津滨海国际机场经停机场名称 └ stop_arrive_datetime String 可选 2019-08-19 15:40:00 经停到达时间 └ stop_city_code String 可选 TSN 经停城市代码 └ stop_city_name String 可选天津经停城市名称 └ stop_departure_datetime String 可选 2019-08-19 15:50:00 经停起飞时间 └ stop_flag String 可选 n 经停标记，y,n └ tes_head_id Number 可选 123123123 差旅单号 └ tes_line_id Number 可选 23443435 差旅单行程id └ trip_type String 可选 domestic 旅行类型，国内-domestic，洲内- continent，洲际-intercontinental，港澳台-HongKongMacaoAndTaiWan └ segment_num Number 可选 1 航段序号 refund_tickets FlightTicketDto [] 可选机票客票对象 └ airline_union String 可选星空SA 航司联盟，天合ST，寰宇OW，星空SA，其它0 └ fee_id String 可选 123123 供应商退票机票价格id，FlightRefundFeeDto对象的outRefundFeeId └ issue_ticket_by_book_or_rise String 可选 book 客票创建的时刻,book,rise └ item_id String 可选 itemid 供应商预定订单回传时的itemId，保持和预定一样 └ office_id String 可选 123213123 office号 └ out_origin_ticket_id String 可选 123213 供应商本次退票，被退的客票的原始ticket_id └ out_refund_apply_id String 可选 123123213 供应商退票申请单ID └ sell_ticket_country_code String 可选 CN 售卖国代码 └ supplier_service_amount1 String 可选 20.00 供应商费用1 └ supplier_service_amount1_type String 可选出票手续费供应商费用1类型 └ supplier_service_amount2 String 可选 20.00 供应商费用2 └ supplier_service_amount2_type String 可选紧急服务费供应商费用2类型 └ supplier_service_total_amount String 可选 40.00 总服务费金额 └ tes_head_id Number 可选 12213123 差旅单号 └ tes_line_id Number 可选 12312321 差旅单行程号 └ ticket_code String 可选 999-123123123 票号 └ ticket_direct String 可选自开出票指向-自开，境内派单，跨境采购 └ ticket_id String 可选 123123123 供应商退票ticketId └ ticket_out_duration String 可选 30 出票时长 └ ticket_out_duration_type String 可选 afterpay 出票时长类型，支付后-afterpay,起飞前- beforetakeoff └ ticket_out_duration_unit String 可选 minute 出票时长单位，hour,minute └ ticket_out_time String 可选 2019-08-11 14:00:30 真正的出票时间 └ ticket_state String 可选已出票客票状态 └ ticketing_carrier String 可选 MU 出票航司2字码 └ ticketing_country_code String 可选 CN 出票国家码 └ tour_code String 可选 demo 大客履约，大客户编码 tourists PeopleTouristDto [] 可选出行人对象 └ birthday String 可选 1981-11-11 出行人生日 └ cert_nation String 可选中国证件签发国 └ cert_num String 可选 123213213 证件号码 └ cert_type Number 可选 0 证件类型，0-身份证，1护照 └ cert_valid_date Date 可选 2022-12-12 00:00:00 证件有效期 └ email String 可选 xxx@ali.com 出行人邮箱 └ employee_id String 可选 111111 阿里出行人工号 └ first_name String 可选亥名 └ happy_bean_amount String 可选 20 欢豆额 └ ht_user_id Number 可选 123213 阿里出行人欢行用户id └ ht_user_id_memo String 可选没有留空阿里出行人欢行用户id备注，空时备注 └ last_name String 可选管姓 └ name String 可选管亥姓名 └ nationality String 可选中国国籍 └ out_passenger_id String 可选 1233456 供应商系统出行人id └ sex Number 可选 1 性别,1-男，2-女 └ taobao_nick String 可选 asd 淘宝昵称 └ tes_head_id Number 可选 123213123 阿里差旅单id └ tes_line_id Number 可选 12321312 阿里差旅单行程id └ tourist_type Number 可选 0 出行人类型，0-成人，1-儿童，2-婴儿 └ travel_business_type Number 可选 0 旅行商业类型，0-出行人，1-同行人，2 外部人员

名称	类型	示例值	描述
result	ResultDto		异步获取历史数据接口返回结果
└ content String success 响应的描述，一般是正常情况下返回的一些信息，主要是一些描述，不作为判断依据 └ errcode String 错误码 └ errmsg String 系统自动生成 └ stack_trace String 异常堆栈不出错情况下不会有 └ success Boolean true 执行结果

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaHappytripFlightOrderRefundPostbackRequest req = new AlibabaHappytripFlightOrderRefundPostbackRequest();
AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundRequest obj1 = new AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundRequest();
List<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundApplyDto> list3 = new ArrayList<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundApplyDto>();
AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundApplyDto obj4 = new AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundApplyDto();
list3.add(obj4);
obj4.setAccountOuCode("A55");
obj4.setBuCode("AD");
obj4.setBuyerXuserEmployeeNo("123123");
obj4.setBuyerXuserId(123213L);
obj4.setBuyerXuserName("管亥");
obj4.setCostcenterCode("成本中心code");
obj4.setCurrentStatus("已退票");
obj4.setFinRegionCode("财务区域");
obj4.setItemId("itemid");
obj4.setOnlineFlag(1L);
obj4.setOuCode("A51");
obj4.setOutApplyId("00123213213");
obj4.setOutOrderId("123213asdsa");
obj4.setPaymentOuCode("A50");
obj4.setProjectCode("项目段");
obj4.setQualityCheckFlag("y");
obj4.setTesHeadId(23423424L);
obj4.setTesLineId(123123213L);
obj4.setTotalAirlineRefundServiceAmount("100.00");
obj4.setTotalRefundAmount("600.00");
obj4.setTotalRefundAmountCurrencyCode("CNY");
obj4.setTotalRefundAmountDecimalPlaces("2");
obj4.setRefundReasonCode("G");
obj4.setRefundReasonDescribe("因航班取消或延误导致改签，费用无需差旅人承担");
obj1.setRefundApplys(list3);
List<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightBookDto> list6 = new ArrayList<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightBookDto>();
AlibabaHappytripFlightOrderRefundPostbackRequest.FlightBookDto obj7 = new AlibabaHappytripFlightOrderRefundPostbackRequest.FlightBookDto();
list6.add(obj7);
obj7.setBigPnr("ABC12");
obj7.setBookType("book");
obj7.setFlightSegmentState("open for use");
obj7.setOutOriginBookId("12321321");
obj7.setOutRefundApplyId("12312312");
obj7.setOutRefundBookId("12312313");
obj7.setOutRefundFeeId("123123");
obj7.setOutRefundFlightId("123213");
obj7.setOutRefundTicketId("123213");
obj7.setPnr("BVC12");
obj7.setTouristId("123123");
obj1.setRefundBooks(list6);
List<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundFeeDto> list9 = new ArrayList<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundFeeDto>();
AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundFeeDto obj10 = new AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundFeeDto();
list9.add(obj10);
obj10.setAirlineRefundServiceAmount("200.00");
obj10.setOutRefundApplyId("00123213213");
obj10.setOutRefundFeeId("123123");
obj10.setRefundAirlineRiseServiceAmount("23.65");
obj10.setRefundOilAmount("50.00");
obj10.setRefundTaxAmount("1000.00");
obj10.setRefundTicketAmount("500.00");
obj10.setRefundUpgradeAmount("100.00");
obj10.setTotalRefundAmount("1950.00");
obj1.setRefundFees(list9);
List<AlibabaHappytripFlightOrderRefundPostbackRequest.ResourceFlightDto> list12 = new ArrayList<AlibabaHappytripFlightOrderRefundPostbackRequest.ResourceFlightDto>();
AlibabaHappytripFlightOrderRefundPostbackRequest.ResourceFlightDto obj13 = new AlibabaHappytripFlightOrderRefundPostbackRequest.ResourceFlightDto();
list12.add(obj13);
obj13.setAirlineCode("MU");
obj13.setAirlineName("中国东方航空");
obj13.setArrivalCountryCode("CN");
obj13.setArrivalCountryName("中国");
obj13.setArrivalStateCode("320000");
obj13.setArrivalStateName("江苏省");
obj13.setArrivalTerminal("T1");
obj13.setArriveAirportCode("NKG");
obj13.setArriveAirportName("南京禄口机场");
obj13.setArriveCityCode("NKG");
obj13.setArriveCityName("南京");
obj13.setArriveDate("2019-08-19");
obj13.setArriveDatetime("2019-08-19 16:40:00");
obj13.setArriveDayOfWeek("WE");
obj13.setArriveTime("16:40");
obj13.setArriveTransferFlag("y");
obj13.setArriveTransferInfo("停留时间2小时45分钟");
obj13.setBaggage("demo");
obj13.setCabinClassCode("Y");
obj13.setCabinCode("M");
obj13.setCabinCodeDesc("经济舱");
obj13.setDepartureAirportCode("PEK");
obj13.setDepartureAirportName("北京首都机场");
obj13.setDepartureCityCode("BJS");
obj13.setDepartureCityName("北京");
obj13.setDepartureCountryCode("CN");
obj13.setDepartureCountryName("中国");
obj13.setDepartureDate("2019-08-19");
obj13.setDepartureDatetime("2019-08-19 16:40:00");
obj13.setDepartureDayOfWeek("SU");
obj13.setDepartureStateCode("110000");
obj13.setDepartureStateName("北京");
obj13.setDepartureTerminal("T1");
obj13.setDepartureTime("18:40");
obj13.setDistance("1200");
obj13.setDuration("120");
obj13.setFlightId("12312321");
obj13.setFlightNum("MU1701");
obj13.setFlightNumWithoutAirlinecode("1701");
obj13.setItemId("123123123");
obj13.setJourneyNumber(1L);
obj13.setMeal("y");
obj13.setMemo("demo");
obj13.setOutOriginFlightId("123213");
obj13.setOutRefundApplyId("123213123");
obj13.setPlaneType("737-MAX");
obj13.setSegmentType("G");
obj13.setShareAirlineCode("CA");
obj13.setShareAirlineName("中国南方航空");
obj13.setShareFlag("nonshared");
obj13.setShareFlightNum("CA130");
obj13.setShareFlightNumWithoutAirlinecode("130");
obj13.setStopAirportCode("TSN");
obj13.setStopAirportName("天津滨海国际机场");
obj13.setStopArriveDatetime("2019-08-19 15:40:00");
obj13.setStopCityCode("TSN");
obj13.setStopCityName("天津");
obj13.setStopDepartureDatetime("2019-08-19 15:50:00");
obj13.setStopFlag("n");
obj13.setTesHeadId(123123123L);
obj13.setTesLineId(23443435L);
obj13.setTripType("domestic");
obj13.setSegmentNum(1L);
obj1.setRefundFlights(list12);
List<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightTicketDto> list15 = new ArrayList<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightTicketDto>();
AlibabaHappytripFlightOrderRefundPostbackRequest.FlightTicketDto obj16 = new AlibabaHappytripFlightOrderRefundPostbackRequest.FlightTicketDto();
list15.add(obj16);
obj16.setAirlineUnion("星空SA");
obj16.setFeeId("123123");
obj16.setIssueTicketByBookOrRise("book");
obj16.setItemId("itemid");
obj16.setOfficeId("123213123");
obj16.setOutOriginTicketId("123213");
obj16.setOutRefundApplyId("123123213");
obj16.setSellTicketCountryCode("CN");
obj16.setSupplierServiceAmount1("20.00");
obj16.setSupplierServiceAmount1Type("出票手续费");
obj16.setSupplierServiceAmount2("20.00");
obj16.setSupplierServiceAmount2Type("紧急服务费");
obj16.setSupplierServiceTotalAmount("40.00");
obj16.setTesHeadId(12213123L);
obj16.setTesLineId(12312321L);
obj16.setTicketCode("999-123123123");
obj16.setTicketDirect("自开");
obj16.setTicketId("123123123");
obj16.setTicketOutDuration("30");
obj16.setTicketOutDurationType("afterpay");
obj16.setTicketOutDurationUnit("minute");
obj16.setTicketOutTime("2019-08-11 14:00:30");
obj16.setTicketState("已出票");
obj16.setTicketingCarrier("MU");
obj16.setTicketingCountryCode("CN");
obj16.setTourCode("demo");
obj1.setRefundTickets(list15);
List<AlibabaHappytripFlightOrderRefundPostbackRequest.PeopleTouristDto> list18 = new ArrayList<AlibabaHappytripFlightOrderRefundPostbackRequest.PeopleTouristDto>();
AlibabaHappytripFlightOrderRefundPostbackRequest.PeopleTouristDto obj19 = new AlibabaHappytripFlightOrderRefundPostbackRequest.PeopleTouristDto();
list18.add(obj19);
obj19.setBirthday("1981-11-11");
obj19.setCertNation("中国");
obj19.setCertNum("123213213");
obj19.setCertType(0L);
obj19.setCertValidDate(StringUtils.parseDateTime("2022-12-12 00:00:00"));
obj19.setEmail("xxx@ali.com");
obj19.setEmployeeId("111111");
obj19.setFirstName("亥");
obj19.setHappyBeanAmount("20");
obj19.setHtUserId(123213L);
obj19.setHtUserIdMemo("没有留空");
obj19.setLastName("管");
obj19.setName("管亥");
obj19.setNationality("中国");
obj19.setOutPassengerId("1233456");
obj19.setSex(1L);
obj19.setTaobaoNick("asd");
obj19.setTesHeadId(123213123L);
obj19.setTesLineId(12321312L);
obj19.setTouristType(0L);
obj19.setTravelBusinessType(0L);
obj1.setTourists(list18);
req.setFlightRefundRequest(obj1);
AlibabaHappytripFlightOrderRefundPostbackResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaHappytripFlightOrderRefundPostbackRequest req = new AlibabaHappytripFlightOrderRefundPostbackRequest();
AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundRequestDomain obj1 = new AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundRequestDomain();
List<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundApplyDtoDomain> list3 = new List<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundApplyDtoDomain>();
AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundApplyDtoDomain obj4 = new AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundApplyDtoDomain();
list3.Add(obj4);
obj4.AccountOuCode = "A55";
obj4.BuCode = "AD";
obj4.BuyerXuserEmployeeNo = "123123";
obj4.BuyerXuserId = 123213L;
obj4.BuyerXuserName = "管亥";
obj4.CostcenterCode = "成本中心code";
obj4.CurrentStatus = "已退票";
obj4.FinRegionCode = "财务区域";
obj4.ItemId = "itemid";
obj4.OnlineFlag = 1L;
obj4.OuCode = "A51";
obj4.OutApplyId = "00123213213";
obj4.OutOrderId = "123213asdsa";
obj4.PaymentOuCode = "A50";
obj4.ProjectCode = "项目段";
obj4.QualityCheckFlag = "y";
obj4.TesHeadId = 23423424L;
obj4.TesLineId = 123123213L;
obj4.TotalAirlineRefundServiceAmount = "100.00";
obj4.TotalRefundAmount = "600.00";
obj4.TotalRefundAmountCurrencyCode = "CNY";
obj4.TotalRefundAmountDecimalPlaces = "2";
obj4.RefundReasonCode = "G";
obj4.RefundReasonDescribe = "因航班取消或延误导致改签，费用无需差旅人承担";
obj1.RefundApplys= list3;
List<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightBookDtoDomain> list6 = new List<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightBookDtoDomain>();
AlibabaHappytripFlightOrderRefundPostbackRequest.FlightBookDtoDomain obj7 = new AlibabaHappytripFlightOrderRefundPostbackRequest.FlightBookDtoDomain();
list6.Add(obj7);
obj7.BigPnr = "ABC12";
obj7.BookType = "book";
obj7.FlightSegmentState = "open for use";
obj7.OutOriginBookId = "12321321";
obj7.OutRefundApplyId = "12312312";
obj7.OutRefundBookId = "12312313";
obj7.OutRefundFeeId = "123123";
obj7.OutRefundFlightId = "123213";
obj7.OutRefundTicketId = "123213";
obj7.Pnr = "BVC12";
obj7.TouristId = "123123";
obj1.RefundBooks= list6;
List<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundFeeDtoDomain> list9 = new List<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundFeeDtoDomain>();
AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundFeeDtoDomain obj10 = new AlibabaHappytripFlightOrderRefundPostbackRequest.FlightRefundFeeDtoDomain();
list9.Add(obj10);
obj10.AirlineRefundServiceAmount = "200.00";
obj10.OutRefundApplyId = "00123213213";
obj10.OutRefundFeeId = "123123";
obj10.RefundAirlineRiseServiceAmount = "23.65";
obj10.RefundOilAmount = "50.00";
obj10.RefundTaxAmount = "1000.00";
obj10.RefundTicketAmount = "500.00";
obj10.RefundUpgradeAmount = "100.00";
obj10.TotalRefundAmount = "1950.00";
obj1.RefundFees= list9;
List<AlibabaHappytripFlightOrderRefundPostbackRequest.ResourceFlightDtoDomain> list12 = new List<AlibabaHappytripFlightOrderRefundPostbackRequest.ResourceFlightDtoDomain>();
AlibabaHappytripFlightOrderRefundPostbackRequest.ResourceFlightDtoDomain obj13 = new AlibabaHappytripFlightOrderRefundPostbackRequest.ResourceFlightDtoDomain();
list12.Add(obj13);
obj13.AirlineCode = "MU";
obj13.AirlineName = "中国东方航空";
obj13.ArrivalCountryCode = "CN";
obj13.ArrivalCountryName = "中国";
obj13.ArrivalStateCode = "320000";
obj13.ArrivalStateName = "江苏省";
obj13.ArrivalTerminal = "T1";
obj13.ArriveAirportCode = "NKG";
obj13.ArriveAirportName = "南京禄口机场";
obj13.ArriveCityCode = "NKG";
obj13.ArriveCityName = "南京";
obj13.ArriveDate = "2019-08-19";
obj13.ArriveDatetime = "2019-08-19 16:40:00";
obj13.ArriveDayOfWeek = "WE";
obj13.ArriveTime = "16:40";
obj13.ArriveTransferFlag = "y";
obj13.ArriveTransferInfo = "停留时间2小时45分钟";
obj13.Baggage = "demo";
obj13.CabinClassCode = "Y";
obj13.CabinCode = "M";
obj13.CabinCodeDesc = "经济舱";
obj13.DepartureAirportCode = "PEK";
obj13.DepartureAirportName = "北京首都机场";
obj13.DepartureCityCode = "BJS";
obj13.DepartureCityName = "北京";
obj13.DepartureCountryCode = "CN";
obj13.DepartureCountryName = "中国";
obj13.DepartureDate = "2019-08-19";
obj13.DepartureDatetime = "2019-08-19 16:40:00";
obj13.DepartureDayOfWeek = "SU";
obj13.DepartureStateCode = "110000";
obj13.DepartureStateName = "北京";
obj13.DepartureTerminal = "T1";
obj13.DepartureTime = "18:40";
obj13.Distance = "1200";
obj13.Duration = "120";
obj13.FlightId = "12312321";
obj13.FlightNum = "MU1701";
obj13.FlightNumWithoutAirlinecode = "1701";
obj13.ItemId = "123123123";
obj13.JourneyNumber = 1L;
obj13.Meal = "y";
obj13.Memo = "demo";
obj13.OutOriginFlightId = "123213";
obj13.OutRefundApplyId = "123213123";
obj13.PlaneType = "737-MAX";
obj13.SegmentType = "G";
obj13.ShareAirlineCode = "CA";
obj13.ShareAirlineName = "中国南方航空";
obj13.ShareFlag = "nonshared";
obj13.ShareFlightNum = "CA130";
obj13.ShareFlightNumWithoutAirlinecode = "130";
obj13.StopAirportCode = "TSN";
obj13.StopAirportName = "天津滨海国际机场";
obj13.StopArriveDatetime = "2019-08-19 15:40:00";
obj13.StopCityCode = "TSN";
obj13.StopCityName = "天津";
obj13.StopDepartureDatetime = "2019-08-19 15:50:00";
obj13.StopFlag = "n";
obj13.TesHeadId = 123123123L;
obj13.TesLineId = 23443435L;
obj13.TripType = "domestic";
obj13.SegmentNum = 1L;
obj1.RefundFlights= list12;
List<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightTicketDtoDomain> list15 = new List<AlibabaHappytripFlightOrderRefundPostbackRequest.FlightTicketDtoDomain>();
AlibabaHappytripFlightOrderRefundPostbackRequest.FlightTicketDtoDomain obj16 = new AlibabaHappytripFlightOrderRefundPostbackRequest.FlightTicketDtoDomain();
list15.Add(obj16);
obj16.AirlineUnion = "星空SA";
obj16.FeeId = "123123";
obj16.IssueTicketByBookOrRise = "book";
obj16.ItemId = "itemid";
obj16.OfficeId = "123213123";
obj16.OutOriginTicketId = "123213";
obj16.OutRefundApplyId = "123123213";
obj16.SellTicketCountryCode = "CN";
obj16.SupplierServiceAmount1 = "20.00";
obj16.SupplierServiceAmount1Type = "出票手续费";
obj16.SupplierServiceAmount2 = "20.00";
obj16.SupplierServiceAmount2Type = "紧急服务费";
obj16.SupplierServiceTotalAmount = "40.00";
obj16.TesHeadId = 12213123L;
obj16.TesLineId = 12312321L;
obj16.TicketCode = "999-123123123";
obj16.TicketDirect = "自开";
obj16.TicketId = "123123123";
obj16.TicketOutDuration = "30";
obj16.TicketOutDurationType = "afterpay";
obj16.TicketOutDurationUnit = "minute";
obj16.TicketOutTime = "2019-08-11 14:00:30";
obj16.TicketState = "已出票";
obj16.TicketingCarrier = "MU";
obj16.TicketingCountryCode = "CN";
obj16.TourCode = "demo";
obj1.RefundTickets= list15;
List<AlibabaHappytripFlightOrderRefundPostbackRequest.PeopleTouristDtoDomain> list18 = new List<AlibabaHappytripFlightOrderRefundPostbackRequest.PeopleTouristDtoDomain>();
AlibabaHappytripFlightOrderRefundPostbackRequest.PeopleTouristDtoDomain obj19 = new AlibabaHappytripFlightOrderRefundPostbackRequest.PeopleTouristDtoDomain();
list18.Add(obj19);
obj19.Birthday = "1981-11-11";
obj19.CertNation = "中国";
obj19.CertNum = "123213213";
obj19.CertType = 0L;
obj19.CertValidDate = DateTime.Parse(2022-12-12 00:00:00");
obj19.Email = "xxx@ali.com";
obj19.EmployeeId = "111111";
obj19.FirstName = "亥";
obj19.HappyBeanAmount = "20";
obj19.HtUserId = 123213L;
obj19.HtUserIdMemo = "没有留空";
obj19.LastName = "管";
obj19.Name = "管亥";
obj19.Nationality = "中国";
obj19.OutPassengerId = "1233456";
obj19.Sex = 1L;
obj19.TaobaoNick = "asd";
obj19.TesHeadId = 123213123L;
obj19.TesLineId = 12321312L;
obj19.TouristType = 0L;
obj19.TravelBusinessType = 0L;
obj1.Tourists= list18;
req.FlightRefundRequest_ = obj1;
AlibabaHappytripFlightOrderRefundPostbackResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaHappytripFlightOrderRefundPostbackRequest;
$flight_refund_request = new FlightRefundRequest;
$refund_applys = new FlightRefundApplyDto;
$refund_applys->account_ou_code="A55";
$refund_applys->bu_code="AD";
$refund_applys->buyer_xuser_employee_no="123123";
$refund_applys->buyer_xuser_id="123213";
$refund_applys->buyer_xuser_name="管亥";
$refund_applys->costcenter_code="成本中心code";
$refund_applys->current_status="已退票";
$refund_applys->fin_region_code="财务区域";
$refund_applys->item_id="itemid";
$refund_applys->online_flag="1";
$refund_applys->ou_code="A51";
$refund_applys->out_apply_id="00123213213";
$refund_applys->out_order_id="123213asdsa";
$refund_applys->payment_ou_code="A50";
$refund_applys->project_code="项目段";
$refund_applys->quality_check_flag="y";
$refund_applys->tes_head_id="23423424";
$refund_applys->tes_line_id="123123213";
$refund_applys->total_airline_refund_service_amount="100.00";
$refund_applys->total_refund_amount="600.00";
$refund_applys->total_refund_amount_currency_code="CNY";
$refund_applys->total_refund_amount_decimal_places="2";
$refund_applys->refund_reason_code="G";
$refund_applys->refund_reason_describe="因航班取消或延误导致改签，费用无需差旅人承担";
$flight_refund_request->refund_applys = $refund_applys;
$refund_books = new FlightBookDto;
$refund_books->big_pnr="ABC12";
$refund_books->book_type="book";
$refund_books->flight_segment_state="open for use";
$refund_books->out_origin_book_id="12321321";
$refund_books->out_refund_apply_id="12312312";
$refund_books->out_refund_book_id="12312313";
$refund_books->out_refund_fee_id="123123";
$refund_books->out_refund_flight_id="123213";
$refund_books->out_refund_ticket_id="123213";
$refund_books->pnr="BVC12";
$refund_books->tourist_id="123123";
$flight_refund_request->refund_books = $refund_books;
$refund_fees = new FlightRefundFeeDto;
$refund_fees->airline_refund_service_amount="200.00";
$refund_fees->out_refund_apply_id="00123213213";
$refund_fees->out_refund_fee_id="123123";
$refund_fees->refund_airline_rise_service_amount="23.65";
$refund_fees->refund_oil_amount="50.00";
$refund_fees->refund_tax_amount="1000.00";
$refund_fees->refund_ticket_amount="500.00";
$refund_fees->refund_upgrade_amount="100.00";
$refund_fees->total_refund_amount="1950.00";
$flight_refund_request->refund_fees = $refund_fees;
$refund_flights = new ResourceFlightDto;
$refund_flights->airline_code="MU";
$refund_flights->airline_name="中国东方航空";
$refund_flights->arrival_country_code="CN";
$refund_flights->arrival_country_name="中国";
$refund_flights->arrival_state_code="320000";
$refund_flights->arrival_state_name="江苏省";
$refund_flights->arrival_terminal="T1";
$refund_flights->arrive_airport_code="NKG";
$refund_flights->arrive_airport_name="南京禄口机场";
$refund_flights->arrive_city_code="NKG";
$refund_flights->arrive_city_name="南京";
$refund_flights->arrive_date="2019-08-19";
$refund_flights->arrive_datetime="2019-08-19 16:40:00";
$refund_flights->arrive_day_of_week="WE";
$refund_flights->arrive_time="16:40";
$refund_flights->arrive_transfer_flag="y";
$refund_flights->arrive_transfer_info="停留时间2小时45分钟";
$refund_flights->baggage="demo";
$refund_flights->cabin_class_code="Y";
$refund_flights->cabin_code="M";
$refund_flights->cabin_code_desc="经济舱";
$refund_flights->departure_airport_code="PEK";
$refund_flights->departure_airport_name="北京首都机场";
$refund_flights->departure_city_code="BJS";
$refund_flights->departure_city_name="北京";
$refund_flights->departure_country_code="CN";
$refund_flights->departure_country_name="中国";
$refund_flights->departure_date="2019-08-19";
$refund_flights->departure_datetime="2019-08-19 16:40:00";
$refund_flights->departure_day_of_week="SU";
$refund_flights->departure_state_code="110000";
$refund_flights->departure_state_name="北京";
$refund_flights->departure_terminal="T1";
$refund_flights->departure_time="18:40";
$refund_flights->distance="1200";
$refund_flights->duration="120";
$refund_flights->flight_id="12312321";
$refund_flights->flight_num="MU1701";
$refund_flights->flight_num_without_airlinecode="1701";
$refund_flights->item_id="123123123";
$refund_flights->journey_number="1";
$refund_flights->meal="y";
$refund_flights->memo="demo";
$refund_flights->out_origin_flight_id="123213";
$refund_flights->out_refund_apply_id="123213123";
$refund_flights->plane_type="737-MAX";
$refund_flights->segment_type="G";
$refund_flights->share_airline_code="CA";
$refund_flights->share_airline_name="中国南方航空";
$refund_flights->share_flag="nonshared";
$refund_flights->share_flight_num="CA130";
$refund_flights->share_flight_num_without_airlinecode="130";
$refund_flights->stop_airport_code="TSN";
$refund_flights->stop_airport_name="天津滨海国际机场";
$refund_flights->stop_arrive_datetime="2019-08-19 15:40:00";
$refund_flights->stop_city_code="TSN";
$refund_flights->stop_city_name="天津";
$refund_flights->stop_departure_datetime="2019-08-19 15:50:00";
$refund_flights->stop_flag="n";
$refund_flights->tes_head_id="123123123";
$refund_flights->tes_line_id="23443435";
$refund_flights->trip_type="domestic";
$refund_flights->segment_num="1";
$flight_refund_request->refund_flights = $refund_flights;
$refund_tickets = new FlightTicketDto;
$refund_tickets->airline_union="星空SA";
$refund_tickets->fee_id="123123";
$refund_tickets->issue_ticket_by_book_or_rise="book";
$refund_tickets->item_id="itemid";
$refund_tickets->office_id="123213123";
$refund_tickets->out_origin_ticket_id="123213";
$refund_tickets->out_refund_apply_id="123123213";
$refund_tickets->sell_ticket_country_code="CN";
$refund_tickets->supplier_service_amount1="20.00";
$refund_tickets->supplier_service_amount1_type="出票手续费";
$refund_tickets->supplier_service_amount2="20.00";
$refund_tickets->supplier_service_amount2_type="紧急服务费";
$refund_tickets->supplier_service_total_amount="40.00";
$refund_tickets->tes_head_id="12213123";
$refund_tickets->tes_line_id="12312321";
$refund_tickets->ticket_code="999-123123123";
$refund_tickets->ticket_direct="自开";
$refund_tickets->ticket_id="123123123";
$refund_tickets->ticket_out_duration="30";
$refund_tickets->ticket_out_duration_type="afterpay";
$refund_tickets->ticket_out_duration_unit="minute";
$refund_tickets->ticket_out_time="2019-08-11 14:00:30";
$refund_tickets->ticket_state="已出票";
$refund_tickets->ticketing_carrier="MU";
$refund_tickets->ticketing_country_code="CN";
$refund_tickets->tour_code="demo";
$flight_refund_request->refund_tickets = $refund_tickets;
$tourists = new PeopleTouristDto;
$tourists->birthday="1981-11-11";
$tourists->cert_nation="中国";
$tourists->cert_num="123213213";
$tourists->cert_type="0";
$tourists->cert_valid_date="2022-12-12 00:00:00";
$tourists->email="xxx@ali.com";
$tourists->employee_id="111111";
$tourists->first_name="亥";
$tourists->happy_bean_amount="20";
$tourists->ht_user_id="123213";
$tourists->ht_user_id_memo="没有留空";
$tourists->last_name="管";
$tourists->name="管亥";
$tourists->nationality="中国";
$tourists->out_passenger_id="1233456";
$tourists->sex="1";
$tourists->taobao_nick="asd";
$tourists->tes_head_id="123213123";
$tourists->tes_line_id="12321312";
$tourists->tourist_type="0";
$tourists->travel_business_type="0";
$flight_refund_request->tourists = $tourists;
$req->setFlightRefundRequest(json_encode($flight_refund_request));
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.happytrip.flight.order.refund.postback' \
-d 'partner_id=apidoc' \
-d 'sign=23312ACF8086EFDEE7A08CC4D949D44C' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-02+22%3A38%3A20' \
-d 'v=2.0' \
-d 'flight_refund_request=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlibabaHappytripFlightOrderRefundPostbackRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.flight_refund_request=""
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.happytrip.flight.order.refund.postback");
add_param(pRequest,"flight_refund_request","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.happytrip.flight.order.refund.postback', {
	'flight_refund_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_happytrip_flight_order_refund_postback_response>
    <result>
        <content>success</content>
        <errcode></errcode>
        <errmsg></errmsg>
        <stack_trace>异常堆栈</stack_trace>
        <success>true</success>
    </result>
</alibaba_happytrip_flight_order_refund_postback_response>

{
    "alibaba_happytrip_flight_order_refund_postback_response":{
        "result":{
            "content":"success",
            "errcode":"",
            "errmsg":"",
            "stack_trace":"异常堆栈",
            "success":true
        }
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

欢行开发平台API

alibaba.happytrip.flight.order.refund.postback (机票退票信息回传)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ