文档中心 > API类目 > 欢行开发平台API

alibaba.happytrip.hotel.order.cancel.result.notify (服务商退订同步)

客人线下联系服务商进行整单退订、提前离店或者规则外退订时,服务商完成服务后,调用本接口同步退订结果到平台

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
assis_cancel_result_notify_dto AssisCancelResultNotifyDTO 可选 请求实体
  • guest_info_list
  • GuestInfoDTO []
  • 可选
  • []
  • 入住人信息列表(部分取消必传)
  • └ person_name
  • String
  • 可选
  • 张三
  • 入住人姓名
  • └ staff_no
  • String
  • 可选
  • 091103
  • 入住人员工编号
  • └ room_person_type
  • Number
  • 可选
  • 1
  • 入住类型(1:实际入住人;2:拼房人 ),拼房场景下必填
  • └ room_index
  • Number
  • 可选
  • 1
  • 房间编号(编号相同代表同一房间)
  • └ check_out_date
  • String
  • 可选
  • 1
  • 取消结束时间,部分取消必传:yyyy-MM-dd
  • └ order_id
  • String
  • 必须
  • 1122334aa
  • 接口订单号
  • └ cancel_room_count
  • Number
  • 可选
  • 1
  • 取消间数(部分取消必传)
  • └ cancel_type
  • Number
  • 必须
  • 1
  • 退订类型: 1:整单取消 2:部分取消
  • └ refund_room_fee
  • String
  • 可选
  • 100.00
  • 退款房费总金额(取消成功必传,退订罚金、退款房费总金额必传其一)
  • └ top_app_key
  • String
  • 可选
  • 111222
  • appkey
  • └ cancel_reason
  • String
  • 可选
  • 太远了
  • 取消原因
  • └ check_in_date
  • String
  • 可选
  • 2023-02-01
  • 取消开始时间,部分取消必传:yyyy-MM-dd
  • └ plat_order_id
  • String
  • 可选
  • 1122334
  • 平台订单号
  • └ cancel_fine
  • String
  • 可选
  • 100.00
  • 退订罚金(取消成功必传,退订罚金、退款房费总金额必传其一)
  • └ service_fee
  • String
  • 可选
  • 100.00
  • 服务费退款金额
  • └ complain_type
  • String []
  • 可选
  • [COMPLAIN_NOTIFY]
  • 投诉类型,枚举,数组;COMPLAIN_NOTIFY(投诉回执)、COMPENSATE_PERSON (赔付个人)、CANCEL_REFUND(协调取消)
  • └ complain_no
  • String []
  • 可选
  • 11123213312
  • 投诉单号
  • └ complain_content
  • String
  • 可选
  • 投诉处理完成
  • 投诉处理结果描述
  • └ complain_amount
  • BigDecimal
  • 可选
  • 100
  • 赔付金额

响应参数

名称 类型 示例值 描述
err_no String 11223 错误码
stack_trace String null 错误栈
content OrderRefundNotifyResultDTO test 返回实体
  • └ result
  • Number
  • 1
  • 0:退订失败 1:退订成功
  • └ fail_msg
  • String
  • error
  • 退订失败原因
  • └ order_id
  • String
  • 1122334
  • 接口订单号
  • └ plat_reverse_order_id
  • String
  • 1122334
  • 平台退单号
  • └ cancel_fine
  • BigDecimal
  • 1.00
  • 退订罚金
  • └ refund_room_fee
  • BigDecimal
  • 1.00
  • 退款房费总金额(取消成功必传)
  • └ company_adv_fee
  • BigDecimal
  • 1.00
  • 企业支付退款金额(包含服务费)
  • └ person_pay_fee
  • BigDecimal
  • 1.00
  • 个人支付退款金额
  • └ service_fee
  • BigDecimal
  • 1.00
  • 服务费退款金额
is_success Boolean true 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaHappytripHotelOrderCancelResultNotifyRequest req = new AlibabaHappytripHotelOrderCancelResultNotifyRequest();
AlibabaHappytripHotelOrderCancelResultNotifyRequest.AssisCancelResultNotifyDTO obj1 = new AlibabaHappytripHotelOrderCancelResultNotifyRequest.AssisCancelResultNotifyDTO();
List<AlibabaHappytripHotelOrderCancelResultNotifyRequest.GuestInfoDTO> list3 = new ArrayList<AlibabaHappytripHotelOrderCancelResultNotifyRequest.GuestInfoDTO>();
AlibabaHappytripHotelOrderCancelResultNotifyRequest.GuestInfoDTO obj4 = new AlibabaHappytripHotelOrderCancelResultNotifyRequest.GuestInfoDTO();
list3.add(obj4);
obj4.setPersonName("张三");
obj4.setStaffNo("091103");
obj4.setRoomPersonType(1L);
obj4.setRoomIndex(1L);
obj1.setGuestInfoList(list3);
obj1.setCheckOutDate("1");
obj1.setOrderId("1122334aa");
obj1.setCancelRoomCount(1L);
obj1.setCancelType(1L);
obj1.setRefundRoomFee("100.00");
obj1.setTopAppKey("111222");
obj1.setCancelReason("太远了");
obj1.setCheckInDate("2023-02-01");
obj1.setPlatOrderId("1122334");
obj1.setCancelFine("100.00");
obj1.setServiceFee("100.00");
obj1.setComplainType("COMPLAIN_NOTIFY");
obj1.setComplainNo("11123213312");
obj1.setComplainContent("投诉处理完成");
obj1.setComplainAmount("100");
req.setAssisCancelResultNotifyDto(obj1);
AlibabaHappytripHotelOrderCancelResultNotifyResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_happytrip_hotel_order_cancel_result_notify_response>
    <err_no>11223</err_no>
    <stack_trace>null</stack_trace>
    <content>
        <result>1</result>
        <fail_msg>error</fail_msg>
        <order_id>1122334</order_id>
        <plat_reverse_order_id>1122334</plat_reverse_order_id>
        <cancel_fine>1.00</cancel_fine>
        <refund_room_fee>1.00</refund_room_fee>
        <company_adv_fee>1.00</company_adv_fee>
        <person_pay_fee>1.00</person_pay_fee>
        <service_fee>1.00</service_fee>
    </content>
    <is_success>true</is_success>
</alibaba_happytrip_hotel_order_cancel_result_notify_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

返回
顶部