Ir al contenido

Salón, Diseñador 2D, Mesas QR y Propina Legal 10%

El módulo Salón y Mesas QR transforma tu Terminal POS en un sistema completo para restaurantes, bares, lounges y discotecas: diseña el plano visual 2D de tu local, genera tarjetas QR únicas para cada mesa, opera con un Mapa de Salón en Vivo sincronizado entre cajas y aplica de forma opcional la Propina Legal del 10% con soporte fiscal completo ante la DGII.

1. Activar los Add-ons en Configuración → Punto de Venta

Sección titulada «1. Activar los Add-ons en Configuración → Punto de Venta»

Antes de utilizar el mapa en vivo o el menú QR, ve a Configuración → Punto de Venta (/configuration) y habilita las opciones que correspondan a tu modelo de negocio (cada interruptor guarda al instante):

Preferencia Clave técnica Qué habilita
Diseño de Establecimiento, Mapa en Vivo y QRs por Mesa enableVenueDesigner Activa el Diseñador 2D (/pos/venue-designer), la generación de QR únicos por mesa y el botón de Mapa de Salón en el Terminal POS.
Autopedido QR en Mesa y Llamado de Mesero enableQrSelfOrder Habilita que los clientes escaneen el QR de su mesa (/menu/:qrToken) para ver la carta digital, enviar pedidos hacia Barra y llamar a un mesero.
Exigir aprobación previa en Barra en el 1er pedido qrRequireBarApproval Activa el filtro de seguridad para que el primer pedido QR de una mesa vacía requiera aprobación en Barra (por defecto activado).
Propina Legal 10% Elegible en POS (Ley RD) enableLegalTip Muestra el selector de Propina Legal (legalTipRate, 10%) en el ticket POS, Pre-Cuenta, Recibo 80mm, Formato Carta y XML e-CF.
Pre-seleccionar automáticamente el 10% al abrir mesas legalTipDefaultOnTables Activa por defecto el 10% de Propina Legal al abrir cuentas desde una mesa (el cajero siempre puede apagarlo si el pedido es para llevar).

2. Diseñador 2D de Establecimiento (/pos/venue-designer)

Sección titulada «2. Diseñador 2D de Establecimiento (/pos/venue-designer)»

Ingresa a Punto de Venta → Salón y Mesas QR (o desde el acceso directo en Configuración) para crear la distribución visual de tu negocio.

Si tu establecimiento aún no tiene zonas configuradas, Zoule te ofrece 3 plantillas prearmadas para empezar en segundos y generar todos sus códigos QR al instante:

Crea 10 mesas en 2 zonas preconfiguradas con referencias visuales de Tarima DJ, Pista Central, Barra Principal, 6 mesas cocteleras y 4 Sofás VIP listos para vincular una lista de precios VIP.

Personalización drag & drop de Zonas, Mesas y Referencias

Sección titulada «Personalización drag & drop de Zonas, Mesas y Referencias»
  1. Crea o edita Zonas / Ambientes Cada zona (ej. Salón Principal, Terraza, Área VIP) tiene nombre, descripción, color identificador y la opción Lista de Precios Automática para aplicar tarifas especiales a todas las mesas de esa zona.

  2. Agrega y arrastra Mesas sobre el lienzo 2D Inserta mesas con forma Cuadrada (SQUARE), Redonda (ROUND), Rectangular (RECTANGLE), Sofá VIP (VIP_SOFA) o Silla Barra (BAR_STOOL). Arrástralas sobre la cuadrícula (10 px) y usa el panel inspector derecho para editar nombre, código corto (ej. V01, M04), capacidad de personas, ancho/alto y rotación (0°, 90°, 180°, 270°).

  3. Agrega elementos de referencia (Landmarks) Ubica referencias no interactivas como Barra, Tarima DJ, Pista Baile o Entrada para que el personal nuevo identifique la orientación real del local desde el POS.

  4. Guarda la distribución Haz clic en Guardar Distribución para sincronizar coordenadas, dimensiones y rotación en tiempo real con todas las cajas y terminales conectadas.

3. Tarjetas QR únicas por mesa e impresión PDF

Sección titulada «3. Tarjetas QR únicas por mesa e impresión PDF»

