跳到主要内容

连接 eZee PMS

快速设置

连接通常需要 2 分钟。你只需要 eZee 支持提供的 Hotel Code 和 Auth Code。

Streamliner 直接连接 eZee（Absolute / Centrix），实时同步预订、住客详情和房态。

脏房规则

AVA 仅会为干净房间保留 eZee 房间分配。 如果所有匹配房间都是脏房，请在 Housekeeping 中清洁一间房，然后刷新再进行分配。 eZee 仍可能在入住时以错误 117 拒绝脏房。

已占用房保护

AVA 将 eZee 的 Arrived 和 Dayuse 状态视为已占用。 即使房间干净，也会将已占用房排除在分配范围之外。 进行自动分配时，AVA 还会跳过被 Confirmed、Confirmed Reservation、Unconfirmed Reservation、Dayuse Reservation 或 Reserved 预订占用的房间。 即使客房清洁状态显示为干净，这些状态也会保护房间，避免发生冲突分配。 如果当前预订拥有一个被占用的房间，Assisted Check-In 可以验证该确切房间。 其他预订仍无法自动获得该被占用的房间。

eZee 时段占位行

eZee 可能发送 roomid: "0" 的 Morning 和 Night 行。 AVA 会忽略这些占位行，因为它们不是实体房间。 房态更新和房间分配请使用实体空房。

住客身份映射

Streamliner 会将嵌套文档数据、顶层 documentNumber 以及顶层 passportNumber 映射到 eZee 的身份字段。

快速参考​

设置说明
Hotel Code你的物业在 eZee 中的唯一 ID
Auth Code用于身份验证的秘密 API 密钥（只写）
Use Demo Environment在沙盒和正式环境之间切换
使用 API Base URL

除非 eZee 提供了自定义 API 端点，否则请将 Base URL 留空。 不要填写 eZee 的营销网站地址，因为 AVA 无法从该地址读取预订。

1. 准备凭证​

连接前，请确保你已准备好：

  • Hotel Code：可在 eZee 控制台中找到
  • Auth Code：专用 API 密钥（向 eZee 或 Vouch 支持申请）
  • Base URL（可选）：仅在使用自定义 eZee 端点时需要

2. 激活连接​

  1. 前往 Settings → Essentials → PMS Integration

  2. 在 Select PMS Provider 下点击 eZee 卡片

  3. ✓ eZee 卡片显示为已选中

  4. 输入你的凭证：

    • Hotel Code：例如 EZ1234
    • Auth Code：输入你的密钥
    • Base URL：标准云环境请留空（默认）

  5. 确保正式操作时 Use Demo Environment 为 OFF

  6. 点击 Save

    ✓ 状态应更新为 "Connected"

安全提示

保存后，你的 Auth Code 会被掩码为 *****。这是正常现象。要更改它，只需用新代码覆盖该字段。

功能​

连接 eZee 后，你可以使用：

  • 自动预订同步：预订会立即出现在 Streamliner 中
  • 住客档案更新：入住数据和身份字段会回写到 PMS
  • 房态同步：客房清洁状态（Clean/Dirty）会反映到 eZee 中
  • 仅限实体房间：Morning 和 Night 等时段占位行不会显示为房间
  • 房间匹配：精确的 roomID 值会优先于备用的 unitID 匹配
  • 全程可用房间：Assisted Check-In 会提供整个入住期间每晚都可用的房间
  • 精确初始分配：对于已确认、未分配且只有一个房间的预订，ACI 房间卡片上会显示 Find ready rooms，并分配所选实体房间
  • 分配恢复：如果 eZee 未确认结果，请刷新房间分配后再重新搜索
  • 分配确认：AVA 会再次读取预订，然后确认所选房间
  • eZee 分配限制：房间移动、互换、升级以及已分配预订的变更在 AVA 中仍不可用
  • 预订清理：Streamliner 会在抵达前取消 eZee 预订
  • 多房间预订：创建一个 eZee 团体预订，并为每个房间设置独立的房型和价格
  • 团体取消：取消抵达前的团体预订会使用父确认编号取消该预订中的每个房间
  • 团体恢复：如果 eZee 的单项预订读取结果少于 eZee 团体列表中的房间，AVA 会保留完整团体
  • 原生 eZee 增值销售：入住期间可以报价并将启用的 eZee Extra Charges 附加到预订
  • 可安全重放的增值销售：重试附加相同的增值销售不会创建重复的 eZee 费用
  • 已捕获的付款会显示在账单和卡片中：已付款的 eZee 预订会在 AVA 中显示已捕获的付款和剩余余额。该余额包括符合条件的额外项目。
  • 来源标签保持可读：如果 eZee 提供了业务来源名称，AVA 会使用该名称
  • 来源收款默认按酒店收款：AVA 将 eZee 的预订来源视为酒店收款
  • 房间容量遵循 eZee 限制：当 eZee 留空 max occupancy 时，AVA 会使用成人或儿童上限中较大的值，同时遵循房间的基础入住人数
  • eZee 不支持超过报告房间容量的住客：AVA 会将辅助入住控制在计算出的 eZee 限制以内
