> ## 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 集成
* ✅ 门店配置

## 设置流程

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

## 功能

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

## 支付处理

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

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

## 菜单同步

您的 Genius 菜单会自动同步：

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

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

## 故障排查

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

  <Accordion title="订单没有出现在 POS 上">
    * 确认 Genius 门店在线 - 确认门店 API 密钥仍然有效 - 请带上订单号联系支持团队
  </Accordion>
</AccordionGroup>

## 支持

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

## 后续步骤

<CardGroup cols={2}>
  <Card title="配置配送" icon="truck" href="/zh/orders/config/delivery">
    设置配送区域和费用
  </Card>

  <Card title="正式上线" icon="rocket" href="/zh/going-live">
    启用您的 Maple AI
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.