TPVHosteleriaFS: documentacion, instalacion y puesta en marcha

TPVHosteleriaFS — Manual de uso y configuración (paso a paso)

TPV táctil de hostelería para FacturaScripts: gestiona la sala por mesas en dos pantallas, toma comandas, envía a cocina/barra, cobra y cierra caja, con auto-comanda por QR, reservas online y tapas de cortesía. Independiente de TPVneo. Compatible con Verifactu. Pensado para usuarios sin conocimientos técnicos.

1. Instalación

Entra como administrador en Administrador → Plugins.
Pulsa Añadir, selecciona el ZIP y pulsa Continuar; cuando aparezca, pulsa Activar.
Pulsa Reconstruir (botón amarillo) para crear las tablas y el menú.
Aparecerá el menú TPV Hostelería en la barra superior.

Requisitos: FacturaScripts 2026 o superior, PHP 8.1+ y el plugin gratuito Tickets (necesario para la impresión).

2. Configuración inicial (una sola vez)

Ve a TPV Hostelería → Configuración TPV y rellena de arriba a abajo. Cada campo tiene un icono de ayuda (i): púlsalo o pasa el ratón para ver una explicación (funciona con ratón y con toque).

2.1. Módulos activos

Actívalo primero. Enciende solo lo que uses; lo que desactives desaparece de la interfaz para dejarla más limpia: Comandero móvil, Cocina/barra (KDS), Carta y pedido por QR, Reservas, Tapas de cortesía, Propinas, Dividir cuenta, Para llevar/barra rápida, Menús y modificadores, Multitarifa, Incidencias y Cajón.

2.2. Datos del establecimiento

Nombre, pie del ticket, serie de facturas, almacén, IVA por defecto y Destino de impresión por familia: asigna cada familia a Cocina o Barra con el selector visual de tres zonas (Sin asignar / Cocina / Barra); un clic mueve la familia de zona. Las familias sin asignar no generan comanda de cocina ni de barra.

2.3. Impresión

Elige las impresoras de ticket, cocina y barra en el desplegable de impresoras registradas en el plugin Tickets (Administrador → Impresoras de tickets); son las predeterminadas y cada terminal puede tener las suyas en su ficha (vacío si no imprimes en ese destino). Además, minutos para alerta de comanda pendiente y refresco de cocina en segundos (10–15).

2.4. Apariencia

Modo oscuro, propinas y cajón.

2.5. Guarda

Pulsa Guardar al terminar.

3. Diseñar el plano de mesas

TPV Hostelería → Diseñar plano de sala: crea zonas (Sala, Terraza, Barra…), añade mesas y puestos de barra y arrástralos a su posición. Toca un elemento para editar nombre, capacidad o forma. Los cambios se guardan solos y se reflejan en el TPV y el comandero.

4. Camareros y apertura de caja

Crea los camareros con su PIN (listado Camareros).
Al abrir el TPV o el comandero, cada camarero se identifica con su PIN.
La primera vez del día se pide la apertura de caja (efectivo inicial).

5. Trabajar con el TPV (dos pantallas)

El TPV y el comandero se muestran a pantalla completa (sin la barra azul de FacturaScripts) para aprovechar el espacio en pantallas táctiles; cada uno tiene su barra superior con botón Salir. El comandero para tablet usa el mismo patrón de dos pantallas que el TPV, adaptándose automáticamente al tamaño de la tablet.

Pantalla 1 — Mapa de mesas. Mesas por zonas con su estado e importe: verde = libre, roja = ocupada, ámbar (parpadea) = cuenta pedida, azul = reservada. Abajo, accesos a Para llevar y Barra.

Pantalla 2 — Ticket (al tocar una mesa).

Izquierda: el ticket con las líneas, el TOTAL grande, un teclado numérico para fijar cantidades y la botonera de acciones (Cobrar destacado). Las líneas se desplazan dentro de su propio bloque, de modo que TOTAL, teclado y botones quedan siempre fijos y visibles aunque la comanda sea larga.
Derecha: buscador, pestañas de categoría y rejilla de productos con foto.
El botón ← (arriba a la izquierda) vuelve al mapa de mesas.

Tomar una comanda

Toca una mesa libre e indica el nº de comensales.
Pulsa productos en la rejilla de la derecha para añadirlos.
Para cambiar una cantidad: toca la línea (se resalta) y escribe la cantidad en el teclado; 0 elimina la línea.
Enviar a cocina / Enviar a barra manda las líneas a las pantallas KDS (según la familia).
Línea libre añade un concepto manual con precio.

6. Cocina y barra (KDS)

TPV Hostelería → Cocina / Barra (ábrelo en la pantalla de cocina): modo Pantalla grande (solo ver) o Gestión táctil (marcar preparado), filtro por destino (cocina o barra); al marcar una comanda como lista/servida desaparece.

7. Tapas de cortesía (estilo almeriense/granadino)

