跳到主要内容

设置 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 payment method mappings在启用的 Mews 支付类别下记录所选的已捕获支付方式你的酒店需要将 PromptPay、电子钱包、银行卡品牌或自定义来源分别分类时
Guest identity documents当 Mews 有身份文件时提供旅行证件详情进行合规报告或证件审核时
Guest document updates将护照和身份证详情保存到 Mews 身份文件员工在 AVA 中更新住客信息后

开始之前​

你需要：

  • 访问 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

提示

请立即将令牌粘贴到 AVA，以免丢失。

配置步骤​

第 1 步：选择 Mews​

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

第 2 步：输入 Access Token​

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

如果你稍后返回页面时看到掩码字符，请保持原样并点击 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 字段会显示掩码字符
  • ✅ 如果以后需要更新令牌，可使用 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 使用排除状态报告已取消或候补预订时，这些预订不会阻止房间分配。
  • ✅ 住客档案更新可以触发自动补发到店前邮件。
  • ✅ 住客护照和身份证更新会通过 Mews 身份文件保存。
  • ✅ 如果 Mews 拒绝该权限，AVA 会自动使用兼容字段。
  • ℹ️ 新保存的证件可能需要几秒钟才会在所有视图中显示。
  • ✅ 如果 Mews 在入住期间变更预订，AVA 会先核对确切的预订，再报告失败。
  • ✅ 当 Mews 已显示 Started 且已分配房间时，AVA 会继续使用该房间，不会重复入住。
  • ✅ Mews 实时计费会在替换已存余额前重新检查已配置的支付政策备注。
  • ✅ 支付设置可以将所选的已捕获支付方式映射到已启用的、酒店专用的 Mews 外部类别。
  • ✅ 未配置的支付方式会保留其默认入账行为。
  • ✅ 完整发票免收可以将应付余额清零，同时保留押金和支付记录以便审计。
  • ✅ 共享 Mews 账单会将支付归属于群组中的各条预订。
  • ✅ 路由到无关账户所拥有账单的费用不会出现在住客账单中。
  • ✅ AVA 在分配剩余支付前，会先结算未关联的产品订单费用。
  • ✅ 已验证的费率包含产品（例如捆绑早餐）可以遵循房间套餐免收规则。
  • ✅ Mews 费率组规则仅适用于预订费率组中包含的产品。
  • ⚠️ 分配给其他费率组的产品仍需支付。
  • ✅ Mews 福利入账通常使用实际入住夜晚，因此 8 月 27 日的入账可能显示为 8 月 28 日早餐。
  • ✅ 明确的当天福利计划会使用所提供的兑换日期，即使产品目录不可用。
  • ✅ 即使 Mews 报告为 Once 但按夜间入账，与房间关联的服务费仍可遵循房间套餐免收规则。
  • ✅ 仅因免收后的住宿四舍五入残差而产生的 THB 0.01 正余额会被隐藏。
  • ⚠️ 未分类的正费用和真实额外费用仍需支付，包括真实的 THB 0.01 额外费用。
  • ⚠️ 如果 AVA 无法证明产品分类，则会采取安全失败处理。
  • ✅ 收取意外余额前，请对照完整的 Mews 发票进行比较。

对住客和员工的影响​

  • 住客表单会根据 Mews 规则调整。 必填字段和隐藏字段会根据 Mews 配置变化，因此住客只会看到所需内容。
  • 预订查找使用 Mews。 如果未配置 Mews，住客查找步骤会失败。
  • 符合条件的 Mews 查找可以更快继续。 如果查找结果已经确定主要确认号，AVA 会直接使用该结果。
  • 房间容量遵循 Mews 房间类别。 AVA 在预订查找和房间同步期间，会计算该类别的标准容量和已配置的加床数。
  • 加床会计入 Mews 住客上限。 AVA 会在房型、预订房间和入住人数检查中使用合并后的容量。
  • 未知容量仍保持未知。 如果 Mews 返回未知类别或容量为零，AVA 不会自行推断住客上限。
  • Mews 接受超过报告房间容量的额外住客。 AVA 会更新本地入住人数，而 Mews 保持其住客人数不变。
  • 离店日期使用酒店时区。 AVA 会将 Mews 的离店日期匹配到酒店当地日期，并涵盖夏令时变化。
  • 已验证的包含产品可以遵循免收规则。 当 Mews 证明费率包含某产品时，AVA 会将其视为住宿费用。
  • 费率组规则保持适用范围。 AVA 会先解析预订所用的费率组，再应用匹配的 Mews 产品规则。
  • 其他费率组的产品仍需支付。 分配给其他费率组的产品不会遵循免收规则。
  • 与房间关联的服务费仍包含在内。 即使 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 可以将已过期的到店前邮件重新发送到最新地址。
  • 入住状态变更会安全地重新核对。 如果 Mews 在入住期间变更预订，AVA 会先核对确切的预订，再报告失败。
  • 不会重复执行已完成的 Mews 入住。 当预订状态为 Started 且已分配房间时，AVA 会使用该房间继续操作。
  • 换房使用当前分配。 如果员工在入住期间于 Mews 中换房，AVA 会在继续前刷新业务预订和房间数据。
  • 入住不会重复使用旧房间数据。 AVA 使用当前房间获取房间详情，并避免为之前的房间更新客房服务状态。
  • 最新业务读取可能稍慢。 AVA 可能会从 Mews 请求当前预订和房间数据，而不是使用短时间有效的缓存结果。
  • 可用性检查优先使用完整的最新数据。 AVA 不会将不完整的 Mews 页面作为成功的可用性结果。

