在入住期间销售套餐

快速设置

选择 PMS 中已有的套餐，为其设置客人易懂的名称，然后发布。大多数物业在约 5 分钟内即可完成第一个套餐的配置。

本指南介绍如何在客人办理入住时提供额外服务，例如早餐、延迟退房和机场接送。客人会将额外项目与房费一起支付，AVA 会将其回传到 PMS。

查找位置

Settings → Check-In → Upsell Packages 标签页

快速参考

设置	控制内容	对客人的影响
Offer packages during check-in	整个功能的总开关	关闭时，入住期间不会显示任何内容
Guest-facing title	套餐卡片上显示的本地化名称（60 个字符）	替代客人无法理解的 PMS 套餐代码
Guest-facing description	标题下方的本地化说明（180 个字符）	告诉客人套餐包含哪些内容
Package image	套餐卡片上显示的照片	让客人更容易识别该优惠
Publish / Save draft	客人是否可以看到套餐	只有已发布的套餐会提供给客人
Display order	套餐的显示顺序	将最畅销的套餐放在最前面
Refresh Package	从 PMS 重新读取价格和可用性	确保报价价格准确

开始之前

你需要准备以下四项：

• 已连接且支持套餐的 PMS（见下表）
• 套餐已在 PMS 中创建并启用 —— AVA 不会创建套餐
• 入住流程已开启收款，可以是全额付款或预授权
• 具有编辑入住设置的权限

必须收款

套餐会作为房费支付步骤的一部分提供。如果入住流程不收款，客人就不会进入套餐页面。请先在 Settings → Payments 完成设置。

哪些 PMS 支持套餐

PMS	入住期间销售套餐	AVA 读取的内容
Cloudbeds	✓ 支持	附加项目和商品，以及 PMS 税费数据
Opera	✓ 支持	所有已启用的套餐，包括房价方案包含的项目
Mews	✓ 支持	产品和房价包含项
AVA PMS	✓ 支持	权益定义
eZee	❌ 不支持	—
Furama	❌ 不支持	—

配置套餐

1. 进入 Settings → Check-In，打开 Upsell Packages 标签页

   ✓ AVA 会列出它能从 PMS 读取的每个已启用套餐

2. 找到要销售的套餐——使用搜索框，或使用 All / Published / Drafts / Not configured / Needs attention 筛选器

3. 点击 Configure

4. 输入 Guest-facing title（最多 60 个字符）

   使用通俗易懂的语言：Breakfast for your stay，而不是 BRKFST-2A

5. 输入 Guest-facing description（最多 180 个字符），说明套餐包含的内容

6. 添加可选的 Package image，或点击选择图片

   支持 PNG、JPEG、GIF、WebP、AVIF 或 SVG，最大 5 MB

   如果跳过图片，AVA 仍会使用无图片卡片布局显示套餐。 要替换图片，请点击 Remove image，然后上传新图片。

7. 检查右侧的 Guest preview 面板

8. 点击 Publish 使其上线，或点击 Save draft 继续编辑

价格仍由 PMS 管理

你可以控制名称、说明和图片。价格、税费，以及套餐按人还是按晚计算，都来自 PMS。AVA 会在显示价格前，为每笔预订重新核对价格。

客人展示由 AVA 管理

这个酒店级设置会改变套餐在 AVA 中的显示方式。它不会在 PMS 中创建、编辑或删除套餐。

添加其他语言

标题和说明字段会为当前启用的客人语言显示标签页。 请在 Settings → Essentials → Supported Languages 中管理这些语言。

1. 在 Guest-facing title 字段上方选择 English 标签页
2. 输入英文标题和说明
3. 点击 Auto-translate to N languages，为其他每种已启用语言创建翻译
4. 在每个语言标签页中检查生成的标题和说明
5. 修改需要调整的翻译
6. 点击 Publish 或 Save draft

必须填写英文，英文会始终作为回退语言。 如果存在相应翻译，客人会看到其在入住时选择的语言。

翻译行为

除英文外，AVA 只保存非空的翻译。 如果某种语言没有翻译，客人会看到英文标题或说明。

本地化的加购体验

加购弹窗会跟随客人在入住期间使用的当前语言。 这包括套餐标题、说明、操作、状态和价格明细标签。

CCI v3 弹窗内置英文、西班牙文、印度尼西亚文、日文、韩文、泰文和中文字符串。 你只需为套餐内容编写翻译。

开启套餐功能

配置套餐并不会自动使其上线。

1. 在标签页顶部打开 Offer packages during check-in

2. 确认至少有一个套餐显示 Published 标记

   ✓ 绿色面板会确认这些费用将并入哪种收款方式

切换 PMS 后更改开关

更换 PMS 后，旧的已发布套餐可能在新目录中不可用。

你仍可以打开或关闭 Offer packages during check-in，并保存现有设置。 AVA 会保留这些旧优惠，以供历史配置使用。

AVA 只会在保存时验证新改为 Published 的套餐。 当前 PMS 必须将新发布的套餐作为启用状态返回。

设置显示顺序

使用每个已发布套餐上的 Move up 和 Move down 箭头。客人会按照这个顺序看到套餐。

客人看到什么

套餐会在客人确认房间后、付款前显示：

1. 客人进入入住流程的付款步骤
2. Enhance your stay 打开，列出已发布的套餐及其价格
3. 客人房价方案中已包含的项目会显示在 Included with your stay 下方 其价值仍包含在房费中，而返回的税费会单独显示。 多晚入住的每一晚都适用此规则。 客人不能重复购买同一个包含项。
4. 客人点击想要的项目上的 Add，或点击 Continue without extras
5. 账单摘要会显示房费余额和套餐费用
6. 客人一次性付款——房费与套餐一起支付