Si activas Tapas de cortesía, al añadir ciertas consumiciones el sistema propone o asigna una tapa gratis según las reglas definidas en Configuración (por familia o por referencia). Puedes limitar el nº de cortesías por mesa y controlar su coste.

8. Cobro

Pulsa Cobrar:

Elige forma de pago: Efectivo, Tarjeta, Bizum o Pago mixto.
En efectivo usa el teclado o los importes rápidos (Exacto, 5, 10, 20, 50 €); el cambio se calcula solo y se resalta en verde.
Opcional: propina y factura a nombre del cliente.
Confirma. Si el cajón está activo, se abre solo; se muestra el ticket para imprimir.

Dividir cuenta: reparte el total entre varias personas/pagos (reparto proporcional).
Pago mixto (por artículos): pulsa Pago mixto y toca cada línea de la comanda para asignarla a Efectivo o Tarjeta. Verás en todo momento cuánto se cobra por cada método (se actualiza al instante) y, al confirmar, se registra el cobro repartido según esa selección. Ideal cuando cada comensal paga lo suyo con distinta forma de pago.

9. Auto-comanda por QR (el cliente pide desde su móvil)

Permite que el cliente pida desde su mesa escaneando un QR.

Configurar: en Configuración TPV activa Carta y pedido por QR y decide: permitir pedir (o solo mostrar la carta), que un camarero confirme los pedidos QR (recomendado; si lo desactivas, se envía automáticamente a cocina/barra según la familia) y un mensaje de bienvenida opcional.

Imprimir los QR: ve a TPV Hostelería → Auto-comanda. Verás un QR por cada mesa/puesto. Puedes copiar el enlace, abrir la carta, regenerar el enlace o Imprimir todos. La impresión usa un formato cuidado en A4 (dos por fila, con líneas de corte y tamaño fijo) para que los QR no se corten al recortarlos.

Cómo funciona: el cliente escanea, elige productos con cantidades y notas, y envía. El pedido se añade automáticamente a la cuenta de esa mesa y cada línea se rutea a cocina o barra según su familia.

10. Reservas online (web + iframe + página pública)

Configurar: en Configuración TPV → Reservas online: aceptar reservas online, confirmar manualmente (recomendado), horario (apertura/cierre), intervalo de franjas, máx. personas y días de antelación; estética: color principal, logo (URL), fuente y mensaje de bienvenida.

Compartir / incrustar: en TPV Hostelería → Reservas online tienes el enlace público, un QR para imprimir y el código iframe para pegar en la web del establecimiento (con vista previa en vivo).

Gestión: las reservas entran en TPV Hostelería → Reservas con su estado (pendiente/confirmada/cancelada/cumplida) y origen (web/manual). Ábrelas para confirmarlas o asignarles mesa.

11. Cierre de caja

Al terminar el turno realiza el cierre de caja: se compara el efectivo contado con el calculado y se registra la diferencia, ventas por forma de pago, propinas y coste de cortesías.

12. Terminales (varias cajas y cómo cambiar de terminal)

Si activas el módulo de terminales puedes tener varias cajas o puntos de venta en el mismo local (por ejemplo, la caja principal, una caja de barra y un terminal de sala), cada uno con su propia caja y arqueo, e incluso con su propia impresora de tickets y de barra.

Crear terminales. Ve a TPV Hostelería → Terminales y pulsa Nuevo. Indica el nombre (p. ej. "Barra", "Caja principal", "Terraza"), el almacén, si tiene cajón portamonedas y, opcionalmente, las impresoras de ticket, cocina y barra de ese terminal. Para editar un terminal ya creado, pulsa sobre su Código en el listado.

Vincular un dispositivo a un terminal. La primera vez que abres el TPV o el comandero en un dispositivo (tablet, ordenador…), el sistema te pide elegir el terminal de ese dispositivo. La elección se guarda en el navegador de ese equipo, de modo que cada dispositivo trabaja siempre sobre la caja del terminal elegido.

Cambiar de terminal en un dispositivo. Los camareros administradores ven en la barra superior del TPV un botón de cambiar terminal que desvincula el dispositivo y vuelve a mostrar el selector de terminal al momento. (Como alternativa, borrar los datos del sitio en el navegador también fuerza el selector.) En una tablet dedicada esto solo se hace una vez, al configurarla.

13. Preguntas frecuentes

No veo un botón o pantalla. Estará desactivado en Configuración → Módulos activos.
Un producto no sale por cocina o barra. Asigna su familia a la zona correcta en Destino de impresión por familia (las familias sin asignar no generan comanda).
El QR muestra la carta pero no deja pedir. Activa Permitir que el cliente pida y el módulo Carta y pedido por QR.
Las reservas dicen "no disponible". Activa el módulo Reservas y Aceptar reservas online.
Cambié algo y no se refleja. Entra en Administrador → Plugins y pulsa Reconstruir.