住客证件号码来自身份文件​

AVA 不会将 Mews 税号视为护照号或旅行证件号码。 除非 Mews 中有身份文件，否则预订和入住读取中的证件号码会留空。

合规报告会单独请求 Mews 身份文件。 报告使用可用的护照、身份证或驾驶证号码。

如果缺少证件号码：

  1. 确认 Mews 中有该住客的旅行证件。

  2. 住客抵达时，在 AVA 中上传或扫描证件。

  3. 查看证件详情前刷新预订。

    ✓ 税号不会在 AVA 中显示为护照号码。

住客证件更新安全同步​

在 AVA 中更新住客信息时，证件详情会使用 Mews 身份文件。 如果 Mews 拒绝写入身份文件，AVA 会自动使用较旧的客户证件字段。

  • Passport 证件会保存为 Mews Passport 证件。
  • 其他受支持的身份文件会保存为 Mews IdentityCard 证件。
  • AVA 会更新匹配的证件，而不是创建重复证件。
  • 如果证件已经是最新状态，AVA 会跳过写入。
  • 缺失的证件字段不会清除 Mews 中已保存的值。
  • 兼容性回退会先匹配已存储的字段，然后再写入。

运行此回退时，无需更改 AVA 设置。 Mews 权限错误可能会暂时通过兼容字段路由证件更新。 护照图像使用单独的上传流程，不受影响。

Mews 可能需要约 2–3 秒才能在所有视图中显示证件。 请在检查已保存的号码或有效期前刷新预订。

多房间预订仍保持完整​

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

对于 Mews v2，当 Mews 提供正数时，每个房间还会带有其房间类别容量。 该容量包括已配置的加床数。 AVA 在检查额外住客登记时，会使用合并后的容量。

共享预订引用保持独立​

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

请求的入住保持自身身份​

AVA 会将请求的 Mews 入住的确认号、日期、住客、房间、状态和财务信息保持在一起。 这样可以避免过去或未来的重复入住为当前入住提供详情。

只有当同组、同服务的关联入住的计划 UTC 入住时间窗口重叠时，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 才能获得最新的备注和发票状态。

共享账单和群组支付​

当多条 Mews 预订共用一张账单时，AVA 会将账单支付归属于每条预订。 这样，已全额支付的群组入住在退房时不会显示为未付款。

AVA 还会在分配剩余支付前处理未关联的产品订单费用。 费用会优先消耗可用支付，而贷项会增加群组可用的支付金额。

如果订单属于群组之外，或计费数据不明确，AVA 仍会将账单发送审核。 这样可以避免住客支付 AVA 无法验证的费用。

已结算的收据和已关闭的发票​

Mews 可能会在另一条预订的返款结算其费用后关闭一张 Receipt。 AVA 会在计算退房余额前读取当前账单状态。

Mews 账单状态AVA 退房结果
Closed + Receipt将账单视为已全额支付，余额为零
Closed + Invoice检查是否存在未支付余额

AVA 不会将另一条预订的返款导入本预订的发票。 这样既能保持预订归属正确，也能避免退房时出现虚假余额。

如果 Mews 无法返回账单，AVA 会保留计算出的余额供审核。 收取意外金额前，请先在 Mews 中检查完整账单。

路由到其他账户的费用​

Mews 可以将费用移至 OTA、公司或其他计费账户的单独账单。 AVA 不会将这些费用及其支付计入住客账单。 住客自己的账单、关联账单和群组成员账单仍会包含在内。

