POS Integration
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
- Select FoodTec in the POS picker.
- Enter the base URL and the three API credential pairs.
- Optionally set the menu order type and order source. The defaults are
PickupandThird Party. - 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:passwordformat. - 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.