文档中心 > API类目 > 酒店在线预订API

taobao.xhotel.order.update (酒店订单发货接口)

卖家确认订单或者取消订单,适用于预付、面付、信用住订单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tid Number 必须 100100100 订单号
opt_type Number 必须 1 操作的类型:1.确认无房(取消预订,710发送短信提醒买家申请退款)2.确认预订 3.入住 4.离店 5.noshow 6.关单
sync_to_hotel String 可选 Y 是否把代理直签的订单同步到酒店,Y为同步,N不同步
refund_fee Number 可选 1000
  • 默认值:0
  • 退款费用
    reason_type Number 可选 6
  • 默认值:0
  • 取消类型,6 代表的是用户取消,reasonType=7代表的是小二协商
    invoice_amount Number 可选 1000
  • 默认值:-1
  • 开票金额
    confirm_code String 可选 25705251 外部订单号(酒店确认号)
    hotel_reverse_reason_code Number 可选 3300001
  • 默认值:0
  • 错误码
    hotel_reverse_reason_desc String 可选 房屋装修/长租/自主 拒单原因描述
    hotel_reverse_reason_detail String 可选 "" 补充细节

    响应参数

    名称 类型 示例值 描述
    result String "success" 返回提示信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelOrderUpdateRequest req = new XhotelOrderUpdateRequest();
    req.setTid(100100100L);
    req.setOptType(1L);
    req.setSyncToHotel("Y");
    req.setRefundFee(1000L);
    req.setReasonType(6L);
    req.setInvoiceAmount(1000L);
    req.setConfirmCode("25705251");
    req.setHotelReverseReasonCode(3300001L);
    req.setHotelReverseReasonDesc("房屋装修/长租/自主");
    req.setHotelReverseReasonDetail("\"\"");
    XhotelOrderUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_order_update_response>
        <result>&quot;success&quot;</result>
    </xhotel_order_update_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.invalid-parameter:NOTNULL 参数不能为空 参考api文档检查入参
    isv.invalid-parameter:NUM 参数应该是数字 参考api文档检查入参
    isv.invalid-parameter:STRING 参数应该是字符串 参考api文档检查入参
    isv.invalid-parameter:DATE_FORMAT_ERROR 参数日期格式不正确 参考api文档检查入参
    isv.invalid-parameter:RANGE_ERROR 参数只能从指定的可选值中选择 参考api文档检查入参
    isv.invalid-parameter:FORMAT_ERROR 参数格式不正确 参考api文档检查入参
    isv.invalid-parameter:LENGTH_OVERRANGE 参数长度不能超过规定值 参考api文档检查入参
    isv.invalid-parameter:BYTES_OVERRANGE 参数字节数不能超过规定值 参考api文档检查入参
    isv.remote-service:CONVERT_ERROR 转换对象时出错 检查入参或者联系技术支持
    isv.permission-error:NO_PERMISSIONS_ERROR 权限不够、非法访问 检查订单id是否输入有误
    isv.invalid-parameter:GET_ORDER_IDS_ALL_NULL_ERROR 参数oid,tid不能都为空 淘宝订单号和卖家订单号至少传入一个
    isv.order-error:ORDER_STATUS_MISMATCHING 订单当前状态不允许进行该操作 确定订单状态,或者联系技术支持
    isv.order-error:ORDER_NOT_EXIST 未查询到订单数据 检查tid是否输入正确
    isv.invalid-parameter:ORDER_UPDATE_CHECKINOUTDATE_ERROR 参数核实入住时间或离店时间不正确 参考api文档检查入参
    isp.remote-service-error 系统错误 联系技术支持跟进
    isv.invalid-parameter:ERROR 参数不正确 参考api文档检查入参
    isv.biz-error:BIZ_ERROR 业务异常 联系技术支持跟进

    API工具

    如何获得此API

    FAQ

    返回
    顶部