当某一行费用指向预订所属群组之外时，AVA 会检查账单所有者。 账单所有者的账户优先于过时的行账户。 如果 AVA 无法读取账单或解析预订所属群组，则会保留该账单。 这种安全失败行为可以避免因无法读取账单而隐藏余额。

OTA 代收预订

OTA 计费账单可能仍处于打开状态，而住客的应付余额为零。 需要审核结算时，请在 Mews 中检查 OTA 或公司账单。

故障排查​

“Access Token is required” 错误​

你会看到： “Access Token is required”

解决方法：

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

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 规则使用了 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 支持。

Mews 账单刷新耗时过长​

你会看到： 自助入住或账单刷新显示 504 Mews view-billing deadline exceeded。

发生原因： Mews 未能在 AVA 的 40 秒账单时限内返回最新的账单详情。 当实时读取不可用时，AVA 可能会使用已存储的账单快照。

解决方法：

  1. 将显示的余额与 Mews 中的完整发票进行比较。

  2. 在 AVA 中刷新该预订一次。

  3. 不要收取 Mews 未确认的金额。

  4. 如果余额仍不明确，请前台员工完成入住。

  5. 如果超时持续出现，请联系 AVA 支持。

    ✓ 住客应看到明确结果，而不是无限期等待。

你会看到： 群组入住显示欠款，但共享的 Mews 账单已经支付完毕。

发生原因： Mews 可能会将多条预订和支付放在同一张共享账单上。

解决方法：

  1. 在 Mews 中打开完整的共享账单。
  2. 确认账单已关闭，且支付覆盖群组总额。
  3. 等 Mews 完成同步后，在 AVA 中刷新预订。
  4. 再次尝试退房。
  5. 如果余额仍与已付款账单不一致，请联系支持。

路由的费用仍出现在住客账单中​

你会看到： 住客账单包含已移至 OTA、公司或其他账户的费用。

发生原因： Mews 可能仍在同步账单所有者，或者账单无法读取。

解决方法：

  1. 在 Mews 中打开该预订的账单。
  2. 确认路由账单的所有者属于住客群组之外。
  3. 确认费用行位于该路由账单中。
  4. 等 Mews 完成同步后，在 AVA 中刷新预订。
  5. 不要向住客收取路由的费用。
  6. 如果刷新后该金额仍然存在，请联系 AVA 支持。

免收原因看起来不对​

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

解决方法：

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

查找显示另一条 Mews 入住的详情​

你会看到： 重复入住显示了另一条入住的房间、住客、日期或余额。

解决方法：

  1. 在 Mews 中确认请求的确认号。
  2. 检查该入住计划的开始和结束时间。
  3. 确认房间属于请求的入住。
  4. 在 AVA 中刷新该预订。
  5. 如果详情仍属于另一条入住，请让支持人员检查查找结果。
重叠入住

AVA 可能会显示同一 Mews 服务中的重叠房间。 即使共享组或预订引用，连续或相邻的入住仍会保持独立。

Mews 入住显示之前的房间​

你会看到： 员工在 Mews 中移动了预订，但 AVA 仍显示之前的房间。

发生原因： 房间在入住界面打开期间发生了变化。

解决方法：

  1. 在 Mews 中确认当前房间分配。

  2. 在 AVA 中刷新预订。

  3. 继续前确认新房间已显示。

  4. 房间详情与 Mews 一致后继续入住。

  5. 如果仍显示之前的房间，请联系 AVA 支持。

    ✓ AVA 应使用当前的 Mews 房间进行入住。

房间仍显示错误时，请不要反复重试。 联系支持时，请提供预订确认号、两个房间号以及换房时间。

住客证件尚未在 Mews 中显示​

你会看到： AVA 已保存住客证件，但 Mews 没有立即显示。

发生原因： 写入后，Mews 可能会延迟约 2–3 秒读取身份文件。

解决方法：

  1. 等待几秒钟。

  2. 在 AVA 中刷新预订。

  3. 再次在 Mews 中检查住客的身份文件。

  4. 仅当证件仍缺失时重试。

    ✓ Mews 完成处理更新后，证件应会显示。

Mews 拒绝更新后的住客证件​

你会看到： 保存更新后的住客证件时，AVA 显示错误。

发生原因： Mews 因已知的权限拒绝以外的原因拒绝了更新，或发现了冲突证件。

解决方法：

  1. 在 Mews 中确认住客和证件号码。

  2. 如果刚完成另一次更新，请等待几秒钟。

  3. 刷新 AVA。

  4. 将住客更新重试一次。

  5. 如果同一证件仍被拒绝，请联系支持。

    ✓ 单次重试是安全的，不会创建重复证件。

验证清单​

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

仍然卡住？​

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

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

建议附上：

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