跳到主要内容

设置 Mews PMS 集成

快速设置

大多数酒店只需要 Access Token。这大约需要 10 分钟。

本指南帮助你将 AVA 连接到 Mews，以便预订和住客详情能够正确同步。

在哪里找到它​

Settings → Essentials → Property Management System (PMS) Integration

快速参考​

设置作用使用时机
Access Token将 AVA 连接到 Mews始终需要
Advanced → Client Token高级连接凭据仅在支持要求时使用
Advanced → Client ID你在 Mews 中的物业标识仅在支持要求时使用
Advanced → Demo Mode使用沙盒端点进行测试仅用于测试环境
Reservation comments将 Mews 服务订单备注拉取到 AVA当 AVA 读取预订或刷新实时计费时
Room payment waiver使用返回的发票来判断是否免除房费当发票标记房费已免收时
Payment waiver keywords在 AVA 支付设置中显示免收关键词字段仅在你的 Mews 连接暴露关键词免收支持时

开始之前​

你需要：

  • 访问 Mews 管理后台
  • 用于 AVA 集成的 Access Token / Token ID
  • 更新 AVA 中 PMS 设置的管理员权限
信息

如果你没有 Access Token，请联系你的 Mews 管理员或 AVA 支持。

如何获取 Mews Access Token​

在 Mews 中按以下步骤操作：

  1. 登录 Mews PMS

  2. 点击侧栏中的 Marketplace

    Mews Marketplace Search

  3. 点击 My Subscriptions

    Mews Subscriptions

  4. 找到 Vouch AVA Front Desk Agent

  5. 点击 Edit

  6. 打开 Access Token 区域

  7. 复制 Token ID

    Mews Access Token

提示

拿到 token 后请立刻粘贴到 AVA，避免丢失。

配置步骤​

第 1 步：选择 Mews​

  1. 前往 Settings → Essentials → PMS Integration
  2. 点击 Mews 卡片
  3. Mews 配置表单会显示出来

第 2 步：输入 Access Token​

  1. 将 Mews 中的 Token ID 粘贴到 Access Token 字段
  2. 保存后 token 会被隐藏以保护安全
掩码值是安全的

如果你稍后返回页面时看到的是掩码字符，请保持原样并点击 Save。 AVA 会保留已保存的 Access Token、Client Token 和 Client ID。

如果你需要 Advanced Mews 设置（仅限支持）
  1. 点击 Advanced
  2. 输入支持提供的值：
    • Client Token
    • Client ID
  3. 可选：如果你在使用沙盒端点进行测试，请打开 Demo Mode
注意

除非支持人员要求，否则不要修改 Advanced 值。错误的值会导致同步中断。

第 3 步：保存​

  1. 点击页面底部的 Save
  2. 查看成功提示
  3. Access Token 字段会显示占位符以保护密钥

连接后会发生什么​

  • ✅ AVA 开始使用 Mews 数据同步预订和住客详情
  • ✅ Access Token 字段会显示掩码字符
  • ✅ 如果以后需要更新 token，可使用 Edit Token
  • ℹ️ 当你保存其他 Mews 字段时，AVA 会保留当前 Demo Mode 值。
  • ℹ️ 生产环境不会强制把 Demo Mode 设为 OFF。
  • ✅ 当 AVA 能解析时，Mews 公司名称现在会填充预订来源标签。
  • ✅ Mews 预订在 AVA 中会被视为酒店代收。
  • ✅ Do Not Move 房锁状态会与 Mews 保持同步。
  • ✅ AVA 在自动分房时会跳过被锁定的 Mews 房间，并在可能时重试其他干净房间。
  • ✅ AVA 会把 Mews 服务订单备注拉入预订备注。
  • ✅ 当发票返回免收标记时，匹配到的备注可以免除房费。
  • ✅ AVA 会先加载完整发票详情，再检查单条预订读取时的免收标记。
  • ✅ AVA 会保持未分配的 Mews 房间在多房间预订中可见。
  • ✅ 客人档案更新可以触发自动补发到店前邮件的追赶。
  • ✅ Mews 实时计费会在替换已存余额前重新检查已配置的支付政策备注。
  • ✅ 完整发票免收可以把应付余额清零，同时保留押金和支付记录以便审计。
  • ✅ AVA 会在账单同步元数据中标记已验证的免收匹配。
  • ✅ 如果 AVA 无法验证已配置的备注，它会保留已存发票。
  • ✅ 这也包括在 AVA 看到已验证 live 评估之前保留的免收状态。

