设置酒店基本信息
大多数酒店只需要设置四项内容：Hotel Name、Country、Timezone 和 Property currency。整个过程大约需要 2 分钟。
酒店基本信息会显示在 AVA 的各个位置以及面向客人的文档中。正确填写这些信息可确保时间显示、地区格式和酒店品牌信息保持一致。 这是你在 Streamliner 中管理酒店币种的唯一位置。 Payment 设置会读取此值，不会单独维护币种字段。 对于受支持的 AVA PMS 酒店，Streamliner 会读取并可以更新由 PMS 管理的币种。
前往： Settings → Essentials → Hotel Basic Details
你将配置的内容
| 设置 | 控制内容 | 客人会在哪些地方看到 |
|---|---|---|
| Hotel Name | AVA 中各处显示的酒店名称 | 入住页面、邮件、收据 |
| Country | 地区功能和合规要求 | 客人表单、国籍列表 |
| Timezone | 所有日期和时间显示 | 确认时间、日程 |
| Property currency | 押金和预订支付显示的唯一来源 | 预订卡片、支付摘要、押金流程 |
分步设置
1. 输入酒店名称
在 Hotel Name 字段中输入酒店的正式商业名称。
| ✓ 合适示例 | ✗ 避免 |
|---|---|
| Sunset Beach Resort & Spa | sunset beach（全小写） |
| The Grand Hotel Bangkok | Test Hotel 1 |
| Lub D Silom | My Property |
这个名称会显示在登记卡、到店前邮件和收据上。它应与正式注册的商业名称一致。
2. 选择国家
- 点击 Country 下拉框
- 开始输入国家名称进行搜索
- 从列表中选择
选择国家后，Timezone 可能会自动填充。只有在 PMS 不作为权威来源时，Property currency 才会自动填充。 如果可写入的 PMS 没有币种，系统会显示基于国家的币种建议。 在你采纳该建议前，它不会被保存。
Country 会启用：
- 特定地区的客人表单字段（例如泰国的 TM30）
- 对应的国籍和职业列表
- 预订和客人档案共用的国家搜索
- 本地合规流程
AVA 会将每个国家保存为标准的两字母 ISO 代码，例如泰国使用 TH。
如果现有酒店之前以小写形式保存国家代码，仍然可以正常使用。
按国家名称选择即可；无需转换代码。
找不到你的国家？
请尝试以下写法：
- 用 "United States" 代替 "USA"
- 用 "United Kingdom" 代替 "UK"
- 使用国家或地区的英文正式名称
AVA 在设置、预订和客人档案中使用同一份国家列表。 部分地区现在也会出现在搜索结果中。
仍然找不到？请将国家名称发送至 success@vouch-technologies.com。
3. 选择时区
选择与酒店当地时间相匹配的时区：
| 如果你在 | 请选择 |
|---|---|
| Thailand | Asia/Bangkok |
| Singapore | Asia/Singapore |
| US East Coast | America/New_York |
| US West Coast | America/Los_Angeles |
| UK | Europe/London |
| Central Europe | Europe/Paris |
| Japan | Asia/Tokyo |
| Australia (Sydney) | Australia/Sydney |
时区更改会影响所有定时任务、预订时间和报告。在正式酒店中更改前，请先与团队协调。
4. 查看酒店币种
- 找到 Property currency 字段。
- 如果你的国家建议了一种币种，请查看显示的代码。
- 点击 Use the displayed currency as property currency 以采纳该建议。
- 如果你的 PMS 没有币种，请在需要时选择其他值。
- 保存由 PMS 管理的币种前，请查看确认警告。
- 点击 Change currency 确认，或取消以不发送币种更改。
- 确认预订支付显示中出现的是同一币种。
- 请记住，Payment 设置会自动使用此值。
采纳建议的币种后，更改 Country 不会替换该币种。 如需使用新国家的币种，请再次选择并采纳它。
AVA 只会重新标记价格，不会转换金额。现有预订会保留当前币种。 确认前请检查押金金额和结账舍入阈值。
如果你的 PMS 管理币种但不支持写入，该字段会保持锁定状态。 请改在 PMS 中更新币种。
如果页面仍在加载，币种可能会显示临时默认值。 请等页面加载完成后，再选择或采纳酒店币种。 AVA 不会将这个临时值保存为酒店币种。
5. 保存更改
-
点击 Save
-
等待绿色确认消息
✓ "Settings saved successfully"
保存后会发生什么
| 更改 | 影响 |
|---|---|
| Hotel Name 更新 | 新名称会显示在今后的所有客人文档中 |
| Country 更改 | 国家相关功能会立即启用 |
| Timezone 更改 | AVA 会在显示、Activity 以及新建房间访问有效期窗口中使用已保存的酒店时区 |
| Property currency 在 AVA 中更改 | AVA 会重新标记 PMS 价格，并让现有预订保留当前币种 |
| Property currency 更改（由 Essentials 管理） | 同步后，押金金额标签和预订支付显示会使用新的默认值 |
| Property currency 锁定（由 PMS 管理） | AVA 在押金、房间和支付显示中会以 PMS 币种为准 |
立即可见：
- ✓ 导航栏中的酒店名称
- ✓ 地区日期格式（MM/DD 或 DD/MM）
- ✓ 酒店当地时区的时间
快速 Kiosk 设置（可选）
如果你正在设置新酒店或测试环境，可以使用 Quick Kiosk Setup，根据 Country 和 Timezone 应用合理的默认值：
- 最低客人年龄
- 自动入住时间
- 基础语言
这样员工无需手动配置每项设置，就能立即测试客人流程。
故障排查
时间显示不正确
你会看到： 预订时间、入住时间或报告显示的小时数不正确。
解决方法：
- 前往 Settings → Essentials → Hotel Basic Details
- 确认 Timezone 与酒店实际使用的时区一致
- 点击 Save
- 退出后重新登录
- 如果仍然不正确，请清除浏览器缓存并刷新
房间访问无法创建凭证
你会看到： 更改时区后，智能门锁 PIN、储物柜密码或钥匙卡请求失败。
解决方法：
- 确认已选择 Timezone，并且与酒店当地时区一致。
- 点击 Save，等待成功消息出现。
- 刷新预订，或重新打开房间访问流程。
- 再次创建 PIN、储物柜密码或钥匙卡。
AVA 会对新的房间访问请求使用最近保存的时区。 当设置无效时，它不会悄悄使用 UTC 或新加坡时间。
更改无法保存
你会看到： 点击 Save 后设置恢复原值，或者没有任何反应。
检查：
- Hotel name 字段不为空
- 已从下拉框中选择 country
- 没有显示校验错误（红色文字）
如果所有字段都有效：
- 刷新页面
- 重新输入更改
- 再次点击 Save
如果出现 "Hotel context mismatch" 或 "Merchant ID mismatch"：
- 刷新页面
- 确认顶部栏中选择的是正确的酒店
- 再次进行更改，然后点击 Save
- 如果仍然失败，请退出后重新登录
更多帮助：切换酒店后设置无法保存
更改已应用但保存显示错误
你会看到： AVA 显示错误，但另一个设置服务可能已经接受了你的更改。
解决方法：
- 不要反复点击 Save。
- 刷新 Settings → Essentials。
- 确认新值是否仍然保存。
- 如果该设置影响 PMS 或支付，请检查相关服务。
- 仅当该值仍然缺失时才再次保存。
错误并不总是意味着所有设置写入都失败。 AVA 会报告失败的步骤，但不会自动回滚已被服务接受的写入。
选择国家后时区发生变化
你会看到： 更新 Country 后，Timezone 字段发生变化。
解决方法：
- 确认自动填充的 Timezone 是否适用于你的酒店
- 如有需要，从下拉框中选择正确的时区
- 点击 Save
选择国家后币种发生变化
你会看到： 更新 Country 后，Property currency 字段发生变化。
解决方法：
- 检查该字段是可编辑的还是由 PMS 管理。
- 如果可编辑，请选择偏好的币种并点击 Save。
- 如果由 PMS 管理，请在 PMS 中更新币种并等待同步。
- 刷新 Settings → Essentials 并确认该值。
国家币种建议未保存
你会看到： 选择国家后出现币种，但保存并未设置该币种。
解决方法：
- 确认 PMS 支持写入酒店币种。
- 点击 Use the displayed currency as property currency。
- 点击 Save。
- 查看关于重新标记价格的警告。
- 点击 Change currency 确认。
- 等待成功消息，然后刷新页面。
在点击 Use 之前，该币种只是国家建议。 取消警告会让 PMS 币种保持不变。
酒店币种显示临时默认值
你会看到： Settings → Essentials 加载时，Property currency 字段显示默认值。
解决方法：
- 等待页面加载完成。
- 如果实际币种没有出现，请刷新 Settings → Essentials。
- 确认币种与 PMS 或酒店记录一致。
- 仅在你确实要设置或更改币种时选择币种。
- 查看完整表单后点击 Save。
AVA 会将尚未加载的币种视为临时值。 国家更改后，它不会提供该值供采纳，也不会用它替换酒店币种。
酒店币种已锁定
你会看到： 无法在 Hotel Basic Details 中编辑 Property currency。
解决方法：
- 打开 Settings → Essentials → PMS Integration。
- 确认你的 PMS 已连接并正在发送酒店币种。
- 在 PMS 中更新币种，而不是在 AVA 中更新。
- PMS 同步后刷新 Settings → Essentials。
- 检查 Settings → Payment，确认押金金额现在使用更新后的币种。
无法验证 AVA 币种更改
你会看到： AVA 无法向 PMS 确认币种更改。
解决方法：
- 检查 PMS 连接是否在线。
- 确认酒店使用的是正确的 PMS 连接。
- 稍等片刻，然后重新加载 Settings → Essentials → Hotel Basic Details。
- 再次选择币种并确认更改。
AVA 不会将未经确认的币种应用到其镜像数据中。 在 AVA 确认保存成功前，请不要依赖新币种。
PMS 拒绝所选币种
你会看到： AVA 报告 PMS 拒绝了该币种，或 PMS 中已经存在其他币种。
解决方法：
- 直接在 PMS 中检查酒店的币种。
- 在 Settings → Essentials 中使用 PMS 的币种。
- 仅在 PMS 接受目标币种后再次保存。
当 PMS 拒绝更改时，AVA 不会更新其镜像数据。
仍然无法解决？
如果出现以下情况，请联系 success@vouch-technologies.com：
- ❌ PMS 同步后酒店币种仍为空
- ❌ 币种已锁定，但 PMS 显示的是其他值
- ❌ 预订支付币种错误持续超过 30 分钟
- ❌ 重试后 AVA 仍无法验证币种更改
相关指南
- Payment Gateway — 配置押金和支付收款规则
- PMS Integration — 连接你的物业管理系统
- Thailand Immigration Reports — TM30 和 RR4 设置（如适用）