新建订单·详细
这一页干什么
详细入住模式开单弹窗：录入订单头信息、选房间和收款，并在右侧 按房填写入住人（主住人、同行人），最后点 确认预订 或 直接入住。
酒店若未开详细入住模式，房态页会打开 新建订单·普通 `page-new-order`，不是本弹窗。
从哪里打开
| 入口 | 操作 |
|---|---|
| 房态日历 | 空房格子右键 →「新增预定」（酒店为详细模式时） |
| 房态视图 | 空房卡片右键 →「新增预定」（酒店为详细模式时） |
从房态页点进来时，已选中的房间和日期会自动带入。是否打开本弹窗，由酒店是否开启「详细入住模式」决定，前台一般不用手动切换。
顶栏按钮
| 按钮 | 作用 |
|---|---|
| 数据录入模式 | 正常模式 / 历史数据录入模式（补录旧单时用） |
| OTA截图添加预约 | 打开 OTA 截图识别 `page-ocr-preview`，识别后回填 |
| 直接入住 | 保存订单并马上办入住；会校验各房入住人必填项 |
| 确认预订 | 只保存为「已预订」，不入住；入住人证件可暂不填齐 |
| 关闭 | 关闭弹窗（未提交的内容不保存） |
顶部汇总条
| 项 | 含义 |
|---|---|
| 房间总数 | 本单几间房 |
| 总天数 | 住几晚 |
| 总价格 | 房价合计（红色显示） |
| 收款总计 | 已填收款合计 |
| 应收余额 | 还差多少没收 |
| 入住时间 / 退房时间 | 酒店默认入离时间（如 15:00 后 / 14:00 前） |
普通模式弹窗把同类数字放在右侧栏；详细模式改在顶部横条展示，方便一边录单一边核对。
左侧：基本信息
带红色 \* 的是必填：
| 字段 | 说明 |
|---|---|
| 姓名 \* | 订单主联系人；可点 读卡 读身份证（H5） |
| 住客类型 \* | 内宾 / 外宾 |
| 联系号码 | 手机号 |
| 证件类型 / 证件号码 | 按住客类型选 |
| 民族 / 证件地址 | 选填 |
| 客户来源 \* | 如线下客人、携程、美团等 |
| 支付方式 \* | 如全部预付、到店现付 |
| 备注信息 | 订单备注 |
输入姓名时，可能弹出历史客人联想列表，点一条可快速填入。
左侧姓名等信息，会自动同步到 第一间房的主住人；右侧按房区仍可单独修改。
订单标记
基本信息区底部有一排小图标（如 🌟 ❤️ 🎯 等），点一下可选中，作为本单标记，再点可取消。
中间：房间信息
每间房一行，可填：
| 项 | 说明 |
|---|---|
| 房间 | 下拉选房号、房型 |
| 入住时间 / 离店时间 | 点日期时间选择 |
| 房价 | 点金额可展开按晚设价 |
点房价展开 设置房价 弹层，可按每一晚单独改价，或用「一键设置」批量填：
- 底部 + 添加房间 可再加一间；每加一间，右侧会多一块「按房入住人」区域
- 房间旁有 钟 标记时，表示该时段有钟点房占用提示
中间下方：收款信息
| 项 | 说明 |
|---|---|
| 款项类别 | 收款、收押金、其他消费、退款等 |
| 付款方式 | 现金、微信、支付宝、各 OTA 代收、小程序支付等 |
| 金额 | 本次收多少 |
| 备注 | 收款备注 |
可 + 添加收款记录 录多笔。选「平台渠道 + 全额预付」时，系统可能自动带出收款金额。顶部汇总条的「收款总计」「应收余额」会随此处填写自动更新。
右侧：按房入住人
橙色提示：预订可不填证件；直接入住请补齐各房入住人。
每间房一块区域，标题显示「第 N 间 + 房号 + 房型」，并注明 每房至少 1 位主住人。
主住人与同行人
| 操作 | 说明 |
|---|---|
| 境内 / 境外 | 切换该客人的证件表单类型 |
| + 添加同行人 | 在同一间房下再加一位客人 |
| 删除 | 同行人卡片右上角可删（主住人不能删） |
境内客人
| 字段 | 说明 |
|---|---|
| 姓名 \* | 可点 读卡 |
| 性别 \* | 男 / 女 |
| 身份证号 \* | 直接入住时必填 |
| 手机号 \* | 主住人必填 |
| 民族 / 证件地址 | 选填 |
境外客人
切换到 境外 后，字段变为护照等信息：
| 字段 | 说明 |
|---|---|
| 英文姓 / 英文名 \* | 护照姓名 |
| 中文名 | 选填 |
| 国籍 \* | 输入中文或英文，从列表选择 |
| 性别 / 证件类型 / 证件号码 \* | 证件类型如普通护照等 |
| 出生日期 / 手机号 \* | 主住人手机号必填 |
| 境内联系人 / 联系人电话 \* | 境外客人必填 |
| 签证有效期至 \* | 日期格式 yyyy-MM-dd |
| 办理日期 | 选填 |
| 护照资料页 / 人像自拍 / 签证签注页 \* | 点 上传 传图；直接入住时通常要齐 |
添加同行人
点 + 添加同行人 后，同房间下会出现「同行人 #2」「同行人 #3」…… 每人可独立选境内/境外并填表。不需要的同行人可点 删除。
提交后会发生什么
| 按钮 | 结果 |
|---|---|
| 确认预订 | 生成「已预订」订单；各房入住人证件可不填齐 |
| 直接入住 | 生成订单并办入住；系统会校验每间房主住人（及同行人）必填项与境外三图 |
| 关闭 | 不保存，弹窗关掉 |
成功后弹窗关闭，房态页自动刷新。
注意点
- 本弹窗是 详细入住模式 专用；普通模式见 新建订单·普通 `page-new-order`
- 详细模式 没有 普通版左侧「同行人员」列表；同行人请在右侧 按房 添加
- 左侧订单头与右侧第一间主住人会互相同步姓名等，改一边另一边也会变
- 必填项没填齐，点提交会提示
- 日期与房间冲突时，系统会拦截或提示
- OTA 截图识别见专篇 OTA 截图 `page-ocr-preview`
相关页面
| 操作 | 链到 |
|---|---|
| 从房态日历打开 | 房态日历 `page-fangtai-index` |
| 从房态视图打开 | 房态视图 `page-fangtai-status-view` |
| 普通模式开单 | 新建订单·普通 `page-new-order` |
| OTA 截图 | OTA 截图识别 `page-ocr-preview` |
| 提交后看单 | 订单详情 `page-op-order` |