跳到主要内容

连接 Furama iPMS

快速设置

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

本指南帮助你将物业连接到 Furama iPMS，并确认连接处于活动状态。

前往： Settings → Essentials → PMS Integration

快速参考​

设置必填控制内容
iPMS Base URL是将 AVA 指向 iPMS API 和服务路径
Organisation Unit是在 iPMS 中识别你的酒店
Control Unit否覆盖 AVA 为目录查询推导出的单位
User Code是获取 iPMS 安全令牌
Business User Code否识别业务请求中的用户
API Key是授权 iPMS 连接
可选值

AVA 使用 Furama 的单位层级，从 Organisation Unit 推导 Control Unit。 宾客来源和付款类型使用推导出的控制单位。 只有在 Furama 确认你的物业需要覆盖时，才输入 Control Unit。 Business User Code 默认使用 User Code，并保留其字母大小写。 房价方案使用 Organisation Unit 的值。 清除 Control Unit 并保存，即可恢复自动解析。

开始之前​

确认以下要求：

  • 你的物业已启用 Furama iPMS
  • Vouch 已确认你的物业使用已发布的 iPMS 连接
  • 你可以编辑 Settings → Essentials
  • 你拥有完整的 iPMS API URL，包括服务路径
  • 你拥有组织单位、用户代码和 API Key
  • 如果你的物业需要覆盖，Furama 已确认该覆盖值
保护 API Key

不要在截图或支持消息中发送 API Key。 设置完成后，AVA 会隐藏已保存的值。 AVA 还会在 Audit Log 详细信息中隐藏 API Key。

连接物业​

  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 与 User Code 不同时，才添加这个可选值。
  10. 点击 Save PMS Settings。

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

✓ 将该字段留空时，AVA 会推导控制单位。

不指定版本的连接使用 v2

当连接未指定版本时，AVA 使用 Furama iPMS v2。 你无需输入或维护版本设置。 不要创建单独的 iPMS 提供商条目。

将 Furama iPMS 用于单房和多房住宿​

已发布的 iPMS 连接支持 AVA 处理单房和多房住宿的主要步骤。

区域AVA 支持的内容重要限制
Reservations查找、查看、创建和编辑预订，包括多房住宿新建多房预订使用一个房型、住宿时间段、入住人数和报价
Operations View加载 Check-ins 和 Check-outs 数据以供日常工作使用查看到店或离店前，先选择所需的业务日期
Check-in and check-out分配房间、为宾客办理入住和退房，包括已批准的空置脏房入住多房住宿必须一次处理一间房；AVA 针对所选房间执行操作
Guests更新主宾客和同行宾客；一次添加多个同住宾客；上传旅行证件、已签署的登记卡和照片Furama 没有宾客档案目录，因此请使用宾客详细信息而不是宾客 ID 来添加宾客
Rooms and housekeeping查看房间、更新状态并管理服务停用块状态和新停用块可能需要约 60 秒才会显示
Rate plans and quotes查看 Furama 房价方案，并按房型、日期和宾客人数报价方案为只读；报价包含房价，但不含税费明细
Billing查看整个住宿的账单、记入付款或费用并查看交易记入项目之前先选择房间；AVA 会合并每个房间报告的费用和付款
Sources加载宾客来源和付款类型AVA 从 Organisation Unit 推导 Control Unit
上线前确认这些限制

已发布的连接支持多房住宿，但每个房间都必须单独处理。 创建多房住宿时，每个房间必须使用相同的房型、日期、宾客人数和报价。 通过 Furama 无法提供物业货币或卡授权。 请在 Settings → Essentials → Hotel Basic Details 中设置物业货币。 当 AVA 显示合成账单时，请在 Furama 中确认最终账单总额。

AVA 如何处理 Furama 多房住宿

Furama 将多个房间归为一次住宿。 AVA 为每个房间显示自己的房号和房间级预订详细信息。 在分配房间、办理入住、办理退房、更换宾客或查看账单前，请先选择所需房间。 AVA 会将操作保留在该房间，而不是默认使用第一间房。

