Prerequisites
FoodTec provides three separateuser:password credential pairs for each location:
- Menu export API
- Order validation API
- Order acceptance API
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.
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 asAAA-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.