办理入住/退房
这一页干什么
对已有订单办理入住或退房：勾选要办的房间、核对客人与收款，确认后更新房态。
同一弹窗，根据打开方式显示 办理入住 或 办理退房 标题和按钮；配图以办理入住为例，退房时布局相同、左侧客人区多为只读核对。
从哪里打开
| 入口 | 操作 |
|---|---|
| 房态日历 | 有订单格子右键 →「办理入住」或「办理退房」 |
| 房态视图 | 有订单卡片右键 →「办理入住」或「办理退房」 |
| 订单列表 | 点订单行打开详情后，再点办理按钮 |
| 订单详情 | 弹窗内点 办理入住 或 办理退房 |
顶栏会显示订单 ID，便于核对是哪一单。
顶栏按钮
办理入住时
| 按钮 | 作用 |
|---|---|
| 数据录入模式 | 正常模式 / 历史数据录入模式 |
| 办理入住 | 对勾选房间执行入住 |
| 取消入住 | 把已入住房间还原为「已预订」（误操作回退） |
| 关闭 | 关闭弹窗，不提交 |
办理退房时
顶栏主按钮变为 办理退房，另有 取消退房（误操作回退）。关闭 作用相同。
左侧：基本信息
酒店为详细入住模式且办理入住时，左侧为 按房填写入住人（与新建订单·详细类似）：
- 橙色提示：请先勾选房间，再填写该房入住人
- 只显示中间栏已勾选房间对应的客人表单
- 未勾选房间时，提示「请先在中间栏勾选要办理入住的房间」
- 每房主住人可填境内/境外信息，可 + 添加同行人
下方还有只读的 客户来源、支付方式、备注、标记（来自订单，本页不可改）。
简单模式 或 办理退房
- 简单模式：左侧显示订单级客人信息（姓名、证件等），全部只读
- 详细模式 + 办理退房：左侧只读展示已勾选房间的入住人快照，用于核对
中间：房间信息
| 元素 | 说明 |
|---|---|
| 全选 | 勾选/取消全部可办房间（已退房等不可选的会自动禁用） |
| 每行勾选框 | 选择本单要办理的房间；可只办其中几间 |
| 房号 / 房型 | 只读 |
| 状态标签 | 如「已预订」「已入住」「已退房」 |
| 入住 / 离店时间 | 只读 |
| 房价 | 只读金额 |
| 🔐 锁图标 | 房间已绑智能锁时出现；点开 密码管理 |
| 💳 卡图标 | H5 且已绑锁时出现；点开 制 IC 卡 |
办理入住时，通常只能勾选 已预订 的房间；已退房的行不可勾选。
密码管理弹窗
点房间行右侧 🔐 打开（需该房已绑定通通锁）：
| 按钮 | 作用 |
|---|---|
| 获取随机密码 | 生成限时开门密码 |
| 添加自定义密码 | 手动指定密码 |
| 删除所有密码 | 清空该锁下全部密码 |
| 刷新 | 重新加载列表 |
| 关闭 | 关闭弹窗 |
列表显示密码 ID、密码、类型、起止时间、发送状态、备注等；每行可 复制密码、修改、删除。
弹窗会带入本房入住/离店时间和客人姓名，便于生成对应时段的密码。
制 IC 卡弹窗
点房间行右侧 💳 打开（H5 + 本机已装发卡助手）：
| 区域 | 说明 |
|---|---|
| 制卡 / 读卡查看 / 回收 / 卡丢了 / 设备 | 顶部页签，常用「制卡」 |
| 锁 | 当前房门锁名称 |
| 卡类型 | 如房间卡 |
| lockMac / 楼栋 / 楼层 | 写卡参数；可点「拉取云端参数」自动填入 |
| 截止时间 | 默认取订单退房时刻 |
| 写房间卡 | 把卡放到发卡器上后点此写入 |
| 调试日志 | 底部可查看连接与写卡过程 |
| 关闭 | 退出制卡窗 |
需本机运行 HotelCardAssistant 并通过 WebSocket 连接发卡器。
中间下方：收款信息
| 项 | 说明 |
|---|---|
| 已有记录 | 灰色只读，如平台全额预付自动生成的「携程代收」 |
| 新增记录 | 可选款项类别、付款方式、金额、备注 |
| + 添加收款记录 | 再加一行 |
| × | 删除尚未保存的新增行 |
本页可以补录收款，但基本信息和房间日期/房价不可改。右侧「收款总计」「应收余额」会随填写更新。
小程序订单若涉及押金，顶部可能出现押金扣除说明。
右侧：总计与须知
| 项 | 含义 |
|---|---|
| 房间总数 / 总天数 / 总价格 | 本单汇总 |
| 收款总计 | 已录收款合计 |
| 应收余额 | 还差多少房费未收齐 |
| 入住须知 / 退房须知 | 核对身份、收款、办完后房态变化等提示 |
| 操作提示 | 基本信息与房间不可改；可改收款；确认后点办理按钮 |
办理退房成功后，房间通常会变为 脏房。
提交后会发生什么
| 操作 | 结果 |
|---|---|
| 办理入住 | 勾选且「已预订」的房间 →「已入住」，房态变在住色 |
| 办理退房 | 勾选且「已入住」的房间 →「已退房」，房态更新 |
| 取消入住 | 已入住 → 还原为「已预订」 |
| 取消退房 | 已退房 → 还原为「已入住」 |
| 关闭 | 不保存本次未提交的修改 |
成功后弹窗关闭，来源页（房态/订单详情）自动刷新。
注意点
- 同一弹窗两种业务：看标题区分入住还是退房
- 详细模式办入住时，务必先勾选房间再填该房入住人
- 锁密码、制卡为辅助功能，房间未绑锁时不显示图标
- 取消入住/退房会影响房态，请谨慎使用
- 修改订单基本信息请用 修改订单 `page-edit-order`
相关页面
| 操作 | 链到 |
|---|---|
| 从房态打开 | 房态日历 `page-fangtai-index` / 房态视图 `page-fangtai-status-view` |
| 从订单详情打开 | 订单详情 `page-op-order` |
| 详细模式录单 | 新建订单·详细 `page-new-order2` |
| 改订单信息 | 修改订单 `page-edit-order` |