跳到主要内容

设置权益支持

快速设置

大多数酒店大约 5 分钟即可完成。 你只需要 PMS 支持和一个管理员账号。

当你希望 Entitlements 显示早餐之类的预订权益时，请使用本指南。 它也适用于你需要将这些权益分配给房价计划，并设置住客何时可以兑换这些权益的情况。

前往： Settings → Essentials

你将配置什么​

任务控制内容使用位置
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
PMS consumption sync可选地将符合条件的消费发送到 PMSEntitlements → Settings
移动端编辑

同一个权益目录在手机和桌面端都会显示。 变化的只是布局。

时间规则如何运作​

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 次日排期

Opera 可以将次日套餐存储在已入住的住宿晚次上。 AVA 会读取 Opera 的排期标志，并将权益放在实际兑换日期。 它仍会将兑换写入匹配的 PMS 排期行。 例如，8 月 28 日兑换的早餐可以使用 Opera 中 8 月 27 日的行。

开始前​

请先准备好以下内容：

  • 你可以打开 Settings → Essentials。
  • 你的 PMS 支持预订权益。
  • 你的 PMS 支持权益目录访问或房价计划分配。
  • 如果需要扫描卡片，你的 PMS 提供商已验证实体钥匙卡读取功能。
  • 你知道哪些权益应该显示在住客住宿中。
  • 你有权限编辑设置或房价计划。
找不到该区块？

如果 Entitlements 页面被禁用，说明你的 PMS 支持缺失或未启用。

选择 PMS 消费同步​

当你希望将符合条件的权益兑换同步到 PMS 时，请使用此酒店级设置。 它不会改变 AVA 记录或报告消费的方式。

  1. 打开 Entitlements → Settings。

  2. 找到 PMS consumption sync。

  3. 打开或关闭开关。

    ✓ AVA 会自动保存该设置。

如果酒店希望由 Vouch 跟踪消费而不写回 PMS，请保持开关关闭。 该设置默认关闭。

同步哪些内容

开关打开时，只有符合条件且未拆分的权益会同步。 PMS 必须支持消费写回。 Opera 和 AVA 目前支持此流程。

现有本地兑换仍保留在本地

打开同步不会补回之前仅保存在本地的兑换记录。 拆分权益始终保留在 Vouch 中。 关闭同步会关闭排队中的任务，但已经发送的请求可能仍会完成。

检查 PMS 支持​

  1. 打开 Settings → Essentials → PMS Integration。

  2. 确认你的 PMS 已连接并处于活动状态。

  3. 打开 Entitlements。

  4. 确认你能看到 Scan、Benefits 和 Activity 选项卡。

    ✓ 受支持的 PMS 会显示权益选项卡。

Entitlements 取决于能力

如果某个选项卡缺失，说明你的 PMS 没有暴露该能力。 有些商户只能扫描和消费。

启用 PMS 钥匙卡扫描​

实体卡扫描同时需要 PMS 支持和 Room Access 读取能力。 即使没有卡片读取功能，仍可手动查询房间和确认信息。

  1. 打开 Settings → Room Access → Keycard Encoding。

  2. 选择 PMS Integration。

  3. 确认 PMS 提供商和编码器设备正确无误。

  4. 开启 Enable physical keycard reading。

  5. 点击 Save。

  6. 返回 Entitlements 并重新加载页面。

    ✓ 当存在可用的快照和符合条件的编码器时，会显示 Start scanning。

仅在验证后启用读取

该设置默认关闭。 只有在 PMS 提供商确认酒店的读取 API 已准备就绪后，才能启用它。 读取关闭时，编码仍会继续。

管理权益目录​

  1. 打开 Entitlements → Benefits。

  2. 如果你可以创建权益，请点击 New benefit。

  3. 输入 Code 和 Name。

  4. 使用 Each guest 或 Each room 设置领取对象。

  5. 使用 Every night 或 Once per stay 设置累计频率。

  6. 选择住客何时可以使用它。

  7. 点击 Save benefit。

    ✓ 该权益会出现在目录列表中。

PMS 管理的目录

如果目录由 PMS 管理，你只能在这里查看权益。 PMS 同步更新后才会显示修改。

将权益分配到房价计划​

  1. 打开 Rates & Availability → Rate Plans。

  2. 找到你要配置的房价计划。

  3. 点击 Manage benefits 或 View benefits。

  4. 从现有目录中选择权益。

  5. 设置每项权益的数量。

  6. 点击 Save assignments。

    ✓ 该房价计划下的预订会获得这些权益。

只能使用已有权益

房价计划现在只能从权益目录中选择。 你不能在房价计划弹窗里新建权益定义。 如果你需要更改分配、累计或兑换时间，请编辑权益本身。

将导入的权益拆分为本地用途​

当一个 PMS 权益需要在 AVA 中对应多个独立用途时，可以使用拆分功能。 例如，一个导入的套餐可以提供早餐和晚间休息室访问。

拆分权益前

拆分不会更改 PMS 中的套餐。 AVA 只会在自己的账本中记录拆分后的兑换。

  1. 打开 Entitlements → Benefits。

  2. 找到导入的 PMS 权益。

  3. 点击其 Split 图标，或点击目录上方的 Add split。

  4. 选择 Imported PMS benefit code。

  5. 为每种用途输入唯一的 Local code 和 Display name。

  6. 为每种用途选择 Same day 或 Following day。

  7. 点击 Save split。

    ✓ 当 PMS 返回完全匹配的来源代码时，AVA 会分别显示这些子用途。

