Skip to main content
将 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 中的可用状态和规格价格行。