完成对信用住或者面付订单的状态的更新。包含订单状态的确认，入离店状态的更新等等。
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| tid | Number | 特殊可选 | 100100100 | 淘宝订单号,必填 | |
| opt_type | Number | 必须 | 1 | 操作的类型：8.取消订单(cancel)酒店端发起取消,必须在和买家协商通过的情况下操作,否则有法务风险; 5.买家未入住(noshow),如果该单有担保，会收取买家的担保金额; 3.核实入住(checkIn); 4.核实离店(checkOut); 1.确认无房(直连卖家禁止该操作),2.确认有房(直连卖家禁止该操作) | |
| reason_type | Number | 可选 | 1 |
|
无房原因分类:1.无房, 2.价格变动, 3.买家原因, 4.其它原因,opt_type=1时必填 |
| reason_text | String | 可选 | 无房 |
|
无房原因描述:opt_type=1时必填 |
| out_room_number | String | 可选 | 2022 | 入住房间号 | |
| checkin_date | String | 可选 | 2014-12-10 |
|
客人实际入住日期,opt_type=3/4时必填 |
| checkout_date | String | 可选 | 2014-12-13 |
|
客人实际离店日期,opt_type=4时必填 |
| rooms | Number | 可选 | 1 |
|
客人实际预定房间数 |
| out_id | String | 特殊可选 | R12345678 |
|
外部订单号 |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| result | String | "success" | 返回提示信息 |
1 2 3 4 5 6 7 8 9 10 11 12 13 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);XhotelOrderAlipayfaceUpdateMockRequest req = new XhotelOrderAlipayfaceUpdateMockRequest();req.setTid(100100100L);req.setOptType(1L);req.setReasonType(1L);req.setReasonText("无房");req.setOutRoomNumber("2022");req.setCheckinDate("2014-12-10");req.setCheckoutDate("2014-12-13");req.setRooms(1L);req.setOutId("R12345678");XhotelOrderAlipayfaceUpdateMockResponse rsp = client.execute(req, sessionKey);System.out.println(rsp.getBody()); |
1 2 3 | <xhotel_order_alipayface_update_mock_response> <result>"success"</result></xhotel_order_alipayface_update_mock_response> |
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> |
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 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 | 未查询到订单数据 | 检查订单id是否输入正确 |
| isv.invalid-parameter:ORDER_UPDATE_CHECKINOUTDATE_ERROR | 入住时间或离店时间不正确 | 检查一下checkIn和checkOut是否正确 |
| isp.remote-service-error | 系统错误 | 联系技术支持跟进 |
| isv.invalid-parameter:ERROR | 参数不正确 | 参考api文档检查入参 |
| isv.biz-error:BIZ_ERROR | 业务异常 | 联系技术支持跟进 |
| isv.order-error:ORDER_CANNOT_CANCEL | 当前订单状态禁止取消 | 不能进行该操作 |
| isv.order-error:CANNOT_CANCEL_GUARANTEE_ORDER | 订单是担保订单，禁止取消 | 不能进行该操作 |
| isv.order-error:ORDER_CANNOT_CANCEL_BEFORE_CHECKIN_TIME | 还未到最晚到店时间，订单禁止取消 | 不能进行该操作 |
| isv.order-error:NOT_SUPPORT_OPT_TYPE | 当前订单不支持该操作类型 | 该接口不支持预付订单操作，请核实一下。同时核实传入的optType是否合理 |
| isv.order-error:ORDER_CANCEL_ERROR | 订单取消失败 | 联系技术 |
| isv.invalid-parameter | 参数不合法 | 检查参数 |
| isv.biz-error | 未知业务错误 | 联系阿里技术支持 |
| isp.system-error | 系统错误 | 联系阿里技术支持 |
