> ## 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. # POS 系统故障排查 > POS 集成问题的解决方案 各 POS 集成的故障排查指南。 ## Toast 问题 ### 常见问题 * **门店不匹配**：检查 Maple 中的餐厅 GUID 是否与 Toast 门店一致 * **菜单可见性**：在 Toast 中隐藏的菜品不会同步；请检查 Toast 的菜单设置 * **Maple 管理的配送被阻止**：在 **Location → Integrations → Toast → Edit dining & delivery setup** 下选择可用的 **Maple Delivery** 服务费（请参阅[在 Toast Web 中需要设置的内容](/zh/orders/pos/toast)） * **使用 StreamOrders 的门店**：刷卡支付通过 Stripe 处理，订单需要在 Toast 中有一个名称恰好为 `STREAM`（区分大小写）的支付选项，否则 Toast 会拒绝订单 ### Toast 支持 * Toast 帮助中心：help.toasttab.com * Toast 支持：617-297-1005 ## Square 问题 ### 常见问题 * **连接**：Square 通过 StreamOrders 连接。StreamOrders 与 Square 之间的问题请在 StreamOrders 中解决 * **商品目录同步**：检查 Square 商品目录；更改通常需要 5-10 分钟才会到达 Maple * **加料组**：核实加料选项的设置 * **门店设置**：确认门店正确 ### Square 支持 * Square Seller Community：sellercommunity.square.com * Square 支持：1-855-700-6000 ## Clover 问题 ### 常见问题 * **API 令牌无效**：Clover 使用会自动刷新的 OAuth 令牌。如果看到令牌错误，请尝试在 Clover 控制台的 **More Tools > Maple** 下重新授权 Maple 应用。 * **菜品可用状态**：Clover 会自动将菜单和可用状态的更改发送给 Maple * **税费计算**：核实税费设置；如果一个菜品有多个税率，Maple 只使用第一个 * **应用已被移除**：如果 Maple 应用已从 Clover 中移除，请从 Clover App Market 重新安装 Clover 令牌会在后台自动刷新。如果您在 Clover 中手动撤销或重新生成令牌，则需要从 Clover 控制台重新授权 Maple。 ### Clover 支持 * Clover 帮助：help.clover.com * Clover 支持：1-855-853-8340 ## SpotOn 问题 ### 常见问题 * **OAuth 过期**：在控制台中重新授权连接 * **菜单同步延迟**：菜单更改后请等待 5-10 分钟 * **门店映射**：核实门店映射正确 * **支付失败**：检查 CyberSource 配置 ### SpotOn 支持 * 请联系您的 SpotOn 代表 ## Smile 问题 ### 常见问题 * **订单未提交到 POS 系统**：Smile 要求先通过 Gravity 付款，才能提交订单。请在 Maple 控制台中确认 Gravity 开通流程已完成。 * **菜单未显示**：Smile 会在 Maple 请求菜单几分钟后返回菜单。如果菜单仍未显示，请在 Menus 页面点击 **Resync Menu**，或联系 Maple 支持。 * **支付链接错误**：如果顾客在支付页面看到错误，可能需要重新建立 Gravity 支付连接。请在控制台中检查开通状态。 * **菜品或加料选项缺失**：如果 POS 系统因缺少菜品或加料选项而拒绝订单，可能是菜单不同步。请在 Maple 控制台中手动触发菜单刷新。 * **不支持到店付款**：Smile 不支持到店付款订单。所有订单必须在提交前通过支付链接支付。 ### Smile 支持 * 请联系您的 Smile 代表 * Maple 集成支持：发短信至 +1 929 543 0229 ## Shift4 Dine（原 SkyTab）问题 ### 常见问题 * **订单未出现在 POS 系统中**：确认 Shift4 Dine 的安装已完成，且门店已开通。请在 Maple 控制台中检查安装状态。只有 Shift4 Dine 接受订单后，Maple 才会确认该订单。 * **支付处理错误**：Shift4 Dine 使用 Shift4 处理支付。请确保 Shift4 开通已完成，且支付链接可用。 * **安装请求卡住**：如果 Shift4 Dine 安装请求显示为待处理，请检查您是否使用与 Maple 账户相同的所有者邮箱，从 Shift4 Marketplace 安装了 Maple；如果邮箱不同，安装将永远无法完成。否则，开通可能仍在进行中。如果超过 24 小时仍未解决，请联系 Maple 支持。 * **菜单同步问题**：Shift4 Dine 菜单在 Shift4 Dine 发送菜单更新时同步。如果菜品仍然过时，请在 Menus 页面点击 **Resync Menu**。您关闭的菜品会从电话菜单中消失，直到您重新开启。 * **多门店设置**：每家门店都需要单独安装 Shift4 Dine。请确保每家门店都已完成开通。 * **到店付款订单**：Shift4 Dine 接受到店付款订单。这些订单到达 Shift4 Dine 时不带付款信息，由员工在收银台收款。通过链接支付的订单在提交前通过 Shift4 支付链接支付。 ### Shift4 Dine 支持 * SkyTab 帮助：support.skytab.com * Shift4 支持：1-888-276-2108 * Maple 集成支持：发短信至 +1 929 543 0229 ## NCR Aloha 问题 ### 常见问题 * **菜单同步延迟**：请等待 10 分钟，并检查 Aloha 设置 * **订单路由**：NCR Aloha 通过 StreamOrders 连接。请检查您的 Aloha 站点与 StreamOrders 的连接是否正常运行；如果连接中断，所有订单都会失败 * **支付问题**：检查支付处理商设置 ### NCR 支持 * 请联系您的 NCR 代表 ## NCR Voyix 问题 ### 常见问题 * **连接**：NCR Voyix 通过 StreamOrders 连接。请确认您的 Aloha Essentials 站点已在 StreamOrders 中关联 * **菜单导入**：请在 POS 系统中修改菜单；在 Maple 中所做的编辑会在下次同步时被替换 ### NCR 支持 * 请联系您的 NCR 代表 ## Quantic 问题 ### 常见问题 * **订单失败**：Quantic 需要一个有效的外带服务区域。请检查设置时选择的服务区域 * **菜单过时**：Quantic 不会在您修改时发送菜单更改。请在 Menus 页面点击 **Resync Menu** * **预约订单**：Quantic 不支持预约稍后时间的订单 ### Quantic 支持 * 请联系您的 Quantic 代表 ## Tray 问题 ### 常见问题 * **Venue ID**：核实您的 Tray Venue ID 是否正确 * **菜单分区**：检查分区已在 Tray 中发布 * **订单提交**：核实订单格式符合 Tray 的要求 * **选项组**：确认加料组同步正常 ### Tray 支持 * 请联系您的 Tray 代表 ## Chowbus 问题 ### 常见问题 * **Location ID**：核实您的 Chowbus location ID 是否正确；它以 `loc_` 开头 * **菜单翻译**：请将英文名称填写在菜品的 Name 字段中，而不是 Foreign name * **分类同步**：核实分类已发布 * **订单取消**：部分订单在制作开始后可能无法取消 ### Chowbus 支持 * 请联系您的 Chowbus 代表 ## 手动设置问题 ### 常见问题 * **订单通知**：检查邮件/短信设置 * **菜单整理**：检查分类 * **支付设置**：核实支付处理账户 * **已售罄（86）菜品**：定期更新可用状态 ## 获取帮助 1. 查阅各 POS 系统的专属文档 2. 在 Maple 控制台中查看集成日志 3. 用一个简单订单进行测试 4. 联系 Maple 支持：发短信至 +1 929 543 0229 5. 联系 POS 供应商支持 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.