跳到主要内容

设置 Mews PMS 集成

快速设置

大多数酒店只需输入 Access Token。如有需要，AVA 会提供高级值。 整个过程大约需要 10 分钟。

本指南帮助你将 AVA 连接到 Mews，以便正确同步预订和住客详情。 本指南还说明 AVA 如何处理包含在费率中的产品，例如 OTA 费率中捆绑的早餐。

在哪里找到它​

Settings → Essentials → Property Management System (PMS) Integration

快速参考​

设置控制内容使用时机
Access Token将 AVA 连接到 Mews始终需要
Advanced → Client Token必需的集成凭据通常由 AVA 部署提供
Advanced → Client ID必需的 Mews 客户端标识符通常由 AVA 部署提供
Advanced → Demo Mode使用沙盒端点进行测试仅用于测试环境
Reservation comments将 Mews 服务订单备注拉取到 AVAAVA 读取预订或刷新实时计费时
Room payment waiver使用返回的发票判断是否免除房费发票将房费标记为已免收时
Accommodation charge policies在 AVA 支付设置中显示住宿免收和隐藏控件仅当你的 Mews 连接提供支付政策支持时

开始之前​

你需要：

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

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

高级值

Mews 需要 Client Token 和 Client ID。 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 实时计费会在替换已存余额前重新检查已配置的支付政策备注。
  • ✅ 完整发票免收可以将应付余额清零，同时保留押金和支付记录以便审计。
  • ✅ 已验证的费率包含产品（例如捆绑早餐）可以遵循房间套餐免收规则。
  • ✅ Mews 福利入账通常使用实际入住夜晚，因此 8 月 27 日的入账可能显示为 8 月 28 日早餐。
  • ✅ 明确的当天福利计划会使用所提供的兑换日期，即使产品目录不可用。
  • ✅ 即使 Mews 报告为 Once 但按夜间入账，与房间关联的服务费仍可遵循房间套餐免收规则。
  • ✅ 仅因免收后的住宿四舍五入残差而产生的 THB 0.01 正余额会被隐藏。
  • ⚠️ 未分类的正费用和真实额外费用仍需支付，包括真实的 THB 0.01 额外费用。
  • ⚠️ 如果 AVA 无法证明产品分类，则会采取安全失败处理。
  • ✅ 收取意外余额前，请对照完整的 Mews 发票进行比较。

对住客和员工的影响​

  • 住客表单会根据 Mews 规则调整。 必填字段和隐藏字段会根据 Mews 配置变化，因此住客只会看到所需内容。
  • 预订查找使用 Mews。 如果未配置 Mews，住客查找步骤会失败。
  • 已验证的包含产品可以遵循免收规则。 当 Mews 证明费率包含某产品时，AVA 会将其视为住宿费用。
  • 与房间关联的服务费仍包含在内。 即使 Mews 报告为 Once 但按夜间入账，AVA 也能识别与房间夜间产品关联的费用。
  • 员工查找仍然可用。 员工可以使用 Staff Access 对照实时 PMS 账单。
  • 无法明确分类的免收会采取安全失败处理。 启用房费收取后，AVA 会在查找期间将住客引导至前台。AVA 会暂不收取未经验证的金额，交由员工审核。
  • 预订来源标签可以显示 Mews 公司名称。 如果 AVA 能解析出公司名称，就会使用该名称而不是原始公司 ID。
  • Mews 来源代收现在默认按酒店代收处理。 这能让来源标签与 AVA 接收到的预订合同保持一致。
  • 被锁定的房间在 AVA 中保持锁定。 如果 Mews 将预订标记为锁定，Streamliner 会在换房视图中显示锁定图标。
  • 服务订单备注会成为预订备注。 员工在查找预订时可以查看备注文本。
  • 已免除的房费仍然可解释。 当 Mews 将发票标记为已免收时，AVA 会显示备注文本作为免收原因。
  • 实时计费采用相同的免收规则。 Room List 会在替换已存余额前重新检查已配置的备注。
  • 完整免收仍会保留审计记录。 AVA 可以显示零余额，同时保留押金和支付行。
  • 无法明确的免收分类需要审核。 AVA 不会将未经验证的免收金额显示为可收取金额。
  • 意外余额需要审核。 收取前请将显示金额与 Mews 实时账单进行比较。
  • 住宿费用政策取决于能力支持。 如果 Mews 提供这些政策，AVA 会在支付设置中显示免收和隐藏控件。
  • 住客邮箱变更可以触发补发追赶。 当 Mews 发送住客更新时，AVA 可以将已过期的到店前邮件重新发送到最新地址。

多房间预订仍保持完整​

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

共享预订引用保持独立​

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

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

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

住客更新保持最新​

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

精确匹配

AVA 会完全匹配已配置的住宿政策值。 当某个值不匹配时，请检查完整的 Mews 发票。

实时计费免收​

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

