> ## 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.

# Toast

> 将 Maple 直接连接到 Toast，并通过 Toast Hosted Checkout 收款

Maple 通过 Toast 的 Orders API 直接连接到 Toast，并通过 **Toast Hosted Checkout** 收款，因此订单和付款都会进入您的 Toast 账户。

> [!NOTE]
>
> 银行卡付款通过您的 Toast 账户处理，因此无需单独的商户资质验证（KYC）步骤。在 Toast Direct 推出之前就通过 StreamOrders 连接 Toast 的门店，请参阅 [通过 StreamOrders 连接 Toast](https://docs.maple.inc/zh/orders/pos/toast-streamorders.md)。

## 前提条件

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

- ✅ Toast Web 的管理员权限
- ✅ 每个门店的 Toast 餐厅 GUID
- ✅ Maple Pro 套餐，其中包含电话点单和 POS 集成

## 连接 Toast

1. ### 安装 Maple 集成
   在 Toast Web 的集成页面中安装 Maple 集成。

2. ### 输入您的餐厅 GUID
   在 Maple 中输入您的 Toast 餐厅 GUID，以连接该门店。

3. ### 设置 Toast Web

   按照下文“在 Toast Web 中需要设置的内容”一节，创建用餐方式（dining option）和服务费（service charge）。

4. ### 映射您的选项
   在 Maple 中选择这些用餐方式和服务费。

5. ### 测试
   下几笔测试订单，并在 Toast 中查看。

## 工作原理

- Maple 会把每笔在线订单直接发送到 Toast（Orders API），并通过 Toast 计价，因此收取的总额始终与 Toast 账单一致。
- 顾客通过 **Toast Hosted Checkout** 付款；资金会结算到**您的 Toast 收款账户**。
- 配送在 Toast 之外处理。对于 **Maple 托管**的配送，Maple 会计算配送费，并把配送费和骑手小费记在您的 **Maple Delivery** 开放金额（open-amount）服务费上。对于**您自己的骑手**，配送费由 Toast 根据您选择的配送服务费设定——这是可选的；如果一项都不选，则免配送费——骑手小费会加到订单的小费中。

### 订单类型

| 订单             | 如何到达 Toast             | 配送方         |
| -------------- | ---------------------- | ----------- |
| 自取             | Take Out 订单            | 顾客自取        |
| **Maple 托管配送** | **Take Out** 订单（由骑手取餐） | Maple 的配送车队 |
| **自行配送（BYOF）** | **Delivery** 订单（含地址）   | 您/您自己的配送服务  |

> [!NOTE]
>
> Maple 托管配送以 **Take Out** 发送，因为从后厨的角度看，这是骑手上门取餐——与 DoorDash/Uber Eats 平台订单在 Toast 中的到达方式完全一致。您自己的配送则以真正的 **Delivery** 订单发送，这样它们会出现在您的 Toast 配送报表中。

## 在 Toast Web 中需要设置的内容

您需要在 Toast 中创建**用餐方式（dining option）**、用于 Maple 托管配送的 **Maple Delivery** 服务费，以及（仅当您为自己的骑手收取配送费时）配送**服务费**。然后在 Maple 入驻过程中完成映射。这些名称不会显示给顾客——仅用于您的报表。

1. ### 用餐方式（Toast Web → Dining Options）

   - 一个 **Take Out** 用餐方式（必需）——用于自取和 Maple 托管配送。
   - 一个 **Delivery** 用餐方式（仅当您提供自己的/BYOF 配送时才需要）。
   - \*推荐：\*再创建一个名为 **“Maple Courier”** 的 **Take Out** 用餐方式，让后厨能区分 Maple 车队骑手的订单和普通顾客自取订单。此项可选——如果跳过，Maple 托管订单会使用您的标准 Take Out 选项。

2. ### 服务费 — "Maple Delivery"(Maple 托管配送必需)

   在 Toast Web 中，前往 **Finance → Related → Settings → Service charges & fees**，并按以下设置创建一个服务费 ([Customize Service Charges and Mandatory Gratuity](https://support.toasttab.com/en/article/How-to-Create-a-Service-Charge)):

   - **Name:** **Maple Delivery**（用于您的报表——顾客看不到）
   - **Charge Type:** **Open Amount**（Maple 会在每笔订单上发送确切金额）
   - **Apply After Amount Threshold:** **$0.00**
   - **Assign to check owner (Gratuity)?:** **No, Assign the fee to the restaurant.**
   - **Taxed?:** **No**
   - **Delivery?:** **No**
   - **Takeout?:** **No**
   - **Dine-In?:** **No**

   请让 Delivery、Takeout 和 Dine-In 全部保持为 **No**。Toast 不允许把开放金额服务费绑定到某个用餐方式，也不需要绑定：Maple 只会把此费用添加到 Maple 托管配送订单上，因此普通自取订单永远不会被收取。不要开启任何自动应用设置。如果您的 Toast 账户为此费用显示了最大账单金额，请留空。

   在 Maple 入驻过程中，于 **Maple delivery service charge** 下拉列表中选择此服务费，或之后在 **Location → Integrations → Toast → Edit dining & delivery setup** 中选择。只有按上述方式设置的服务费才会列出；其他任何开放金额服务费，或名称中带有 “Maple” 的固定金额/固定比例服务费，会显示需要修正的设置。对于每笔 Maple 托管配送订单，Maple 会把该服务费设为此订单的配送费加骑手小费。如果已开启 Maple 托管配送但没有选择可用的服务费，Maple 会在顾客付款之前阻止这些订单。

   当您在 Maple 中保存 Toast 设置时，Maple 会保存此服务费的设置。如果您之后在 Toast 中更改了该服务费，请打开 **Edit dining & delivery setup** 并再次保存，让 Maple 重新检查。如果它不再符合要求，Maple 会清除它，并阻止 Maple 托管配送订单，直到您选择符合要求的服务费。

   > [!NOTE]
   >
   > 此服务费是 Maple 的配送费加骑手小费，不是您的收入。它会显示在您的 Toast 账单上并存入您的 Toast 账户；之后 Maple 会在每周的配送账单中，向您预留的银行卡收取同样的金额，因此两者相互抵消。它不是小费，也不计税，因此永远不会进入您的小费池或薪资。

3. ### 自己骑手的服务费（可选）

   可选。免费配送的商户——例如在没有 Toast 配送服务费的小范围内配送——可以不选择服务费就完成设置。这些订单会以无配送费的方式下单，Maple 会显示警告，提示不会收取任何费用。

   如需收取配送费，请按照 [Configure Delivery Fees Using Your Own Drivers](https://support.toasttab.com/en/article/Configuring-Delivery-Fees-1493053499602) 创建一个或多个配送服务费（例如 **BYOF Delivery Fee**），设置如下：

   - **Charge Type:** **Fixed Amount** 或 **Fixed Percent**（Toast 不允许开放金额的配送费；金额由 Toast 设定）
   - **Assign to check owner (Gratuity)?:** **No, Assign the fee to the restaurant.**
   - **Taxed?:** 按您通常的配送费税务处理方式设置
   - **Delivery?:** **Yes**

   这笔费用是**您的**收入。自行配送订单的骑手小费会并入您门店的常规小费。

4. ### 在 Maple 中连接并映射您的选项

   在 Maple 入驻过程中，选择用餐方式、**Maple Delivery** 服务费，以及您在上面创建的任何自己骑手的服务费。Maple 会对照 Toast 验证它们，并在您正式上线之前标出任何配置错误。您之后可以在 **Location → Integrations → Toast** 中更改这些设置。

## 正式上线

完成映射并通过验证后，请为每种订单类型各下一笔测试订单（自取、Maple 托管配送，以及——如果您使用的话——自行配送），并确认每一笔都正确出现在 Toast 中，且收费无误。

## 菜单同步

- 菜单菜品、价格、加料选项（modifier）、选项和分类会按您在 Toast 中的设置导入
- 您在 Toast 中售罄（86）的菜品，不会再在通话中提供
- 您在 Toast 中发布的菜单更改会自动到达 Maple，您也可以在 Maple 控制台中重新同步菜单
- 在 Toast 中隐藏的菜品不会同步

> [!NOTE]
>
> 菜单更改必须在 Toast 中进行。

## 支付

- 顾客通过 **Toast Hosted Checkout** 付款，资金结算到您的 Toast 收款账户
- 配送订单在下单时付款；如果您允许，自取订单可以在通话中付款或到店付款

## 断开 Toast

- 在 Toast Partner Connect 中移除 Maple
- Toast 会发送合作伙伴移除通知，Maple 会为该门店关闭 Toast 集成