跳到主要内容

设置 SiteMinder 渠道管理器集成

快速设置

大多数酒店大约 10 分钟即可完成这项设置。 你需要准备好 Publisher ID、Hotel Code、Environment 和 REST API Bearer Token。 你还需要用于 SiteMinder 房型映射的 AVA 房型。

本指南帮助你连接 SiteMinder，让 AVA 自动接收预订更新。 它与你的 PMS 配合使用，而不是取代 PMS。 你也可以在这里将 SiteMinder 房型映射到 AVA 房型。 物理 SiteMinder 房间 ID 现在会在 Rooms 页面上进行映射。 SiteMinder 价格计划代码现在会在 Rates & Availability → Rate Plans 上进行映射。 房间映射工作区仍会显示汇总数量、搜索、筛选、建议和抽屉编辑功能。 它使用与 Room Access 映射建议相同的相似度规则。

前往： Settings → Essentials → Channel Manager Integration

快速参考​

| 设置 | 控制内容 | 你需要输入什么 | | --- | --- | | Channel Manager | 选择供应商 | 选择 SiteMinder | | Environment | 连接测试或正式的 SiteMinder | Pre-production (Sandbox) 或 Production | | Publisher ID | 关联你的 SiteMinder 账号 | 你的 SiteMinder publisher ID | | Hotel Code | 与 SiteMinder 中的物业匹配 | 你的酒店代码 | | REST API Bearer Token | 让 AVA 调用 REST API | 来自 SiteMinder 的 bearer token | | Room Type Mappings | 将 SiteMinder 房型匹配到 AVA 房型 | 在 Settings → Essentials 中为每个已发现的代码选择对应的 AVA 房型 | | Physical Room Mappings | 将已发现的 SiteMinder 房间 ID 匹配到 AVA 房间 | 在 Rooms 中使用工作区 | | Rate Plan Mappings | 将 SiteMinder 价格代码匹配到 AVA 价格计划 | 使用 Rates & Availability → Rate Plans | | Enable SiteMinder integration | 开始同步 | 一切准备好后将其打开 | | SiteMinder reservations missing from the PMS | 显示需要检查的 OTA 预订 | 启用 SiteMinder 后进行检查 | | Overbooked stays needing a room | 显示已接受但尚未分配房间的 OTA 入住 | 分配房间、升级、释放容量，或按照你的接待流程处理 |

SOAP 凭据

这里不需要输入 SOAP 用户名或密码。 AVA 会统一管理这些凭据。

房型发现

SiteMinder 房型会在 SiteMinder 发送预订后出现。 在那之前，你可能看不到所有代码。

房间映射位置

使用 Settings → Essentials → Channel Manager Integration 进行 SiteMinder 房型映射。 使用 Rooms 处理物理 SiteMinder 房间 ID 映射。

更快查看房间

先从 Unmapped 开始。 然后查看 Suggestions 和 Conflicts。 在房间数量很多的物业里，这样更快。

开始前​

请先确认这些事项：

  • 你已拥有该物业的 SiteMinder 访问权限
  • 你有正确的 Publisher ID 和 Hotel Code
  • 你知道自己是在测试还是正式上线
  • 你已在 SiteMinder 中注册 SOAP endpoint URL
这很重要

AVA 可以先保存设置，而不启用 SiteMinder。 你必须先完成所有字段，然后再打开集成。

注意

不要在 SiteMinder 拥有正确 SOAP endpoint URL 之前启用集成。 如果 endpoint 缺失，更新将无法到达 AVA。

设置 SiteMinder​

  1. 前往 Settings → Essentials
  2. 滚动到 Channel Manager Integration
  3. 打开 Channel Manager 下拉菜单
  4. 选择 SiteMinder
  5. 打开 Environment
  6. 测试时选择 Pre-production (Sandbox)
  7. 正式流量选择 Production
  8. 输入你的 Publisher ID
  9. 输入你的 Hotel Code
  10. 粘贴 REST API Bearer Token
  11. 打开 Enable SiteMinder integration
  12. 点击 Save

✓ 你应该会看到 Connected。

保存后会发生什么​

变更结果
SiteMinder 设置已保存AVA 会立即保存本地设置。
设置同步运行AVA 会在后台将配置发送给 web-be-channel-manager。
你稍后再回来敏感字段仍会在页面上保持遮罩。
你切换为 NoneAVA 会清除 SiteMinder 字段。
敏感字段

