跳到主要内容

查找并编辑客人档案

快速开始

通过姓名、邮箱、电话或证件号，通常可在 1 分钟内找到客人。

本指南帮助你查找、查看、更新和删除在签到时创建的客人档案。

前往： Main Menu → Guests

Guest Management interface showing the guest profiles list with search and filter options

快速参考​

任务点击位置结果
查找客人Search 输入框列表显示匹配档案
筛选近期客人Filters → Activity → Recent (30 days) → Apply Filters只显示近期客人
编辑档案Edit（铅笔图标）打开编辑面板
删除档案Delete（垃圾桶图标）打开确认弹窗
标记 VIPEdit → VIP Guest保存 VIP 状态
保存更改Save Changes档案更新，可能出现同步提示

查找客人档案​

  1. 前往 Main Menu → Guests。

  2. 在 Search 中输入姓名、邮箱、电话或证件号。

  3. 如有需要，点击 Filters 并设置 Nationality、Activity 或 Sort by。

  4. 点击 Apply Filters。

    ✓ 列表会更新为匹配结果。

更快的搜索

当姓名相似时，优先用电话或邮箱搜索。

筛选与排序客人​

  1. 点击 Filters。

  2. 选择以下任意项：

    • Nationality（开始输入进行搜索，然后选择结果）
    • Activity → Recent (30 days)
    • Sort by：Last Check-in、Name 或 Created Date
    • Order：Ascending 或 Descending

  3. 点击 Apply Filters。

    ✓ 表格会按新排序刷新。

    Guest Filters Panel

要重置所有条件，请点击 Clear all filters。

编辑客人档案​

  1. 找到客人所在行并点击 Edit。

    ✓ Edit Guest Information 面板会打开。

Edit Guest Information panel showing personal details, basic information, and travel information sections

  1. 更新需要的字段。

  2. 点击 Save Changes。

    ✓ 会显示成功提示。

如果最新预订也被更新，你会看到： "Guest profile updated and synced to last reservation"

可修改内容​

区域可修改内容备注
Personal Details姓名、出生日期、性别、国籍、护照/证件号First Name 和 Last Name 为必填
Basic Information邮箱、电话、VIP 状态、VIP 说明、职业邮箱必须有效
Travel Information离店/下一目的地、离店时间可使用 Same as current address 复选框
Address Information地址、城市、省/州、国家、邮编可选字段
Administrative客人类型、居留状态、验证包含 Permanent resident or work permit holder 和 Guest verified
如果你的酒店在泰国
  • Occupation 使用泰国职业列表。
  • Nationality 使用泰国官方国籍列表。

删除客人档案​

  1. 找到客人所在行并点击 Delete（垃圾桶图标）。

  2. 查看确认信息。

  3. 点击 Delete 确认。

    ✓ 客人档案会被移除，列表也会刷新。

删除是永久操作

此操作无法撤销。只有拥有删除权限的用户才会看到 Delete 按钮。

活动入住检查

你不能删除当前正在入住的客人。请先结束入住，再重试。

标记客人为 VIP​

  1. 找到客人并点击 Edit。

  2. 在 Basic Information 中启用 VIP Guest。

  3. 输入简短的 VIP Description。

  4. 点击 Save Changes。

    ✓ 会显示成功提示。

谨慎使用 VIP

仅在管理层批准后才应用 VIP。

查看近期客人活动​

  1. 前往 Main Menu → Guests。

  2. 查看顶部的 Recent Guests 卡片。

  3. 在表格中查看 Activity 列的签到日期。

  4. 点击 Filters → Activity → Recent (30 days)。

  5. 点击 Apply Filters。

    ✓ 列表会显示近期有活动的客人。

需要完整签到历史？

使用 Command Center 查看完整预订记录。

故障排查​

没有找到客人​

你会看到： "No guests found" 或 "No guests match your current filters."

解决方法：

  1. 点击 Clear all filters。
  2. 清除搜索文本。
  3. 在客人完成签到后再试一次。

更新失败，提示 "cannot update these fields"​

你会看到： 红色错误信息 "cannot update these fields"。

解决方法：

  1. 在 PMS 中更新这些字段。
  2. 等待下一次同步。
  3. 再次尝试保存。

校验错误​

你会看到： Email、Phone Number 或姓名字段下方有红字。

解决方法：

  • 使用有效的邮箱格式。
  • 使用国际电话格式。
  • 填写 First Name 和 Last Name。

签到日期显示 "Never"​

你会看到： Activity 列显示 "Never"。

解决方法：

  1. 确认客人已经完成签到。
  2. 刷新页面。
  3. 在 Command Center 中查看该预订。

近期客人数量为 0​

你会看到： Recent Guests 卡片显示 0。