Furama 将每个房间存储为单独的 iPMS 订单。 AVA 计算多房住宿余额时，会读取每个房间的订单。 付款和账单费用归属于单个房间。 记入任一项目之前，请打开该房间所在的行或卡片。 如果 AVA 无法识别房间，会停止操作，而不是猜测房间。

创建 Furama 多房预订​

  1. 打开 Operations View，然后点击 Create Reservation。

  2. 输入主宾客、住宿日期、房型、宾客人数和报价 Rate。

  3. 每增加一个房间，就点击 Add another room。

  4. 需要更改房型、宾客人数或报价时，编辑 Room 1。 AVA 会将这些值复制到其他房间卡片。 Rooms 2 及之后的房间为只读，并显示 Matches Room 1。

  5. 点击 Create Reservation。

    ✓ AVA 创建住宿、分离各房间，并在显示住宿前刷新该住宿。

AVA 会为每个请求的房间创建一个独立的房间条目。 创建后分别为每个房间分配房间。 有关通用流程，请参阅创建预订。

已签署的登记卡

Furama 可以按照 PMS 上传策略接收已签署的登记卡。 请在 Settings → Check-In → Check-In Policy 中开启 Upload registration card to PMS。 AVA 会在所选上传时间后，将渲染后的已签署登记卡作为附件发送。 需要确认发送结果时，请检查 Command Center → View Details。

Furama 房价报价

AVA 会将 Furama 每晚的行项目合并为每种房型和房价方案的一份报价。 缺少任何所需晚数的报价会被排除。 Furama 不提供税费详细信息，因此报价总额仅为房价。 某些物业可能会返回类似 001 的内部货币代码。 收款前请在 Furama 中确认货币和最终金额。

在日常运营中使用 Furama​

Furama iPMS v2 支持 Operations View 中的 Check-ins 和 Check-outs 标签页。 这些标签页使用所选业务日期加载到店和离店记录。

  1. 打开 Operations View。

  2. 选择 Check-ins 或 Check-outs。

  3. 选择所需的业务日期。

  4. 如果你在 Furama 中更改了预订，点击 Refresh。

    ✓ 列表显示所选到店或离店时间段内的 Furama 预订。

更改 Furama 房间分配​

如果宾客在退房前需要更换房间，请使用 Change room。

  1. 从 Operations View 或 Reservations 打开预订。

  2. 点击 Change room。

  3. 查看房型匹配、状态为可用且没有冲突预订的房间。

  4. 选择房间，然后点击 Confirm room change。

    ✓ AVA 通过 Furama 发送新的分配，并刷新预订。

AVA 会检查房型、入住人数、客房服务状态、锁定状态和重叠住宿。 脏房或已占用的房间可能不会显示为候选房间。 Furama 支持直接移动到匹配的空置房间。 它不会交换已经分配房间的两个预订。

发放门禁前检查新房间

编码钥匙或分享房间说明前，请在 AVA 和 Furama 中确认新房间。

入住前检查 PMS 房间​

Furama 在入住时使用预订订单中分配的房间。 AVA 完成宾客入住前，会验证该房间。 AVA 要求 Furama 确认房间为空置。 未知或缺失的空置数据不视为空置。 已占用、已锁定、停止服务、缺失或被维护停用块占用的房间，会在 AVA 写入分配前被拒绝。

对于多房住宿，请在开始操作前打开所需房间。 AVA 会将房间分配和入住请求发送到该房间的 Furama 记录。 其余房间请分别处理。

  • 如果预订没有房间，AVA 会先分配请求的房间。
  • 如果请求的房间与 Furama 中的房间不同，AVA 会拒绝入住。
  • 如果宾客已经入住，重试会返回当前的 PMS 房间。

编码钥匙或分享房间说明前，请在 Furama 中检查房间。

