跳转到内容
Maple

    POS 集成

    Toast

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

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

    前提条件

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

    • ✅ 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 订单（含地址） 您/您自己的配送服务

    在 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):

      • 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 托管配送订单，直到您选择符合要求的服务费。

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

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

      如需收取配送费，请按照 Configure Delivery Fees Using Your Own Drivers 创建一个或多个配送服务费（例如 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 中隐藏的菜品不会同步

    支付

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

    断开 Toast

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