跳到主要内容

连接 eZee PMS

快速设置

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

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

脏房规则

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

住客身份映射

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

快速参考​

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

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. 确保 Demo Mode 处于 OFF，用于正式操作

  6. 点击 Save

    ✓ 状态应更新为 "Connected"

安全提示

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

功能​

连接 eZee 后，你可以获得：

  • 自动预订同步：预订会立即出现在 Streamliner 中
  • 住客档案更新：入住数据和身份字段会回写到 PMS
  • 房态同步：客房清洁状态（Clean/Dirty）会反映到 eZee 中
  • 房间匹配：精确的 roomID 会优先于备用的 unitID 匹配
  • 预订清理：Streamliner 会通过 eZee 的 edit-reservation 流程取消预订
  • 来源标签保持可读：AVA 会在可用时使用 eZee 的 business source 名称
  • 来源收款默认按酒店收款：AVA 会将 eZee 的预订来源视为 hotel collect

故障排除​

"Invalid Credentials" 错误​

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

解决方法：

  1. 确认 Hotel Code 是否完全一致
  2. 重新输入 Auth Code（它可能已经轮换）
  3. 确保没有粘贴尾随空格

连接成功但无预订​

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

检查：

  • Demo Mode 已关闭 (OFF)
  • eZee 中有今天/明天的有效抵达预订
  • 等待 15 分钟，让初始同步周期完成

分房时显示 "No rooms available"​

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

原因： AVA 只会在 eZee 的分房流程中提供干净房间。

解决方法：

  1. 打开 Housekeeping。

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

  3. 返回预订并点击 Refresh。

  4. 再次尝试 Assign Room。

    ✓ 房间选择器应至少显示一间可选房间。

仍有问题？​

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

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

建议附上：

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