允许入住空置脏房​

Furama iPMS v2 接受入住到客房服务状态为 Dirty 的已分配房间。 仅当前台已批准该房间立即接待宾客时，才启用此设置。

  1. 前往 Settings → Check-In → Check-In Policy。

  2. 打开 Room Automation and Room Status Rules。

  3. 开启 Allow Vacant Dirty Rooms。

  4. 点击 Save。

  5. 完成入住前确认房间空置且安全。

    ✓ Furama 确认房间空置时，即使房间仍为 Dirty，AVA 也可以完成 Furama 入住。

当空置状态缺失、未知或为否时，AVA 会拒绝 Dirty 房间。 即使启用了脏房入住，AVA 也会拒绝被维护停用块占用的房间。

房间状态不会自动更改

完成此次入住后，Furama 会保留房间的 Dirty 状态。 房间准备就绪后，请单独更新客房服务状态。

批准的例外结束后，请关闭此设置。 有关房间状态的指导，请参阅入住政策。

更新 Furama 客房服务状态​

你可以从 Housekeeping 更新 Clean、Dirty 和 Inspected 状态。 Furama 接受更改后会异步应用这些更改。

操作预期结果
保存状态Furama 接受请求后，AVA 显示成功消息
立即检查房间仍可能显示旧状态
约 60 秒后刷新新状态应显示在 Housekeeping 和 Operations View 中

  1. 打开 Housekeeping。

  2. 找到 Furama 房间。

  3. 在 Condition 中选择 Clean、Dirty 或 Inspected。

  4. 等待约 60 秒，再在其他 AVA 页面检查房间。

  5. 刷新 Housekeeping 和 Operations View。

    ✓ Furama 完成处理请求后，更新后的状态会显示出来。

不要重复发送待处理的更新

成功消息确认的是请求已被接受，而不是处理已完成。 请等待后再为同一房间发送另一项状态更改。

Furama iPMS v2 在启用相应能力后，支持通过 AVA 管理服务停用块。 维护、深度清洁或翻修时，使用 Take out of service。 仅当停用块在当前 PMS 业务日期生效时，才使用 Restore to service。 Furama 接受新停用块后，可能需要约 60 秒才会显示。 不要使用 Condition 表示维护停用块。

查看 Furama 账单​

AVA 根据 Furama 报告的费用和付款计算 Furama 余额。 Furama 不会在每个账单窗口中包含住宿费用。 即使额外费用总额低于房价，额外费用仍会显示。

对于多房住宿，AVA 会读取每个房间订单中的交易。 它会将这些交易与住宿的所有房间费用合并，计算住宿余额。 记入付款或账单费用时，AVA 使用所选房间的订单。

  1. 在 AVA 中打开预订。
  2. 查看 Balance Due 和账单行。
  3. 收款前，将最终金额与 Furama 账单进行比较。

验证日常运营​

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

  1. 打开 Reservations。

  2. 搜索已知的 Furama 预订。

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

  4. 打开 Rates & Availability，确认预期房价方案出现。

  5. 在 Housekeeping 中确认所有预期房间（包括已占用的房间）均已显示。

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

    ✓ AVA 仅显示已连接 iPMS 物业所支持的操作。

基于能力的控件

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

查看入住/退房日志​

完整的 Furama 连接允许你在 Command Center 中查看宾客活动。

  1. 打开 Main Menu → Command Center。

  2. 选择 Status 或 Live。

  3. 打开预订并选择 View Details。

  4. 查看入住或退房时间线。

    ✓ PMS 设置完成后，Furama 物业可以打开入住/退房日志。

日志需要完整连接

如果缺少必需的 Furama 凭据，Command Center 会显示 PMS 恢复卡片。 完成连接，然后刷新 Command Center。

