文档中心 > API类目 > 酒店线下信用住API

taobao.xhotel.order.offline.settle.put (线下信用住结账专用接口)

线下信用住结账专用接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tid Number 特殊可选 123 淘宝订单id,必须填写
total_room_fee Number 必须 12 房费总额(必须大于0)
other_fee Number 必须 2 杂费总额(不能为负数)
other_fee_detail String 可选 {"洗衣费":5000,"水吧":10000,"优惠":1000} 杂费明细,如果otherFee>0则该字段必须设置,并和杂费金额相吻合
out_id String 特殊可选 r123456 商家订单号
room_no String 可选 eee 入住房间号
daily_price_info String 可选 [{"day":"2015-08-12","price":48800},{"day":"2015-08-13","price":48800}] 每日房价,json格式,如果房价和在阿里旅行下单时发生了变化,必须设置该字段.用于更新阿里旅行端的房价信息,涉及到对用户的优惠信息处理等环节(多间房的时候dailyPriceInfo留空)
check_out Date 必须 2015-08-10 00:00:00 实际离店日期,用于校验总房费收取
memo String 可选 "客人要求提前离店" 备注
room_settle_info_list RoomSettleInfo [] 可选
  • 最大列表长度:20
  • 房间明细列表
    • └ room_no
    • String
    • 可选
    • 123
    • 房间号
    • └ room_fee
    • Number
    • 可选
    • 3
    • 房间费(大于零)
    • └ room_other_fee
    • Number
    • 可选
    • 3
    • 房间杂费(不能为负数)
    • └ room_other_fee_detail
    • String
    • 可选
    • {"洗衣费":5000,"水吧":10000,"优惠":1000}
    • 房间杂费明细 (当房间杂费存在时候,此值不能空。格式与原有杂费格式otherFeeDetail的格式相同)eg;{"洗衣费":5000,"水吧":10000,"优惠":1000}
    • └ room_check_in
    • Date
    • 可选
    • 2015-08-10 00:00:00
    • 房间check in 时间
    • └ room_check_out
    • Date
    • 可选
    • 2015-08-11 00:00:00
    • 房间check out时间
    • └ daily_price_info
    • String
    • 可选
    • [{"day":"2015-08-12","price":48800},{"day":"2015-08-13","price":48800}]
    • 日历价格(每个房间的日历价格,多间房结账必填)
    • └ room_status
    • String
    • 可选
    • 3
    • 房间状态;1:未入住(担保且需扣款);2:取消成功(卖家取消;担保noshow且双方协商一致不扣款);3:已入住
    contain_guarantee Number 可选 1 此金额是否包含担保金 0:默认值无意义;1:包含;2:不包含(多间房结账必须传入)
    out_uuid String 可选 333333 结账请求流水号
    notify_url String 可选 http://www.xxx.com 请求结果通知地址(暂时无效,无需传入)
    amount Number 可选 100 应收金额,大于0时,直接按照此金额扣款,忽略房费和杂费金额(单位分)
    hotel_code String 可选 SADFA 商家酒店编码
    vendor String 可选 taobao
  • 默认值:taobao
  • 系统商标识

    响应参数

    名称 类型 示例值 描述
    result String success 返回描述

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelOrderOfflineSettlePutRequest req = new XhotelOrderOfflineSettlePutRequest();
    req.setTid(123L);
    req.setTotalRoomFee(12L);
    req.setOtherFee(2L);
    req.setOtherFeeDetail("{\"洗衣费\":5000,\"水吧\":10000,\"优惠\":1000}");
    req.setOutId("r123456");
    req.setRoomNo("eee");
    req.setDailyPriceInfo("[{\"day\":\"2015-08-12\",\"price\":48800},{\"day\":\"2015-08-13\",\"price\":48800}]");
    req.setCheckOut(StringUtils.parseDateTime("2015-08-10 00:00:00"));
    req.setMemo("\"客人要求提前离店\"");
    List<XhotelOrderOfflineSettlePutRequest.RoomSettleInfo> list2 = new ArrayList<XhotelOrderOfflineSettlePutRequest.RoomSettleInfo>();
    XhotelOrderOfflineSettlePutRequest.RoomSettleInfo obj3 = new XhotelOrderOfflineSettlePutRequest.RoomSettleInfo();
    list2.add(obj3);
    obj3.setRoomNo("123");
    obj3.setRoomFee(3L);
    obj3.setRoomOtherFee(3L);
    obj3.setRoomOtherFeeDetail("{\"洗衣费\":5000,\"水吧\":10000,\"优惠\":1000}");
    obj3.setRoomCheckIn(StringUtils.parseDateTime("2015-08-10 00:00:00"));
    obj3.setRoomCheckOut(StringUtils.parseDateTime("2015-08-11 00:00:00"));
    obj3.setDailyPriceInfo("[{\"day\":\"2015-08-12\",\"price\":48800},{\"day\":\"2015-08-13\",\"price\":48800}]");
    obj3.setRoomStatus("3");
    req.setRoomSettleInfoList(list2);
    req.setContainGuarantee(1L);
    req.setOutUuid("333333");
    req.setNotifyUrl("http://www.xxx.com");
    req.setAmount(100L);
    req.setHotelCode("SADFA");
    req.setVendor("taobao");
    XhotelOrderOfflineSettlePutResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_order_offline_settle_put_response>
        <result>success</result>
    </xhotel_order_offline_settle_put_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

    返回
    顶部