POS 集成
通过 StreamOrders 连接 Toast
适用于通过 StreamOrders 连接的 Toast 门店
通过 StreamOrders（Maple 的订单中继服务）将 Maple 连接到您的 Toast POS 系统。通过电话或短信下的订单会出现在您的 Toast 系统中。
前提条件
开始之前，请确保您已具备：
- ✅ Toast 的管理员权限
- ✅ Maple Pro 套餐，包含电话订餐和 POS 集成
- ✅ 用于 KYC 的企业证明文件
- ✅ 银行账户信息
- ✅ 一个可连接到 StreamOrders 的 Toast 门店
- ✅ 您的 Toast 账户已开通 Toast Restaurant Management Suite（集成需要）
- ✅ 一台带网页浏览器的电脑（仅用手机无法完成设置）
设置流程
开始 KYC 验证
提交企业验证文件通过 StreamOrders 连接
从 Maple 控制台打开 StreamOrders，并关联您的 Toast 门店选择门店
在 StreamOrders 中选择要连接的门店配置支付设置
设置支付方式和规则测试集成
下测试订单，验证设置
第 1 步：KYC 验证
所需文件
- 企业注册证明（LLC、Corp 等）
- EIN 或税号函
- 所有者的政府签发身份证件
- 银行对账单或作废支票
- 企业地址证明
提交文件
- 在侧边栏点击 Orders，继续进入 Payment Processing 步骤
- 选择您的企业注册所在国家/地区，然后开始 Verify Your Business Entity
- 上传所需文件
- 填写所有者信息
- 提交审核
第 2 步：通过 StreamOrders 连接 Toast
Toast 通过 StreamOrders 连接。您可以按以下步骤自行连接，也可以请 Maple 团队为您设置（见让 Maple 为您设置 Toast）。
- 在侧边栏点击 Orders，继续进入 Select POS 步骤（或打开该门店的设置并前往 Integrations）
- 选择 Toast (via StreamOrders)，然后点击 Continue with Toast (via StreamOrders)
- 如有提示，请填写商户所有者的全名和联系电话（使用您的个人手机，而不是门店电话），然后点击 Save & Continue
- 点击 Open StreamOrders
- 在 StreamOrders 中授权 Maple，连接您的 Toast 门店，并选择要连接的门店
- 返回 Maple 控制台，点击 I completed this step
让 Maple 为您设置 Toast
在 Toast 中将 Maple 添加为员工，Maple 团队即可为您完成连接，通常约一个工作日内完成。
- 在 Toast 控制台中点击 Employees，然后点击 Add New Employee。
- First Name 填写
Maple，Last Name 填写Onboarding，Email 填写onboarding@maple.inc（必须完全一致）。POS Access Code 可填写任何其他员工未使用的号码，并选择一个不带薪资的职位且不填写工资标准，这样 Maple 就不会进入您的工资单。 - 点击 Add，刷新页面，点击 Maple Onboarding 旁的编辑图标，然后打开 Jobs and Permissions。
- 开启权限 4.5 和 4.14（菜单）、6.2（Web Setup: Publishing）、6.3 和 6.4（报表）、6.6（打印机）以及 8.4， 然后点击 Save。Toast 中的编号可能不同，请浏览完整列表。
- 告知您的入驻专员已添加该员工。
Maple 只会获得这些权限，无法访问您的财务或工资数据。
第 3 步：配置门店
单个门店
- 您的门店会自动填充
- 确认信息无误
- 启用订单处理
- 设置默认备餐时间
多个门店
- 所有门店都会列出
- 逐个开启/关闭门店
- 按门店配置设置：
- 备餐时间
- 支付方式
- 外送范围（如适用）
- 营业时间
第 4 步：菜单同步
您的 Toast 菜单会通过 StreamOrders 自动同步到 Maple：
自动同步的内容
- ✅ 所有菜品和价格
- ✅ 加料选项和选项
- ✅ 分类和组织结构
- ✅ 已售罄（86）的菜品
- ✅ 价格变更
- ✅ 供应时段安排
- ✅ 菜单时段
- Toast 中隐藏的菜品不会同步
同步时间
- 菜单变更（包括已售罄（86）的菜品）经 StreamOrders 转发，通常在 5 分钟内到达 Maple，往往更快
- 如需立即推送变更，请在 StreamOrders 中重新同步
选择同步内容
您不需要同步所有 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 按钮。如需立即重新同步：
- 在 Toast Menu Builder 中 Save 并 Publish 您的修改。
- 在 Maple 中打开门店设置，前往 Integrations，点击 Open StreamOrders。
- 点击 Toast 标志旁的蓝色刷新图标，然后点击 Publish（或绿色对勾）。
如果 StreamOrders 无法打开，请联系 Maple 支持团队为您重新同步。
Toast 菜单建议
- 在 Toast 中添加详细描述（配料、尺寸如“10 英寸个人披萨”、饮食信息）。AI 会用这些描述回答问题。
- 对名称特殊的菜品（例如“Thanduri Chicken”），在描述中加入其他拼写和读音，帮助 AI 匹配来电者所说的内容。
- 在 Toast 中最少选择数为 1 的加料组为必选，AI 会主动询问。最少选择数为 0 时为可选：AI 不会询问，但来电者提到时会添加。
第 5 步：支付配置
支付方式
配置接受哪些支付类型：
- 信用卡/借记卡：通过 Maple 的安全支付链接支付，链接以短信发送给顾客，并由您的 Maple 支付服务商处理（默认为 Stripe）。顾客在订单发送到 Toast 之前完成支付。
- 到店付款：自取订单，如已启用。外送订单仅在由您自己的骑手配送时才可货到付款。
- 礼品卡：不支持
- 挂账账户（house accounts）：不支持
支付规则
设置顾客何时付款：
| 订单类型 | 支付选项 |
|---|---|
| 外送 | 预先支付；仅在由您自己的骑手配送时可货到付款 |
| 自取 | 立即支付或到店付款 |
| 堂食 | 不适用 |
第 6 步：订单流程设置
备餐时间
按订单类型设置切合实际的备餐时间：
- 自取订单：默认 15-20 分钟
- 外送订单：默认 30-45 分钟
- 大额订单：自动调整
订单确认
配置确认设置：
- 启用订单复述
- 设置确认方式（号码或电子邮件）
- 配置收据发送方式
特殊要求
定义如何处理：
- 过敏提醒
- 特殊制作
- 自定义修改
- 给后厨的备注
第 7 步：测试
正式上线前，请充分测试：
测试清单
-
下测试订单
- 拨打您的 Maple 号码
- 点几样带加料选项的菜品
- 确认订单出现在 Toast 中
-
检查订单详情
- 菜品和数量正确
- 加料选项已记录
- 价格准确
- 支付处理正确
-
测试边缘情况
- 已售罄（86）的菜品处理正确
- 大额订单
- 特殊要求
- 不同支付方式
正式上线
上线清单
- ✅ 员工已接受培训，了解新订单的出现方式
- ✅ 后厨知道有 Maple 订单
- ✅ 网站/Google 上的电话号码已更新
- ✅ 测试订单成功
- ✅ 支付处理已验证
软启动策略
- 先在有限的时段内开通
- 密切关注最初的几笔订单
- 收集员工反馈
- 根据需要调整设置
- 扩展到全部营业时间
管理订单
在 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 中重新同步
- 最多等待 5 分钟完成同步
- 如问题持续，请联系支持团队
AI 无法识别某个菜品名称
在 Toast 中为该菜品的描述添加其他名称和读音拼写，然后重新同步。
Open StreamOrders 没有打开新标签页
改为从 Toast 连接：在 Toast 中前往 Integrations → Browse and Purchase Integrations，搜索 Stream（不是“Maple”），点击 Add 并授予员工访问权限。点击 Stream 集成上的齿轮图标，复制 Merchant ID（也称 Venue ID），发送给您的入驻专员或 Maple 支持团队，以完成门店关联。
在 Toast 中找不到 Integrations
在 Toast 搜索框中搜索“integrations”，或在 General Settings → Integrations 下查找。如果仍然找不到，请确认您的 Toast 账户已开通 Restaurant Management Suite。购买后请刷新页面并查看确认邮件；变更可能需要片刻才会显示。
订单未出现在 Toast 中
- 确认集成处于启用状态
- 检查 Toast 是否在线
- 确认已选择门店
- 在控制台中查看错误日志
支付失败
- 确认支付设置
- 检查支付处理商连接
- 查看拒付原因
- 与顾客确认银行卡信息
价格显示有误
- 在 Toast 中更新价格
- 等待同步（最多 5 分钟），或在 StreamOrders 中重新同步
- 检查是否有生效的促销
- 确认价格级别
高级功能
收入中心（Revenue Centers）
- 不使用
- 订单通过已配置的外带或外送用餐方式（dining option）下单
会员忠诚度
- 不支持
- 不支持保存银行卡
餐饮外烩订单
适用于大额/提前下单的订单：
- 延长备餐时间
- 押金要求
- 特别说明
- 预约下单
最佳实践
支持资源
- Toast 支持：处理 POS 相关问题
- Maple 支持：hello@maple.inc
- 集成状态：在控制台查看实时状态
- 文档：Toast API Docs