连接 eZee PMS

快速设置

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

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

脏房规则

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

已占用房保护

AVA 将 eZee 的 Arrived 和 Dayuse 状态视为已占用。 即使房间干净，也会将已占用房排除在分配范围之外。 仅预订状态（例如 Confirmed Reservation）不表示住客已在房内。

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 匹配
• 预订清理：Streamliner 会在抵达前取消 eZee 预订
• 多房间预订：创建一个 eZee 团体预订，并为每个房间设置独立的房型和价格
• 团体取消：取消抵达前的团体预订会取消该预订中的每个房间
• 来源标签保持可读：如果 eZee 提供了业务来源名称，AVA 会使用该名称。
• 来源收款默认按酒店收款：AVA 将 eZee 的预订来源视为酒店收款。
• 房间容量遵循 eZee 限制：当 eZee 留空 max occupancy 时，AVA 会使用成人或儿童上限中较大的值，同时遵循房间的基础入住人数。

成人和儿童上限

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 在 eZee 分配房间流程中只提供干净房间。

解决方法：

1. 打开 Housekeeping。

2. 将一间匹配房标记为 Clean。

3. 返回预订并点击 Refresh。

4. 再次尝试 Assign Room。

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

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 会保留这个更高的基础值。

仍有问题？

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

• ❌ 30 分钟后同步仍然为空
• ❌ Auth Code 反复被拒绝

建议附上：

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

相关指南

• PMS 同步问题
• 入住规则
• 房态清洁面板