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

# FoodTec

> 将 Maple 连接到 FoodTec，实现菜单同步和订单注入

将 Maple 连接到 FoodTec，实现自动菜单同步和 AI 驱动的订单注入。

## 前提条件

FoodTec 会为每家门店提供三组独立的 `user:password` 凭据：

* 菜单导出 API
* 订单校验 API
* 订单接收 API

您还需要门店的 FoodTec 基础 URL，如有端口，请一并包含。Maple 要求使用 HTTPS URL。

## 设置

1. 在 POS 选择器中选择 **FoodTec**。
2. 输入基础 URL 和三组 API 凭据。
3. 可选：设置菜单订单类型和订单来源。默认值为 `Pickup` 和 `Third Party`。
4. Maple 会验证凭据和所配置的订单类型，然后启用集成。

启用后会自动开始菜单同步。

## 菜单同步

Maple 会导入 FoodTec 的分类、菜品规格、价格和可选加料选项。每个 `(category, item, size)` 组合都会成为一个 Maple 菜品。在 FoodTec 中标记为不可用的菜品，在 Maple 中会显示为缺货。特价、优惠券、限定条件（qualifiers）、半份（halves）和条件性加料选项依赖关系不会同步。

菜单和库存变更应在 FoodTec 中管理。您可以在 Maple 控制台中手动触发菜单重新同步。

## 订单

订单被接受之前，Maple 会先将其发送到 FoodTec 校验。FoodTec 提供权威的小计、税费、各项费用、总额和重新定价后的菜品；Maple 会在接收请求中提交这些经校验的总额、费用和菜品，并将小费加到提交的总额中。支持自取和外送订单、顾客详情、备注、小费、预约时间以及所选加料选项。顾客电话会以 `AAA-XXX-NNNN` 格式发送给 FoodTec；非 NANP 号码会在校验前被拒绝。

商户自有的外送订单会以 `Delivery` 提交给 FoodTec，但预付款前的校验会按自取计价，因此不会向顾客收取 FoodTec 自己的外送费。Maple Fleet 外送订单会以自取方式提交给 FoodTec。

## 取消

FoodTec 的取消使用其作废（void）端点。FoodTec 通过 Maple 最初的外部引用来识别作废请求。Maple 在取消订单时会保留该引用并传递给 FoodTec；FoodTec 的票据号会保存在提交元数据中，供支持团队使用。

## 故障排查

* 确认三组凭据均使用 `user:password` 格式。
* 确认基础 URL 为 HTTPS，并包含正确的门店端口。
* 确认所配置的订单类型已在该 FoodTec 门店启用。
* 如果菜品缺失，请检查其在 FoodTec 中的可用状态和规格价格行。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.