附加费

本指南介绍如何在 Hivive 中设置商家附加费、附加费何时生效、Hivive 如何计算附加费，以及附加费会显示在订单和收据的哪些位置。

商家附加费与刷卡附加费是分开的。商家附加费是您自行配置的规则，例如周末、公共假期或堂食服务附加费。刷卡附加费由付款流程处理，适用时会单独显示。

功能入口

附加费菜单显示在商家管理后台的 Surcharge（附加费） 中。在 POS 应用中，也可以通过 Settings > Surcharges（设置 > 附加费） 打开同一个后台设置页面。

如果您看不到 Surcharge（附加费），请联系 Hivive 客服确认您的商家权限。

在哪里管理附加费

使用商家管理后台：

1. 进入 Surcharge（附加费）。
2. 点击 Add Surcharge（添加附加费） 创建新规则。
3. 点击已有的附加费行进行编辑或删除。

每条附加费规则都有自己的名称、百分比、生效时间、销售渠道和外带行为。

推荐设置流程

1. 确定附加费的用途，例如周末、公共假期或堂食服务。
2. 起一个顾客和员工都能看懂的清晰名称。
3. 选择附加费应生效的销售渠道。
4. 选择是否对外带订单生效。
5. 输入百分比。
6. 选择生效方式：Day of Week（每周固定日） 或 Date Range（日期范围）。
7. 保存附加费，并在对应渠道下一笔测试订单验证。

只启用当前应该收取的附加费。不使用的附加费可以保留，但把 Is Enabled（启用） 关掉。

附加费字段

字段	作用
Surcharge Name（附加费名称）	显示在订单合计、收据和订单详情中的名称。请使用顾客友好的名称，例如 "Weekend Surcharge"（周末附加费）或 "Public Holiday Surcharge"（公共假期附加费）。
Chinese Name（中文名称）	可选的翻译名称，供使用中文显示的商家使用。
Is Enabled（启用）	控制附加费是否生效。停用的附加费会被保存但跳过。
Apply to Takeaway?（应用到外带？）	控制外带商品或纯外带订单是否收取此附加费。
Sales Channels（销售渠道）	控制附加费生效的渠道：POS、QR_CODE 和/或 KIOSK。
Percentage（百分比）	附加费费率。必须是小数位不超过 2 位的数字。
Surcharge Type（附加费类型）	控制生效时间：每周某一天，或一个包含首尾的日期范围。

销售渠道

选择附加费应生效的所有渠道。

渠道	适用于
POS	员工 POS 订单。POS 也涵盖关联的副 POS 订单流程。
QR_CODE	扫码点餐流程。
KIOSK	自助点餐机订单。

新建的附加费默认选中所有渠道。请保持所需渠道处于选中状态，这样附加费才会在顾客端购物车、POS 购物车、收据和存储订单中一致地显示。

生效时间行为

每周固定日（Day of Week）

当附加费每周重复时，使用 Day of Week。

示例：

• 周一附加费。
• 周末附加费（如果您的业务在所选的整天使用同一规则）。
• 周日附加费。

每条“每周固定日”附加费规则只支持一天。要在周六和周日都收取，请创建两条附加费规则，一条周六、一条周日。

日期范围（Date Range）

特殊日期使用 Date Range。

示例：

• 单个日期的公共假期附加费。
• 跨周末的活动附加费。
• 固定季节性时段的临时附加费。

开始日期和结束日期都包含在内。单天的公共假期附加费应把开始和结束日期设为同一天。

附加费的生效时间基于日期，而不是一天中的时段。Hivive 使用澳大利亚/墨尔本的营业日期来判断订单计算时附加费是否生效。

外带行为

Apply to Takeaway?（应用到外带？） 控制附加费是否适用于外带。

设置	行为
开	附加费适用于符合条件的堂食和外带商品/订单。
关	纯外带订单不收取附加费。在混合的 POS 购物车中，只对堂食商品收取。

对于按外带方式处理的线上、扫码和自助点餐机流程，如果这些渠道应收取附加费，请保持 Apply to Takeaway? 开启。

附加费何时生效

只有当以下条件全部满足时，附加费才会生效：

• 附加费已启用。
• 订单日期匹配附加费的生效时间。
• 订单销售渠道匹配所选销售渠道之一。
• 订单或符合条件的商品通过外带规则。
• 订单是在规则生效期间创建或更新的。

如果多条附加费同时匹配一个订单，所有匹配的附加费都会生效。

计算方式

Hivive 根据符合条件的商品合计来计算商家附加费。

基本公式：

符合条件的商品合计 = 商品价格 x 数量或重量
附加费金额 = 符合条件的商品合计 x 附加费百分比 / 100
订单总额 = 小计 + 商家附加费 - 折扣

