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

# 通过 StreamOrders 连接 Toast

> 适用于通过 StreamOrders 连接的 Toast 门店

> [!NOTE]
>
> 本页适用于通过 StreamOrders 连接的 Toast 门店。新门店直接连接 Toast：请参阅[Toast](https://docs.maple.inc/zh/orders/pos/toast.md)。

通过 StreamOrders（Maple 的订单中继服务）将 Maple 连接到您的 Toast POS 系统。通过电话或短信下的订单会出现在您的 Toast 系统中。

> [!NOTE]
>
> 银行卡支付通过 Stripe 处理，需要进行商户资质验证（KYC）。审核时长由 Stripe 决定，部分商户需要等待几天。

## 前提条件

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

- ✅ Toast 的管理员权限
- ✅ Maple Pro 套餐，包含电话订餐和 POS 集成
- ✅ 用于 KYC 的企业证明文件
- ✅ 银行账户信息
- ✅ 一个可连接到 StreamOrders 的 Toast 门店
- ✅ 您的 Toast 账户已开通 **Toast Restaurant Management Suite**（集成需要）
- ✅ 一台带网页浏览器的电脑（仅用手机无法完成设置）

## 设置流程

1. ### 开始 KYC 验证
   提交企业验证文件
2. ### 通过 StreamOrders 连接
   从 Maple 控制台打开 StreamOrders，并关联您的 Toast 门店
3. ### 选择门店
   在 StreamOrders 中选择要连接的门店
4. ### 配置支付设置
   设置支付方式和规则
5. ### 测试集成
   下测试订单，验证设置

## 第 1 步：KYC 验证

### 所需文件

- 企业注册证明（LLC、Corp 等）
- EIN 或税号函
- 所有者的政府签发身份证件
- 银行对账单或作废支票
- 企业地址证明

> [!WARNING]
>
> KYC 审核时长由 Stripe 决定，部分商户需要等待几天。请尽早开始，以免延误。

### 提交文件

1. 在侧边栏点击 **Orders**，继续进入 **Payment Processing** 步骤
2. 选择您的企业注册所在国家/地区，然后开始 **Verify Your Business Entity**
3. 上传所需文件
4. 填写所有者信息
5. 提交审核

## 第 2 步：通过 StreamOrders 连接 Toast

Toast 通过 StreamOrders 连接。您可以按以下步骤自行连接，也可以请 Maple 团队为您设置（见[让 Maple 为您设置 Toast](#%E8%AE%A9-maple-%E4%B8%BA%E6%82%A8%E8%AE%BE%E7%BD%AE-toast)）。

1. 在侧边栏点击 **Orders**，继续进入 **Select POS** 步骤（或打开该门店的设置并前往 **Integrations**）
2. 选择 **Toast (via StreamOrders)**，然后点击 **Continue with Toast (via StreamOrders)**
3. 如有提示，请填写商户所有者的全名和联系电话（使用您的个人手机，而不是门店电话），然后点击 **Save & Continue**
4. 点击 **Open StreamOrders**
5. 在 StreamOrders 中授权 Maple，连接您的 Toast 门店，并选择要连接的门店
6. 返回 Maple 控制台，点击 **I completed this step**

> [!TIP]
>
> 您需要 Toast 管理员权限，才能在 StreamOrders 中连接 Toast。如果您没有权限，请联系您的 Toast 管理员。

### 让 Maple 为您设置 Toast

在 Toast 中将 Maple 添加为员工，Maple 团队即可为您完成连接，通常约一个工作日内完成。

1. 在 Toast 控制台中点击 **Employees**，然后点击 **Add New Employee**。
2. **First Name** 填写 `Maple`，**Last Name** 填写 `Onboarding`，**Email** 填写 `onboarding@maple.inc`（必须完全一致）。**POS Access Code** 可填写任何其他员工未使用的号码，并选择一个不带薪资的职位且不填写工资标准，这样 Maple 就不会进入您的工资单。
3. 点击 **Add**，刷新页面，点击 **Maple Onboarding** 旁的编辑图标，然后打开 **Jobs and Permissions**。
4. 开启权限 **4.5** 和 **4.14**（菜单）、**6.2**（Web Setup: Publishing）、**6.3** 和 **6.4**（报表）、**6.6**（打印机）以及 **8.4**， 然后点击 **Save**。Toast 中的编号可能不同，请浏览完整列表。
5. 告知您的入驻专员已添加该员工。

Maple 只会获得这些权限，无法访问您的财务或工资数据。

## 第 3 步：配置门店

### 单个门店

1. 您的门店会自动填充
2. 确认信息无误
3. 启用订单处理
4. 设置默认备餐时间

### 多个门店

1. 所有门店都会列出

2. 逐个开启/关闭门店

3. 按门店配置设置：

   - 备餐时间
   - 支付方式
   - 外送范围（如适用）
   - 营业时间

## 第 4 步：菜单同步

您的 Toast 菜单会通过 StreamOrders 自动同步到 Maple：

### 自动同步的内容

- ✅ 所有菜品和价格
- ✅ 加料选项和选项
- ✅ 分类和组织结构
- ✅ 已售罄（86）的菜品
- ✅ 价格变更
- ✅ 供应时段安排
- ✅ 菜单时段
- Toast 中隐藏的菜品不会同步

### 同步时间

- 菜单变更（包括已售罄（86）的菜品）经 StreamOrders 转发，通常在 5 分钟内到达 Maple，往往更快
- 如需立即推送变更，请[在 StreamOrders 中重新同步](#%E5%9C%A8-streamorders-%E4%B8%AD%E9%87%8D%E6%96%B0%E5%90%8C%E6%AD%A5)

> [!NOTE]
>
> 菜单变更必须在 Toast 中进行。变更会自动同步到 Maple。

### 选择同步内容

您不需要同步所有 Toast 菜单，也不需要上传菜单文件。请把要同步的菜单的准确名称告诉您的入驻专员：

- **包含**用于电话和自取订单的菜单（例如 Food、Beverages 或 Online Ordering 菜单）。如果一个 Online Ordering 菜单已包含所有相关菜品，可以只同步这一个菜单。
- **排除**专为第三方平台制作的菜单（例如仅限 Grubhub 的菜单）、内部菜单（例如 Crew Takeout），以及不希望通过电话点的分类（例如 Liquor）。

Maple 会遵循 Toast 在菜单、分类和菜品层级的 **Channel Visibility** 设置。对 **Online Ordering Partners** 隐藏的内容不会同步，也无法通过电话点。如需修改，请在 **Menu Builder** 中点击菜单、分类或菜品旁的 **⋯**，选择 **Edit**，在 **Channel Visibility** 下设置 **Online Ordering Partners**，然后 **Save** 并 **Publish**。隐藏功能适用于每日特价、酒类和仅限店内的菜品。

Maple 也会遵循 Toast 中设置的预约订单规则。

### 在 StreamOrders 中重新同步

使用 StreamOrders 的门店在 Maple 的 **Menus** 页面上没有 **Resync Menu** 按钮。如需立即重新同步：

1. 在 Toast **Menu Builder** 中 **Save** 并 **Publish** 您的修改。
2. 在 Maple 中打开门店设置，前往 **Integrations**，点击 **Open StreamOrders**。
3. 点击 Toast 标志旁的蓝色刷新图标，然后点击 **Publish**（或绿色对勾）。

如果 StreamOrders 无法打开，请联系 Maple 支持团队为您重新同步。

> [!WARNING]
>
> 在 Maple 中所做的修改（例如菜品名称、描述或菜单时间）会在下次同步时被覆盖。永久性修改请在 Toast 中进行。营业时间例外：请同时在 Toast 和 Maple 的 **My Location** 中设置。

### Toast 菜单建议

- 在 Toast 中添加详细描述（配料、尺寸如“10 英寸个人披萨”、饮食信息）。AI 会用这些描述回答问题。
- 对名称特殊的菜品（例如“Thanduri Chicken”），在描述中加入其他拼写和读音，帮助 AI 匹配来电者所说的内容。
- 在 Toast 中最少选择数为 **1** 的加料组为必选，AI 会主动询问。最少选择数为 **0** 时为可选：AI 不会询问，但来电者提到时会添加。

## 第 5 步：支付配置

### 支付方式

配置接受哪些支付类型：

- **信用卡/借记卡**：通过 Maple 的安全支付链接支付，链接以短信发送给顾客，并由您的 Maple 支付服务商处理（默认为 Stripe）。顾客在订单发送到 Toast 之前完成支付。
- **到店付款**：自取订单，如已启用。外送订单仅在由您自己的骑手配送时才可货到付款。
- **礼品卡**：不支持
- **挂账账户（house accounts）**：不支持

> [!NOTE]
>
> 此集成不使用 Toast Hosted Checkout，银行卡付款也不会结算到您的 Toast 账户。有关 Maple 支付链接的工作方式，请参阅[支付方式](https://docs.maple.inc/zh/orders/config/payment-methods.md)。

### 支付规则

设置顾客何时付款：

| 订单类型   | 支付选项                   |
| ------ | ---------------------- |
| **外送** | 预先支付；仅在由您自己的骑手配送时可货到付款 |
| **自取** | 立即支付或到店付款              |
| **堂食** | 不适用                    |

> [!WARNING]
>
> **货到付款需要在 StreamOrders 中启用现金。** 对于通过 StreamOrders 发送到 Toast 的货到付款（到店付款）订单，您必须在 StreamOrders 中将 **cash** 设为外送可接受的支付方式。否则 Toast 会拒绝订单（`decision_failed` / “payment method declined”），订单也不会送达后厨。请参阅[StreamOrders: accepted payment methods](https://help.streamorders.com/en/articles/13441016)。

## 第 6 步：订单流程设置

### 备餐时间

按订单类型设置切合实际的备餐时间：

- 自取订单：默认 15-20 分钟
- 外送订单：默认 30-45 分钟
- 大额订单：自动调整

### 订单确认

配置确认设置：

- 启用订单复述
- 设置确认方式（号码或电子邮件）
- 配置收据发送方式

### 特殊要求

定义如何处理：

- 过敏提醒
- 特殊制作
- 自定义修改
- 给后厨的备注

## 第 7 步：测试

正式上线前，请充分测试：

### 测试清单

1. **下测试订单**

   - 拨打您的 Maple 号码
   - 点几样带加料选项的菜品
   - 确认订单出现在 Toast 中

2. **检查订单详情**

   - 菜品和数量正确
   - 加料选项已记录
   - 价格准确
   - 支付处理正确

3. **测试边缘情况**

   - 已售罄（86）的菜品处理正确
   - 大额订单
   - 特殊要求
   - 不同支付方式

> [!TIP]
>
> 使用 Toast 的培训模式进行测试，不会影响真实库存或报表。

## 正式上线

### 上线清单

- ✅ 员工已接受培训，了解新订单的出现方式
- ✅ 后厨知道有 Maple 订单
- ✅ 网站/Google 上的电话号码已更新
- ✅ 测试订单成功
- ✅ 支付处理已验证

### 软启动策略

1. 先在有限的时段内开通
2. 密切关注最初的几笔订单
3. 收集员工反馈
4. 根据需要调整设置
5. 扩展到全部营业时间

## 管理订单

### 在 Toast POS 中

Maple 订单显示为：

- 通过 StreamOrders 发送的标准 Toast 订单
- 所有常规 Toast 功能均可使用
- 报表包含 Maple 订单

### 断开 Toast 连接

- Toast 通过 StreamOrders 连接，因此请在 StreamOrders 中断开 Toast
- StreamOrders 与 Toast 之间的连接问题，也需在 StreamOrders 中解决，而不是在 Maple 中

### 在 Maple 控制台中

查看和管理：

- 通话录音和文字记录
- 订单历史
- 订单失败原因
- 顾客信息
- 绩效指标

## 常见问题与解决方法

**菜单项未显示**

- 检查菜品在 Toast 中是否已启用
- 确认菜单可见性设置
- 检查 **Channel Visibility**：该菜品可能对 **Online Ordering Partners** 隐藏
- 确认您在 Toast 中同时点击了 **Save** 和 **Publish**，然后[在 StreamOrders 中重新同步](#%E5%9C%A8-streamorders-%E4%B8%AD%E9%87%8D%E6%96%B0%E5%90%8C%E6%AD%A5)
- 最多等待 5 分钟完成同步
- 如问题持续，请联系支持团队

**AI 无法识别某个菜品名称**

在 Toast 中为该菜品的描述添加其他名称和读音拼写，然后重新同步。

**Open StreamOrders 没有打开新标签页**

改为从 Toast 连接：在 Toast 中前往 **Integrations** → **Browse and Purchase Integrations**，搜索 **Stream**（不是“Maple”），点击 **Add** 并授予员工访问权限。点击 Stream 集成上的齿轮图标，复制 **Merchant ID**（也称 Venue ID），发送给您的入驻专员或 [Maple 支持团队](https://docs.maple.inc/zh/need-help.md)，以完成门店关联。

**在 Toast 中找不到 Integrations**

在 Toast 搜索框中搜索“integrations”，或在 **General Settings** → **Integrations** 下查找。如果仍然找不到，请确认您的 Toast 账户已开通 **Restaurant Management Suite**。购买后请刷新页面并查看确认邮件；变更可能需要片刻才会显示。

**订单未出现在 Toast 中**

- 确认集成处于启用状态
- 检查 Toast 是否在线
- 确认已选择门店
- 在控制台中查看错误日志

**支付失败**

- 确认支付设置
- 检查支付处理商连接
- 查看拒付原因
- 与顾客确认银行卡信息

**价格显示有误**

- 在 Toast 中更新价格
- 等待同步（最多 5 分钟），或在 StreamOrders 中重新同步
- 检查是否有生效的促销
- 确认价格级别

## 高级功能

### 收入中心（Revenue Centers）

- 不使用
- 订单通过已配置的外带或外送用餐方式（dining option）下单

### 会员忠诚度

- 不支持
- 不支持保存银行卡

### 餐饮外烩订单

适用于大额/提前下单的订单：

- 延长备餐时间
- 押金要求
- 特别说明
- 预约下单

## 最佳实践

> [!TIP]
>
> **菜单优化**：菜品名称要清晰，便于语音点餐时发音。

> [!TIP]
>
> **加料选项管理**：只保留必要的选项，以降低复杂度。

> [!TIP]
>
> **定期测试**：每月下一次测试订单，确保一切运行顺畅。

## 支持资源

- **Toast 支持**：处理 POS 相关问题
- **Maple 支持**：<hello@maple.inc>
- **集成状态**：在控制台查看实时状态
- **文档**：[Toast API Docs](https://doc.toasttab.com)

## 后续步骤

- [配置支付](https://docs.maple.inc/zh/orders/config/payment-methods.md): 设置支付处理
- [外送设置](https://docs.maple.inc/zh/orders/config/delivery.md): 配置外送范围
- [菜单管理](https://docs.maple.inc/zh/orders/config/menu-management.md): 管理您的菜单
- [正式上线](https://docs.maple.inc/zh/going-live.md): 向顾客开放