设置权益支持
大多数酒店大约 5 分钟即可完成。 你只需要 PMS 支持和一个管理员账号。
当你希望 Entitlements 显示早餐之类的住客权益时，请使用本指南。 它也适用于你需要把这些权益分配到房价计划，并设置住客何时可以兑换时。
你将配置什么
| 任务 | 控制内容 | 使用位置 |
|---|---|---|
| PMS entitlement support | 显示扫描、权益和活动功能 | Entitlements 页面 |
| PMS keycard reading | 允许为 Entitlements 扫描实体卡 | Settings → Room Access |
| Benefit catalog | 创建或编辑权益定义 | Entitlements → Benefits |
| Rate plan assignments | 将权益绑定到房价计划 | Rates & Availability → Rate Plans |
| Redemption timing | 设置住客何时可以使用权益 | Entitlements → Benefits |
| Ledger sync | 先记录消费，再同步到 PMS | Entitlements → Activity |
同一个权益目录在手机和桌面端都会显示。 变化的只是布局。
时间规则如何运作
AVA 会结合营业日期、分配时间、累计时间和兑换时间，以及任何 PMS 排期，来判断权益是否可用。 当 PMS 提供排期时，AVA 会优先遵循该排期。 如果 PMS 数据不完整，AVA 只会在规则可安全解释时推导时间。 Streamliner 会为用于兑换的资格签名，而 Entitlements 页面会使用这个已签名结果。
这样可以让早餐和类似权益跟随酒店当天的营业日，而不只是日历日期。
营业日期和 PMS 排期日期
当 PMS 排期使用已入住的住宿晚次时，AVA 会将两个日期分开处理：
- 酒店营业日期控制员工今天是否可以兑换权益。
- PMS 排期日期标识要读取和更新的额度行。
例如，8 月 28 日兑换的早餐可以使用日期为 8 月 27 日的 PMS 行。 没有明确住宿晚次依据的排期仍会使用酒店营业日期。 同一规则适用于每日权益，以及按住宿计次权益的有效日期。
Mews 入账日期
Mews 通常会将权益记入已入住的住宿晚次。 例如，8 月 27 日的入账可能显示为 8 月 28 日的早餐。 当 Mews 产品目录不可用时，AVA 仍会保留这一住宿晚次依据。 明确指定当日的排期则使用提供的兑换日期。 这包括 PostingTimeUnit、到店日和离店日排期。
Opera 可以将次日套餐存储在已入住的住宿晚次上。 AVA 会读取 Opera 的排期标志，并将权益放在实际兑换日期。 它仍会将兑换写入匹配的 PMS 排期行。 例如，8 月 28 日兑换的早餐可以使用 Opera 中 8 月 27 日的行。
开始前
请先准备好以下内容：
- 你可以打开 Settings → Essentials。
- 你的 PMS 支持住客权益。
- 你的 PMS 支持权益目录访问或房价计划分配。
- 如果需要扫描卡片，你的 PMS 提供商已验证实体钥匙卡读取功能。
- 你知道哪些权益应该显示在住客住宿中。
- 你有权限编辑设置或房价计划。
如果 Entitlements 页面被禁用，说明你的 PMS 支持缺失或未启用。
检查 PMS 支持
-
打开 Settings → Essentials → PMS Integration。
-
确认你的 PMS 已连接并处于活动状态。
-
打开 Entitlements。
-
确认你能看到 Scan、Benefits 和 Activity 选项卡。
✓ 受支持的 PMS 会显示这些权益选项卡。
如果某个选项卡缺失，说明你的 PMS 没有暴露该能力。 有些酒店只能扫描和消费。
启用 PMS 钥匙卡扫描
实体卡扫描同时需要 PMS 支持和 Room Access 读取能力。 即使没有卡片读取功能，仍可手动查询房间和确认信息。
-
打开 Settings → Room Access → Keycard Encoding。
-
选择 PMS Integration。
-
确认 PMS 提供商和编码器设备正确无误。
-
开启 Enable physical keycard reading。
-
点击 Save。
-
返回 Entitlements 并重新加载页面。
✓ 当存在可用的快照和符合条件的编码器时，会显示 Start scanning。
该设置默认关闭。 只有在 PMS 提供商确认酒店的读取 API 已准备就绪后，才能启用它。 读取关闭时，编码仍会继续。
管理权益目录
-
打开 Entitlements → Benefits。
-
如果你可以创建权益，请点击 New benefit。
-
输入 Code 和 Name。
-
使用 Each guest 或 Each room 设置领取对象。
-
使用 Every night 或 Once per stay 设置累计频率。
-
选择住客何时可以使用它。
-
点击 Save benefit。
✓ 该权益会出现在目录列表中。
如果目录由 PMS 管理，你只能在这里查看权益。 PMS 同步更新后才会显示修改。
将权益分配到房价计划
-
打开 Rates & Availability → Rate Plans。
-
找到你要配置的房价计划。
-
点击 Manage benefits 或 View benefits。
-
从现有目录中选择权益。
-
设置每项权益的数量。
-
点击 Save assignments。
✓ 该房价计划下的预订会获得这些权益。
房价计划现在只能从权益目录中选择。 你不能在房价计划弹窗里新建权益定义。 如果你需要更改分配、累计或兑换时间，请编辑权益本身。
验证账本
-
打开 Entitlements → Activity。
-
检查最新的兑换记录。
-
确认你能看到以下状态之一：
- Saved in Streamliner
- PMS sync pending
- PMS synced
- Ledger only
- PMS sync failed
-
对失败的同步使用 Retry。
✓ Streamliner 会先记录兑换。 ✓ 在受支持的情况下，之后再同步到 PMS。
故障排查
出现 “An active PMS connection is required”
你会看到： 即使 Settings → Essentials → PMS Integration 显示已连接，Entitlements 页面仍提示 An active PMS connection is required。
解决方法：
- 在确认 PMS 连接后重新加载 Entitlements。
- 如果你刚切换酒店，请重新打开正确的酒店后再试。
- 如果仍然出现该提示，请退出登录再登录。
Entitlements 现在会读取当前酒店的活动 PMS 配置。 这样可以让页面与 PMS Integration 中看到的连接保持一致。
Entitlements 页面被禁用
你会看到： Entitlements 页面显示禁用横幅。
解决方法：
- 请管理员确认你的套餐。
- 确认你的 PMS 集成已启用。
- 重新加载 Entitlements 页面。
Benefits 选项卡是只读
你会看到： 你可以查看权益，但不能创建或编辑它们。
解决方法：
- 检查你的 PMS 是否管理目录。
- 请管理员授予设置写权限。
- 重新加载 Entitlements。
房价计划权益无法保存
你会看到： 权益抽屉关闭了，但房价计划仍保留旧权益。
解决方法：
- 确认你有设置写权限。
- 确认你的 PMS 支持房价计划分配。
- 重新打开房价计划并再次保存。
同步一直挂起或失败
你会看到： 活动记录一直处于挂起状态，或者显示同步失败。
解决方法：
- 对失败记录点击 Retry。
- 如果重试仍失败，请检查 PMS 连接。
- 期间继续使用 Streamliner 账本。
某项权益今天看起来不可用
你会看到： 权益出现在目录中，但今天的住宿无法使用。
解决方法：
- 检查预订日期和酒店营业日期。
- 打开该权益并查看其时间规则。
- 如果目录由 PMS 管理，请在 PMS 中确认排期。
如果 PMS 会发送排期，AVA 会先按该排期判断权益是否可用。 如果权益从第二天才开始，AVA 会阻止到店当天兑换。
对于 Opera 或 Mews，如果早餐今天不可用，请检查已入住住宿晚次对应的行。
某项权益使用了错误的排期日期
你会看到： 权益今天可用，但其 PMS 排期显示在前一个住宿晚次。
解决方法：
-
确认酒店当前的营业日期。
-
检查已入住住宿晚次对应的 PMS 行。
-
在 PMS 中确认权益的排期依据。
-
再次尝试前刷新 Entitlements。
✓ AVA 应按今天的营业日期进行兑换，并更新匹配的 PMS 行。
仍然卡住？
如果出现以下情况，请联系 success@vouch-technologies.com：
- ❌ 刷新后 Entitlements 页面仍被禁用
- ❌ 权益始终不出现在目录中
- ❌ 房价计划分配无法保存
- ❌ 活动记录一直停留在挂起状态
建议附上：
- PMS 名称
- 一个权益代码或房价计划名称
- 页面或抽屉的截图