跳到主要内容

连接 Furama iPMS

快速设置

开始前，请向 Furama 联系人索取所有必填连接信息。设置通常约需 10 分钟。

本指南帮助你将物业连接至 Furama iPMS，并确认连接已启用。

前往： Settings → Essentials → PMS Integration

快速参考​

设置必填功能
iPMS Base URL是将 AVA 指向 iPMS API 和服务路径
Organisation Unit是在 iPMS 中识别酒店
Control Unit否选择目录查询所用的单位
User Code是获取 iPMS 安全令牌
Business User Code否识别业务请求中的用户
API Key是授权 iPMS 连接
可选默认值

Control Unit 默认使用 Organisation Unit。 Business User Code 默认使用 User Code，并保留字母大小写。

开始之前​

  • 你的物业已启用 Furama iPMS
  • 你可以编辑 Settings → Essentials
  • 你有包含服务路径的完整 iPMS API URL
  • 你有 Organisation Unit、User Code 和 API Key
  • 你知道物业是否需要可选值
保护 API Key

请勿在截图或支持消息中发送 API Key。 AVA 会在设置后隐藏已保存的值。

连接物业​

  1. 前往 Settings → Essentials。
  2. 打开 PMS Integration。
  3. 选择 Furama iPMS 作为 PMS 提供商。
  4. 输入 iPMS Base URL。
  5. 输入 Organisation Unit。
  6. 输入 User Code。
  7. 输入 API Key。
  8. 如果 Furama 提供了单独值，请添加 Control Unit。
  9. 如果不同，请添加 Business User Code。
  10. 选择 Save PMS Settings。

✓ 页面显示“Furama Integration Configured.” ✓ 页面重新加载后，API Key 仍保持隐藏。

使用已发布的 iPMS 连接

AVA 会自动选择当前 Furama 适配器。 你无需选择适配器版本。

验证日常运营​

保存后，使用安全的测试预订验证物业。

  1. 打开 Reservations。

  2. 搜索一个已知的 Furama 预订。

  3. 确认宾客、房间、入住日期和状态。

  4. 在 Rates & Availability 中确认预期房价方案。

  5. 在 Housekeeping 中确认房间状态。

  6. 完成已批准的测试入住和退房流程。

    ✓ AVA 只显示已连接物业支持的操作。

基于能力的控制

部分 AVA 操作取决于当前 PMS 连接。 不支持的控件会隐藏或停用，不会发送不安全的请求。

更新连接信息​

  1. 返回 Settings → Essentials → PMS Integration。

  2. 更新所需的非密钥字段。

  3. 仅在更换 API Key 时选择 Edit Secret。

  4. 输入新的 API Key。

  5. 选择 Save PMS Settings。

    ✓ 不更改已隐藏的 API Key 会保留现有密钥。

故障排除​

未列出 Furama iPMS​

你看到： 提供商列表中没有 Furama iPMS。

解决方法：

  1. 刷新 Settings → Essentials。
  2. 确认你可以编辑 PMS 设置。
  3. 请 AVA 管理员确认物业发布状态。

设置无法保存​

你看到： “Failed to save PMS Integration”。

解决方法：

  1. 填写所有必填字段。
  2. 确认 Base URL 包含 iPMS 服务路径。
  3. 准确检查 Organisation Unit 和 User Code。
  4. 重新输入 API Key，然后再次保存。

缺少目录数据​

你看到： 未显示房价方案、来源或付款类型。

解决方法：

  1. 向 Furama 联系人确认 Control Unit。
  2. 如果它与 Organisation Unit 不同，请输入该值。
  3. 选择 Save PMS Settings。
  4. 重新加载受影响的 AVA 页面。

业务请求被拒绝​

你看到： 可以读取，但更新预订失败。

解决方法：

  1. 确认 Business User Code。
  2. 保留准确的字母大小写。
  3. 再次保存连接。
  4. 使用已批准的测试预订重试。

未显示预订​

你看到： Reservations 中缺少一个已知的 Furama 预订。

解决方法：

  1. 确认入住日期符合当前搜索条件。
  2. 清除筛选条件并重新搜索。
  3. 在 iPMS 中检查该预订。
  4. 查看 PMS 连接错误。

仍需帮助？​

以下情况请联系 success@vouch-technologies.com：

  • ❌ 重新连接后仍缺少 Furama 住宿记录
  • ❌ 必填字段正确，但保存仍失败
  • ❌ 支持的入住或退房操作仍不可用

建议提供：

  • 物业名称
  • Organisation Unit
  • 测试失败时间
  • 完整错误消息
  • 隐藏 API Key 的截图