入住规则
设置年龄限制、入住时间和房间规则。大多数酒店大约 5 分钟即可完成。
本指南帮助你设置哪些住客可以自助入住、何时可以开始,以及哪些房间符合条件。这些规则适用于自助入住和人工协助入住流程。
在哪里找到
Settings → Check-In → Check-In Policy快速参考
| 设置项 | 控制内容 | 对住客的影响 |
|---|---|---|
| Minimum Age | 允许自助入住的最低年龄 | 未成年住客会被引导到前台 |
| Allow DOB Editing | 住客是否可以更正 OCR 识别出的出生日期 | 可避免 OCR 识别错误导致的年龄拦截 |
| Allow Travel Document Upload | 是否允许上传照片来代替实时相机扫描 | 住客可以上传护照或身份证照片 |
| Image Retention Policy | 在设定天数后自动删除证件和自拍图片 | 应用更改后,较旧的图片可能会被移除 |
| Document Storage | 选择已采集证件和签名的存储位置 | 控制入住记录的存储目的地 |
| PMS Upload Policy | 控制入住文件是否发送到 PMS | 文件可以保留在 Streamliner 中,而不同步到 PMS |
| Registration Card Upload Timing | 选择登记卡上传到 PMS 的时间 | 上传可等待住客同步完成或入住完成 |
| Mandatory Guest Registration | 要求每位 PMS 住客都完成登记 | 额外住客不能跳过住客信息 |
| Allowed Check-In Time | 自助入住可以开始的最早时间 | 提前到达的住客会看到等待提示 |
| Validate Check-In Time Only | AVA 只检查时间,还是同时检查到店日期和时间 | 控制提前到店校验的严格程度 |
| Long Stay Limit | 自助入住允许的最长入住晚数 | 长住需要由员工办理入住 |
| Kiosk Welcome Buttons | 在自助终端欢迎页显示或隐藏 Check-In 和 Check-Out | 住客只会看到你在终端首页启用的按钮 |
| Group Checkout | 让退房流程把关联预订一起处理 | 住客可以在一个流程中完成关联预订退房 |
| Guest Step Auto-Advance | 保存后自动打开下一个必填住客步骤 | 让入住流程继续推进,或让住客手动继续 |
| Room Automation | 分别控制无房号预订、预分配房间移动和排队 | 控制房间准备状态与安全性 |
| Expected room-assignment behaviour | 无房号和预分配预订在入住前后的矩阵 | 帮助员工解释等待和 Room Ready 邮件 |
| OPERA Specials Codes | 旅程步骤可搜索的代码 | 跟踪登记、预授权、入住和退房进度 |
设置住客资格
设置入住最低年龄
- 前往 Settings → Check-In → Check-In Policy
- 在 Minimum Age for Check-In 中输入数值(通常为 18 或 21)
- 点击 Save
工作方式:
- 年龄检查适用于预订中的主住客
- 如果主住客未达到最低年龄,自助入住会被阻止
- 年龄会根据登记时采集的 Date of Birth 计算
允许住客编辑出生日期
使用 Allow editing guest date of birth 来控制住客是否可以修正 OCR 错误:
- 启用: 住客可以更正扫描出的出生日期
- 停用: 出生日期会保持与扫描证件一致
建议关闭的场景:
- 当地法规要求证件内容必须完全一致
- 你需要严格的年龄验证(例如年龄限制设施)
允许编辑可以在证件扫描误读日期时减少错误的年龄拦截。
允许上传旅行证件
使用 Allow travel document upload 允许住客上传证件照片:
- 启用: 住客可以上传护照或身份证照片
- 停用: 住客必须使用实时相机扫描
- 前往 Settings → Check-In → Check-In Policy
- 打开或关闭 Allow travel document upload
- 点击 Save
设置图片保留策略
使用 Image retention policy 可以在指定天数后删除已存储图片。
如果某个开关关闭,Streamliner 不会根据保留策略删除对应类型的图片。
保存更短的保留周期会立即删除早于所选天数的现有证件照或自拍照。
-
在 Image retention policy 中,启用 Travel document 或 Selfie
-
输入保留天数(1-365)。默认值为 180。
-
点击 Save
-
如果出现确认窗口,输入
DELETE IMAGES -
点击 Save and apply now
✓ 你的保留策略已保存并生效。
如果你修改了图片保留设置并立即点击 Save,AVA 会使用你最新的值。 当更改需要破坏性确认时,也会显示确认窗口。
设置文档存储
使用 Document storage 选择入住文件和签名的存储位置。
-
在 Document storage 中使用 Use your own server (on-premises)
-
选择一种模式:
- 关闭时使用 S3 云存储
- 开启时使用你本地的图片存储服务
-
如果启用了本地部署,请输入你的 Image storage URL
-
如果显示了密钥,请点击 Image storage secret 旁边的 Copy
-
点击 Save
✓ 你的文档存储设置已保存。
Image storage secret 字段是只读的。只要有值,就可以复制。
设置 PMS 上传策略
使用 PMS upload policy 控制 Streamliner 向 PMS 发送哪些入住文件。
这不会更改 Streamliner 中的本地存储或保留规则。
在 v4 中,AVA 会在住客变为 Verified 时上传证件照。
这是现有设置的默认行为。
旧版缺失值或 guestSync 时机值也会使用 guestVerified。
显式的 checkIn 时机对旧记录仍然有效。
如果 Upload travel document to PMS 关闭,AVA 会跳过上传。
只有较大的证件照片会在上传到 PMS 前压缩。
较小的文件保持不变。
-
在 PMS upload policy 中,打开或关闭:
- Upload travel document to PMS
- Upload registration card to PMS
-
点击 Save
✓ 你的文件同步策略已保存。
如果你当前的 PMS 是 AVA,这些开关会被禁用。此策略不适用于 AVA PMS。
设置登记卡上传时间
使用 Registration card upload timing 选择 AVA 何时将卡片发送到你的 PMS。
默认情况下,AVA 使用 When check-in completes。 这会让现有酒店继续沿用当前流程。
-
在 PMS upload policy 中,打开 Upload registration card to PMS
-
在 Registration card upload timing 中选择一种:
- When guest syncs - AVA 在 PMS 住客同步成功后上传
- When check-in completes - AVA 在入住结束后上传
-
点击 Save
✓ 你的登记卡时间设置已保存。
只有在 Upload registration card to PMS 打开时,你才会看到此设置。 在 AVA PMS 中它始终隐藏。 如果保存值缺失或无效,AVA 会回退到 When check-in completes。
如果你的酒店在带随行人档案的多房间流程中使用 Opera,AVA 会为 2 号房上传主住客的登记卡。 当 Registration card upload timing 设为 When guest syncs,且 2 号房住客验证变为 Verified 时,就会发生这种情况。 如果只有主住客签名,它仍会使用主住客的签名。
要求 PMS 住客完成登记
当与 PMS 预订关联的每位住客都必须完成登记时,开启此项。设置大约需要 1 分钟。
使用 Mandatory Guest Registration 可要求预订关联的每位住客都完成登记。
-
在 Registration 中启用 Mandatory Guest Registration
-
点击 Save
✓ 每位 PMS 住客都必须先完成登记,入住才会结束。
此设置适用于所有 PMS 提供商。 仅适用于 Opera 的登记控制仍保留在 Registration 部分。
使用 OPERA 特殊代码建议
当你当前的 PMS 是 OPERA 家族 PMS,例如 Opera、OHIP 或 OWS 时,AVA 会为每个旅程字段加载匹配的特殊代码建议。 其他 PMS 提供商会忽略这些字段,因此不会影响非 Opera 预订。
如果你不想使用建议,也可以手动输入代码。
如果你的 PMS 请求包含生命周期覆盖,AVA 会优先使用该代码。 如果 PMS 设置为空或 null,AVA 会保留上次保存的代码,而不是清空它。 退房使用的生命周期路径与登记、预授权和入住相同。 你不需要单独调用退房特殊代码。
在 Opera 登记期间,如果预订没有任何付款方式,AVA 可以先提交当前的 Cash 付款方式。 它会使用 Opera 的付款类型列表,并保留现有付款方式不变。
-
找到 OPERA Specials Codes 部分
-
填入以下旅程字段:
- Specials code for registration
- Specials code for pre-authorisation
- Specials code for check-in
- Specials code for check-out
-
在每个字段中开始输入,以搜索有效代码列表
-
选择一个建议,或输入你自己的代码
-
点击 Save Check-In Policy
✓ 你的代码值会保持可编辑且可搜索。
只有当你当前的 PMS 是 OPERA 家族 PMS 且 PMS 设置完整时,才会显示建议。
输入值必须与 Opera Specials 完全一致。错误值会破坏状态映射。
设置入住时间
- 在 Allowed Check-In Time 中选择你的正式入住时间
- 点击 Save
格式规则:
- 使用 24 小时制(例如
14:00) - 留空则表示任何时间都允许入住
住客体验:
- 在入住时间之前,会显示提前到达提示
- 在入住时间之后,如果其他规则允许,住客可以继续
仅校验入住时间
当你希望 AVA 只检查时间,而不比较到达日期时,请使用 Validate Check-In Time Only。
- Yes: AVA 只按入住时间校验
- No: AVA 同时按到达日期和入住时间校验
-
打开或关闭 Validate Check-In Time Only
-
点击 Save
✓ 你的入住时间校验规则已保存。
如果你的酒店只想按时间判断到达,请使用 Yes。 如果你希望同时检查到达日期和时间,请使用 No。
付款设置已移到别处
支付网关配置和 Opera 付款策略控制现在位于 Settings → Payment。
在该页面中可配置:
- 网关连接(Stripe 或 Red Dot)
- 押金和全额付款收取
- Opera 映射和 Opera 付款策略控制
与客房清洁协同
提示客房清洁确认当日退房
如果你希望客房清洁在完成当日清洁更新之前先确认退房,请启用此项。这样可以帮助员工关闭前台遗漏的房间。
长住限制
- 启用 Block Long Stay Check-ins
- 设置 Maximum Nights for Kiosk Check-in
- 点击 Save
超过该限制的预订必须由员工办理入住。
设置自助终端欢迎按钮
使用 Kiosk Welcome Buttons 控制自助终端主页上 Check-In 和 Check-Out 按钮的显示或隐藏。
这些设置仅在自助终端运行于 mode=cci 时生效。
使用 Set Up the Kiosk Welcome Screen 控制 Request Assistance。 使用 Set Up Guest Lost Keycard Replacement 控制 I lost my keycard 选项。
- 前往 Settings → Check-In → Check-In Policy
- 找到 Kiosk Welcome Buttons
- 打开或关闭 Check-In 和 Check-Out
- 点击 Save
✓ 即使你关闭了某个按钮,AVA 也会保留已保存的按钮值。 ✓ 重新加载后,自助终端欢迎页会更新。
使用现有的 Walk-In Booking 设置来控制 Walk-In 按钮。 AVA 是否显示该按钮取决于预订能力,而不是这里的设置。
设置分组退房
使用 Group Checkout 控制关联预订是否可以一起完成退房。
-
在退房控制区域找到 Group Checkout
-
打开或关闭 Group Checkout
-
点击 Save
✓ AVA 会记住你对住客退房流程的选择。 ✓ 打开后,退房界面会出现 Group Checkout 选项卡。
当你希望住客一起完成关联预订退房时,请打开此项。 当你希望每个预订分别退房时,请保持关闭。
设置住客步骤自动前进
使用 Guest Step Auto-Advance 决定 AVA 保存后是否自动打开下一个必填住客步骤。
-
找到 Guest Step Auto-Advance
-
打开它以保持当前自动展开流程
-
关闭它以便住客和员工手动打开每一步
-
点击 Save
✓ 新的入住步骤会立即遵循该设置。
如果该设置缺失,AVA 会将 Guest Step Auto-Advance 视为 on。 这会让现有酒店继续保持当前流程。
房间自动化与房态规则
大多数酒店在这里大约花 5 分钟。先配置房间自动化,再选择允许的房态。
这一部分控制 AVA 何时分配房间、排队预订,或让员工来处理。
AVA 会禁用不受支持的开关并说明原因。 如果你的 PMS 不能自动分配房间,你必须先在 PMS 中分配房间。
当尚未分配房间时自动分配房间
当预订还没有房间时使用此项。
启用后,AVA 会向 PMS 请求可用房间。 关闭后,AVA 会将预订保留在排队中,或交由员工分配。
如果你当前的 PMS 是 eZee,此项会保持禁用。 eZee 不支持入住过程中的自动分配或重新分配。
如果启用了 Allow Vacant Dirty Rooms,AVA 会关闭自动分配房间。 这样可以避免把住客分配到未清洁的房间。
在 eZee 中,AVA 仅在分房时提供干净房间。 如果所有匹配房间都是脏房,请在 Housekeeping 中清洁一间房后重试。
如果 Opera 返回的是同一个有效房间,AVA 会保留它。 如果 Opera 需要其他房间而重新分配关闭,AVA 会将房间分配排队。 如果 Opera 因房间不是空房、未清洁或未检查而拒绝,AVA 会显示 Room Not Ready 消息。
当预分配房间不可用时移动该预订
当预订已经有房间,但该房间在入住时间后不可用时使用此项。
启用后,AVA 可以把预订移动到另一个符合条件的房间。 关闭后,AVA 会保留原房间,并按下方的排队流程处理。
如果 PMS 刷新成功而预订不再有房间,AVA 会清除本地过期房间。 当无房间分配开启时,AVA 会对干净或已检查的替代房间使用正常自动分配流程。 如果 PMS 刷新失败,AVA 会保留现有房间目标。
允许在没有客房清洁状态时分配房间
如果你的 PMS 不发送客房清洁状态,请启用此项。 启用后,AVA 会忽略房态筛选。
允许的房态
选择哪些房态可用于入住:
- Allow Vacant Inspected Rooms(推荐)
- Allow Vacant Clean Rooms
- Allow Vacant Dirty Rooms(仅限紧急情况)
允许脏房可能会带来健康和服务问题。 只有在你有人工流程时才可使用。
自助入住要生效,至少必须启用一种房态。
预期的房间分配行为
使用这张表来匹配当前房间自动化设置。

