MagicTPV
← Inicio
Guía de puesta en marcha

Tu restaurante, funcionando en ocho pasos.

Del panel a la primera comanda. Te acompañamos configurando un caso real: el Restaurante El Cortijo.

El Cloud · configuras

Panel web

Carta, mesas, estaciones y camareros. Desde cualquier navegador.

El Nodo · operas

Mini-PC en el local

Comandas, cocina y cobro. En tu red, aunque se caiga internet.

1

Crear el restaurante

Entra en el panel de MagicTPV con tu usuario. En el menú lateral pulsa Añadir restaurante, pon el nombre («El Cortijo»), teléfono y datos básicos, y guarda.

Al abrirlo verás su menú: Productos, Comandas, Ventas, Pedidos web, Carta pública / QR y WhatsApp IA.

2

Cargar la carta

La forma rápida es por foto con IA:

  1. Productos → Importar carta desde foto.
  2. Elige una foto nítida (máx. 8 MB) y pulsa ✨ Leer carta con IA.
  3. En segundos tienes una tabla con categoría, nombre, precio y descripción.
  4. Revisa, corrige y pulsa Crear productos seleccionados.

Si prefieres hacerlo a mano, la carta tiene tres niveles:

Grupo Bebidas · Para picar · Nuestras carnes · Postres
└Categoría Pizzas, Pastas, Refrescos, Vinos…
└Producto Margarita 9,90 € · Entrecot 17,90 €
💡

Aunque importes por IA, luego puedes reorganizar los productos en grupos y categorías desde Productos.

3

Definir las mesas

En la configuración del restaurante → Mesas, crea las de tu sala (Mesa 1…Mesa 12, Barra 1, Terraza 1…). Serán las que el camarero elija en el comandero.

4

Sistema de comandas

En Comandas defines quién trabaja, qué pantallas hay y a dónde va cada plato.

Estaciones — las pantallas y puntos de trabajo

EstaciónTipoKDSPara qué sirve
Cocinacocina✅Pantalla de cocina
BarrabarraBebidas (KDS opcional)
SalasalaComandero de camareros
RecogidarecogidaPedidos listos para recoger
TótemtotemAutopedido del cliente

Empleados (PIN)

Añade a tu equipo con su rol y un PIN de 4-8 dígitos (p. ej. Luis · camarero · 1234). Con ese PIN entran en el Nodo.

Reglas de enrutado — el corazón del sistema

A qué estación salta cada plato. Lo práctico es enrutar por categoría:

Refrescos · Cervezas · Vinos · Cafés→🍺 Barra
Pizzas · Pastas · Carnes · Postres→🔥 Cocina

Para un plato que sea excepción, crea una regla por producto con prioridad menor (gana sobre la de su categoría).

⚠️

El formulario de reglas solo aparece después de pulsar «Publicar config» una vez (para materializar la carta). Si ves «Publica primero…», ve al paso 5 y vuelve aquí.

5

Publicar la configuración

Pulsa Publicar config (arriba a la derecha en Comandas). Materializa la carta y las mesas y deja todo listo para que lo descargue el Nodo.

🔄

Cada vez que cambies carta, mesas, estaciones, enrutado o camareros: vuelve a Publicar, y en el Nodo pulsa Sincronizar.

6

Instalar el Nodo en el local

  1. En Comandas, pulsa Descargar instalable del nodo: genera un ZIP con un token único.
  2. Cópialo al mini-PC y ejecútalo:
    • Linux (recomendado): sudo sh instalar.sh
    • Windows: instalar.ps1.
  3. El Nodo arranca, se registra y sincroniza toda la config.

Cuando termine, abre desde cualquier móvil o tablet de la red: http://<IP-del-miniPC>:8090

7

Emparejar las pantallas

En cada dispositivo (tablet de cocina, móvil del camarero, tótem…), abre …:8090/stations y elige la estación que le corresponde. Queda emparejado a esa función.

8

¡A trabajar!

El día a día ocurre en el Nodo:

  • Comandero /sala: el camarero entra con su PIN, elige mesa, toca productos (agrupados, sin precios, ágil) y marcha. Los platos saltan a su estación.
  • Cocina · KDS /kds: dos columnas — Pendiente y Realizado. Cada comanda muestra su origen (Mesa 5, Web, Para llevar…). Selecciona líneas o pulsa ✅ Todo listo.
  • Cobro · TPV /tpv y Caja /caja: cobrar (efectivo/tarjeta), abrir/cerrar caja y arqueo.
  • Tótem /totem: el cliente pide solo y paga con tarjeta.
  • Recogida /recogida y Pedidos /pedidos: seguimiento de todo lo que está en marcha.
◆

Pedidos por internet (carta web / QR)

Tus clientes piden desde casa o desde la mesa con el móvil, con la misma interfaz que el tótem. En Carta pública / QR obtienes el enlace y el código QR para imprimir.

  1. El cliente elige productos y va al checkout: nombre obligatorio, email y teléfono opcionales.
  2. Paga online (tarjeta) o elige pagar al recoger.
  3. Recibe un justificante (email + pantalla) que indica claramente PAGADO o PENDIENTE.
  4. El pedido entra al instante en cocina y aparece en Recogida.
  5. Se le avisa por WhatsApp cuando está listo (si hay sesión conectada). Al entregarlo se genera el ticket.

Ves estos pedidos en el panel (menú Pedidos web) y en el Nodo (pantallas Pedidos y Recogida).

?

Dudas frecuentes

No me aparece el formulario de reglas de enrutado

Pulsa Publicar config una vez: se materializa la carta y entonces aparece.

Cambié la carta y el Nodo no lo refleja

Panel → Publicar config, y en el Nodo pulsa Sincronizar.

Las bebidas no salen en la pantalla de Cocina

Es correcto si las enrutaste a Barra. Si quieres pantalla de bebidas, marca la estación Barra como KDS y pon una tablet en /kds de esa estación.

Desde el móvil no entra al Nodo

Usa la IP del mini-PC (http://192.168.x.x:8090), no localhost. El móvil y el mini-PC deben estar en la misma WiFi.

Un plato se ha agotado

Márcalo como no disponible (86); se propaga a las pantallas al instante.

¿Todo listo? Entra en tu panel y empieza por el paso 1.

Ir a mi panel →