如果重新加载后敏感字段仍显示为遮罩，这是正常现象。 只有在你想替换已保存值时，才需要更改它。

查看 SiteMinder 预订结果​

使用预订结果面板查找 AVA 尚未在 PMS 中确认的 SiteMinder 预订。 SiteMinder 可能会先向客人确认预订，然后 PMS 才接受预订。 对于 PMS 在售罄时接受的 OTA 入住，请使用单独的超售面板。

  1. 前往 Settings → Essentials

  2. 打开 Channel Manager Integration

  3. 确认已选择并启用 SiteMinder

  4. 查看 SiteMinder reservations missing from the PMS

  5. 打开每一项，检查客人、确认号、入住信息、房型和原因

  6. 手动在 PMS 中创建预订，或联系客人

    ✓ 选择并启用 SiteMinder 后，面板会自动打开。 ✓ 默认显示需要处理的项目。

查看需要房间的超售入住​

启用 SiteMinder 后会显示 Overbooked stays needing a room 面板。 它会列出 PMS 在房型售罄时接受的 OTA 入住。 每一行都会显示客人、预订号或 OTA 编号、日期、房型和售罄夜数。

  1. 查看入住信息及其售罄夜数

  2. 在 AVA 或 PMS 中分配合适的房间

  3. 必要时为客人升级、释放容量，或按照你的接待流程处理

  4. 点击 Refresh

    ✓ 当入住已有房间、售罄夜已解决或入住已取消时，该入住会消失。

此面板只会出现在支持超售入住检查的 PMS 连接中。 不支持的 PMS 连接不会显示超售入住，也不会执行此项检查。

了解预订结果状态​

| 状态 | 含义 | 你应该怎么做 | | --- | --- | | Rejected by the PMS | PMS 拒绝了预订。 | 检查原因，然后手动创建预订或联系客人。 | | Delivery failed, retrying | AVA 尚未能发送预订。 | 检查原因，稍后刷新。 | | Not confirmed by the PMS | PMS 在 15 分钟后仍未确认预订。 | 先检查 PMS，再创建预订，以免重复。 | | Rejected, sent back to SiteMinder | 预订已被拒绝并退回 SiteMinder。 | 跟进客人或 SiteMinder。 | | Accepted as overbooking | 尽管库存不可用，预订仍被接受。 | 分配房间或按照超售流程处理。 | | Resolved by a later update | 后续 SiteMinder 更新解决了之前的问题。 | 通常无需处理。 | | Applied | 预订已成功到达 PMS。 | 无需处理。 |

处理仍需要房间的已接受超售​

在房间需求解决之前，超售面板会持续显示已接受的超售。 使用入住详情查看客人、日期、房型和受影响的夜晚。

  1. 在 Overbooked stays needing a room 中查看已接受的超售

  2. 查看入住信息和仍需要房间的夜晚

  3. 在 AVA 或 PMS 中分配合适的房间

  4. 点击超售面板中的 Refresh

    ✓ 成功分配房间后，该入住会从未解决超售列表中移除。

如果有可用容量，请刷新面板以更新列表。 取消或后续预订更新也可能移除该入住。 此视图仅在已连接的 PMS 支持未解决超售入住时显示。

显示所有 SiteMinder 预订​

默认情况下，面板会隐藏成功的预订。

  1. 选择 Show every SiteMinder reservation, not only problems
  2. 一起查看成功、待处理和问题结果
  3. 清除复选框，返回需要处理的项目

在 PMS 中创建或更新预订后，使用 Refresh。 选择 Load older 查看更早的结果。

使用房间映射工作区​

当 Rooms 上出现 SiteMinder 房间映射工作区后，使用本节进行操作。

  1. 前往 Rooms
  2. 找到 Channel Manager Room Mappings
  3. 查看 Mapped、Unmapped、Conflicts 和 Disabled 的汇总数量
  4. 使用搜索或筛选缩小列表范围
  5. 打开房间行或建议
  6. 选择匹配的 AVA room
  7. 在抽屉中使用 Map、Change 或 Unmap
  8. 点击 Save
建议行为

AVA 在生成新建议时，会跳过已经完成映射的 AVA 房间。 使用 Apply all 逐一应用当前建议。 如果某条建议失败，AVA 会继续应用其余建议。

