> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maple.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# Genius

> 将 Maple 连接到您的 Genius(Heartland Restaurant)POS 系统

将 Maple 连接到 Genius（Heartland Restaurant），即可使用 AI 点单，并自动同步菜单、直接下单到 POS。

## 前提条件

开始之前，请确保您具备：

- ✅ 您门店的 Genius API 密钥（来自 Heartland Restaurant 门户）。这是您唯一需要输入的密钥——合作伙伴认证密钥由 Maple 一次性配置，适用于所有门店。
- ✅ Maple Pro 套餐，其中包含电话点单和 POS 集成
- ✅ 门店配置

## 设置流程

1. ### 输入门店 API 密钥
   在 Maple 控制台中填写这家餐厅的 Genius API 密钥。Maple 会针对您的 Genius 门店实时验证该密钥。
2. ### 选择已付款订单的记录方式
   选择用于在账单上记录 Maple 已收款订单的 Genius 挂账账户，或者让账单保持未付款状态，由员工在收银台结算。
3. ### 选择配送费的记录方式
   如果您的 Genius 门店配置了服务费（service charge），请选择用于记录由您自己的骑手配送的订单配送费的那一项，也可以选择不记录。如果您的门店没有可供选择的服务费，则会跳过此步骤。
4. ### 激活
   您的菜单会自动从 Genius 导入。请核对菜品、规格、加料选项和价格，然后正式上线。

## 功能

- 自动同步菜单，包括已售罄（86）的菜品和加料选项
- 完整支持加料选项（modifier），包括按菜品设置的加料选项配置、按规格定价，以及情境选项（加量 / 少量 / 另放）
- 税费和总价由 Genius 计算——顾客支付的金额始终与 Genius 账单一致
- 实时更新：菜单发布和库存变化会立即从 Genius 推送到 Maple
- 订单直接显示在您的 Genius POS 和 KDS 上

## 支付处理

Maple 可以在订单发送到 Genius 之前收款，并记录到您在设置期间选择的挂账账户，也可以将订单以未付款状态发送，由员工在店内结算。

- 支持到店付款——账单会以未结状态到达 POS
- Maple 收取的小费会随订单一并发送到 Genius
- 对于由您自己的骑手配送的订单，骑手小费会记在账单上，配送费则记录为您在设置期间选择的服务费
- 订单一旦到达 Genius,Maple 就无法取消；请在 Genius POS 上作废该订单

## 菜单同步

您的 Genius 菜单会自动同步：

- ✅ 所有菜单（分组）、分类（版块）、菜品和规格，以及按规格设置的价格
- ✅ 加料选项，包括按菜品设置的默认项、排除项和含量规则
- ✅ 情境选项（加量 / 少量 / 另放）及其价格
- ✅ 已售罄（86）的菜品和加料选项

> [!NOTE]
>
> 菜单修改应在 Genius 中进行。发布菜单或更改库存时会自动推送到 Maple，您也可以在 Maple 控制台中手动触发同步。

## 故障排查

**菜单菜品未同步**

- 确认这些菜品及其所属版块在 Genius 中已标记为可在线订购
- 在 Maple 控制台中手动触发菜单同步
- 如果问题仍然存在，请联系支持团队

**订单没有出现在 POS 上**

- 确认 Genius 门店在线
- 确认门店 API 密钥仍然有效
- 请带上订单号联系支持团队

## 支持

- **Heartland 支持**：请联系您的 Heartland 客户代表
- **Maple 支持**：发送短信至 +1 929 543 0229

## 后续步骤

- [配置配送](https://docs.maple.inc/zh/orders/config/delivery.md): 设置配送区域和费用
- [正式上线](https://docs.maple.inc/zh/going-live.md): 启用您的 Maple AI