AVA 会在替换已存余额前检查最新的 Mews 服务订单备注。 只有在至少配置了一个支付政策列表时，AVA 才会这样做。

员工仍可进行查找，以便将预订与 Mews 实时账单进行比较。 当 Mews 证明某个费率包含产品属于已预订费率时，免收规则会涵盖该产品。 即使 Mews 报告为 Once 但按夜间入账，与房间关联的服务费也遵循同一免收规则。 仅有 Once 标签不会产生额外费用，也不会阻止账单审核。 如果 AVA 无法证明分类，则会暂不收取未经验证的应付金额，交由员工审核。 启用房费收取后，AVA 会阻止预订查找并将住客引导至前台。

较小的住宿四舍五入残差​

住宿免收后，Mews 可能会因夜间服务费四舍五入而留下正数 THB 0.01 残差。 当每个正费用部分都属于住宿费用时，AVA 会在该残差进入支付流程前将其隐藏。 未分类或真实额外的 THB 0.01 费用仍需支付。

AVA 会先验证四舍五入产品，再将其视为住宿费用：

  • 产品来自与房间预订关联的服务订单。
  • Mews 报告其为零价 Absolute 定价和 Once 频率。
  • 产品使用该房间的会计类别。

只有经过验证的产品行会遵循住宿免收规则。 无关或未经验证的产品行仍需支付。

看到任何正余额时，请检查完整的 Mews 发票。 如果余额包含额外费用或未分类费用，请收取该余额。

当 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 仍显示支付金额。

发生原因： 余额可能是真实额外费用、未分类费用，或超过 THB 0.01。

解决方法：

  1. 在 Mews 中检查预订的完整发票。
  2. 确认预订符合 Accommodation Charge Policies。
  3. 确认 AVA 中仍然配置了这些政策值。
  4. 等 Mews 同步完成后刷新预订。
  5. 不要收取未经验证的金额。
  6. 请前台员工审核发票。
THB 0.01 住宿残差

只有当正数 THB 0.01 余额是免收后的住宿四舍五入残差时，AVA 才会将其隐藏。 真实或未分类的 THB 0.01 费用仍需支付。

房费仍然需要支付​

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

发生原因： 免收规则未匹配，或 AVA 需要验证计费分类。

解决方法：

  1. 在 Mews 中打开该预订。
  2. 检查完整发票。
  3. 确认预订符合 Accommodation Charge Policies。
  4. 在 AVA 中刷新该预订。
  5. 不要收取未经验证的金额。
  6. 如果支付仍然显示，请联系支持。

捆绑产品需要审核​

你会看到： 某个包含在内的 Mews 产品（例如早餐）需要账单审核。

发生原因： AVA 无法证明该产品是否属于已预订费率。

与房间关联的服务费

仅因为 Mews 报告服务费为 Once，与房间夜间产品关联的服务费不应需要审核。 如果仍需审核，请检查是否存在其他未分类产品或发票不匹配。

解决方法：

  1. 在 Mews 中检查费率包含的产品和完整发票。
  2. 确认预订符合 Accommodation Charge Policies 中的某个值。
  3. 在 AVA 中刷新该预订。
  4. 不要收取未经验证的金额。
  5. 请前台员工审核完整的 Mews 发票。

查找期间住客被引导至前台​

你会看到： 预订查找后，住客看到前台审核消息。 住客无法继续进行房间或支付步骤。

发生原因： 已配置的住宿政策匹配，但 Mews 无法对某项费用进行分类。

解决方法：

  1. 检查 Mews 费率、包含的产品和完整发票。
  2. 确认匹配值位于 Settings → Payment → Accommodation Charge Policies。
  3. 等 Mews 完成同步后刷新预订。
  4. 使用完整的 Mews 发票确认应付金额。
  5. 如果仍需要审核，请前台员工完成入住。

AVA 不会使用已存余额，也不会收取未经验证的金额。

Mews 账单需要审核​

你会看到： 显示的 Mews 余额与完整发票不一致。

发生原因： AVA 无法证明免收涉及的产品分类。

解决方法：

  1. 通过 Staff Access 打开该预订。
  2. 在 Mews 中审核预订费率、包含的产品和完整发票。
  3. 确认已配置的政策与房间套餐匹配。
  4. 等 Mews 数据完整后刷新 AVA。
  5. 只收取 AVA 和 Mews 都确认应付的金额。
  6. 如果金额仍不一致，请联系 AVA 支持。

免收原因看起来不对​

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

解决方法：

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

验证清单​

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

仍然卡住？​

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

  • ❌ 15 分钟后同步仍未开始
  • ❌ 你看到无法解决的保存错误
  • ❌ 你需要 Advanced 设置但没有相应值
  • ❌ 实时余额刷新后仍与 Mews 不一致
  • ❌ 完整免收没有清除住宿余额
  • ❌ 显示的余额与完整 Mews 发票不一致

建议附上：

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