更新连接信息​

  1. 返回 Settings → Essentials → PMS Integration。

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

  3. 仅在更换 API Key 时点击 Edit Secret。

  4. 输入新的 API Key。

  5. 点击 Save PMS Settings。

    ✓ 保持隐藏的 API Key 不变，会保留当前密钥。 ✓ 清除 Control Unit 会恢复自动解析。 ✓ 清除 Business User Code 会恢复其默认值。

确认 API Key 轮换

点击 Edit Secret 会清除显示的 API Key。 保存设置前，请输入替换用的密钥。

故障排除​

未列出 Furama iPMS​

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

修复方法：

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

设置无法保存​

你看到： 出现 "Failed to save PMS Integration"。

修复方法：

  1. 填写每个必填字段。
  2. 确认基础 URL 包含 iPMS 服务路径。
  3. 准确检查组织单位和用户代码。
  4. 重新输入 API Key，然后再次保存。

缺少目录数据​

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

修复方法：

  1. 向 Furama 联系人确认 Organisation Unit。
  2. 除非 Furama 已确认覆盖值，否则将 Control Unit 留空。
  3. 如果 Furama 确认了覆盖值，输入其准确值。
  4. 点击 Save PMS Settings。
  5. 重新加载受影响的 AVA 页面。

AVA 会自动为宾客来源和付款类型推导控制单位。 对于这些目录，它不会将组织单位作为备用值。

Furama 无法解析目录单位​

你看到： AVA 报告无法解析 Furama 控制单位。

修复方法：

  1. 确认 Organisation Unit 与你的 Furama 物业匹配。
  2. 将 Control Unit 留空，再次保存连接。
  3. 请 Furama 确认该物业的控制单位映射。
  4. 将已确认的值作为 Control Unit 输入，然后再次保存。
  5. 重新加载需要来源或付款类型的页面。

不要猜测控制单位的值。错误的值可能显示其他物业的目录。

业务请求被拒绝​

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

修复方法：

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

入住仍使用 PMS 房间​

你看到： AVA 拒绝请求的房间，或入住后返回其他房间。

修复方法：

  1. 在 Furama 中打开预订。
  2. 确认分配给订单的房间。
  3. 在 AVA 中使用该房间，或先在 Furama 中分配请求的房间。
  4. 重试入住。

在 AVA 和 Furama 显示相同房间前，不要编码钥匙。

缺少已占用的房间​

你看到： 已占用的房间未出现在 Housekeeping 或房间列表中。

修复方法：

  1. 刷新 Housekeeping 或 Operations。
  2. 清除房间状态和搜索筛选条件。
  3. 确认该房间存在于 Furama 的房间库存中。
  4. 如果房间仍然缺失，请联系支持团队。

Furama 房间读取会先加载完整的房间库存，然后 AVA 才应用分页。

无法使用入住操作​

你看到： AVA 显示预订，但缺少房间分配或入住操作。

修复方法：

  1. 确认连接显示 "Furama Integration Configured."。
  2. 检查连接是否使用准确的 Organisation Unit。
  3. 使用已发布的 iPMS 凭据再次保存连接。
  4. 重新加载 Operations，然后重试已批准的测试预订。

未指定版本时，AVA 会自动选择 Furama iPMS v2。

Operations 标签页失败或不显示预订​

你看到： Check-ins 或 Check-outs 加载失败，或缺少预期住宿。

修复方法：

  1. 在 Operations View 中选择正确的业务日期。
  2. 点击 Refresh，等待列表完成加载。
  3. 清除搜索和筛选条件。
  4. 在 Furama 中确认预订日期和状态。
  5. 确认 Furama 连接已配置，然后重试。

如果两个标签页在连接和日期均正确后仍失败，请联系支持团队。

多房操作影响了错误的房间​

你看到： 多房操作无法识别所选房间，或旧会话显示第一间房。

修复方法：

  1. 关闭当前预订详细信息。
  2. 刷新 Operations View 或 Reservations。
  3. 打开该房间自己的行或房间卡片。
  4. 再次开始操作前，确认房号。
  5. 如果 AVA 仍然针对其他房间，请联系支持团队。

