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

> Conecte Maple con FoodTec para sincronizar el menú y enviar pedidos

Conecte Maple con FoodTec para la sincronización automática del menú y el envío de pedidos tomados con IA.

## Requisitos previos

FoodTec proporciona tres pares de credenciales `user:password` independientes para cada local:

* API de exportación del menú
* API de validación de pedidos
* API de aceptación de pedidos

También necesitará la URL base de FoodTec del local, incluido su puerto cuando corresponda. Maple
requiere una URL HTTPS.

## Configuración

1. Seleccione **FoodTec** en el selector de POS.
2. Ingrese la URL base y los tres pares de credenciales de API.
3. Opcionalmente, defina el tipo de pedido del menú y el origen del pedido. Los valores predeterminados son `Pickup` y
   `Third Party`.
4. Maple verifica las credenciales y el tipo de pedido configurado, y luego activa la integración.

La activación inicia automáticamente una sincronización del menú.

## Sincronización del menú

Maple importa las categorías, los tamaños de los artículos, los precios y los ingredientes seleccionables de FoodTec. Cada
variante `(category, item, size)` se convierte en un artículo del menú de Maple. Los artículos de FoodTec marcados como no disponibles se
muestran como agotados en Maple. Las promociones especiales, los cupones, los calificadores, las mitades y las
dependencias condicionales de los modificadores no se sincronizan.

Los cambios de menú y de existencias deben administrarse en FoodTec. Puede iniciar una resincronización manual del menú desde
el panel de Maple.

## Pedidos

Antes de aceptar un pedido, Maple lo envía a FoodTec para su validación. FoodTec proporciona el subtotal, los
impuestos, las tarifas, el total y los artículos con precios recalculados que son la referencia oficial; Maple envía esos totales,
tarifas y artículos validados con la solicitud de aceptación, y suma la propina al total enviado.
Se admiten pedidos para recoger y a domicilio, datos del cliente, notas, propinas, horarios programados e
ingredientes seleccionados.
Los teléfonos de los clientes se envían a FoodTec como `AAA-XXX-NNNN`; los números que no son del plan NANP se rechazan antes de
la validación.

Los pedidos a domicilio propios del comercio se envían a FoodTec como `Delivery`, pero la validación previa al pago los
calcula como pedidos para recoger, por lo que el cargo de entrega propio de FoodTec no se cobra al
cliente. Los pedidos a domicilio de Maple Fleet se envían a FoodTec como pedidos para recoger.

## Cancelación

La cancelación en FoodTec usa su endpoint de anulación (void). FoodTec identifica una solicitud de anulación por la referencia externa
original de Maple. Maple conserva esa referencia y la envía a FoodTec al cancelar
un pedido; el número de ticket de FoodTec se conserva en los metadatos del envío para uso de soporte.

## Solución de problemas

* Verifique que los tres pares de credenciales usen el formato `user:password`.
* Verifique que la URL base sea HTTPS e incluya el puerto correcto del local.
* Confirme que el tipo de pedido configurado esté activado para el local en FoodTec.
* Si faltan artículos del menú, revise su disponibilidad en FoodTec y las filas de precio por tamaño.


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