成人和儿童上限

eZee 的 maximum adults 和 maximum children 是同一房间的两个独立上限。 AVA 不会将两者相加来计算房间总容量。 如果 eZee 提供了明确的 max occupancy 值，该值始终具有最高优先级。

故障排除​

"Invalid Credentials" 错误​

你会看到： 保存时出现错误消息，或者同步立即失败。

解决方法：

  1. 确认 Hotel Code 完全一致

  2. 重新输入 Auth Code（它可能已经轮换）

  3. 确保没有粘贴尾随空格

    ✓ 下一次 PMS 操作时，AVA 会使用更新后的凭证。

更改凭证后出现 eZee code 611​

你会看到： 更改任一值后，eZee 返回 code 611，提示 "Invalid Auth Code or Hotel Code"。

原因： 之前的 PMS 请求可能仍在使用旧凭证完成处理。

解决方法：

  1. 确认 Hotel Code 和 Auth Code 对应同一个 eZee 物业。

  2. 在 Settings → Essentials → PMS Integration 中点击 Save。

  3. 等待保存确认。

  4. 仅重试一次预订或房态清洁操作。

    ✓ 下一次操作会使用新凭证。

如果保存成功后 code 611 仍然存在，请联系支持团队。

连接成功但没有预订​

你会看到： 状态显示 "Connected"，但预订列表为空。

检查：

  • Use Demo Environment 已设为 OFF
  • eZee 中有今天/明天的有效抵达预订
  • 等待 15 分钟，让初始同步周期完成

eZee 返回 API 响应错误​

你会看到： 预订或 Analytics 覆盖范围显示 eZee 响应错误。

原因： Base URL 指向网站或其他非 API 地址。

解决方法：

  1. 打开 Settings → Essentials → PMS Integration。

  2. 选择 eZee。

  3. 标准 eZee 云连接请将 Base URL 留空。

  4. 仅在 eZee 提供自定义 URL 时使用该 URL。

  5. 点击 Save，然后刷新预订或 Analytics。

    ✓ 没有预订的真实日期仍然是有效的零结果。

房态与入住状态不匹配​

你会看到： 房间意外显示为 Occupied 或 Vacant。

原因： eZee 使用当前酒店日期报告入住状态。 AVA 将 Arrived 和 Dayuse 映射为已占用状态。

解决方法：

  1. 在 eZee 中检查房间的住客状态和酒店日期。

  2. 如有需要，在 eZee 中完成住客入住或退房。

  3. 在 AVA 中打开 Housekeeping 并刷新房间列表。

  4. 如果状态仍不正确，请联系支持团队。

    ✓ 房间分配应遵循刷新后的已占用状态。

eZee 拒绝房态清洁更新​

你会看到： 状态更新失败，并显示 Fail 或 Unit Id(s) not found in the system。

原因： eZee 未将该房间作为房态清洁单元进行跟踪。 AVA 现在会保留 eZee 返回的原因。

解决方法：

  1. 记下错误中的房间号。

  2. 确认该房间在 eZee 中配置为房态清洁单元。

  3. 在 eZee 中修正房间映射，或更新另一个已跟踪的房间。

  4. 返回 Housekeeping 并刷新房间列表。

    ✓ 已跟踪的房态清洁单元应能成功更新状态。

分配房间时显示 "No rooms available"​

你会看到： 房间选择器为空，或者 AVA 提示没有可用房间。

原因： AVA 仅提供在整个预订期间都保持可用的符合条件的房间。 它还会检查房态清洁、封锁、房型和预订占用状态。 今天可用的房间，如果之后被另一项预订占用，也可能会被排除。

解决方法：

  1. 打开 Housekeeping。

  2. 在 eZee 中检查是否有 Confirmed、Confirmed Reservation、Unconfirmed Reservation、Dayuse Reservation 或 Reserved 预订占用匹配的房间。

  3. 解决冲突预订，或在 eZee 中选择其他房间。

  4. 如有需要，将另一间匹配房标记为 Clean。

  5. 返回预订并点击 Refresh。

  6. 再次尝试 Assign Room。

    ✓ 房间选择器应至少显示一间符合条件的房间。

选择房间后房间消失​

你会看到： 所选房间不再能供住客完成整个入住期间使用。

原因： 房间列表加载后，eZee 的可用性发生了变化。 AVA 会在写入分配前重新检查入住期间的每一晚。

