Manual completo — TPV Táctil v6 + Comandero

1. Introducción

TPV Táctil v6 es el TPV moderno de OEM para hostelería (restaurantes, bares, cafeterías, discotecas). Se compone de dos productos que trabajan juntos:

2. Instalación

Requisitos TPV central

• PC POS o mini-PC con Windows 10/11 x64.
• Pantalla táctil capacitiva 15"+ recomendada.
• SQL Server 2019+ (Express es suficiente).
• Impresora térmica ESC/POS (ticket + cocina).
• Opcional: cajón portamonedas RJ11/12, escáner códigos barras USB.

Requisitos Comandero

• Android 8+ con pantalla 6"+.
• WiFi estable con el TPV central.
• Impresora ESC/POS local para tickets remotos (opcional).

Proceso

1. Instalar el TPV central con TpvTactilSetup_AAAA.M.D.N.exe (Inno Setup 6, ubicado en D:\tpv_tactil_v6\installer\).
2. La primera ejecución crea la BD tpv_rest con esquema inicial.
3. Configurar impresoras en Configuración → Impresoras.
4. Instalar el APK del Comandero en cada dispositivo Android.
5. Vincular cada Comandero introduciendo la IP/dominio del TPV central.

3. Configuración inicial

Datos del establecimiento

• NIF, razón social, domicilio.
• Serie de facturación simplificada.
• Tipos de IVA aplicables (10% general hostelería, 21% bebidas alcohólicas, 4% pan, etc.).

Salas y mesas

Se dibujan los planos de sala en Configuración → Salas: fondo, mesas, sillas. Cada mesa tiene código, capacidad, aforo mínimo y zona.

Carta

• Familias, categorías, productos con imagen y precio.
• Modificadores (poco hecho, sin sal, sin gluten, con hielo…).
• Menús con secciones (primero + segundo + bebida + postre + café).
• Precio por franja horaria y precio por sala (menú diario más barato de 13-16h en terraza, por ejemplo).

Empleados

Alta de camareros/cocineros con foto y PIN de identificación rápida en pantalla táctil. Cada empleado tiene rol (camarero / responsable turno / cocina / administrador) y permisos derivados.

4. Salas y mesas

La pantalla principal del TPV muestra el plano gráfico multi-sala con el estado de cada mesa:

Operaciones sobre mesa

• Pulsar mesa libre → nueva comanda.
• Pulsar mesa ocupada → editar comanda existente.
• Arrastrar mesa a otra → cambio de mesa (drag & drop).
• Juntar mesas → agrupar dos comandas para cobro conjunto.
• Dividir cuenta → split de líneas en dos tickets.

5. Toma de comanda

1. Se abre la mesa (o se activa el modo barra si no hay mesas).
2. Rejilla de productos con imagen — un tap añade línea con cantidad 1.
3. Modificadores disponibles automáticamente por producto.
4. Envío a cocina — impresión del ticket de comanda + envío al KDS.
5. Comanda queda abierta hasta el cierre para cobro.

Atajos

• Cantidad por defecto 1, editable con teclado numérico táctil.
• Comentario libre por línea (para cocinar).
• Regalo — línea a coste cero con anotación.
• Retirar — marca la línea como retirada (con motivo obligatorio).

6. Cocina y KDS

Impresora de cocina

Cada envío desde la comanda imprime en la impresora ESC/POS asignada a la sección (barra vs cocina caliente vs cocina fría). El diseño del ticket destaca modificadores y comentarios.

Pantalla KDS (Kitchen Display System)

Alternativa/complemento a la impresora: monitor táctil en cocina con tarjetas por comanda. El cocinero marca líneas como "en marcha" y "servido" con un tap. El servicio ve en el TPV qué comandas están listas.

7. Cobro

Formas de pago soportadas

• Efectivo con cálculo de cambio.
• Tarjeta (integración con TPV bancario mediante interfaz estándar).
• Bizum / transferencia inmediata.
• Vales, tickets restaurante, cupones.
• Mixto (parte efectivo + parte tarjeta).

Cuentas divididas

