设置 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 service order notes 拉取到 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 中按以下步骤操作：
-
登录 Mews PMS
-
点击侧栏中的 Marketplace
-
点击 My Subscriptions
-
找到 Vouch AVA Front Desk Agent
-
点击 Edit
-
打开 Access Token 区域
-
复制 Token ID
拿到 token 后请立刻粘贴到 AVA，避免丢失。
配置步骤
第 1 步：选择 Mews
- 前往 Settings → Essentials → PMS Integration
- 点击 Mews 卡片
- Mews 配置表单会显示出来
第 2 步：输入 Access Token
- 将 Mews 中的 Token ID 粘贴到 Access Token 字段
- 保存后 token 会被隐藏以保护安全
如果你稍后返回页面看到的是掩码字符，请保持原样并点击 Save。 AVA 会保留已保存的 Access Token、Client Token 和 Client ID。
如果你需要 Advanced Mews 设置（仅限支持）
- 点击 Advanced
- 输入支持提供的值：
- Client Token
- Client ID
- 可选：如果你在使用沙盒端点进行测试，请打开 Demo Mode
除非支持人员要求，否则不要修改 Advanced 值。错误的值会导致同步中断。
第 3 步：保存
- 点击页面底部的 Save
- 查看成功提示
- Access Token 字段会显示占位符以保护密钥
连接后会发生什么
- ✅ AVA 开始使用 Mews 数据同步预订和住客信息
- ✅ Access Token 字段会显示掩码字符
- ✅ 如果以后需要更新 token，可使用 Edit Token
- ℹ️ 当你保存其他 Mews 字段时，AVA 会保留当前 Demo Mode 值。
- ℹ️ 生产环境不会强制把 Demo Mode 设为 OFF。
- ✅ 当 AVA 能解析时，Mews company names 现在会填充预订来源标签。
- ✅ Mews 预订在 AVA 中被视为 hotel collect。
- ✅ Do Not Move 房锁状态会与 Mews 保持同步。
- ✅ AVA 在自动分房时会跳过被锁定的 Mews 房间，并在可能时重试其他干净房间。
- ✅ AVA 会把 Mews service order notes 拉入预订备注。
- ✅ 当发票返回免收标记时，匹配到的备注可以免除房费。
- ✅ AVA 会先加载完整发票详情，再检查单条预订读取时的免收标记。
- ✅ AVA 会保持未分配的 Mews 房间在多房间预订中可见。
对客人与员工的影响
- 客人表单会根据 Mews 规则调整。 必填字段和隐藏字段会根据 Mews 配置变化，因此客人只会看到需要填写的内容。
- 预订查找使用 Mews。 如果未配置 Mews，客人查找步骤会失败。
- 预订来源标签可以显示 Mews company names。 如果 AVA 能解析出 company name，就会使用该名称而不是原始 company ID。
- Mews source collect 现在默认是 hotel collect。 这能让来源标签与 AVA 接收到的预订合同保持一致。
- 被锁定的房间在 AVA 中保持锁定。 如果 Mews 将预订标记为锁定，Streamliner 会在换房视图中显示锁定图标。
- service order notes 会变成预订备注。 员工在查找预订时可以查看备注文本。
- 已免除的房费仍然可解释。 当 Mews 将发票标记为已免除时，AVA 会把备注文本作为免收原因显示。
- Payment waiver keywords 依据能力决定是否显示。 如果 Mews 暴露了这些能力，AVA 就会在支付设置中显示免收关键词字段。
共享预订邮箱会创建独立住客
如果两位客人共用同一个预订邮箱，AVA 会创建独立的 Mews customer。 只有当证件号码与现有记录匹配时，AVA 才会复用 customer。 如果 AVA 已经有直接的 Mews guest reference，它会继续更新该住客。
AVA 会按完整单词匹配免收关键词。
PAID 不会匹配 UNPAID。
故障排查
“Access Token is required” 错误
你会看到： “Access Token is required”
解决方法：
- 粘贴 Mews 的 Token ID
- 再次点击 Save
- ✓ 保存后错误会消失
Token 已保存，但没有同步数据
你会看到： 你已保存 token，但预订没有出现
解决方法：
- 等待 10-15 分钟完成首次同步
- 刷新页面并确认仍然选中了 Mews
- 请 Mews 管理员确认 AVA 订阅仍然处于活动状态
- 如果问题持续，请联系 AVA 支持
刷新后又回到掩码字段
你会看到： 刷新页面后，Access Token 或高级字段再次显示掩码字符。
解决方法：
- 保持掩码值不变。
- 再次点击 Save。
- ✓ AVA 会保留已保存的 Mews 凭据。
找不到 Client Token、Client ID 或 Demo Mode
你会看到： 看不到 Client Token、Client ID 或 Demo Mode 字段
解决方法：
- 点击 Advanced
- ✓ 高级字段会显示在 Advanced 区域内
Demo Mode 已开启，但同步看起来不对
你会看到： 缺少预订或出现意外测试数据
解决方法：
- 关闭 Demo Mode
- 点击 Save
- 刷新页面并检查连接状态
- 如果问题持续，请联系支持
保存后 Demo Mode 不一致
你会看到： 刷新后 Demo Mode 复选框发生变化，或与已保存的 Mews 设置不一致。
解决方法：
- 打开 Advanced。
- 检查 Demo Mode 的值。
- 只保存你想要的那项修改。
- 刷新页面。
- 如果复选框仍然与已保存的 Mews 配置不一致，请联系支持。
某个房间没有出现在换房中
你会看到： Allow move room 中缺少该房间。
解决方法：
- 在 Mews 中检查预订。
- 如果该房间应该可移动，请移除房锁。
- 在 AVA 中刷新该预订。
- 再试一次换房。
Mews 阻止了房间分配
你会看到： 入住或换房时显示 “space is blocked” 或 “room unavailable”。
解决方法：
- 等待 AVA 尝试另一间干净房间。
- 如果没有可用干净房间，请在 Mews 中分配其他房间。
- 刷新 AVA 后重试。
房费仍然需要支付
你会看到： Mews 预订仍在要求支付房费。
解决方法：
- 在 Mews 中打开该预订。
- 检查 service order notes。
- 确认备注使用的是准确的免收措辞。
- 在 AVA 中刷新该预订。
- 如果支付仍然显示，请联系支持。
免收原因看起来不对
你会看到： AVA 已免除房费，但原因文本与预期不符。
解决方法：
- 检查匹配到的 Mews service order note。
- 确认备注文本就是你预期的那条。
- 记住 AVA 只匹配完整单词。
- 如果免收原因仍然不对，请联系支持。
验证清单
- 已在 Select PMS Provider 中选择 Mews
- Access Token 已输入并保存且没有错误
- 刷新后 Access Token 字段显示掩码字符
- 预订开始从 Mews 同步
仍然卡住？
如果出现以下情况，请联系 success@vouch-technologies.com：
- ❌ 15 分钟后同步仍未开始
- ❌ 你看到无法解决的保存错误
- ❌ 你需要 Advanced 设置但没有相应值
建议附上：
- PMS Integration 部分截图
- 你的 PMS 提供商（Mews）
- 具体的错误文本（如有）