✓ 当 SiteMinder 房间 ID 或房间名称相近时，会出现匹配建议。 ✓ 建议使用与 Room Access 映射相同的相似度规则。 ✓ 如果所选 AVA 房间已在其他位置使用，抽屉会发出警告。 ✓ 后续预订会使用所选的 AVA 房间。

故障排查​

无法启用 SiteMinder​

你会看到： 系统提示你必须先完成 SiteMinder 配置，才能启用集成。

解决方法：

  1. 确认 Channel Manager 设为 SiteMinder
  2. 填写每个 SiteMinder 字段
  3. 检查 Environment 的选择
  4. 打开 Enable SiteMinder integration
  5. 再次点击 Save

没有出现 Connected​

你会看到： 页面已保存，但没有看到 Connected。

解决方法：

  1. 确认 Enable SiteMinder integration 已打开
  2. 刷新 Settings → Essentials
  3. 检查所有 SiteMinder 字段是否仍有值
  4. 再次保存

更新没有到达 SiteMinder​

你会看到： AVA 已保存设置，但 SiteMinder 没有收到更新。

解决方法：

  1. 确认 SOAP endpoint URL 已在 SiteMinder 中注册
  2. 检查 Environment 是否与 SiteMinder 账号一致
  3. 重新核对 Publisher ID 和 Hotel Code
  4. 再次保存设置

SiteMinder 字段消失了​

你会看到： 当你选择 None 后，SiteMinder 字段会被清空。

解决方法：

  1. 再次选择 SiteMinder
  2. 重新输入数值
  3. 点击 Save

房型没有出现​

你会看到： SiteMinder 房型列表为空。

解决方法：

  1. 等待 SiteMinder 为该物业发送预订
  2. 刷新 Settings → Essentials
  3. 再次检查新的房型代码
  4. 代码出现后保存映射

房间映射没有出现​

你会看到： Rooms 中缺少 Channel Manager Room Mappings 面板。

解决方法：

  1. 确认你的有效 PMS 是 AVA
  2. 确认在 Settings → Essentials → Channel Manager Integration 中已选择并启用 SiteMinder
  3. 确认 Hotel Code 已保存
  4. 等待 SiteMinder 发送预订或房间事件
  5. 刷新 Rooms

重复映射警告​

你会看到： 抽屉警告所选的 AVA room 已完成映射。

解决方法：

  1. 选择其他 AVA room
  2. 或先取消其他行的映射
  3. 再次保存

抽屉中的保存失败​

你会看到： 保存操作失败，或抽屉保留旧值。

解决方法：

  1. 重新打开同一行
  2. 确认所选的 AVA room
  3. 再次点击 Save

预订结果面板缺失​

你会看到： 找不到 SiteMinder reservations missing from the PMS。

解决方法：

  1. 确认在 Channel Manager Integration 中已选择 SiteMinder
  2. 确认 Enable SiteMinder integration 已打开
  3. 保存设置
  4. 刷新 Settings → Essentials

预订结果面板显示加载错误​

你会看到： 面板提示加载 SiteMinder 预订失败。

解决方法：

  1. 点击 Refresh
  2. 确认 SiteMinder 已连接
  3. 检查其他 SiteMinder 设置是否能正常加载
  4. 如果错误持续，请联系支持团队

SiteMinder 预订未列出​

你会看到： 客人拥有 SiteMinder 确认信息，但你找不到该预订。

解决方法：

  1. 点击 Refresh
  2. 选择 Show every SiteMinder reservation, not only problems
  3. 如果预订不是最近的，选择 Load older
  4. 使用确认号在 PMS 中搜索
  5. 如果仍找不到预订，请联系支持团队

在检查 PMS 之前，不要创建重复预订。

已接受的超售未列出​

你会看到： 预订在售罄时被接受，但没有显示为需要房间。

解决方法：

  1. 确认预订已成功到达 PMS
  2. 在超售面板中点击 Refresh
  3. 检查预订是否仍有未分配的房间
  4. 确认你的 PMS 支持未解决超售入住

部分 PMS 连接不提供此列表。 它们会跳过检查，而不是显示加载错误。

仍有问题？​

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

  • ❌ SiteMinder 区域仍然无法启用
  • ❌ 已保存的 SiteMinder 值总是丢失
  • ❌ 你注册 endpoint 后，更新仍然没有到达 SiteMinder

建议附上：

  • SiteMinder 区域截图
  • 具体错误信息
  • 问题开始的时间