> ## 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 账户。

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

## 前提条件

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

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

## 连接 Toast

<Steps>
  <Step title="安装 Maple 集成">在 Toast Web 的集成页面中安装 Maple 集成。</Step>
  <Step title="输入您的餐厅 GUID">在 Maple 中输入您的 Toast 餐厅 GUID，以连接该门店。</Step>

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

  <Step title="映射您的选项">在 Maple 中选择这些用餐方式和服务费。</Step>
  <Step title="测试">下几笔测试订单，并在 Toast 中查看。</Step>
</Steps>

## 工作原理

* 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 配送报表中。
</Note>

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

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

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

  <Step title="服务费 — &#x22;Maple Delivery&#x22;(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 会在每周的配送账单中，向您预留的银行卡收取同样的金额，因此两者相互抵消。它不是小费，也不计税，因此永远不会进入您的小费池或薪资。
    </Note>
  </Step>

  <Step title="自己骑手的服务费（可选）">
    可选。免费配送的商户——例如在没有 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**

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

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

## 正式上线

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

## 菜单同步

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

<Note>菜单更改必须在 Toast 中进行。</Note>

## 支付

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

## 断开 Toast

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


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