解决方法：

  1. 在 AVA 中刷新预订。

  2. 在 eZee 中检查房间每一晚的可用性。

  3. 检查房间的房态清洁状况和封锁状态。

  4. 选择预订房型中的另一间符合条件的房间。

    ✓ 只有在 eZee 确认整个入住期间后，AVA 才会分配房间。

AVA 无法确认所选房间​

你会看到： AVA 提示无法验证该分配。

原因： 写入操作或后续的预订读取未能证明最终房间。

解决方法：

  1. 不要立即选择其他房间。

  2. 在 AVA 中刷新预订。

  3. 确认 eZee 中显示的房间。

  4. 仅在预订仍未分配时重试。

    ✓ 刷新后的预订会在你继续操作前显示实体房间。

如果结果仍不明确，请联系支持团队。

eZee 不允许更换此房间​

你会看到： AVA 拒绝移动、互换、升级或更改已分配预订。

原因： eZee 仅支持 AVA 用于初始分配的流程。 预订必须已确认、未分配且只包含一个房间。

解决方法：

  1. 如果预订已有房间，请直接在 eZee 中更改房间。

  2. 在 AVA 中刷新预订。

  3. 仅对已确认、未分配且只有一个房间的预订使用房间选择器。

    ✓ AVA 会显示 eZee 为该预订确认的房间。

自己预分配的房间显示为已占用​

你会看到： Assisted Check-In 对住客预分配的房间显示 Room occupied。

原因： 为了安全起见，eZee 会将未抵达预订的占用保留报告为已占用。 AVA 可以将该保留与同一预订的已抵达住客区分开。

解决方法：

  1. 确认房间号与当前 eZee 预订匹配。

  2. 在 AVA 中刷新预订。

  3. 对同一预订重试 Assisted Check-In。

  4. 仅在需要其他房间时使用 Find ready rooms。

    ✓ AVA 可以保留住客自己的占用房，同时保护该房间不被其他预订使用。

如果显示的房间不正确，请请求支持团队检查 eZee 房间映射。 eZee 的 roomid 和 unitid 值可能在不同实体房间之间重复。

eZee 房间容量看起来比以前低​

你会看到： Assisted Check-In 中某个房间可容纳的剩余住客名额减少。

原因： AVA 不再将 eZee 的成人和儿童上限相加。 这些数值限制的是同一组床位，而不是两组独立的容量池。

解决方法：

  1. 在 eZee 中比较房间的 maximum adults、maximum children 和基础入住人数。

  2. 检查 eZee 是否提供明确的 max occupancy 值。

  3. 使用 AVA 显示的房间容量计算剩余住客名额和辅助入住限制。

  4. 如果 AVA 与 eZee 中配置的值不一致，请联系支持团队。

    ✓ 现有预订仍可容纳其预订的住客人数。

容量示例

如果 eZee 报告 maximum adults 为 4、maximum children 为 3，AVA 使用 4，而不是 7。 如果房间的基础入住人数更高，AVA 会保留这个更高的基础值。

你会看到： eZee 显示已捕获付款，但 AVA 预订卡片或账单中没有显示付款，或余额过高。

原因： eZee 完成记录付款后，AVA 可能需要刷新预订。

解决方法：

  1. 确认付款已显示在 eZee 的预订账单中。

  2. 刷新 AVA 中的预订详情。

  3. 重新打开 Payments 部分，并将 Balance Due 与 eZee 中的余额进行比较。

  4. eZee 已显示付款被捕获时，不要再次收款。

    ✓ 卡片和账单应显示已捕获的付款及剩余余额。

如果刷新后数值仍有差异，请联系支持团队。

eZee 团体取消报告临时 PMS 错误​

你会看到： 取消抵达前团体预订时显示 503 或 PMS 暂时不可用消息。 消息会指出未取消的房间，并列出已取消的房间。

原因： eZee 的取消服务未完成请求。 AVA 会逐个取消团体房间，并在 eZee 失败时报告部分进度。

解决方法：

  1. 在 eZee 中打开团体预订。

  2. 检查每个房间的取消状态。

  3. 等待 eZee 恢复正常响应。

  4. 在 AVA 中刷新预订。

  5. 仅重试一次取消操作。

  6. 确认 eZee 中的每个房间都已取消。

    ✓ AVA 会保留父确认编号，不会将未完成的取消视为成功。

暂不要创建替代预订

在创建替代预订前，请检查 eZee 中的每个房间。 某些房间可能已成功取消，而另一个房间仍处于有效状态。

仍然无法解决？​

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

  • ❌ 30 分钟后同步仍为空
  • ❌ Auth Code 被反复拒绝
  • ❌ eZee 恢复后团体取消仍未完成

建议提供：

  • 你的 Hotel Code
  • 错误消息截图
  • 问题开始的时间