对客人与员工的影响​

  • 客人表单会根据 Mews 规则调整。 必填字段和隐藏字段会根据 Mews 配置变化，因此客人只会看到需要填写的内容。
  • 预订查找使用 Mews。 如果未配置 Mews，客人查找步骤会失败。
  • 预订来源标签可以显示 Mews 公司名称。 如果 AVA 能解析出公司名称，就会使用该名称而不是原始公司 ID。
  • Mews 来源代收现在默认按酒店代收处理。 这能让来源标签与 AVA 接收到的预订合同保持一致。
  • 被锁定的房间在 AVA 中保持锁定。 如果 Mews 将预订标记为锁定，Streamliner 会在换房视图中显示锁定图标。
  • 服务订单备注会变成预订备注。 员工在查找预订时可以查看备注文本。
  • 已免除的房费仍然可解释。 当 Mews 将发票标记为已免除时，AVA 会把备注文本作为免收原因显示。
  • 实时计费采用相同的免收规则。 Room List 会在替换已存余额前重新检查已配置的备注。
  • 完整免收仍会保留审计记录。 AVA 可以显示零余额，同时保留押金和支付行。
  • Payment waiver keywords 是否显示取决于能力支持。 如果 Mews 暴露了这些能力，AVA 就会在支付设置中显示免收关键词字段。
  • 客人邮箱变更可以触发补发追赶。 当 Mews 发送客人更新时，AVA 可以把已过期的到店前邮件重新发送到最新地址。

多房间预订仍保持完整​

AVA 会保持每个已预订的 Mews 房间可见，即使 Mews 还没有分配实体房间。 主房间仍然排在列表第一位。 这可以帮助员工在查找和入住时看到完整预订。

共享预订引用保持独立​

如果多个 Mews 预订共享同一个外部预订 ID 或家庭 ID，AVA 会把每个预订保持独立。 客人、房间、日期、状态和总额都会保留在你打开的那条预订上。

共享预订邮箱会创建独立住客​

如果两位客人共用同一个预订邮箱，AVA 会创建独立的 Mews 客户。 只有当证件号码与现有记录匹配时，AVA 才会复用该客户。 如果 AVA 已经有直接的 Mews 住客引用，它会继续更新该住客。

住客更新保持最新​

当 Mews 发送住客档案更新时，AVA 会刷新它用于补发检查的住客记录。 如果住客邮箱已变更，AVA 可以在同步后重新发送已过期的到店前邮件。

精确匹配

AVA 会按完整单词匹配免收关键词。 PAID 不会匹配 UNPAID。

实时计费免收​

当 Room List 或预订刷新需要再次应用 Mews 支付政策时，使用这一功能。

AVA 会在替换已存余额前检查最新的 Mews 服务订单备注。 只有在至少配置了一个支付政策列表时才会这样做。 如果 AVA 无法验证这些备注，它会保留已存发票。 这也包括先前已免收的快照。

当 Mews 返回完整发票免收时，AVA 会显示零应付余额。 它仍会保留押金和支付记录以便审计。 这样即使总额变成零，员工也能查看实际收取了什么。 当实时评估已验证时，它还可以替换过时的免收快照。

提示

等 Mews 完成同步后再刷新预订。 这样 AVA 能拿到最新的备注和发票状态。

故障排查​

“Access Token is required” 错误​

你会看到： “Access Token is required”

解决方法：

  1. 粘贴 Mews 的 Token ID
  2. 再次点击 Save
  3. ✓ 保存后错误会消失

Token 已保存，但没有同步数据​

