Artículos, impresoras y reglas — Guía detallada¶
Este capítulo describe la interacción completa de artículos, grupos de artículos, control de impresoras, reglas de precio, opciones de artículo y sistemas de grifo en DiKAS. Está dirigido a usuarios avanzados, administradores de sistemas e integradores.
Índice¶
- Grupos de artículos y jerarquía
- El artículo en detalle
- Opciones de artículo y plantillas de opciones
- Control de impresoras — El corazón del sistema
- Reglas de precio y control horario
- Integración del sistema de grifo
- Artículos del sistema
- Ejemplo práctico: Pizzería „Da Mario"
- Ejemplo práctico: Cervecería al aire libre „Zum Löwen"
- Ejemplo práctico: Restaurante grande con 3 estaciones de cocina
- Preguntas frecuentes (FAQ)
1. Grupos de artículos y jerarquía¶
Estructura de los grupos¶
Los grupos de artículos en DiKAS tienen una estructura jerárquica, hasta tres niveles de profundidad:
Hauptgruppe (Ebene 0)
├── Untergruppe (Ebene 1)
│ ├── Unter-Untergruppe (Ebene 2)
│ └── Unter-Untergruppe (Ebene 2)
└── Untergruppe (Ebene 1)
Ejemplo práctico:
100 Speisen
├── 10001 Vorspeisen
├── 10002 Pizza
│ ├── 100020001 Pizza Klassiker
│ └── 100020002 Pizza Spezial
├── 10003 Pasta
└── 10004 Salate
200 Getränke
├── 20001 Alkoholfrei
├── 20002 Bier
├── 20003 Wein
└── 20004 Cocktails
300 Desserts
Dos tipos de ID en los grupos¶
Cada grupo de artículos tiene dos ID diferentes — esto es importante entenderlo:
| Tipo de ID | Ejemplo | Uso |
|---|---|---|
ID de documento (_id) |
artgrp_a1b2c3d4e5f6 |
Referencia estable. Se guarda en Article.GroupId. No cambia nunca. |
N.º de grupo (GroupId) |
10002 |
Número jerárquico. Determina la estructura de árbol y el orden. Puede modificarse. |
ℹ️ Nota: Cuando un artículo pertenece al grupo „Pizza", almacena la ID de documento del grupo (no el número de grupo). Esto significa: puede cambiar el número de grupo en cualquier momento sin que los artículos pierdan su asignación.
Configuración de grupos¶
Cada grupo ofrece estas posibilidades de configuración:
| Configuración | Descripción |
|---|---|
| Nombre | Nombre visible (p. ej. „Pizza") |
| N.º de grupo | Ordenación jerárquica |
| Color / Icono | Presentación en el punto de venta |
| Tipo de visualización | Venta (POS), Pedido (cocina), Guardarropa, Informe mensual |
| Opciones de impresión | Ticket de estación, comanda agrupada — se heredan a todos los artículos y subgrupos |
| Opciones de impresión por zona | Distintas impresoras por grupo de mesas |
| Reglas de visibilidad | Mostrar el grupo solo en determinados días/horas/puestos de trabajo |
| Opciones de grupo | Grupos de opciones que se aplican a todos los artículos del grupo |
| Reglas de precio | Reglas que se aplican a todos los artículos del grupo |
| Artículos adicionales | Artículos de venta cruzada (p. ej. „¿Un postre para acompañar?") |
Herencia¶
Las configuraciones se heredan de arriba hacia abajo:
Speisen (ExtraBon 1 → Küchendrucker)
├── Pizza (erbt Küchendrucker)
│ ├── Pizza Margherita (erbt Küchendrucker)
│ └── Pizza Salami (erbt Küchendrucker)
└── Salate (ExtraBon 1 → Salatdrucker) ← überschreibt Vererbung
├── Caesar Salad (erbt Salatdrucker)
└── Griechischer Salat (erbt Salatdrucker)
La cadena de herencia se recorre en cada pedido de abajo hacia arriba:
- ¿Tiene el artículo su propia opción de impresión? → Usar esa.
- ¿No? ¿Tiene el grupo directo una opción de impresión? → Usar esa.
- ¿No? ¿Tiene el grupo superior una? → Usar esa.
- ¿No? → No se imprime ningún ticket.
2. El artículo en detalle¶
Todos los campos de un artículo¶
Datos básicos¶
| Campo | Obligatorio | Descripción | Ejemplo |
|---|---|---|---|
| Nombre | Sí | Visualización en el punto de venta y en los tickets | Pizza Margherita |
| Precio | Sí | Precio de venta (bruto) | 12,50 |
| Clase fiscal | Sí | 19 %, 7 % o 0 % | 19 % |
| Clase fiscal reducida | No | Tipo de IVA alternativo (histórico) | — |
| Grupo | Sí | Grupo de artículos asignado | Pizza |
| Número de artículo | No | Para informes, DATEV, importación | 101 |
| Código de barras | No | EAN para escáner | 4001234567890 |
| Nombre corto | No | Nombre compacto para botones del POS | Margh. |
| Texto de ticket | No | Nombre alternativo en el ticket de cocina | — |
| Texto adicional de ticket | No | Texto adicional bajo el nombre del artículo en el ticket | „mit Basilikum" |
| Unidad | No | Unidad de medida | Unidad, litro, kg |
| Activo | — | Los artículos inactivos no aparecen en el punto de venta | Sí |
| Favorito | — | Aparece en la vista de favoritos del punto de venta | No |
| Ordenación | — | Orden dentro del grupo | 10 |
Clases fiscales — Resumen¶
| Clase fiscal | Tipo | Uso habitual |
|---|---|---|
| Normal (19 %) | 19 % | Bebidas |
| Reducido (7 %) | 7 % | Comidas (desde el 01.01.2026 uniformemente 7 %, tanto en local como para llevar) |
| Exento (0 %) | 0 % | Vales monetarios en la venta, depósito |
Funciones especiales¶
| Campo | Descripción | Ejemplo |
|---|---|---|
| Precio manual | El precio lo introduce el camarero en cada registro | Plato a precio de mercado |
| Modo de precio manual | Permitir solo más, solo menos o ambos | Descuento: solo menos |
| Depósito | Recargo de depósito automático por unidad | 0,25 € (depósito de botella) |
| Puntos | Puntos de fidelidad por venta | +10 puntos |
| Tiempo | Tiempo estándar para este artículo | Tiempo 1 (entrante) |
| Alérgenos | Etiquetado de los 14 alérgenos de la UE | Gluten, lactosa |
| PLU de sistema de grifo | Número PLU para el tiraje automático | 5 |
Tipos de artículo (ExtraOption)¶
Mediante el campo ExtraOption los artículos pueden recibir funciones especiales:
| Tipo | Función |
|---|---|
| Ninguno (estándar) | Artículo de venta normal |
| Recarga de cliente | Recarga el saldo del cliente (0 % de IVA en la venta) |
| Vale | Vende un vale |
| Artículo por tiempo | El precio se calcula por tiempo (p. ej. mesa de billar por hora) |
| Depósito | Artículo de depósito |
| Descuento | Descuento porcentual sobre el pedido completo |
| Propina | Posición de propina en el ticket |
| Guardarropa | Ticket de guardarropa |
3. Opciones de artículo y plantillas de opciones¶
Tres niveles de opciones¶
DiKAS admite tres maneras diferentes de definir opciones de artículo. Se combinan en este orden de prioridad:
| Prioridad | Origen | Descripción |
|---|---|---|
| 1 (más alta) | Plantillas de opciones | Plantillas reutilizables que comparten varios artículos |
| 2 | Grupos de opciones en línea | Grupos definidos directamente en el artículo |
| 3 (más baja) | Opciones heredadas (legacy) | Lista plana (compatibilidad con datos antiguos) |
Las tres fuentes se combinan automáticamente al cargar el artículo y se presentan como una lista unificada.
Grupos de opciones en detalle¶
Un grupo de opciones agrupa posibilidades de elección relacionadas:
| Campo | Descripción | Ejemplo |
|---|---|---|
| Nombre | Título del grupo (etiqueta de pestaña en el POS) | Ingrediente extra |
| Selección obligatoria | ¿Debe el cliente hacer una elección? | Sí/No |
| Selección mínima | ¿Cuántas opciones como mínimo? | 1 |
| Selección máxima | ¿Cuántas opciones como máximo? | 3 |
| Cantidad gratuita | Las N opciones más baratas son gratis | 1 |
| Descuento al deseleccionar | Reducción de precio al deseleccionar una opción estándar | Sí/No |
Opciones individuales¶
Cada opción dentro de un grupo tiene:
| Campo | Descripción | Ejemplo |
|---|---|---|
| Nombre | Denominación de la opción | Jamón |
| Recargo | Precio adicional | 1,50 € |
| Estándar | ¿Preseleccionada? | No |
| Porcentual | ¿Recargo como porcentaje del precio del artículo? | No |
| Imprimir en ticket de estación | ¿Mostrar la opción en el ticket de cocina? | Sí |
Cantidad gratuita (FreeCount)¶
La cantidad gratuita hace que las N opciones más baratas sean automáticamente gratis:
Ejemplo: Hamburguesa con una salsa incluida
Burger (10,90 €)
└── Optionsgruppe: Soße (Gratis-Anzahl: 1)
├── Ketchup 0,00 € ← wird gratis (günstigste)
├── Mayo 0,50 € ← gewählt, wird gratis weil Gratis-Anzahl = 1
├── BBQ-Soße 0,80 € ← wenn zusätzlich gewählt: +0,80 €
└── Trüffel-Mayo 1,50 € ← wenn zusätzlich gewählt: +1,50 €
La opción más barata seleccionada se calcula automáticamente como gratuita.
Descuento al deseleccionar (DeductOnDeselect)¶
Cuando un artículo viene de serie con determinados ingredientes y el cliente deselecciona uno de ellos:
Ejemplo: La hamburguesa viene con queso y lechuga
Burger mit Käse und Salat (11,90 €)
└── Optionsgruppe: Zutaten (Abzug bei Abwahl: Ja)
├── Käse 1,50 € Standard ✓ → Gast wählt ab: -1,50 € Abzug
├── Salat 0,80 € Standard ✓ → Gast wählt ab: -0,80 € Abzug
├── Tomate 0,50 € Standard ✓ → bleibt gewählt: kein Aufpreis
└── Jalapeño 0,50 € Standard ✗ → Gast wählt dazu: +0,50 € Aufpreis
Resultado al deseleccionar el queso: 11,90 € − 1,50 € = 10,40 €
Plantillas de opciones¶
Las plantillas de opciones son grupos de opciones reutilizables que define una vez y asigna a varios artículos:
Admin → Plantillas de opciones → „+ Nueva plantilla"
- Crear plantilla (p. ej. „Pizza-Extras")
- Añadir grupos de opciones a la plantilla
- Abrir artículo → pestaña „Plantillas" → asignar plantilla
| Ventaja | Descripción |
|---|---|
| Mantenimiento centralizado | Los cambios se aplican de inmediato a todos los artículos asignados |
| Coherencia | Los mismos extras en todos los artículos similares |
| Ahorro de tiempo | Sin mantenimiento manual por artículo |
Valores estándar modificables por artículo: Aunque una plantilla esté aplicada a un artículo, puede determinar individualmente para cada artículo qué opciones están seleccionadas por defecto. La plantilla define qué está disponible, el artículo determina qué está preseleccionado.
4. 🖨️ Control de impresoras — El corazón del sistema¶
El control de impresoras es el núcleo del reenvío de pedidos. Determina qué impresora recibe qué ticket cuando un camarero realiza un pedido.
Tipos de impresora¶
| Tipo | Descripción | Conexión |
|---|---|---|
| Red (IP) | Impresora térmica ESC/POS en WLAN/LAN | TCP, IP:Puerto (p. ej. 192.168.1.51:9100) |
| Local | Conectada al servidor | USB |
| Cliente | En el dispositivo del camarero | Impresión por navegador |
| A4 (PDF/CUPS) | Impresora normal para impresiones A4 | CUPS/lpr |
Configuración de impresora¶
| Campo | Descripción | Estándar |
|---|---|---|
| Nombre | Nombre visible | — |
| Dirección IP | IP:Puerto de la impresora | — |
| Ancho de papel | 58 mm o 80 mm | 80 mm |
| Codepage | Juego de caracteres | 858 (Europa Occidental + Euro) |
| Impresora de respaldo | Se usa si esta impresora falla | — |
| Desactivada | Apagar temporalmente la impresora | No |
Impresoras virtuales¶
Hay dos ID de impresora especiales integradas de forma fija en DiKAS:
| Impresora virtual | Significado |
|---|---|
Impresora del camarero (__kellner__) |
La impresora asignada al dispositivo del camarero |
Impresora estándar (__standard__) |
La impresora configurada en los ajustes como „Impresora estándar" |
Puede usar estas impresoras virtuales en las opciones de impresión. Esto permite configuraciones flexibles como: „Factura siempre en la impresora del camarero" o „Ticket de estación en la impresora estándar".
Tipos de ticket¶
DiKAS distingue cuatro tipos de ticket diferentes:
| Tipo de ticket | Cuándo se imprime | Contenido |
|---|---|---|
| Factura (TemplateType 0) | Al pagar | Todas las posiciones, IVA, método de pago, datos TSE |
| Comanda agrupada (TemplateType 1) | Al realizar el pedido | Todos los artículos de una estación reunidos |
| Ticket de estación (TemplateType 2) | Al realizar el pedido | Artículos individuales o grupos de artículos |
| Ticket de anulación (TemplateType 3) | Al anular | Posición anulada con motivo |
Adicionalmente: Ticket de cierre de caja (TemplateType 4), Ticket de vale (TemplateType 5).
Ticket de estación — Reenvío selectivo de pedidos¶
Cada artículo (o cada grupo) puede tener hasta dos impresoras de ticket de estación:
| Configuración | Descripción |
|---|---|
| ExtraBon 1 — Impresora | Impresora de destino (p. ej. impresora de cocina) |
| ExtraBon 1 — Nombre | Encabezado del ticket (p. ej. „KÜCHE") |
| ExtraBon 1 — Imprimir precio | ¿Mostrar el precio en el ticket de cocina? |
| ExtraBon 1 — Imprimir PLU | ¿Mostrar el número de artículo? |
| ExtraBon 1 — Imprimir opciones | ¿Mostrar los extras seleccionados? |
| ExtraBon 1 — Multi-ticket | Un ticket por unidad (en lugar de un ticket para todas) |
| ExtraBon 1 — Ticket de tiempo | Usar también esta impresora para los tickets de cambio de tiempo |
ExtraBon 2 tiene la misma configuración — para una segunda impresora.
Ejemplo: Un plato „Spaghetti Bolognese" va como ExtraBon 1 a la impresora de cocina y, como ExtraBon 2, adicionalmente a la impresora de la barra (para que la barra sepa que pronto sale una comida y se pueda ofrecer una bebida para acompañar).
Comanda agrupada — Todos los artículos en un ticket¶
La comanda agrupada reúne todos los artículos de un pedido que tienen la misma impresora como destino:
══════════════════════════════
KÜCHE Tisch 5
──────────────────────────────
Gang 1:
2× Schnitzel
→ mit Pommes
→ ohne Salat
1× Lasagne
Gang 2:
1× Rinderfilet
→ medium
──────────────────────────────
Kellner: Maria 18:45
══════════════════════════════
| Configuración | Descripción |
|---|---|
| Impresora | Impresora de destino para la comanda agrupada |
| Tipo de impresión | 0 = imprimir siempre, 1 = imprimir adicionalmente |
| Nombre | Encabezado (p. ej. „KÜCHE") |
| Agrupar artículos | Reunir artículos idénticos en una línea |
Varios destinos de comanda agrupada: Un artículo puede tener varias entradas de comanda agrupada, de modo que la misma comanda agrupada aparezca en varias impresoras.
Resolución de opciones de impresión — El algoritmo¶
Cuando un camarero realiza un pedido, DiKAS recorre para cada artículo individual la siguiente cadena de comprobación:
Schritt 1: Hat der ARTIKEL eine bereichsabhängige Druckoption,
die zur Tischgruppe passt?
→ JA: Diese verwenden. FERTIG.
→ NEIN: Weiter zu Schritt 2.
Schritt 2: Hat der ARTIKEL eine eigene Druckoption (Enabled = true)?
→ JA: Diese verwenden. FERTIG.
→ NEIN: Weiter zu Schritt 3.
Schritt 3: Hat die DIREKTE ARTIKELGRUPPE eine bereichsabhängige
Druckoption für diese Tischgruppe?
→ JA: Diese verwenden. FERTIG.
→ NEIN: Weiter zu Schritt 4.
Schritt 4: Hat die DIREKTE ARTIKELGRUPPE eine Druckoption?
→ JA: Diese verwenden. FERTIG.
→ NEIN: Weiter zu Schritt 5.
Schritt 5: Übergeordnete Gruppe prüfen (Schritte 3+4 wiederholen).
Gruppenbaum nach oben durchlaufen bis zur Hauptgruppe.
Schritt 6: Keine Druckoption gefunden → Kein Bon wird gedruckt.
⚠️ Importante: Esta resolución se realiza en cada pedido individual, no solo en la configuración inicial. Esto significa: si cambia una opción de impresión en un grupo, el cambio surte efecto de inmediato en el siguiente pedido.
Opciones de impresión por zona (ExtraPrintOptions)¶
La función de control de impresión más potente: distintas impresoras según la zona de servicio (grupo de mesas).
| Campo | Descripción |
|---|---|
| Grupos de mesas | ¿Para qué grupos de mesas se aplica esta opción de impresión? |
| Opción de impresión | Configuración propia de ticket de estación/comanda agrupada/sistema de grifo |
Caso de uso: Un artículo „Cola 0,3l" va en la zona interior a la impresora de la barra, en la cervecería al aire libre a la impresora del jardín.
Cola 0,3l
├── Standard-Druckoption: ExtraBon 1 → Thekendrucker
├── Bereichsabhängig:
│ └── Tischgruppe „Biergarten" → ExtraBon 1 → Gartendrucker
Cuando un camarero pide la cola en la mesa 15 (cervecería al aire libre), se usa la impresora del jardín. En la mesa 25 (zona interior), la impresora de la barra.
Plantillas de ticket — Ajustar el diseño¶
Cada tipo de ticket tiene una plantilla configurable:
Admin → Configuración → Diseñador de tickets
| Configuración | Descripción |
|---|---|
| Encabezados | Texto sobre el ticket (nombre de la empresa, dirección) |
| Pies de página | Texto bajo el ticket (texto de agradecimiento, horario de apertura) |
| Ancho de línea | Número de caracteres por línea (estándar: 42 para papel de 80 mm) |
| Carácter separador | Carácter para las líneas divisorias (p. ej. ─) |
| Mostrar logotipo | Logotipo de la empresa en la parte superior del ticket |
| Mostrar código QR | Código QR TSE en el recibo |
| Mostrar info TSE | Información de firma TSE |
Específico de la comanda agrupada: - Ordenar por tiempo - Mostrar precio - Mostrar opciones
Específico del ticket de estación: - Imprimir precio - Imprimir PLU - Imprimir opciones
Seguridad ante fallos de impresión¶
DiKAS dispone de varios mecanismos de protección frente a fallos de impresora:
| Mecanismo | Descripción |
|---|---|
| Impresora de respaldo | Si la impresora principal falla, se usa automáticamente la impresora de respaldo |
| Lógica de reintento | 5 intentos de repetición con 5 segundos de pausa |
| Los errores de impresión nunca bloquean | Una salida de ticket fallida nunca impide el registro o el pago |
| Redirección de impresora | Redirección temporal de todos los trabajos de una impresora a otra |
| Estado de la impresora | Consulta en tiempo real de papel, tapa y cortador mediante comandos ESC/POS DLE |
5. Reglas de precio y control horario¶
Jerarquía de reglas¶
Las reglas de precio pueden definirse en dos niveles:
| Nivel | Prioridad | Descripción |
|---|---|---|
| Artículo | Más alta | Reglas directamente en el artículo |
| Grupo de artículos | Más baja | Reglas en el grupo (se aplican a todos los artículos del grupo) |
Las reglas de artículo prevalecen sobre las reglas de grupo.
Condiciones de una regla¶
Cada regla puede limitarse mediante combinaciones de estas condiciones:
| Condición | Descripción | Ejemplo |
|---|---|---|
| Días de la semana | ¿Qué días se aplica la regla? | Lu–Vi |
| Fecha de inicio / Fecha de fin | Periodo de validez | 01.06.–31.08. (carta de verano) |
| Grupos de mesas | Solo para determinadas zonas de servicio | Cervecería al aire libre |
| Grupos de clientes | Solo para determinados clientes | Clientes habituales, empleados |
| Puestos de trabajo | Solo en determinados puntos de venta | Caja 1 |
| Modo de entrega | Entrega, recogida o todos | Solo recogida |
| Sexo | Solo para hombres/mujeres (modo discoteca) | Mujeres |
Ajustes de precio¶
Cuando se cumplen las condiciones de una regla, el precio se ajusta de la siguiente manera:
| Ajuste | Descripción | Ejemplo |
|---|---|---|
| Porcentaje del precio normal | p. ej. 80 = 20 % de descuento | Happy Hour: 80 % |
| Precio fijo | Precio fijo (solo si es más barato que el normal) | Oferta de mediodía: 8,90 € |
| Recargo/descuento | Sumar/restar un importe fijo | Recargo de cervecería al aire libre: +0,50 € |
| Precio mínimo | El precio no puede caer por debajo de este valor | Mínimo 1,00 € |
| Redondeo | Redondear a 5 o 10 céntimos | A 10 céntimos |
Subreglas (franjas horarias)¶
Dentro de una regla puede definir franjas horarias que establecen distintos precios a distintas horas:
Ejemplo: Desayuno, mediodía, Happy Hour
Regel: „Tageszeiten-Preise" (Mo–Fr)
├── 07:00–11:00 → 80 % (Frühstücksrabatt)
├── 11:30–14:00 → Festpreis 8,90 € (Mittagsmenü)
├── 16:00–18:00 → 70 % (Happy Hour)
└── 22:00–02:00 → 120 % (Nachtzuschlag)
Reglas de visibilidad en los grupos¶
Los grupos de artículos pueden tener además reglas de visibilidad que determinan cuándo se muestra el grupo en el punto de venta:
Ejemplo: - Mostrar el grupo „Frühstück" solo de 07:00–11:00 - Grupo „Mittagsmenü" solo Lu–Vi de 11:30–14:00 - Grupo „Cocktails" solo a partir de las 17:00
6. 🍺 Integración del sistema de grifo¶
DiKAS controla sistemas automáticos de tiraje de bebidas. Cuando un camarero pide una bebida, el sistema tira automáticamente — no hace falta tirar manualmente.
Protocolos compatibles¶
| Protocolo | Fabricante | Conexión | Descripción |
|---|---|---|---|
| Gruber | Gruber | Serie, TCP, UDP | Encuadre STX/ETX con suma de verificación XOR, handshake ENQ |
| Addimat | Addimat | Serie, TCP, UDP | Encuadre STX/ETX con suma de verificación XOR-CRC, handshake ENQ |
| Hogatron | Hogatron/WMF | Serie, TCP, UDP | Longitudes de campo configurables, sin STX/ETX |
| Simulator | DiKAS | Interno | Para probar sin hardware real |
Tipos de conexión¶
| Conexión | Descripción | Uso habitual |
|---|---|---|
| TCP | Red (estándar) | Sistemas modernos con Ethernet |
| UDP | Red (sin conexión) | Sistemas de red más antiguos |
| Serie | Puerto COM (RS-232) | Sistemas más antiguos con interfaz serie |
Configuración de un sistema de grifo¶
Admin → Configuración → Sistemas de grifo → „+ Neue Anlage"
| Campo | Descripción | Ejemplo |
|---|---|---|
| Nombre | Nombre visible | Sistema de grifo de la barra |
| Protocolo | Gruber, Addimat, Hogatron o Simulator | Gruber |
| Tipo de conexión | TCP, UDP o Serie | TCP |
| Dirección IP | Dirección de red del sistema | 192.168.1.70 |
| Puerto | Puerto de red | 3010 |
| Activado | Encender/apagar el sistema | Sí |
| Reset en cierre de caja | Restablecer el sistema en el cierre de caja | Sí |
Configuración avanzada (específica del protocolo):
| Campo | Descripción | Estándar |
|---|---|---|
| Longitud de PLU | Número de dígitos del número PLU en el frame del protocolo | 4 |
| Longitud de camarero | Número de dígitos del número de camarero | 3 |
| Longitud de mesa | Número de dígitos del número de mesa | 3 |
| Longitud de cantidad | Número de dígitos de la cantidad | 4 |
| Usar suma de verificación | Añadir suma de verificación XOR | No |
| Timeout de envío | Timeout en milisegundos | 1000 |
| Intervalo de consulta | Intervalo de sondeo para registros entrantes | 1000 |
Conectar un artículo con el sistema de grifo¶
Para que un artículo se tire automáticamente, deben configurarse dos cosas:
- PLU de sistema de grifo en el artículo: El número PLU que identifica el grifo
- Sistema de grifo activado en la opción de impresión: En la sección de opciones de impresión del artículo
| Configuración | Dónde | Descripción |
|---|---|---|
| PLU de sistema de grifo | Artículo → General | Número PLU del grifo (p. ej. 5) |
| Sistema de grifo activado | Artículo → Opciones de impresión → Sistema de grifo | Debe estar en „Sí" |
| Sistema de destino | Artículo → Opciones de impresión → Sistema de grifo → Destino | Qué sistema (o estándar = primero activo) |
| Manual | Artículo → Opciones de impresión → Sistema de grifo → Manual | Operación manual en lugar de automática |
Sistema de grifo por zona de servicio¶
Mediante las opciones de impresión por zona puede asignar distintos sistemas de tiraje a distintas zonas de servicio:
Artikel: Helles 0,5l (PLU: 5)
├── Standard → Schankanlage: Zapfanlage Innen
└── Tischgruppe „Biergarten" → Schankanlage: Zapfanlage Garten
Número de mesa de grifo¶
Cada mesa puede tener su propio número de mesa de sistema de grifo. Este número se transmite al sistema en el frame del protocolo, para que el sistema pueda registrar el consumo por mesa.
Admin → Mesas → Editar mesa → „Schank-Tischnr."
Desarrollo de un tiraje automático¶
1. Kellner bestellt „Helles 0,5l" an Tisch 5
2. DiKAS erstellt die Bestellung (OpenBon)
3. DiKAS prüft: BeveragePlu vorhanden? Schankanlage aktiviert?
4. DiKAS sendet Buchung an die Schankanlage:
- PLU: 5 (Zapfhahn für Helles)
- Kellnernummer: 12 (Kellner-ID)
- Tischnummer: 5 (Schank-Tischnr. des Tischs)
- Menge: 1
5. Schankanlage empfängt, zapft Bier, sendet ACK zurück
6. Bestellung ist abgeschlossen — Kellner sieht Bestätigung
Comportamiento ante errores: Si el sistema de grifo no es accesible o notifica un error, el pedido se guarda de todos modos. El error de impresión nunca bloquea el registro. El tiraje fallido se registra y puede consultarse en el registro de depuración (Debug-Log).
Anulación y devolución¶
Los pedidos anulados se envían al sistema de grifo como cantidad negativa. El sistema descuenta el consumo.
Depuración y diagnóstico¶
Admin → Configuración → Sistemas de grifo → [Sistema] → „Debug"
La ventana de depuración muestra todos los paquetes de datos enviados y recibidos en representación hexadecimal y ASCII:
18:45:12.345 TX: 02 62 30 31 32 30 30 30 35 2B 30 30 30 30 31 30 30 03 .b012000 5+000010 0.
18:45:12.456 RX: 06 .
| Dirección | Significado |
|---|---|
| TX | Enviado de DiKAS al sistema |
| RX | Recibido del sistema |
| ERR | Error (timeout, interrupción de la conexión) |
7. Artículos del sistema¶
DiKAS tiene 12 artículos del sistema predefinidos, necesarios para funciones internas:
| Artículo | ID | Función |
|---|---|---|
| Descuento por bonificación | art_custbonusrabatt |
Descuento automático con saldo de bonificación |
| Pago de saldo | art_payout |
Pago del saldo del cliente |
| Recargar saldo | art_guthabenaufladen |
Recarga del saldo del cliente |
| Recargar vale | art_gutscheinaufladen |
Venta de vale |
| Artículo manual | art_manuell |
Introducción libre de precio en el punto de venta |
| Tiempo de trabajo | art_arbeitszeit |
Control de horario / Taller |
| Canjear vale | art_gutscheineinloesung |
Canje de vale (posición negativa) |
| Depósito | art_pfand |
Recargo de depósito automático |
| Gastos de entrega | art_liefergebuehr |
Costes de reparto |
| Importe mínimo de pedido | art_mindestbestellwert |
Recargo por no alcanzar el mínimo |
| Entrada de discoteca | art_discoeintritt |
Importe de entrada (módulo discoteca) |
| Consumición mínima de discoteca | art_discomindestverzehr |
Recargo de consumición mínima (módulo discoteca) |
Protección: Los artículos del sistema no pueden eliminarse. Al editarlos solo se permite el cambio de grupo — todos los demás campos están protegidos.
8. Ejemplo práctico: Pizzería „Da Mario"¶
Descripción del negocio¶
- Pizzería con 40 plazas en el interior y 20 en la terraza
- Cocina con horno de pizza y estación de ensaladas separada
- Barra de bebidas con cafetera
- 3 camareros en el servicio de noche
Hardware¶
| Dispositivo | Ubicación | IP |
|---|---|---|
| Impresora de caja | Caja (entrada) | 192.168.1.50 |
| Impresora de cocina | Junto al horno de pizza | 192.168.1.51 |
| Impresora de ensaladas | Estación de ensaladas | 192.168.1.52 |
| Impresora de la barra | Barra de bebidas | 192.168.1.53 |
| 3× Tablets | Camareros | WLAN |
Estructura de grupos¶
100 Speisen
├── 10001 Pizza
├── 10002 Pasta
├── 10003 Salate
├── 10004 Vorspeisen
└── 10005 Desserts
200 Getränke
├── 20001 Alkoholfrei
├── 20002 Bier
├── 20003 Wein
└── 20004 Cocktails
300 Kaffee & Kuchen
Configuración de impresoras¶
| Grupo | ExtraBon 1 | Comanda agrupada |
|---|---|---|
| Speisen (100) | Impresora de cocina | Impresora de cocina |
| Salate (10003) | Impresora de ensaladas | Impresora de ensaladas |
| Getränke (200) | Impresora de la barra | Impresora de la barra |
| Kaffee & Kuchen (300) | Impresora de la barra | Impresora de la barra |
ℹ️ Nota: „Salate" sobrescribe la herencia de „Speisen" — los pedidos de ensalada van a la estación de ensaladas, no a la cocina.
Grupos de mesas¶
| Grupo de mesas | Mesas | Particularidad |
|---|---|---|
| Zona interior | 1–20 | Opciones de impresión estándar |
| Terraza | 21–30 | +0,50 € de recargo de terraza en bebidas |
Reglas de precio¶
Regla: Recargo de terraza en bebidas
| Configuración | Valor |
|---|---|
| Grupo de mesas | Terraza |
| Recargo | +0,50 € |
| Se aplica a | Grupo „Getränke" |
Regla: Menú de mediodía (Lu–Vi, 11:30–14:00)
| Configuración | Valor |
|---|---|
| Días | Lu–Vi |
| Periodo | 11:30–14:00 |
| Precio fijo | 8,90 € |
| Se aplica a | Artículo „Tagesmenü" |
Plantillas de opciones¶
Plantilla: „Pizza-Extras"
Optionsgruppe: Extra-Belag
Gratis: 0
Maximal: 5
Schinken +1,50 €
Pilze +1,00 €
Oliven +1,00 €
Peperoni +1,00 €
Sardellen +1,50 €
Extra Käse +2,00 €
Rucola +1,00 €
Artischocken +1,50 €
Esta plantilla se asigna a las 15 pizzas. Si Mario cambia el precio del queso extra, el nuevo precio se aplica de inmediato a todas las pizzas.
Desarrollo del pedido¶
Gast an Tisch 25 (Terrasse) bestellt:
1× Pizza Salami 12,50 € + Extra Käse (+2,00 €)
1× Caesar Salad 9,50 €
2× Cola 0,3l 3,50 € + 0,50 € Terrasse = 4,00 € × 2
DiKAS erzeugt 3 Bons:
→ Küchendrucker: „1× Pizza Salami + Extra Käse"
→ Salatdrucker: „1× Caesar Salad"
→ Thekendrucker: „2× Cola 0,3l"
Kassenbon-Summe: 12,50 + 2,00 + 9,50 + 8,00 = 32,00 €
9. Ejemplo práctico: Cervecería al aire libre „Zum Löwen"¶
Descripción del negocio¶
- Tasca con sala (zona interior, 60 plazas) y cervecería al aire libre (100 plazas)
- Ambas zonas tienen su propio sistema de grifo (protocolo Gruber)
- La cocina abastece ambas zonas
- En la cervecería al aire libre hay una estación de parrilla separada
- 5 camareros, 2 cocineros, 1 parrillero
Hardware¶
| Dispositivo | Ubicación | IP | Tipo |
|---|---|---|---|
| Impresora de caja | Caja | 192.168.1.50 | ESC/POS |
| Impresora de cocina | Cocina | 192.168.1.51 | ESC/POS |
| Impresora de parrilla | Parrilla de la cervecería | 192.168.1.52 | ESC/POS |
| Sistema de grifo de la sala | Sala (barra) | 192.168.1.70 | Gruber TCP |
| Sistema de grifo del jardín | Cervecería al aire libre (despacho) | 192.168.1.71 | Gruber TCP |
Grupos de mesas¶
| Grupo de mesas | Mesas | Descripción |
|---|---|---|
| Sala | 1–15 | Zona interior, sistema de grifo de la sala |
| Cervecería al aire libre | 101–130 | Zona exterior, sistema de grifo del jardín |
Configuración del sistema de grifo¶
Sistema 1: Grifo de la sala
| Configuración | Valor |
|---|---|
| Nombre | Grifo de la sala |
| Protocolo | Gruber |
| Conexión | TCP |
| IP | 192.168.1.70 |
| Puerto | 3010 |
| Longitud de PLU | 4 |
| Reset en cierre de caja | Sí |
Sistema 2: Grifo del jardín
| Configuración | Valor |
|---|---|
| Nombre | Grifo del jardín |
| Protocolo | Gruber |
| Conexión | TCP |
| IP | 192.168.1.71 |
| Puerto | 3010 |
| Longitud de PLU | 4 |
| Reset en cierre de caja | Sí |
Artículos de cerveza con sistema de grifo por zona¶
Artículo: Helles 0,5l
| Campo | Valor |
|---|---|
| Nombre | Helles 0,5l |
| Precio | 4,20 € |
| Clase fiscal | 19 % |
| Grupo | Bier |
| PLU de sistema de grifo | 1 |
Opciones de impresión:
| Configuración | Valor |
|---|---|
| Sistema de grifo estándar | Grifo de la sala |
| Por zona: Cervecería al aire libre | Grifo del jardín |
Artículo: Weißbier 0,5l
| Campo | Valor |
|---|---|
| PLU de sistema de grifo | 2 |
| Todas las demás configuraciones | Como Helles, solo la PLU es distinta |
Artículo: Radler 0,5l
| Campo | Valor |
|---|---|
| PLU de sistema de grifo | 3 |
Mesas con números de mesa de sistema de grifo¶
| Mesa DiKAS | N.º de mesa de grifo | Sistema |
|---|---|---|
| Tisch 1 (Stube) | 1 | Grifo de la sala |
| Tisch 2 (Stube) | 2 | Grifo de la sala |
| ... | ... | ... |
| Tisch 101 (Garten) | 1 | Grifo del jardín |
| Tisch 102 (Garten) | 2 | Grifo del jardín |
ℹ️ Nota: Los números de mesa del sistema de grifo son independientes por sistema. La mesa 1 de la sala y la mesa 101 del jardín pueden tener ambas el número de mesa de grifo 1 — pertenecen a sistemas diferentes.
Configuración de impresoras para la cocina¶
| Grupo | Impresora estándar | Impresora de la cervecería |
|---|---|---|
| Speisen | Impresora de cocina | Impresora de cocina |
| Grillgerichte | Impresora de cocina | Impresora de parrilla |
| Bier | — (solo sistema de grifo) | — (solo sistema de grifo) |
| Alkoholfrei | — (no hace falta ticket) | — (no hace falta ticket) |
Particularidad de los platos de parrilla: En la sala, el pedido va a la impresora de cocina (la cocina prepara). En la cervecería al aire libre va a la impresora de parrilla (el parrillero prepara directamente).
Artikelgruppe: Grillgerichte
├── Standard-Druckoption: ExtraBon 1 → Küchendrucker
└── Bereichsabhängig: Biergarten → ExtraBon 1 → Grilldrucker
Reglas de precio¶
Regla: Jarra de cervecería al aire libre
En la cerveza Helles, en la cervecería al aire libre solo está la jarra (1,0l), en la sala la mediana (0,5l):
| Artículo | Sala | Cervecería al aire libre |
|---|---|---|
| Helles 0,5l | 4,20 € | Oculta |
| Helles Maß 1,0l | Oculta | 8,90 € |
Esto se controla mediante reglas de visibilidad en el grupo de artículos:
- Grupo „Bier Halbe" → Mostrar solo en el grupo de mesas „Stube"
- Grupo „Bier Maß" → Mostrar solo en el grupo de mesas „Biergarten"
Desarrollo completo del pedido¶
Kellner Maria bestellt an Tisch 105 (Biergarten):
2× Helles Maß 1,0l (PLU 1)
1× Schweinshaxe
1× Obatzda
DiKAS verarbeitet:
1. Helles Maß → Schankanlage:
→ Tisch 105 = Biergarten → Garten-Zapfhahn
→ PLU 1, Kellner 3 (Maria), Tisch 5 (Schank-Tischnr.), Menge 2
→ Garten-Zapfhahn zapft automatisch 2× Helles
2. Schweinshaxe → Druckoption:
→ Tisch 105 = Biergarten, Gruppe „Grillgerichte"
→ Bereichsabhängig → Grilldrucker
→ ExtraBon geht an Grilldrucker
3. Obatzda → Druckoption:
→ Tisch 105 = Biergarten, Gruppe „Vorspeisen"
→ Kein bereichsabhängiger Override → Standard: Küchendrucker
→ Sammelbon geht an Küchendrucker
Ergebnis: 3 automatische Aktionen — kein manuelles Eingreifen nötig.
10. Ejemplo práctico: Restaurante grande con 3 estaciones de cocina¶
Descripción del negocio¶
- Restaurante de alta gama con 80 plazas
- 3 estaciones de cocina: cocina caliente, cocina fría (ensaladas/carpaccio), pastelería
- Control de tiempos: menús de 3 a 5 tiempos con preparación secuencial
- Bar con impresora propia
- Monitor de cocina (KDS) como complemento de las impresoras
Hardware¶
| Dispositivo | Ubicación | IP |
|---|---|---|
| Impresora de caja | Caja | 192.168.1.50 |
| Impresora cocina caliente | Estación 1 | 192.168.1.51 |
| Impresora cocina fría | Estación 2 | 192.168.1.52 |
| Impresora pastelería | Estación 3 | 192.168.1.53 |
| Impresora del bar | Bar | 192.168.1.54 |
| Monitor de cocina | TV de cocina | Cliente de navegador |
Estructura de grupos y asignación de impresoras¶
100 Speisen
├── 10001 Vorspeisen warm (→ Drucker Warme Küche)
├── 10002 Vorspeisen kalt (→ Drucker Kalte Küche)
├── 10003 Suppen (→ Drucker Warme Küche)
├── 10004 Hauptgerichte (→ Drucker Warme Küche)
│ └── 100040001 Fisch (→ Drucker Warme Küche + ExtraBon 2 → Kalte Küche)
├── 10005 Salate (→ Drucker Kalte Küche)
└── 10006 Desserts (→ Drucker Patisserie)
200 Getränke (→ Drucker Bar)
300 Cocktails (→ Drucker Bar)
Particularidad de los platos de pescado: En determinados platos de pescado, la guarnición (ensalada) viene de la cocina fría. Por eso el subgrupo „Fisch" tiene dos impresoras de ticket de estación: ExtraBon 1 → cocina caliente (pescado), ExtraBon 2 → cocina fría (guarnición).
Control de tiempos en detalle¶
Desarrollo de un menú de 4 tiempos:
Gang 1: Gast bestellt
→ Amuse-Bouche (Küche bereitet sofort zu)
→ Drucker Warme Küche druckt Gang 1
Gang 2: Kellner drückt „Nächster Gang"
→ Vorspeise: Carpaccio → Kalte Küche
→ Vorspeise: Bouillon → Warme Küche
→ Beide Stationen erhalten Gang-Bon mit „GANG 2"
Gang 3: Kellner drückt „Nächster Gang"
→ Hauptgericht: Rinderfilet → Warme Küche
→ Gang-Bon auf Drucker Warme Küche: „GANG 3"
Gang 4: Kellner drückt „Nächster Gang"
→ Dessert: Crème Brûlée → Patisserie
→ Gang-Bon auf Drucker Patisserie: „GANG 4"
Configuración para los tickets de tiempo:
En la impresora de ticket de estación debe estar activado el campo „Ticket de tiempo". Entonces esta impresora recibe automáticamente un ticket de tiempo cuando el camarero cambia de tiempo.
| Grupo | ExtraBon 1 Impresora | Ticket de tiempo |
|---|---|---|
| Vorspeisen warm | Drucker Warme Küche | Sí |
| Vorspeisen kalt | Drucker Kalte Küche | Sí |
| Hauptgerichte | Drucker Warme Küche | Sí |
| Desserts | Drucker Patisserie | Sí |
| Getränke | Drucker Bar | No |
Bebidas sin ticket de tiempo: La impresora del bar no recibe ningún ticket de tiempo, porque las bebidas se sirven con independencia de la secuencia de tiempos.
Comanda agrupada para el pase (expeditor)¶
El jefe de cocina (expeditor) coordina las estaciones. Recibe una comanda agrupada con todos los pedidos:
══════════════════════════════
SAMMELBON Tisch 5
──────────────────────────────
Gang 1:
2× Bouillon WARME KÜCHE
2× Carpaccio KALTE KÜCHE
Gang 2:
1× Rinderfilet WARME KÜCHE
1× Dorade WARME KÜCHE
Gang 3:
2× Crème Brûlée PATISSERIE
──────────────────────────────
Kellner: Thomas 19:30
══════════════════════════════
Configuración: Además del ticket de estación en cada estación, la impresora estándar (caja/pase) recibe una comanda agrupada con todas las posiciones.
11. Preguntas frecuentes (FAQ)¶
Artículos y grupos¶
¿Puedo tener un artículo en varios grupos a la vez? No, un artículo pertenece siempre exactamente a un grupo. Pero puede ofrecer el mismo artículo en otros grupos mediante artículos adicionales (venta cruzada).
¿Qué ocurre si elimino un grupo de artículos? Los grupos solo pueden eliminarse si ya no hay artículos asignados. Mueva primero todos los artículos a otro grupo.
¿Puedo cambiar los precios de los artículos con efecto retroactivo? Sí, pero el cambio solo se aplica a los pedidos nuevos. Los tickets ya registrados conservan el precio antiguo. Los cambios de precio se documentan en el historial de cambios del artículo (los últimos 100 cambios).
Control de impresoras¶
¿Qué ocurre si una impresora falla? DiKAS intenta imprimir el ticket 5 veces con 5 segundos de pausa. Si hay configurada una impresora de respaldo, se usa esta automáticamente. El pedido se guarda en cualquier caso — un error de impresión nunca bloquea el registro.
¿Puedo cambiar la configuración de impresoras de forma espontánea? Sí, los cambios se aplican de inmediato en el siguiente pedido. También puede configurar una redirección de impresora temporal cuando se realiza el mantenimiento de una impresora.
¿Cómo pruebo una impresora nueva? Mediante Admin → Configuración → Impresoras → „Test drucken" puede enviar un ticket de prueba a cualquier impresora configurada.
Reglas de precio¶
¿Qué ocurre cuando hay reglas que se solapan? Las reglas de artículo tienen prioridad sobre las reglas de grupo. Dentro de un nivel se aplica la primera regla que coincide.
¿Puedo cambiar precios para determinados clientes? Sí, mediante grupos de clientes en las reglas de precio. Cree un grupo de clientes „Clientes habituales" y defina una regla con un 10 % de descuento para ese grupo.
Sistemas de grifo¶
¿Se tira la cerveza también si el sistema está sin conexión? No, el sistema debe ser accesible. Pero el pedido se guarda de todos modos — entonces el camarero debe tirar manualmente.
¿Puedo ver qué se ha enviado al sistema? Sí, mediante la vista de depuración del sistema de grifo (Admin → Configuración → Sistemas de grifo → Debug). Allí ve todos los paquetes de datos enviados y recibidos.
¿Por qué mi artículo de cerveza tiene tanto una impresora como un sistema de grifo? La impresora imprime un ticket como confirmación del pedido (p. ej. para el empleado de la barra). El sistema de grifo tira la cerveza físicamente. Ambos pueden funcionar en paralelo. Si el sistema tira automáticamente, a menudo ya no necesita una impresora de barra separada.
Siguiente paso¶
→ Artículos, impresoras y reglas — Guía rápida — La versión compacta para empezar rápido
→ Impresora de cocina y monitor de cocina — Control de tiempos y pantalla de cocina
→ Configuración — Todas las posibilidades de configuración en el área de administración