• Split por comensal (partes iguales).
• Split por líneas seleccionadas.
• Split por importe libre.

Propina

Botón "Propina" al cerrar el cobro — se añade sin afectar a base imponible ni IVA.

8. Cierre de caja

Al final del turno, el responsable ejecuta el arqueo:

1. Contaje manual del efectivo en caja.
2. Comparación con lo esperado según cobros efectuados.
3. Registro de descuadres (positivos o negativos) con motivo.
4. Impresión del Z (informe fin de día).

Informes de cierre

• Ventas por producto / familia.
• Ventas por camarero (para propinas y comisiones).
• Ventas por franja horaria (heat map).
• Cobros por forma de pago.
• Descuentos, invitaciones, retiradas.

9. Comandero Android

La app Comandero replica la operativa del TPV central en el móvil del camarero:

• Login por PIN.
• Plano de salas idéntico al TPV.
• Toma de comanda con la misma carta y modificadores.
• Envío a cocina — imprime en la impresora del TPV central.
• Cobro (efectivo, tarjeta) con opción de imprimir ticket en impresora Bluetooth local.

Diseño

Interfaz touch-first con controles grandes, alto contraste y respuesta táctil inmediata. Modo día/noche automático para terrazas.

10. Sincronización cliente-servidor

El Comandero mantiene una conexión persistente con el TPV central sobre WebSocket. Cambios en la comanda se propagan en tiempo real:

• Camarero A toma comanda en mesa 5.
• Camarero B ve la mesa 5 como ocupada al instante en su Comandero.
• Cocina ve la comanda en el KDS.
• Al cerrar, el estado se refleja en el TPV central para el cobro.

Modo offline

Si la WiFi cae temporalmente, el Comandero cola los cambios y los replica cuando recupera conexión. Cero pérdida de comandas.

11. Licencias

TPV central

Licencia por instalación, activada con el mismo modelo v2 firmado que Gestión Profesional.

Comandero

Activación

1. Instalar el APK — el trial arranca al abrir.
2. Antes de los 30 días, contactar con OEM para adquirir la licencia.
3. Introducir la clave en Ajustes → Licencia.
4. Validación online — la app queda activada permanentemente para ese dispositivo.

12. Facturación (Verifactu)

El TPV emite ticket + factura simplificada cumpliendo Verifactu:

• Encadenamiento de huellas obligatorio.
• Firma XAdES.
• Código QR obligatorio en el ticket.
• Envío a AEAT en tiempo real (modo Verifactu) o conservación local (modo no Verifactu).

Factura completa

Para clientes que piden factura con NIF, se puede transformar el ticket en factura completa. La emisión Verifactu es idéntica.

13. Acceso remoto (Cloudflare Tunnel)

El TPV Táctil expone la BD SQL Server a los Comanderos remotos vía Cloudflare Tunnel en el puerto local 23500.

El túnel garantiza que ningún puerto SQL queda expuesto directamente a internet. Solo el ejecutable cloudflared corriendo en el TPV puede llegar a SQL Server, y sólo autoriza dispositivos con Service Token válido en Cloudflare Access.

14. Backup y seguridad

• Backup automático de tpv_rest nocturno.
• Retención local + copia opcional a Cloudflare R2 vía rclone.
• DPAPI LocalMachine para secretos de conexión.
• Auditoría de retiradas, invitaciones, descuentos por motivo (con usuario y timestamp).
• Roles: camarero / responsable turno / cocina / administrador.

15. Instalador

El instalador Inno Setup 6 (D:\tpv_tactil_v6\installer\TpvTactil.iss) incluye:

• Ejecutables del TPV y sus dependencias.
• Redistribuibles VC++ y .NET Runtime reutilizados de gespro si ya están instalados.
• Creación automática de la BD tpv_rest.
• Instalación de servicio Cloudflared configurable.

El Comandero tiene su propio instalador D:\tpv_tactil_v6\installer\Comandero.iss que empaqueta el APK y el firmante.

16. Soporte

• Email: info@oem-informatica.com
• Licencias Comandero: licencias@oem-informatica.com
• SAT remoto: Descargar Supremo.