你可以创建两个到十个子用途。 来源 PMS 代码区分大小写，必须与 PMS 响应完全匹配。 每个子用途都会在其配置的日期获得来源额度。

了解拆分兑换规则​

  • AVA 会保留 PMS 中的原始套餐。
  • AVA 会为每个子用途提供独立的本地额度和活动记录。
  • AVA 不会将子用途兑换写回 PMS。
  • 次日子用途使用来源住宿日期之后的下一个日期。
  • 未知的来源排期会保持未验证状态，无法消费。
保护现有兑换历史

子用途一旦产生兑换记录，就不能再编辑或移除拆分。 如果来源权益今天已经使用，请在新的营业日启用拆分。

拆分后的权益不会获得新的额度​

你会看到： 新的拆分子用途显示为已使用或不可用。

原因： 来源权益在该日期已经有 PMS 或 AVA 的使用记录。

解决方法：

  1. 在 PMS 中检查来源权益的使用情况。
  2. 在 Entitlements → Activity 中检查是否已有 AVA 兑换记录。
  3. 使用现有的使用记录，不要启用另一份额度。
  4. 如果来源权益今天已使用，请在新的营业日开始拆分。

验证账本​

  1. 打开 Entitlements → Activity。

  2. 检查最新的兑换记录。

  3. 确认你能看到以下状态之一：

    • Saved in Streamliner
    • PMS sync pending
    • PMS synced
    • Ledger only
    • PMS sync failed

  4. 对失败的同步使用 Retry。

    ✓ Streamliner 会先记录兑换。 ✓ 在受支持的情况下，之后再同步到 PMS。

故障排查​

出现 "An active PMS connection is required"​

你会看到： 即使 Settings → Essentials → PMS Integration 显示已连接，Entitlements 页面仍提示 An active PMS connection is required。

解决方法：

  1. 在确认 PMS 连接后重新加载 Entitlements。
  2. 如果你刚切换酒店，请重新打开正确的酒店后再试。
  3. 如果仍然出现该提示，请退出登录再登录。

Entitlements 现在会读取当前酒店的活动 PMS 配置。 这样可以让页面与 PMS Integration 中看到的连接保持一致。

Entitlements 页面被禁用​

你会看到： Entitlements 页面显示禁用横幅。

解决方法：

  1. 请管理员确认你的套餐。
  2. 确认你的 PMS 集成已启用。
  3. 重新加载 Entitlements 页面。

Benefits 选项卡是只读​

你会看到： 你可以查看权益，但不能创建或编辑它们。

解决方法：

  1. 检查你的 PMS 是否管理目录。
  2. 请管理员授予设置写权限。
  3. 重新加载 Entitlements。

房价计划权益无法保存​

你会看到： 权益抽屉关闭了，但房价计划仍保留旧权益。

解决方法：

  1. 确认你有设置写权限。
  2. 确认你的 PMS 支持房价计划分配。
  3. 重新打开房价计划并再次保存。

同步一直挂起或失败​

你会看到： 活动记录一直处于挂起状态，或者显示同步失败。

解决方法：

  1. 对失败记录点击 Retry。
  2. 如果重试仍失败，请检查 PMS 连接。
  3. 期间继续使用 Streamliner 账本。

PMS 没有收到新的消费​

你会看到： 兑换记录出现在 Activity 中，但 PMS 没有收到这些记录。

解决方法：

  1. 打开 Entitlements → Settings。
  2. 确认 PMS consumption sync 已打开。
  3. 确认 PMS 支持消费写回。
  4. 检查该权益是否未被拆分。

启用开关后，之前的 Ledger only 兑换不会补回。

同步开关无法保存​

你会看到： 开关恢复到之前的状态，或显示错误。

解决方法：

  1. 确认你的角色可以编辑权益设置。
  2. 确认酒店拥有所需的客房访问计费权限。
  3. 刷新 Entitlements 后重试。
  4. 如果错误持续，请联系支持团队。

某项权益今天看起来不可用​

你会看到： 权益出现在目录中，但今天的住宿无法使用。

解决方法：

  1. 检查预订日期和酒店营业日期。
  2. 打开该权益并查看其时间规则。
  3. 如果目录由 PMS 管理，请在 PMS 中确认排期。

如果 PMS 会发送排期，AVA 会先按该排期判断权益是否可用。 如果权益从第二天才开始，AVA 会阻止到店当天兑换。

对于 Opera 或 Mews，如果早餐今天不可用，请检查已入住住宿晚次对应的行。

某项权益使用了错误的排期日期​

你会看到： 权益今天可用，但其 PMS 排期显示在前一个住宿晚次。

解决方法：

  1. 确认酒店当前的营业日期。

  2. 检查已入住住宿晚次对应的 PMS 行。

  3. 在 PMS 中确认权益的排期依据。

  4. 再次尝试前刷新 Entitlements。

    ✓ AVA 应按今天的营业日期进行兑换，并更新匹配的 PMS 行。

仍然卡住？​

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

  • ❌ 刷新后 Entitlements 页面仍被禁用。
  • ❌ 权益始终不出现在目录中。
  • ❌ 房价计划分配无法保存。
  • ❌ 活动记录一直停留在挂起状态。

请附上：

  • PMS 名称
  • 一个权益代码或房价计划名称
  • 页面或抽屉的截图