> ## 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 问题

通过 StreamOrders 连接的 Toast 门店，另请参阅 [Toast issues](https://docs.maple.inc/help/troubleshooting/toast-pos-integration-troubleshooting.md)（英文）。

### 常见问题

- **门店不匹配**：检查 Maple 中的餐厅 GUID 是否与 Toast 门店一致
- **菜单可见性**：在 Toast 中隐藏的菜品不会同步；请检查 Toast 的菜单设置
- **Maple 管理的配送被阻止**：在 **Location → Integrations → Toast → Edit dining & delivery setup** 下选择可用的 **Maple Delivery** 服务费（请参阅[在 Toast Web 中需要设置的内容](https://docs.maple.inc/zh/orders/pos/toast.md)）
- **使用 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 问题

另请参阅 [Clover issues](https://docs.maple.inc/help/troubleshooting/clover-pos-integration-troubleshooting.md)（英文）。

### 常见问题

- **API 令牌无效**：Clover 使用会自动刷新的 OAuth 令牌。如果看到令牌错误，请尝试在 Clover 控制台的 **More Tools > Maple** 下重新授权 Maple 应用。
- **菜品可用状态**：Clover 会自动将菜单和可用状态的更改发送给 Maple
- **税费计算**：核实税费设置；如果一个菜品有多个税率，Maple 只使用第一个
- **应用已被移除**：如果 Maple 应用已从 Clover 中移除，请在 Maple 控制台中选择**Reconnect Clover** 以再次安装

> [!TIP]
>
> 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 供应商支持