预订多间客房的客人

客人办理多间客房入住时，AVA 会显示 Quick add 区域，一次将同一套餐应用到所有符合条件的客房。需要单独调整时，Customize individual rooms 可打开逐间客房的控制选项。

付款和 PMS 过账方式

步骤	发生的情况
客人选择套餐	AVA 请求包含套餐税费的最新合并报价，并将其保留 10 分钟
客人付款	套餐金额和税费与房费一起进行同一笔付款或预授权
付款成功	AVA 将每个套餐过账到 PMS 中的该预订
PMS 确认	套餐像其他费用一样出现在客人账单上

报价 10 分钟后失效

如果客人让页面打开太久，会看到 "Package prices have expired. Please review your selection again."。系统会重新报价，不会产生扣款。

PMS 特定的套餐行为

PMS	预期行为
Cloudbeds	每个项目使用 Cloudbeds 返回的含税报价。支持安全重试过账，避免重复收取项目费用。
Opera	可以提供已启用的套餐，包括房价方案已包含的套餐。包含项的价值仍保留在房费中。
Mews	AVA 为选定产品报价，并将付款作为一个合并金额过账。
AVA PMS	AVA 使用其原生套餐和付款支持处理预订。

税费显示可能不同

AVA 使用各 PMS 返回的报价和税费规则。面向客人的总额是该笔预订的权威金额。

套餐状态

标记	含义	处理方式
Published	已上线并提供给客人	无需处理
Draft	已配置但对客人隐藏	打开后点击 Publish
Not configured	已从 PMS 读取，但还没有面向客人的文字	点击 Configure 并添加标题
Needs attention	AVA 无法安全提供——见下文	按下一节的修复方法处理

故障排查

客人始终看不到套餐页面

你看到的现象： 入住流程完成，但没有提供任何套餐。

请检查：

• Offer packages during check-in 已开启
• 至少有一个套餐显示 Published 标记
• 入住流程会收款——全额付款或预授权
• 该套餐未包含在客人的房价方案中
• 在 PMS 中，该套餐对这笔预订的日期和客人数可用

"Couldn't retrieve the latest package information"

你看到的现象： 出现警告横幅，已保存的套餐显示 Availability not verified。

处理方法：

1. 在 Settings → Essentials 检查 PMS 连接
2. 返回 Upsell Packages 标签页
3. 点击 Refresh Package

目录无法访问时，已保存的配置不会丢失。你仍可以更改总开关、编辑现有文字以及保存草稿。

在 AVA 确认套餐存在于当前 PMS 目录之前，你无法发布新套餐。

"This package is no longer available in the source catalogue"

你看到的现象： 已配置的套餐被标记为 Needs attention。

原因： 该套餐已在 PMS 中被删除或停用，或者你连接了其他 PMS。

处理方法：

1. 在 PMS 中重新创建或重新启用套餐，然后点击 Refresh Package；或者
2. 在 AVA 中打开套餐并点击 Remove configuration

"This source package is marked as unsuitable for sale"

你看到的现象： 套餐无法发布。

原因： 该套餐在 PMS 中的名称或说明包含 "do not use"。这通常是内部记录或测试记录。

处理方法： 如果确实可以销售，请在 PMS 中重命名，然后点击 Refresh Package。

自动翻译不可用

你看到的现象： Auto-translate to N languages 按钮被禁用或不显示。

处理方法：

1. 在 Settings → Essentials → Supported Languages 中启用至少一种其他客人语言
2. 再次打开套餐编辑器
3. 选择 English 标签页
4. 输入标题或说明
5. 点击 Auto-translate to N languages

该按钮需要英文文字以及至少一种其他已启用语言。

客人看到英文而不是翻译

你看到的现象： 客人选择了其他语言，但套餐内容或弹窗文字仍显示英文。

处理方法：

1. 从 Settings → Check-In → Upsell Packages 打开套餐
2. 选择客人使用的语言标签页
3. 添加或检查翻译后的标题和说明
4. 点击 Publish

如果所选语言的条目为空，AVA 会使用英文。 对于受支持的语言，弹窗会使用其内置翻译。

套餐显示价格但客人无法加购

你看到的现象： 入住期间套餐卡片显示为灰色。

原因： 只有 PMS 返回完整价格——金额、单价、数量和币种——AVA 才会销售套餐。缺少任何一项时，套餐会显示为只读，而不是猜测价格。

处理方法： 在 PMS 中检查受影响的房价方案和日期对应的套餐定价设置。

客人已付款但账单上没有套餐

你看到的现象： 付款成功，但 PMS 中没有套餐费用。

处理方法：

1. 在 PMS 中刷新预订——过账可能需要几秒钟
2. 如果仍未显示，请在 PMS 中手动过账套餐
3. 联系客服，并提供预订确认号和付款时间

不要向客人重复收费

这笔付款已经包含套餐费用。请在 PMS 中手动过账，而不是要求客人再次付款。

仍未解决？

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

• ❌ 刷新后套餐仍显示 Needs attention
• ❌ 已付款的套餐没有到达 PMS
• ❌ 向客人显示的价格与 PMS 不一致

建议一并提供：

• 套餐代码和预订确认号
• Upsell Packages 标签页的截图
• 客人办理入住的时间

相关指南

• 支付
• 入住政策
• 支持的语言