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

> Connect Maple to FoodTec for menu sync and order injection

Connect Maple to FoodTec for automatic menu synchronization and AI-powered order injection.

## Prerequisites

FoodTec provides three separate `user:password` credential pairs for each location:

* Menu export API
* Order validation API
* Order acceptance API

You will also need the location's FoodTec base URL, including its port when applicable. Maple
requires an HTTPS URL.

## Setup

1. Select **FoodTec** in the POS picker.
2. Enter the base URL and the three API credential pairs.
3. Optionally set the menu order type and order source. The defaults are `Pickup` and
   `Third Party`.
4. Maple verifies the credentials and configured order type, then activates the integration.

Activation starts a menu synchronization automatically.

## Menu synchronization

Maple imports FoodTec categories, item sizes, prices, and selectable ingredients. Each
`(category, item, size)` variant becomes a Maple menu item. FoodTec items marked unavailable are
shown as out of stock in Maple. Specials, coupons, qualifiers, halves, and conditional modifier
dependencies are not synchronized.

Menu and stock changes should be managed in FoodTec. You can trigger a manual menu resync from
the Maple dashboard.

## Orders

Before an order is accepted, Maple sends it to FoodTec for validation. FoodTec supplies the
authoritative subtotal, tax, fees, total, and repriced items; Maple submits those validated
totals, fees, and items with the acceptance request, adding the tip to the submitted total.
Pickup and delivery orders, customer details, notes, tips, scheduled times, and selected
ingredients are supported.
Customer phones are sent to FoodTec as `AAA-XXX-NNNN`; non-NANP numbers are rejected before
validation.

Merchant-owned delivery orders are submitted to FoodTec as `Delivery`, but the pre-payment
validation prices them as pickup, so FoodTec's own delivery charge is not collected from the
customer. Maple Fleet delivery orders are submitted to FoodTec as pickup.

## Cancellation

FoodTec cancellation uses its void endpoint. FoodTec identifies a void request by Maple's
original external reference. Maple retains and passes that reference to FoodTec when cancelling
an order; the FoodTec ticket number is retained in the submission metadata for support use.

## Troubleshooting

* Verify that all three credential pairs use the `user:password` format.
* Verify that the base URL is HTTPS and includes the correct store port.
* Confirm that the configured order type is enabled for the FoodTec location.
* If menu items are missing, check their FoodTec availability and size-price rows.