Ir al contenido
Maple

    Integración con POS

    Toast

    Conecte Maple directamente con Toast, con pagos mediante Toast Hosted Checkout

    Maple se conecta directamente con Toast mediante la Orders API de Toast y cobra con Toast Hosted Checkout, de modo que los pedidos y los pagos llegan a su cuenta de Toast.

    Requisitos previos

    Antes de empezar, asegúrese de tener:

    • ✅ Acceso de administrador a Toast Web
    • ✅ El GUID del restaurante en Toast de cada local
    • ✅ Un plan Maple Pro, que incluye pedidos por teléfono e integraciones con POS

    Conecte Toast

    1. Instale la integración de Maple

      Instale la integración de Maple desde la página de integraciones de Toast Web.

    2. Ingrese el GUID de su restaurante

      Ingrese en Maple el GUID de su restaurante en Toast para conectar el local.

    3. Configure Toast Web

      Cree las opciones de consumo y los cargos por servicio descritos en Qué configurar en Toast Web.

    4. Asigne sus opciones

      Elija esas opciones de consumo y cargos en Maple.

    5. Pruebe

      Haga pedidos de prueba y revíselos en Toast.

    Cómo funciona

    • Maple envía cada pedido en línea directamente a Toast (Orders API) y calcula el precio a través de Toast, para que el total cobrado siempre coincida con la cuenta de Toast.
    • El cliente paga mediante Toast Hosted Checkout; los fondos se depositan en su cuenta de depósito de Toast.
    • La entrega se gestiona fuera de Toast. Con entrega administrada por Maple, Maple calcula la tarifa y la coloca, junto con la propina del repartidor, en su cargo por servicio de monto abierto Maple Delivery. Con sus propios repartidores, Toast fija la tarifa según los cargos por servicio de entrega que usted seleccione (es opcional; si no selecciona ninguno, la entrega es gratis) y la propina del repartidor se suma a la propina del pedido.

    Tipos de pedido

    Pedido Cómo llega a Toast Entrega a cargo de
    Para recoger Pedido Take Out El cliente lo recoge
    Entrega administrada por Maple Pedido Take Out (lo recoge un repartidor) La flota de entrega de Maple
    Entrega propia (BYOF) Pedido Delivery (con dirección) Usted / su propio servicio de entrega

    Qué configurar en Toast Web

    Creará opciones de consumo (dining options) en Toast, un cargo por servicio Maple Delivery para la entrega administrada por Maple y, solo si cobra por sus propios repartidores, cargos por servicio de entrega. Luego los asignará durante la incorporación en Maple. Los nombres no se muestran a los clientes; son para sus reportes.

    1. Dining options (Toast Web → Dining Options)

      • Una opción de consumo Take Out (obligatoria): se usa para pedidos para recoger y entrega administrada por Maple.
      • Una opción de consumo Delivery (obligatoria solo si ofrece entrega propia / BYOF).
      • Recomendado: una segunda opción de consumo Take Out llamada “Maple Courier” para que su cocina pueda distinguir un pedido de un repartidor de la flota de Maple de una recolección normal de un cliente. Es opcional: si la omite, los pedidos administrados por Maple usan su opción Take Out estándar.

    2. Cargo por servicio "Maple Delivery" (obligatorio para la entrega administrada por Maple)

      En Toast Web, vaya a Finance → Related → Settings → Service charges & fees y cree un cargo por servicio con esta configuración (Customize Service Charges and Mandatory Gratuity):

      • Name: Maple Delivery (para sus reportes; los clientes no lo ven)
      • Charge Type: Open Amount (Maple envía el monto exacto en cada pedido)
      • Apply After Amount Threshold: $0.00
      • Assign to check owner (Gratuity)?: No, Assign the fee to the restaurant.
      • Taxed?: No
      • Delivery?: No
      • Takeout?: No
      • Dine-In?: No

      Deje Delivery, Takeout y Dine-In en No. Toast no permite vincular un cargo de monto abierto (Open Amount) a una opción de consumo, y no lo necesita: Maple agrega este cargo solo a los pedidos de entrega administrada por Maple, por lo que una recolección normal nunca lo paga. No active ninguna opción de aplicación automática. Si su cuenta de Toast muestra un monto máximo de cuenta para este cargo, déjelo en blanco.

      Seleccione este cargo en el menú desplegable Maple delivery service charge durante la incorporación en Maple, o más adelante en Location → Integrations → Toast → Edit dining & delivery setup. Solo se listan los cargos configurados como se indica arriba; cualquier otro cargo Open Amount, o un cargo Fixed Amount / Fixed Percent con “Maple” en el nombre, se muestra con el ajuste que debe corregir. En cada pedido de entrega administrada por Maple, Maple fija el cargo en la tarifa de entrega de ese pedido más la propina del repartidor. Si la entrega administrada por Maple está activada y no hay un cargo utilizable seleccionado, Maple bloquea esos pedidos antes de que el cliente pague.

      Maple guarda la configuración de este cargo cuando usted guarda su configuración de Toast en Maple. Si más adelante cambia el cargo en Toast, abra Edit dining & delivery setup y guarde de nuevo para que Maple lo revise otra vez. Si ya no cumple los requisitos, Maple lo borra y bloquea los pedidos de entrega administrada por Maple hasta que usted seleccione un cargo que sí los cumpla.

    3. Cargos por servicio para sus propios repartidores (opcional)

      Opcional. Los comercios que entregan gratis (por ejemplo, dentro de una zona pequeña, sin cargos por servicio de entrega en Toast) pueden terminar la configuración sin seleccionar uno. Esos pedidos se envían sin tarifa de entrega, y Maple muestra una advertencia de que no se aplicará ninguna tarifa.

      Para cobrar la entrega, siga Configure Delivery Fees Using Your Own Drivers para crear uno o más cargos por servicio de entrega (por ejemplo, BYOF Delivery Fee) con:

      • Charge Type: Fixed Amount o Fixed Percent (Toast no permite cargos de entrega Open Amount; Toast fija el monto)
      • Assign to check owner (Gratuity)?: No, Assign the fee to the restaurant.
      • Taxed?: según su tratamiento fiscal habitual de la tarifa de entrega
      • Delivery?: Yes

      Esta tarifa es ingreso suyo. La propina del repartidor en una entrega propia se suma a la propina normal de su local.

    4. Conecte en Maple y asigne sus opciones

      En la incorporación de Maple, seleccione las opciones de consumo, el cargo por servicio Maple Delivery y los cargos por servicio de sus propios repartidores que haya creado arriba. Maple los valida con Toast y le señalará cualquier error de configuración antes de salir en vivo. Puede cambiarlos más adelante en Location → Integrations → Toast.

    Salir en vivo

    Una vez asignado y validado, haga un pedido de prueba de cada tipo (para recoger, entrega administrada por Maple y, si la usa, entrega propia) y confirme que cada uno aparece correctamente en Toast con el cargo correcto.

    Sincronización del menú

    • Los artículos, precios, modificadores, opciones y categorías se importan tal como los configure en Toast
    • Los artículos que marque como agotados (86) en Toast dejan de ofrecerse en las llamadas
    • Los cambios de menú que publique en Toast llegan a Maple automáticamente, y también puede volver a sincronizar el menú desde el panel de Maple
    • Los artículos ocultos en Toast no se sincronizan

    Pagos

    • Los clientes pagan mediante Toast Hosted Checkout, y los fondos se depositan en su cuenta de depósito de Toast
    • La entrega se paga al hacer el pedido; el pedido para recoger se puede pagar durante la llamada o en el local si usted lo permite

    Desconectar Toast

    • Elimine Maple en Toast Partner Connect
    • Toast envía un aviso de eliminación del socio y Maple desactiva la integración con Toast para ese local