付款和账单费用操作开始前，请先选择房间。 AVA 会停止有歧义的操作，而不是写入第一间房。

Furama 退房找不到房间​

你看到： 输入房间和姓氏后，Furama 退房找不到住宿。

修复方法：

  1. 输入 Furama 中显示的准确 Room Number。
  2. 输入 Furama 中显示的主宾客 Last Name。
  3. 对于多房住宿，为正在退房的房间重复查询。
  4. 刷新退房页面并重试。
  5. 如果住宿仍不可用，请使用 Furama 或联系前台。

AVA 使用房号和姓氏来识别正确的 Furama 房间。

更换房间时没有可选房间​

你看到： Change room 已打开，但无法选择房间。

修复方法：

  1. 在 Furama 中确认预订日期和房型。
  2. 检查匹配的房间是否空置且已准备好。
  3. 检查是否存在与住宿时间重叠的其他预订。
  4. 刷新 Operations View，然后再次打开 Change room。

如果未启用 Allow Vacant Dirty Rooms，AVA 不会将未售出但为脏房的房间视为可分配状态。 对于已批准的例外，请在入住政策中启用该设置。

客房服务更改未更新​

你看到： 保存了状态，但 AVA 中仍显示旧值。

修复方法：

  1. 确认选择 Clean、Dirty 或 Inspected 后，AVA 显示了成功消息。
  2. 等待约 60 秒，让 Furama 应用更改。
  3. 刷新 Housekeeping，然后刷新 Operations View。
  4. 如果等待并刷新后旧值仍存在，请联系支持团队。

Furama 异步应用客房服务更改。 房间列表和汇总计数可能在不同时间更新。

Furama 服务停用块的时间或释放问题​

你看到： 新停用块尚未显示，或 Furama 拒绝 Restore to service。

原因： Furama 异步应用新停用块。 它只会释放在当前 PMS 业务日期生效的停用块。

修复方法：

  1. AVA 确认停用块后等待约 60 秒。
  2. 刷新 Housekeeping 和 Operations View。
  3. 根据 Furama 当前业务日期检查停用块时间范围。
  4. 在 Furama 中释放未来或已过期的停用块。
  5. 如果仍无法释放有效停用块，请联系支持团队。

AVA 账单需要确认​

你看到： AVA 账单总额与 Furama 总额不同。

修复方法：

  1. 在 AVA 中刷新预订。
  2. 将费用和付款与 Furama 账单进行比较。
  3. 完成付款前，在 Furama 中确认最终金额。

预订日期筛选显示错误的住宿​

你看到： 按日期筛选的 Furama 列表显示了所选范围之外的住宿。

修复方法：

  1. 在 Operations 中选择所需的到店或离店日期。
  2. 点击 Refresh。
  3. 跨当前日期搜索时使用 All dates。
  4. 如果刷新后仍有无关住宿，请联系支持团队。

AVA 会将 Furama 日期范围的起止日期都发送到 PMS。

宾客邮箱或国籍显示不同​

你看到： 已保存的邮箱后来缺失，或国籍显示为国家名称。

修复方法：

  1. 在 Furama 中确认宾客的电话、姓名、证件和国籍字段。
  2. 对于测试物业，将缺失邮箱视为 Furama 的显示限制。
  3. 如果其他宾客字段无法保留，请向 Vouch 寻求帮助。

预订未显示​

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

修复方法：

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

无法使用入住/退房日志​

你看到： Command Center 显示 PMS 设置恢复卡片，而不是日志。

修复方法：

  1. 返回 Settings → Essentials → PMS Integration。
  2. 确认 iPMS Base URL、Organisation Unit、User Code 和 API Key 均已填写。
  3. 点击 Save PMS Settings。
  4. 返回 Command Center 并刷新页面。

配置必需凭据后，Furama 不会阻止入住/退房日志。

仍需帮助？​

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

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

建议提供：

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