设置权益支持
大多数酒店大约 5 分钟即可完成。 你只需要 PMS 支持和一个管理员账号。
当你希望 Entitlements 显示早餐之类的住客权益时，请使用本指南。 它也适用于你需要把这些权益分配到房价计划，并设置住客何时可以兑换时。
你将配置什么
| 任务 | 控制内容 | 使用位置 |
|---|---|---|
| PMS entitlement support | 显示扫描、权益和活动功能 | Entitlements 页面 |
| 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 页面会使用这个已签名结果。
这样可以让早餐和类似权益跟随酒店当天的营业日，而不只是日历日期。
开始前
请先准备好以下内容：
- 你可以打开 Settings → Essentials。
- 你的 PMS 支持住客权益。
- 你的 PMS 支持权益目录访问或房价计划分配。
- 你知道哪些权益应该显示在住客住宿中。
- 你有权限编辑设置或房价计划。
如果 Entitlements 页面被禁用，说明你的 PMS 支持缺失或未启用。
检查 PMS 支持
-
打开 Settings → Essentials → PMS Integration。
-
确认你的 PMS 已连接并处于活动状态。
-
打开 Entitlements。
-
确认你能看到 Scan、Benefits 和 Activity 选项卡。
✓ 受支持的 PMS 会显示这些权益选项卡。
如果某个选项卡缺失，说明你的 PMS 没有暴露该能力。 有些酒店只能扫描和消费。
管理权益目录
-
打开 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 会阻止到店当天兑换。
仍然卡住？
如果出现以下情况，请联系 success@vouch-technologies.com：
- ❌ 刷新后 Entitlements 页面仍被禁用
- ❌ 权益始终不出现在目录中
- ❌ 房价计划分配无法保存
- ❌ 活动记录一直停留在挂起状态
建议附上：
- PMS 名称
- 一个权益代码或房价计划名称
- 页面或抽屉的截图