解决方法：

  1. 确认最近 30 天内有签到记录。
  2. 清除筛选并刷新。
  3. 如果签到仍在处理，稍后再试。

删除按钮缺失​

你会看到： 操作列里没有 Delete（垃圾桶图标）。

解决方法：

  1. 确认你的角色包含删除客人的权限。
  2. 权限更新后刷新页面。

因活动入住而阻止删除​

你会看到： "Guest is currently checked in." 或删除错误信息。

解决方法：

  1. 在 Command Center 中查看客人的当前入住。
  2. 完成退房。
  3. 再次尝试删除。

删除失败，提示 "Guest ID is missing"​

你会看到： "Guest ID is missing. Please refresh and try again."

解决方法：

  1. 刷新页面。
  2. 重新尝试删除操作。

vouch-ava-docs/i18n/zh/docusaurus-plugin-content-docs/current/operations/room-access/room-metadata-management.md​

*** Delete File: /Users/officemacgithubrunner/actions-runner-org1/_work/vouch-ava/vouch-ava/vouch-ava-docs/i18n/zh/docusaurus-plugin-content-docs/current/operations/room-access/room-metadata-management.md *** Add File: /Users/officemacgithubrunner/actions-runner-org1/_work/vouch-ava/vouch-ava/vouch-ava-docs/i18n/zh/docusaurus-plugin-content-docs/current/operations/room-access/room-metadata-management.md​

title: 更新房间限制和备注​

更新房间限制和备注

快速更新

大多数修改会在 1 分钟内保存完成。你可以一次更新一个房间，也可以批量更新多个房间。

本指南帮助你管理用于房间分配的房间限制和备注。

前往： Rooms

快速参考​

任务点击位置结果
查找房间Search 输入框列表筛选到匹配房间
按房号排序Room Number 列标题房间按 1、2、10 的顺序排序
编辑单个房间Edit打开房间元数据弹窗
批量更新选择房间 → Bulk update metadata打开批量更新弹窗
批量删除房间选择房间 → Delete rooms打开删除确认
清除选择Clear selection不再选中任何房间

查找房间​

  1. 前往 Rooms。

  2. 使用 Search 输入房号或房型。

    ✓ 匹配的房间会显示在列表中。

排序房间列表​

  1. 点击 Room Number 按升序排序。

  2. 再次点击 Room Number 按降序排序。

    ✓ 房号会按自然顺序排序，例如 DK(1)、DK(2)、DK(10)。

编辑房间元数据​

  1. 找到房间并点击 Edit。

  2. 在 Gender Restrictions 中选择一种：

    • No restrictions
    • Restrict to specific genders → 选择 Male 或 Female

  3. 在 General Information 中输入备注或特殊说明。

  4. 点击 Save。

    ✓ 你会看到 "Room metadata updated successfully"。

批量更新多个房间​

  1. 勾选房间复选框。

  2. 点击 Bulk update metadata。

  3. 选择要更改的内容：

    • Gender restrictions（保留、清除或设置为特定性别）
    • General information（保留、替换或清除）

  4. 点击 Apply Changes。

    ✓ 成功提示会显示已更新多少个房间。

删除多个房间​

  1. 勾选房间复选框。

  2. 在选择栏中点击 Delete rooms。

  3. 再次点击 Delete rooms 确认。

    ✓ 提示会显示已删除多少个房间。

删除前

已分配给当前或即将入住预订的房间可能无法删除。 请先移动或取消这些预订。

小贴士​

  • 使用 General Information 记录客房部备注或特殊处理要求。
  • 限制条件应符合酒店政策，以免影响房间分配。

故障排查​

“A PMS room identifier is required”​

你会看到： 编辑弹窗关闭并显示警告。

解决方法：

  1. 确认房间有 PMS 房间 ID。
  2. 从 PMS 同步房间。
  3. 再试一次。

批量更新只完成了一部分​

你会看到： "Updated X rooms. Y failed."

解决方法：

  1. 查看仍然被选中的房间。
  2. 重新尝试批量更新。

批量删除只完成了一部分​

你会看到： "Deleted X rooms. Y failed."

解决方法：

  1. 查看删除失败的房间。
  2. 从这些房间中移除当前或即将入住的预订。
  3. 再次尝试删除。

保存失败​

你会看到： "Failed to update room metadata."

解决方法：

  1. 刷新页面。
  2. 再次尝试保存。

仍然卡住？​

如果出现以下情况，请联系 success@vouch-technologies.com：

  • ❌ 无法编辑任何房间
  • ❌ 批量更新持续失败
  • ❌ 同步后房间消失

建议附上：

  • 房号或 PMS 房间 ID
  • 错误截图
  • 问题发生时间

相关指南​