Cada mesa creada en el diseñador recibe un qrToken único enlazado a la ruta pública /menu/:qrToken. Desde el panel inspector derecho de cualquier mesa puedes:

  • Copiar Link o abrir Vista Cliente en una pestaña nueva para probar la carta digital de esa mesa.
  • Imprimir Tarjeta QR (PDF): Imprime una tarjeta individual, todas las tarjetas de la zona activa o Imprimir Todos los QRs en formato Carta (TableQrSheetPDF, 4 tarjetas listas para recortar o plastificar por página, con logotipo del negocio, zona, nombre/código de mesa y QR de alta definición).
  • Regenerar QR: Si una etiqueta física se daña o necesitas rotar el enlace de seguridad de una mesa, pulsa Regenerar; el QR anterior queda invalidado de inmediato.

4. Mapa de Salón en Vivo dentro del Terminal POS

Sección titulada «4. Mapa de Salón en Vivo dentro del Terminal POS»

Cuando enableVenueDesigner está activo, dentro del Terminal POS (/pos) aparece la vista Mapa de Salón (VenueFloorMap) organizada por pestañas de zona.

Color / Insignia Estado en vivo Comportamiento al tocar la mesa
Blanco (Libre) Mesa disponible con capacidad indicada. Abre automáticamente una nueva OpenCheck con el nombre de la zona/mesa y su tarifa de zona.
Verde (Ocupada) Muestra monto acumulado con ITBIS, unidades y nombre del mesero. Carga la cuenta abierta en el ticket derecho para añadir rondas, imprimir pre-cuenta o cobrar.
Azul (Seleccionada) Es la cuenta que estás editando actualmente en tu pantalla. Permite seguir agregando ítems, enviar comanda (F3) o cobrar (F8).
Ámbar con candado Otro cajero/mesero está editando esa misma cuenta en otra terminal (editingChecks). Se bloquea temporalmente en lectura para evitar ediciones simultáneas en conflicto.
Badge Índigo (QR) / Ámbar (Campana) Pedidos QR esperando aprobación o cliente llamando al mesero. Pulsa Barra / Alertas arriba a la derecha para ir directo a /pos/bar-dispatch.
Sección titulada «5. Propina Legal del 10% (Ley RD y DGII e-CF código 001)»

En República Dominicana, la propina legal del 10% aplica al consumo en salón/mesa y no aplica a entregas para llevar (take-out) ni genera ITBIS sobre el monto de la propina.

Cuando enableLegalTip está encendido:

  • En el pie del ticket POS (Cart.jsx) aparece el interruptor Propina Legal (10%), sincronizado en vivo con la cuenta abierta (/api/open-checks/:id/legal-tip).
  • Si legalTipDefaultOnTables está activo, las cuentas creadas desde mesas arrancan con el 10% marcado automáticamente, pero el cajero o mesero puede apagarlo en 1 clic si la orden es para llevar.
  • Cálculo y desglose fiscal: La Propina Legal se calcula como el 10% sobre el Subtotal Neto (después de descuentos y antes de ITBIS), nunca sobre el ITBIS.
  • Representación documental y DGII: Se refleja claramente en la Pre-Cuenta (PreBillPDF), Recibo 80mm (ReceiptPDF), Formato Carta, asiento contable y en el XML e-CF dentro de `<TablaImpuestoAdicional>` con el código oficial DGII `<TipoImpuesto>001</TipoImpuesto>`, `<MontoImpuestoAdicional>` y `<OtrosImpuestosAdicionales>`.
Sección titulada «Simulador interactivo de Propina Legal e ITBIS»

Prueba cómo Zoule calcula la Propina Legal del 10% sobre el subtotal neto sin generar ITBIS adicional sobre la propina:

Simulador Fiscal RD (ITBIS, Compuesto y Propina Legal)
Subtotal netoRD$1,000.00
ITBIS (18%)RD$180.00
Propina Legal (10% s/ subtotal)RD$100.00
Total a facturarRD$1,280.00

En Salón y Mesas POS, la Propina Legal del 10% se calcula sobre el subtotal neto (antes de ITBIS) y puede habilitarse o retirarse por cuenta antes del cobro.