刷卡附加费（如有）在付款时单独计算，并作为单独一行显示。

示例：单条附加费

购物车：

商品	价格	数量	行小计
汉堡	$20.00	2	$40.00
饮品	$5.00	1	$5.00

小计：$45.00

周末附加费：10%

$45.00 x 10% = $4.50
$45.00 + $4.50 = $49.50

刷卡附加费之前的订单总额：$49.50

示例：多条附加费

购物车小计：$100.00

匹配的附加费：

• 周日附加费：10%
• 服务附加费：5%

每条附加费分别基于符合条件的商品合计计算，然后相加。

$100.00 x 10% = $10.00
$100.00 x 5% = $5.00
商家附加费合计 = $15.00
订单总额 = $115.00

多条附加费是相加的，不会互相复利叠加。

示例：外带关闭时的混合商品

附加费：10%

应用到外带？：关

购物车：

商品	类型	行小计
堂食餐品	堂食	$50.00
外带饮品	外带	$10.00

只有堂食商品符合条件。

$50.00 x 10% = $5.00
小计 = $60.00
订单总额 = $65.00

折扣

折扣与商家附加费分开显示。

订单总额计算方式为：

小计 + 商家附加费 - 折扣

在积分获取规则中，Hivive 计算消费金额积分时会排除商家附加费和刷卡附加费。

四舍五入

Hivive 将显示的金额四舍五入到小数点后 2 位。最终总额四舍五入到分。

GST（商品及服务税）

Hivive 在订单总额的含税 GST 计算中包含商家附加费。含税 GST 基于扣除折扣、加上商家附加费之后的最终总额计算。

附加费显示在哪里

商家附加费显示在：

• 附加费生效时的顾客结账合计。
• POS 购物车合计。
• 自助点餐机购物车合计。
• POS 和顾客收据。
• 管理后台订单详情的 Other Surcharge（其他附加费）。
• 生成的订单报表中的 otherSurcharge 字段。

Fees（费用） 报表主要关注银行卡处理费和扫码点餐费用。商家自定义的附加费与支付处理费不是一回事。

编辑或删除附加费

编辑附加费：

1. 进入 Surcharge（附加费）。
2. 点击附加费所在行。
3. 更新字段。
4. 点击 Finish（完成）。

删除附加费：

1. 进入 Surcharge（附加费）。
2. 点击附加费所在行。
3. 点击 Delete Surcharge（删除附加费）。
4. 确认删除操作。

已付款订单会保留其保存的附加费行，用于订单历史、收据和报表。未付款的进行中订单在付款前被更新时，可能会重新计算附加费。

常见配置

周末附加费

为周六和周日各创建一条附加费。

推荐字段：

• 名称：Weekend Surcharge（周末附加费）
• 启用：开
• 应用到外带？：按您的政策
• 销售渠道：选择所有应生效的渠道
• 百分比：您的周末费率
• 类型：每周固定日

公共假期附加费

创建一条日期范围附加费。

推荐字段：

• 名称：Public Holiday Surcharge（公共假期附加费）
• 启用：开
• 应用到外带？：按您的政策
• 销售渠道：选择所有应生效的渠道
• 百分比：您的公共假期费率
• 类型：日期范围
• 开始和结束日期：公共假期当天，或整个假期时段

仅堂食的服务附加费

推荐字段：

• 名称：Service Surcharge（服务附加费）
• 启用：开
• 应用到外带？：关
• 销售渠道：POS，或您使用的任何堂食点餐渠道
• 百分比：您的服务费率
• 类型：每周固定日或日期范围

故障排查

附加费没有出现

请检查：

• Is Enabled（启用） 已打开。
• 当前日期匹配所选的星期几或日期范围。
• 已选择正确的销售渠道。
• 需要对外带、线上、扫码或自助点餐机订单收取时，Apply to Takeaway?（应用到外带？） 已打开。
• 百分比有效，且小数位不超过 2 位。
• 订单是在附加费启用之后创建或更新的。

附加费在一个渠道出现，另一个渠道没有

检查附加费的 Sales Channels（销售渠道）。POS 订单需要 POS，扫码点餐需要 QR_CODE，自助点餐机需要 KIOSK。

总额看起来比预期高

检查是否有多条附加费规则同时匹配了该订单。匹配的附加费会相加叠加。

同时检查订单是否有单独的刷卡附加费。商家附加费和刷卡附加费显示为不同的行，可以同时存在于同一订单上。

附加费需要覆盖整个周末

为周六和周日各创建一条每周固定日附加费；如果该周末是一次性的活动时段，也可以使用日期范围。