你会看到： 你已保存 token，但预订没有出现

解决方法：

  1. 等待 10-15 分钟完成首次同步
  2. 刷新页面并确认仍然选中了 Mews
  3. 请 Mews 管理员确认 AVA 订阅仍然处于活动状态
  4. 如果问题持续，请联系 AVA 支持

刷新后又回到掩码字段​

你会看到： 刷新页面后，Access Token 或高级字段再次显示掩码字符。

解决方法：

  1. 保持掩码值不变。
  2. 再次点击 Save。
  3. ✓ AVA 会保留已保存的 Mews 凭据。

找不到 Client Token、Client ID 或 Demo Mode​

你会看到： 看不到 Client Token、Client ID 或 Demo Mode 字段

解决方法：

  1. 点击 Advanced
  2. ✓ 高级字段会显示在 Advanced 区域内

Demo Mode 已开启，但同步看起来不对​

你会看到： 缺少预订或出现意外测试数据

解决方法：

  1. 关闭 Demo Mode
  2. 点击 Save
  3. 刷新页面并检查连接状态
  4. 如果问题持续，请联系支持

保存后 Demo Mode 不一致​

你会看到： 刷新后 Demo Mode 复选框发生变化，或者与已保存的 Mews 设置不一致。

解决方法：

  1. 打开 Advanced。
  2. 检查 Demo Mode 的值。
  3. 只保存你想要的那项修改。
  4. 刷新页面。
  5. 如果复选框仍然与已保存的 Mews 配置不一致，请联系支持。

某个房间没有出现在换房中​

你会看到： Allow move room 中缺少该房间。

解决方法：

  1. 在 Mews 中检查预订。
  2. 如果该房间应该可移动，请移除房锁。
  3. 在 AVA 中刷新该预订。
  4. 再试一次换房。

Mews 阻止了房间分配​

你会看到： 入住或换房时显示 “space is blocked” 或 “room unavailable”。

解决方法：

  1. 等待 AVA 尝试另一间干净房间。
  2. 如果没有可用干净房间，请在 Mews 中分配其他房间。
  3. 刷新 AVA 后重试。

Room List 在免收后仍显示余额​

你会看到： Mews 本应免收，但 Room List 仍显示支付金额。

解决方法：

  1. 检查预订的 Mews 服务订单备注。
  2. 确认免收关键词是独立单词。
  3. 确认 AVA 中仍然配置了支付政策。
  4. 等 Mews 同步完成后刷新预订。
  5. 如果 AVA 无法验证这些备注，它会继续把余额视为应付。

房费仍然需要支付​

你会看到： Mews 预订仍在要求支付房费。

解决方法：

  1. 在 Mews 中打开该预订。
  2. 检查服务订单备注。
  3. 确认备注使用的是准确的免收措辞。
  4. 在 AVA 中刷新该预订。
  5. 如果支付仍然显示，请联系支持。

免收原因看起来不对​

你会看到： AVA 已免除房费，但原因文本与预期不符。

解决方法：

  1. 检查匹配到的 Mews service order note。
  2. 确认备注文本就是你预期的那条。
  3. 记住 AVA 只匹配完整单词。
  4. 如果免收原因仍然不对，请联系支持。

验证清单​

  • Mews 已在 Select PMS Provider 中选中
  • Access Token 已输入并保存且没有错误
  • 刷新后 Access Token 字段显示掩码字符
  • 预订开始从 Mews 同步

仍然卡住？​

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

  • ❌ 15 分钟后同步仍未开始
  • ❌ 你看到无法解决的保存错误
  • ❌ 你需要 Advanced 设置但没有相应值
  • ❌ 实时余额刷新后仍与 Mews 不一致
  • ❌ 完整免收没有把应付余额清零
  • ❌ 已验证的免收元数据缺失

建议附上：

  • PMS Integration 部分截图
  • 你的 PMS 提供商（Mews）
  • 具体的错误文本（如有）
  • 预订确认号
  • Mews 备注和 AVA 余额截图
  • 发票上次同步时间