文档中心 > API类目 > 酒店官网信用住API

taobao.xhotel.order.official.settle.put (官网信用住结账接口)

用于酒店官网信用住商家结账调用

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tid Number 特殊可选 1234565 淘宝订单id,必须填写
total_room_fee Number 必须 123 房费总额(必须大于0)
other_fee Number 必须 344 杂费总额(不能为负数)
other_fee_detail String 可选 {"洗衣费":5000,"水吧":10000,"优惠":1000} 杂费明细,如果otherFee>0则该字段必须设置,并和杂费金额相吻合
out_id String 特殊可选 3333 商家订单号
room_no String 可选 12e 入住房间号
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
    • 可选
    • 4
    • 房间费(大于零)
    • └ room_other_fee
    • Number
    • 可选
    • 2
    • 房间杂费(不能为负数)
    • └ 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 可选 33333333333 结账请求流水号
    notify_url String 可选 http://www.xxx.com 请求结果通知地址(暂时无效,无需传入)

    响应参数

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

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelOrderOfficialSettlePutRequest req = new XhotelOrderOfficialSettlePutRequest();
    req.setTid(1234565L);
    req.setTotalRoomFee(123L);
    req.setOtherFee(344L);
    req.setOtherFeeDetail("{\"洗衣费\":5000,\"水吧\":10000,\"优惠\":1000}");
    req.setOutId("3333");
    req.setRoomNo("12e");
    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<XhotelOrderOfficialSettlePutRequest.RoomSettleInfo> list2 = new ArrayList<XhotelOrderOfficialSettlePutRequest.RoomSettleInfo>();
    XhotelOrderOfficialSettlePutRequest.RoomSettleInfo obj3 = new XhotelOrderOfficialSettlePutRequest.RoomSettleInfo();
    list2.add(obj3);
    obj3.setRoomNo("123");
    obj3.setRoomFee(4L);
    obj3.setRoomOtherFee(2L);
    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("33333333333");
    req.setNotifyUrl("http://www.xxx.com");
    XhotelOrderOfficialSettlePutResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    1
    2
    3
    <xhotel_order_official_settle_put_response>
        <result>success</result>
    </xhotel_order_official_settle_put_response>

    异常示例

    • XML示例
    • JSON示例
    1
    2
    3
    4
    5
    6
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案
    isp.system-error 系统错误 联系技术支持

    API工具

    如何获得此API

    FAQ

    返回
    顶部