| 预订状态 | 入住时间前 | 入住时间后 |
|---|---|---|
| 未分配房间 | 如果 Auto Queue Room 开启,AVA 会先尝试分配房间。如果没有可用房间,它会把预订排队。如果 Auto Queue Room 关闭,住客会停留在入住前流程中。 | 如果自动分配开启,AVA 会分配一个可用房间。如果关闭,员工必须分配房间或将预订排队。 |
| 已预分配房间 | AVA 会保留原房间。如果 Auto Queue Room 开启且房间未准备好,AVA 会把预订排队,而不是移动它。 | 如果重新分配开启,当原房间不可用时,AVA 会使用另一个可用房间。如果关闭,AVA 会将预订排队或由员工处理。 |
| 房间已清洁或已检查 | AVA 继续入住。 | AVA 继续入住。 |
排队需要你的 PMS 支持排队功能。 如果 PMS 不支持排队,AVA 仍会阻止入住并显示未就绪消息。 预订可能不会保留在 PMS 排队中。
默认情况下,当排队中的房间变为就绪时,AVA 会把预订从 PMS 队列中移除。 Room Ready 邮件和 DO-NOT-MOVE 提醒仍会发送。 如需让预订继续留在队列中,请打开 Keep Booking in Queue When Room Is Ready。
你可以只开启无房间分配,而不启用预分配房间替换。 你也可以开启预分配房间替换,而不改变无房间分配。
故障排查
住客被意外阻止
你会看到: 符合条件的住客被送到前台
检查:
- Minimum Age 和出生日期准确性
- Allowed Check-In Time
- Validate Check-In Time Only
- Long stay limit
- Room status eligibility
- Settings → Payment 中的付款设置
上传选项缺失
你会看到: 住客只能看到实时相机扫描
解决方法:
- 打开 Allow travel document upload
- 保存更改并再次测试
确认按钮一直不可用
你会看到: 确认窗口中的 Save and apply now 是灰色的。
解决方法:
- 严格按照提示输入
DELETE IMAGES - 点击 Save and apply now
保留天数字段是灰色的
你会看到: 无法编辑保留天数。
解决方法:
- 打开 Travel document 或 Selfie
- 输入天数
本地存储 URL 一直回退
你会看到: Image storage URL 无法保存。
解决方法:
- 打开 Use your own server (on-premises)
- 输入完整 URL,例如
https://image-storage.yourhotel.local - 点击 Save,然后刷新页面一次
图片存储密钥的复制按钮被禁用
你会看到: Copy 变灰,无法点击。
解决方法:
- 打开 Use your own server (on-premises)
- 确认 Image storage secret 中有密钥值
- 如果为空,请先让管理员设置密钥
PMS 上传开关被禁用
你会看到: 无法更改 Upload travel document to PMS、Upload registration card to PMS 或其时机。
解决方法:
- 检查你当前的 PMS 提供商
- 如果是 AVA PMS,这是预期行为
- 使用非 AVA PMS 提供商来配置这些开关
登记卡上传时间选项缺失
你会看到: 找不到 Registration card upload timing。
解决方法:
- 打开 Upload registration card to PMS
- 确认当前 PMS 不是 AVA PMS
- 再次保存页面
- 重新打开 Settings → Check-In → Check-In Policy
自动房间分配被禁用
你会看到: 房间自动化开关是关闭、禁用或缺失的。
解决方法:
- 检查你当前的 PMS
- 如果是 eZee,这是预期行为
- 如果 PMS 不支持房间分配,AVA 会禁用该开关
- 如果 PMS 不支持排队,Auto Queue Room 会保持隐藏
- 确保 Allow Vacant Dirty Rooms 处于 OFF
- 确保你的 PMS 会发送房态更新
- 如果你需要无房间自动分配,请使用支持该功能的 PMS
- 如果你还想移动预分配房间,请启用单独的房间不可用控制
提前到达提示从不出现
你会看到: 住客提前入住时没有任何提示
解决方法:
- 设置 Allowed Check-In Time
- 在 Room Not Ready Messages 中添加提示
入住时间验证感觉过于严格
你会看到: 即使入住时间看起来正确,住客仍被阻止。
解决方法:
- 检查 Validate Check-In Time Only
- 如果你只想按时间验证,请设为 Yes
- 如果你想同时检查到达日期和时间,请设为 No
- 保存并用新的预订测试
分组退房选项缺失
你会看到: 住客一次只能退一个预订。
解决方法:
- 前往 Settings → Check-In → Check-In Policy
- 打开 Group Checkout
- 保存更改
- 重新加载住客退房界面并再次测试
OPERA specials codes 没有生效
你会看到: 旅程进度在 Opera 中没有被正确标记。
解决方法:
- 确认你当前的 PMS 是 OPERA-family PMS
- 检查每个代码是否与 Opera 完全一致(包括拼写)
- 使用 Save Check-In Policy 再次保存
- 用新的入住会话测试
OPERA 代码建议没有出现
你会看到: 特殊代码字段一直为空,或者没有任何匹配项。
解决方法:
- 确认你当前的 PMS 是 OPERA-family PMS
- 检查 OPERA PMS 设置是否完整
- 输入部分代码来筛选列表
- 如果你已经知道代码,可以手动输入
- 保存并重新打开页面
相关指南
- Registration Fields - 必填住客信息
- Room Not Ready Messages - 提前到达和延迟提示
- Opera PMS Integration - 连接并验证 Opera 设置
仍然卡住?
如果出现以下情况,请联系 success@vouch-technologies.com:
- ❌ 住客本应符合条件,却被阻止
- ❌ 房间分配没有按预期工作
- ❌ 你需要帮助设置年龄或付款规则
建议附上:
- 你的政策设置截图
- 一个被阻止的示例预订
- PMS 提供商和酒店类型