设置 SiteMinder 渠道管理器集成
大多数酒店大约 10 分钟即可完成这项设置。 你需要准备好 Publisher ID、Hotel Code、Environment 和 REST API Bearer Token。
本指南帮助你连接 SiteMinder，让 AVA 自动接收预订更新。 它是与 PMS 配合使用，而不是取代 PMS。
前往： 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 工作区中操作 |
| Enable SiteMinder integration | 开始同步 | 一切准备好后将其打开 |
这里不需要输入 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
- 前往 Settings → Essentials
- 滚动到 Channel Manager Integration
- 打开 Channel Manager 下拉菜单
- 选择 SiteMinder
- 打开 Environment
- 测试时选择 Pre-production (Sandbox)
- 正式流量选择 Production
- 输入你的 Publisher ID
- 输入你的 Hotel Code
- 粘贴 REST API Bearer Token
- 打开 Enable SiteMinder integration
- 点击 Save
✓ 你应该会看到 Connected。
保存后会发生什么
| 变更 | 结果 |
|---|---|
| SiteMinder 设置已保存 | AVA 会立即保存本地设置。 |
| 设置同步运行 | AVA 会在后台将配置发送给 web-be-channel-manager。 |
| 你稍后再回来 | 敏感字段仍会在页面上保持遮罩。 |
| 你切换为 None | AVA 会清除 SiteMinder 字段。 |
如果重新加载后敏感字段仍显示为遮罩，这是正常现象。 只有在你想替换已保存值时，才需要更改它。
故障排查
无法启用 SiteMinder
你会看到： 系统提示你必须先完成 SiteMinder 配置，才能启用集成。
解决方法：
- 确认 Channel Manager 设为 SiteMinder
- 填写每个 SiteMinder 字段
- 检查 Environment 的选择
- 打开 Enable SiteMinder integration
- 再次点击 Save
没有出现 Connected
你会看到： 页面已保存，但没有看到 Connected。
解决方法：
- 确认 Enable SiteMinder integration 已打开
- 刷新 Settings → Essentials
- 检查所有 SiteMinder 字段是否仍有值
- 再次保存
更新没有到达 SiteMinder
你会看到： AVA 已保存设置，但 SiteMinder 没有收到更新。
解决方法：
- 确认 SOAP endpoint URL 已在 SiteMinder 中注册
- 检查 Environment 是否与 SiteMinder 账号一致
- 重新核对 Publisher ID 和 Hotel Code
- 再次保存设置
SiteMinder 字段消失了
你会看到： 当你选择 None 后，SiteMinder 字段会被清空。
解决方法：
- 再次选择 SiteMinder
- 重新输入数值
- 点击 Save
仍有问题？
如果出现以下情况，请联系 success@vouch-technologies.com：
- ❌ SiteMinder 区域仍然无法启用
- ❌ 已保存的 SiteMinder 值总是丢失
- ❌ 你注册 endpoint 后，更新仍然没有到达 SiteMinder
建议附上：
- SiteMinder 区域截图
- 具体错误信息
- 问题开始的时间