Articoli, stampanti e regole — Guida dettagliata¶
Questo capitolo descrive l'interazione completa di articoli, gruppi articoli, gestione delle stampanti, regole di prezzo, opzioni articolo e impianti di spillatura in DiKAS. È rivolto a utenti esperti, amministratori di sistema e integratori.
Indice¶
- Gruppi articoli e gerarchia
- Articolo in dettaglio
- Opzioni articolo e modelli di opzioni
- Gestione delle stampanti — Il cuore del sistema
- Regole di prezzo e gestione temporale
- Integrazione degli impianti di spillatura
- Articoli di sistema
- Esempio pratico: Pizzeria „Da Mario"
- Esempio pratico: Birreria all'aperto „Zum Löwen"
- Esempio pratico: Ristorante grande con 3 stazioni di cucina
- Domande frequenti (FAQ)
1. Gruppi articoli e gerarchia¶
Struttura dei gruppi¶
I gruppi articoli in DiKAS hanno una struttura gerarchica — fino a tre livelli di profondità:
Hauptgruppe (Ebene 0)
├── Untergruppe (Ebene 1)
│ ├── Unter-Untergruppe (Ebene 2)
│ └── Unter-Untergruppe (Ebene 2)
└── Untergruppe (Ebene 1)
Esempio pratico:
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
Due tipi di ID per i gruppi¶
Ogni gruppo articoli ha due ID diversi — è importante capirlo:
| Tipo di ID | Esempio | Utilizzo |
|---|---|---|
ID documento (_id) |
artgrp_a1b2c3d4e5f6 |
Riferimento stabile. Viene salvato in Article.GroupId. Non cambia mai. |
N. gruppo (GroupId) |
10002 |
Numero gerarchico. Determina la struttura ad albero e l'ordinamento. Può essere modificato. |
ℹ️ Nota: Se un articolo appartiene al gruppo „Pizza", esso salva l'ID documento del gruppo (non il numero del gruppo). Questo significa: è possibile modificare in qualsiasi momento il numero del gruppo senza che gli articoli perdano la loro associazione.
Impostazioni del gruppo¶
Ogni gruppo offre queste possibilità di configurazione:
| Impostazione | Descrizione |
|---|---|
| Nome | Nome visualizzato (ad es. „Pizza") |
| N. gruppo | Ordinamento gerarchico |
| Colore / Icona | Rappresentazione nel punto cassa |
| Tipo di visualizzazione | Vendita (POS), Ordine (cucina), Guardaroba, Report mensile |
| Opzioni di stampa | Scontrino stazione, Comanda cumulativa — si ereditano a tutti gli articoli e sottogruppi |
| Opzioni di stampa dipendenti dall'area | Stampanti diverse per ogni gruppo tavoli |
| Regole di visibilità | Mostrare il gruppo solo in determinati giorni/orari/postazioni |
| Opzioni di gruppo | Gruppi di opzioni validi per tutti gli articoli del gruppo |
| Regole di prezzo | Regole valide per tutti gli articoli del gruppo |
| Articoli aggiuntivi | Articoli cross-sell (ad es. „Un dessert in abbinamento?") |
Ereditarietà¶
Le impostazioni vengono ereditate dall'alto verso il basso:
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 catena di ereditarietà viene percorsa ad ogni ordine dal basso verso l'alto:
- L'articolo ha un'opzione di stampa propria? → Usa questa.
- No? Il gruppo diretto ha un'opzione di stampa? → Usa questa.
- No? Il gruppo sovraordinato ne ha una? → Usa questa.
- No? → Non viene stampato alcuno scontrino.
2. Articolo in dettaglio¶
Tutti i campi di un articolo¶
Dati di base¶
| Campo | Obbligatorio | Descrizione | Esempio |
|---|---|---|---|
| Nome | Sì | Visualizzazione nel punto cassa e sugli scontrini | Pizza Margherita |
| Prezzo | Sì | Prezzo di vendita (lordo) | 12,50 |
| Classe fiscale | Sì | 19 %, 7 % o 0 % | 19 % |
| Classe fiscale ridotta | No | Aliquota IVA alternativa (storica) | — |
| Gruppo | Sì | Gruppo articoli associato | Pizza |
| Numero articolo | No | Per report, DATEV, importazione | 101 |
| Barcode | No | EAN per scanner | 4001234567890 |
| Nome breve | No | Nome compatto per i pulsanti POS | Margh. |
| Testo scontrino | No | Nome alternativo sullo scontrino cucina | — |
| Aggiunta scontrino | No | Testo aggiuntivo sotto il nome dell'articolo sullo scontrino | „mit Basilikum" |
| Unità | No | Unità di misura | Stück, Liter, kg |
| Attivo | — | Gli articoli inattivi non compaiono nel punto cassa | Sì |
| Preferito | — | Compare nella vista preferiti del punto cassa | No |
| Ordinamento | — | Sequenza all'interno del gruppo | 10 |
Classi fiscali — Panoramica¶
| Classe fiscale | Aliquota | Utilizzo tipico |
|---|---|---|
| Normale (19 %) | 19 % | Bevande |
| Ridotta (7 %) | 7 % | Cibi (dal 01.01.2026 uniformemente al 7 %, indipendentemente dal consumo sul posto o da asporto) |
| Esente (0 %) | 0 % | Buoni di valore alla vendita, cauzione |
Funzioni speciali¶
| Campo | Descrizione | Esempio |
|---|---|---|
| Prezzo manuale | Il prezzo viene inserito dal cameriere ad ogni registrazione | Piatto a prezzo di mercato |
| Modalità prezzo manuale | Consentire solo più, solo meno o entrambi | Sconto: solo meno |
| Cauzione | Supplemento cauzione automatico per pezzo | 0,25 € (cauzione bottiglie) |
| Punti | Punti fedeltà per vendita | +10 punti |
| Portata | Portata standard per questo articolo | Portata 1 (antipasto) |
| Allergeni | Etichettatura allergeni UE-14 | Glutine, lattosio |
| PLU impianto di spillatura | Numero PLU per la spillatura automatica | 5 |
Tipi di articolo (ExtraOption)¶
Tramite il campo ExtraOption gli articoli possono ottenere funzioni speciali:
| Tipo | Funzione |
|---|---|
| Nessuno (standard) | Articolo di vendita normale |
| Ricarica cliente | Ricarica il credito cliente (0 % IVA alla vendita) |
| Buono | Vende un buono |
| Articolo a tempo | Il prezzo viene calcolato in base al tempo (ad es. tavolo da biliardo all'ora) |
| Cauzione | Articolo di cauzione |
| Sconto | Sconto percentuale sull'intero ordine |
| Mancia | Voce mancia sullo scontrino |
| Guardaroba | Biglietto guardaroba |
3. Opzioni articolo e modelli di opzioni¶
Tre livelli di opzioni¶
DiKAS supporta tre modi diversi per definire le opzioni articolo. Vengono unite in questo ordine di priorità:
| Priorità | Origine | Descrizione |
|---|---|---|
| 1 (massima) | Modelli di opzioni | Modelli riutilizzabili condivisi da più articoli |
| 2 | Gruppi di opzioni inline | Gruppi definiti direttamente sull'articolo |
| 3 (minima) | Opzioni legacy | Lista piatta (compatibilità con dati più vecchi) |
Tutte e tre le origini vengono unite automaticamente al caricamento dell'articolo e visualizzate come lista unica.
Gruppi di opzioni in dettaglio¶
Un gruppo di opzioni raggruppa scelte correlate tra loro:
| Campo | Descrizione | Esempio |
|---|---|---|
| Nome | Titolo del gruppo (etichetta della scheda nel POS) | Condimento extra |
| Selezione obbligatoria | L'ospite deve effettuare una scelta? | Sì/No |
| Selezione minima | Quante opzioni come minimo? | 1 |
| Selezione massima | Quante opzioni al massimo? | 3 |
| Quantità gratuita | Le N opzioni più economiche sono gratuite | 1 |
| Detrazione alla deselezione | Detrazione di prezzo quando un'opzione standard viene deselezionata | Sì/No |
Singole opzioni¶
Ogni opzione all'interno di un gruppo ha:
| Campo | Descrizione | Esempio |
|---|---|---|
| Nome | Denominazione dell'opzione | Prosciutto |
| Supplemento | Prezzo aggiuntivo | 1,50 € |
| Standard | Preselezionato? | No |
| Percentuale | Supplemento come percentuale del prezzo dell'articolo? | No |
| Stampare sullo scontrino stazione | Mostrare l'opzione sullo scontrino cucina? | Sì |
Quantità gratuita (FreeCount)¶
La quantità gratuita fa sì che le N opzioni più economiche siano automaticamente gratuite:
Esempio: Burger con una salsa inclusa
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 €
L'opzione più economica selezionata viene calcolata automaticamente come gratuita.
Detrazione alla deselezione (DeductOnDeselect)¶
Quando un articolo viene fornito di serie con determinati ingredienti e l'ospite ne deseleziona uno:
Esempio: il Burger viene fornito con formaggio e insalata
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
Risultato in caso di deselezione del formaggio: 11,90 € − 1,50 € = 10,40 €
Modelli di opzioni¶
I modelli di opzioni sono gruppi di opzioni riutilizzabili che si definiscono una volta e si assegnano a più articoli:
Admin → Modelli di opzioni → „+ Nuovo modello"
- Creare il modello (ad es. „Extra pizza")
- Aggiungere gruppi di opzioni al modello
- Aprire l'articolo → Scheda „Modelli" → Assegnare il modello
| Vantaggio | Descrizione |
|---|---|
| Gestione centralizzata | Le modifiche valgono immediatamente per tutti gli articoli associati |
| Coerenza | Stessi extra per tutti gli articoli simili |
| Risparmio di tempo | Nessuna gestione manuale per articolo |
Valori standard sovrascrivibili per articolo: Anche quando un modello è applicato a un articolo, è possibile stabilire individualmente per ogni articolo quali opzioni sono selezionate di serie. Il modello definisce cosa è disponibile, l'articolo determina cosa è preselezionato.
4. 🖨️ Gestione delle stampanti — Il cuore del sistema¶
La gestione delle stampanti è il nucleo dell'inoltro degli ordini. Essa determina quale stampante riceve quale scontrino quando un cameriere invia un ordine.
Tipi di stampante¶
| Tipo | Descrizione | Connessione |
|---|---|---|
| Rete (IP) | Stampante termica ESC/POS in WLAN/LAN | TCP, IP:porta (ad es. 192.168.1.51:9100) |
| Locale | Collegata al server | USB |
| Client | Sul dispositivo finale del cameriere | Stampa da browser |
| A4 (PDF/CUPS) | Stampante normale per stampe A4 | CUPS/lpr |
Configurazione della stampante¶
| Campo | Descrizione | Standard |
|---|---|---|
| Nome | Nome visualizzato | — |
| Indirizzo IP | IP:porta della stampante | — |
| Larghezza carta | 58 mm o 80 mm | 80 mm |
| Codepage | Set di caratteri | 858 (Europa occidentale + euro) |
| Stampante di backup | Viene usata se questa stampante non funziona | — |
| Disattivata | Spegnere temporaneamente la stampante | No |
Stampanti virtuali¶
Due ID stampante speciali sono integrati in modo fisso in DiKAS:
| Stampante virtuale | Significato |
|---|---|
Stampante cameriere (__kellner__) |
La stampante associata al dispositivo finale del cameriere |
Stampante standard (__standard__) |
La stampante configurata come „stampante standard" nelle impostazioni |
È possibile utilizzare queste stampanti virtuali nelle opzioni di stampa. Ciò consente configurazioni flessibili come: „Fattura sempre sulla stampante cameriere" oppure „Scontrino stazione sulla stampante standard".
Tipi di scontrino¶
DiKAS distingue quattro diversi tipi di scontrino:
| Tipo di scontrino | Quando viene stampato | Contenuto |
|---|---|---|
| Fattura (TemplateType 0) | Al pagamento | Tutte le voci, IVA, metodo di pagamento, dati TSE |
| Comanda cumulativa (TemplateType 1) | All'invio dell'ordine | Tutti gli articoli di una stazione raggruppati |
| Scontrino stazione (TemplateType 2) | All'invio dell'ordine | Singoli articoli o gruppi articoli |
| Scontrino di storno (TemplateType 3) | In caso di storno | Voce stornata con motivo |
Inoltre: Scontrino di chiusura giornaliera (TemplateType 4), Scontrino buono (TemplateType 5).
Scontrino stazione — Inoltro mirato dell'ordine¶
Ogni articolo (o ogni gruppo) può avere fino a due stampanti per scontrino stazione:
| Impostazione | Descrizione |
|---|---|
| Scontrino stazione 1 — Stampante | Stampante di destinazione (ad es. stampante cucina) |
| Scontrino stazione 1 — Nome | Intestazione sullo scontrino (ad es. „CUCINA") |
| Scontrino stazione 1 — Stampare prezzo | Mostrare il prezzo sullo scontrino cucina? |
| Scontrino stazione 1 — Stampare PLU | Mostrare il numero articolo? |
| Scontrino stazione 1 — Stampare opzioni | Mostrare gli extra selezionati? |
| Scontrino stazione 1 — Multi-scontrino | Uno scontrino per unità (invece di uno scontrino per tutto) |
| Scontrino stazione 1 — Scontrino portata | Usare questa stampante anche per gli scontrini di cambio portata |
Lo scontrino stazione 2 ha le stesse impostazioni — per una seconda stampante.
Esempio: Un piatto „Spaghetti Bolognese" va come scontrino stazione 1 alla stampante cucina e come scontrino stazione 2 anche alla stampante del bancone (in modo che il bancone sappia che presto esce un pasto e che si può proporre una bevanda in abbinamento).
Comanda cumulativa — Tutti gli articoli su uno scontrino¶
La comanda cumulativa raggruppa tutti gli articoli di un ordine che hanno la stessa stampante come destinazione:
══════════════════════════════
KÜCHE Tisch 5
──────────────────────────────
Gang 1:
2× Schnitzel
→ mit Pommes
→ ohne Salat
1× Lasagne
Gang 2:
1× Rinderfilet
→ medium
──────────────────────────────
Kellner: Maria 18:45
══════════════════════════════
| Impostazione | Descrizione |
|---|---|
| Stampante | Stampante di destinazione per la comanda cumulativa |
| Tipo di stampa | 0 = stampare sempre, 1 = stampare in aggiunta |
| Nome | Intestazione (ad es. „CUCINA") |
| Raggruppare articoli | Raggruppare gli articoli identici su una riga |
Più destinazioni della comanda cumulativa: Un articolo può avere più voci di comanda cumulativa, in modo che la stessa comanda cumulativa compaia su più stampanti.
Risoluzione delle opzioni di stampa — L'algoritmo¶
Quando un cameriere invia un ordine, DiKAS percorre per ogni singolo articolo la seguente catena di verifica:
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: Questa risoluzione avviene a ogni singolo ordine, non solo alla configurazione iniziale. Questo significa: se si modifica un'opzione di stampa su un gruppo, la modifica ha effetto immediatamente al prossimo ordine.
Opzioni di stampa dipendenti dall'area (ExtraPrintOptions)¶
La funzione di gestione delle stampanti più potente: stampanti diverse a seconda dell'area di servizio (gruppo tavoli).
| Campo | Descrizione |
|---|---|
| Gruppi tavoli | Per quali gruppi tavoli vale questa opzione di stampa? |
| Opzione di stampa | Configurazione propria di scontrino stazione/comanda cumulativa/impianto di spillatura |
Caso d'uso: Un articolo „Cola 0,3l" va nella zona interna alla stampante del bancone, nella birreria all'aperto alla stampante del giardino.
Cola 0,3l
├── Standard-Druckoption: ExtraBon 1 → Thekendrucker
├── Bereichsabhängig:
│ └── Tischgruppe „Biergarten" → ExtraBon 1 → Gartendrucker
Quando un cameriere ordina la cola al tavolo 15 (birreria all'aperto), viene usata la stampante del giardino. Al tavolo 25 (zona interna) la stampante del bancone.
Modelli di scontrino — Personalizzare il layout¶
Ogni tipo di scontrino ha un modello configurabile:
Admin → Impostazioni → Designer scontrino
| Impostazione | Descrizione |
|---|---|
| Intestazioni | Testo sopra lo scontrino (nome azienda, indirizzo) |
| Piè di pagina | Testo sotto lo scontrino (testo di ringraziamento, orari di apertura) |
| Larghezza riga | Numero di caratteri per riga (standard: 42 per carta da 80mm) |
| Carattere separatore | Carattere per le linee di separazione (ad es. ─) |
| Mostrare logo | Logo aziendale in alto sullo scontrino |
| Mostrare codice QR | Codice QR TSE sullo scontrino |
| Mostrare info TSE | Informazioni sulla firma TSE |
Specifico della comanda cumulativa: - Ordinare per portata - Mostrare prezzo - Mostrare opzioni
Specifico dello scontrino stazione: - Stampare prezzo - Stampare PLU - Stampare opzioni
Sicurezza in caso di guasto della stampa¶
DiKAS dispone di diversi meccanismi di protezione contro i guasti delle stampanti:
| Meccanismo | Descrizione |
|---|---|
| Stampante di backup | Se la stampante principale non funziona, viene usata automaticamente la stampante di backup |
| Logica di retry | 5 tentativi di ripetizione con pause di 5 secondi |
| Gli errori di stampa non bloccano mai | Un'emissione di scontrino non riuscita non impedisce mai la registrazione o il pagamento |
| Deviazione stampante | Deviazione temporanea di tutti i lavori di una stampante su un'altra |
| Stato stampante | Interrogazione in tempo reale di carta, coperchio, taglierina tramite comandi ESC/POS DLE |
5. Regole di prezzo e gestione temporale¶
Gerarchia delle regole¶
Le regole di prezzo possono essere definite su due livelli:
| Livello | Priorità | Descrizione |
|---|---|---|
| Articolo | Più alta | Regole direttamente sull'articolo |
| Gruppo articoli | Più bassa | Regole sul gruppo (valgono per tutti gli articoli del gruppo) |
Le regole dell'articolo sovrascrivono le regole del gruppo.
Condizioni di una regola¶
Ogni regola può essere limitata da combinazioni di queste condizioni:
| Condizione | Descrizione | Esempio |
|---|---|---|
| Giorni della settimana | In quali giorni vale la regola? | Lun–Ven |
| Data inizio / Data fine | Periodo di validità | 01.06.–31.08. (carta estiva) |
| Gruppi tavoli | Solo per determinate aree di servizio | Birreria all'aperto |
| Gruppi clienti | Solo per determinati clienti | Clienti abituali, dipendenti |
| Postazioni | Solo su determinate casse | Cassa 1 |
| Modalità di consegna | Consegna, ritiro o tutte | Solo ritiro |
| Sesso | Solo per uomini/donne (modalità disco) | Donne |
Adeguamenti di prezzo¶
Quando le condizioni di una regola sono soddisfatte, il prezzo viene adeguato come segue:
| Adeguamento | Descrizione | Esempio |
|---|---|---|
| Percentuale sul prezzo normale | ad es. 80 = 20 % di sconto | Happy hour: 80 % |
| Prezzo fisso | Prezzo fisso (solo se più conveniente del normale) | Offerta pranzo: 8,90 € |
| Supplemento/Sconto | Aggiungere/sottrarre un importo fisso | Supplemento birreria all'aperto: +0,50 € |
| Prezzo minimo | Il prezzo non può scendere sotto questo valore | Almeno 1,00 € |
| Arrotondamento | Arrotondare a 5 o 10 centesimi | A 10 centesimi |
Sottoregole (fasce orarie)¶
All'interno di una regola è possibile definire fasce orarie che stabiliscono prezzi diversi a diversi orari:
Esempio: Colazione, pranzo, 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)
Regole di visibilità sui gruppi¶
I gruppi articoli possono inoltre avere regole di visibilità che determinano quando il gruppo viene mostrato nel punto cassa:
Esempio: - Mostrare il gruppo „Colazione" solo dalle 07:00 alle 11:00 - Gruppo „Menù pranzo" solo Lun–Ven dalle 11:30 alle 14:00 - Gruppo „Cocktail" solo a partire dalle 17:00
6. 🍺 Integrazione degli impianti di spillatura¶
DiKAS controlla gli impianti automatici di spillatura delle bevande. Quando un cameriere ordina una bevanda, l'impianto spilla automaticamente — non è necessaria alcuna spillatura manuale.
Protocolli supportati¶
| Protocollo | Produttore | Connessione | Descrizione |
|---|---|---|---|
| Gruber | Gruber | Seriale, TCP, UDP | Framing STX/ETX con checksum XOR, handshake ENQ |
| Addimat | Addimat | Seriale, TCP, UDP | Framing STX/ETX con checksum XOR-CRC, handshake ENQ |
| Hogatron | Hogatron/WMF | Seriale, TCP, UDP | Lunghezze di campo configurabili, senza STX/ETX |
| Simulatore | DiKAS | Interno | Per il test senza hardware reale |
Tipi di connessione¶
| Connessione | Descrizione | Utilizzo tipico |
|---|---|---|
| TCP | Rete (standard) | Impianti moderni con Ethernet |
| UDP | Rete (senza connessione) | Impianti di rete più vecchi |
| Seriale | Porta COM (RS-232) | Impianti più vecchi con interfaccia seriale |
Configurazione di un impianto di spillatura¶
Admin → Impostazioni → Impianti di spillatura → „+ Nuovo impianto"
| Campo | Descrizione | Esempio |
|---|---|---|
| Nome | Nome visualizzato | Impianto di spillatura bar |
| Protocollo | Gruber, Addimat, Hogatron o Simulatore | Gruber |
| Tipo di connessione | TCP, UDP o Seriale | TCP |
| Indirizzo IP | Indirizzo di rete dell'impianto | 192.168.1.70 |
| Porta | Porta di rete | 3010 |
| Attivato | Accendere/spegnere l'impianto | Sì |
| Reset alla chiusura giornaliera | Resettare l'impianto alla chiusura giornaliera | Sì |
Impostazioni avanzate (specifiche del protocollo):
| Campo | Descrizione | Standard |
|---|---|---|
| Lunghezza PLU | Numero di cifre del numero PLU nel frame del protocollo | 4 |
| Lunghezza cameriere | Numero di cifre del numero cameriere | 3 |
| Lunghezza tavolo | Numero di cifre del numero tavolo | 3 |
| Lunghezza quantità | Numero di cifre della quantità | 4 |
| Utilizzare checksum | Aggiungere checksum XOR | No |
| Timeout di invio | Timeout in millisecondi | 1000 |
| Intervallo di interrogazione | Intervallo di polling per le registrazioni in entrata | 1000 |
Collegare l'articolo all'impianto di spillatura¶
Affinché un articolo venga spillato automaticamente, devono essere configurate due cose:
- PLU impianto di spillatura sull'articolo: Il numero PLU che identifica il rubinetto di spillatura
- Impianto di spillatura attivato nell'opzione di stampa: Nell'area opzioni di stampa dell'articolo
| Impostazione | Dove | Descrizione |
|---|---|---|
| PLU impianto di spillatura | Articolo → Generale | Numero PLU del rubinetto di spillatura (ad es. 5) |
| Impianto di spillatura attivato | Articolo → Opzioni di stampa → Impianto di spillatura | Deve essere impostato su „Sì" |
| Impianto di destinazione | Articolo → Opzioni di stampa → Impianto di spillatura → Destinazione | Quale impianto (oppure standard = primo attivo) |
| Manuale | Articolo → Opzioni di stampa → Impianto di spillatura → Manuale | Funzionamento manuale invece che automatico |
Impianto di spillatura per area di servizio¶
Tramite le opzioni di stampa dipendenti dall'area è possibile assegnare impianti di spillatura diversi a diverse aree di servizio:
Artikel: Helles 0,5l (PLU: 5)
├── Standard → Schankanlage: Zapfanlage Innen
└── Tischgruppe „Biergarten" → Schankanlage: Zapfanlage Garten
Numero tavolo per la spillatura¶
Ogni tavolo può avere un proprio numero tavolo per l'impianto di spillatura. Questo numero viene trasmesso all'impianto nel frame del protocollo, in modo che l'impianto possa registrare il consumo per ogni tavolo.
Admin → Tavoli → Modifica tavolo → „N. tavolo spillatura"
Svolgimento di una spillatura automatica¶
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
Comportamento in caso di errore: Se l'impianto di spillatura non è raggiungibile o segnala un errore, l'ordine viene comunque salvato. L'errore di stampa non blocca mai la registrazione. La spillatura non riuscita viene registrata e può essere consultata nel log di debug.
Storno e restituzione¶
Gli ordini stornati vengono inviati all'impianto di spillatura come quantità negativa. L'impianto storna il consumo.
Debug e diagnostica¶
Admin → Impostazioni → Impianti di spillatura → [Impianto] → „Debug"
La finestra di debug mostra tutti i pacchetti di dati inviati e ricevuti in rappresentazione esadecimale e 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 .
| Direzione | Significato |
|---|---|
| TX | Inviato da DiKAS all'impianto |
| RX | Ricevuto dall'impianto |
| ERR | Errore (timeout, interruzione della connessione) |
7. Articoli di sistema¶
DiKAS ha 12 articoli di sistema predefiniti, necessari per le funzioni interne:
| Articolo | ID | Funzione |
|---|---|---|
| Sconto bonus | art_custbonusrabatt |
Sconto automatico in presenza di credito bonus |
| Pagamento | art_payout |
Pagamento del credito cliente |
| Ricaricare credito | art_guthabenaufladen |
Ricarica del credito cliente |
| Ricaricare buono | art_gutscheinaufladen |
Vendita di buono |
| Articolo manuale | art_manuell |
Inserimento libero del prezzo nel punto cassa |
| Orario di lavoro | art_arbeitszeit |
Rilevazione presenze / Officina |
| Riscattare buono | art_gutscheineinloesung |
Riscatto del buono (voce in negativo) |
| Cauzione | art_pfand |
Supplemento cauzione automatico |
| Spese di consegna | art_liefergebuehr |
Costi di consegna |
| Valore minimo d'ordine | art_mindestbestellwert |
Supplemento in caso di mancato raggiungimento |
| Ingresso disco | art_discoeintritt |
Quota d'ingresso (modulo disco) |
| Consumo minimo disco | art_discomindestverzehr |
Supplemento consumo minimo (modulo disco) |
Protezione: Gli articoli di sistema non possono essere eliminati. In fase di modifica è consentita solo la modifica del gruppo — tutti gli altri campi sono protetti.
8. Esempio pratico: Pizzeria „Da Mario"¶
Descrizione dell'attività¶
- Pizzeria con 40 posti a sedere all'interno e 20 sulla terrazza
- Cucina con forno per pizza e stazione insalate separata
- Bancone bevande con macchina del caffè
- 3 camerieri nel servizio serale
Hardware¶
| Dispositivo | Postazione | IP |
|---|---|---|
| Stampante cassa | Cassa (ingresso) | 192.168.1.50 |
| Stampante cucina | Accanto al forno per pizza | 192.168.1.51 |
| Stampante insalate | Stazione insalate | 192.168.1.52 |
| Stampante bancone | Bancone bevande | 192.168.1.53 |
| 3× Tablet | Camerieri | WLAN |
Struttura dei gruppi¶
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
Configurazione delle stampanti¶
| Gruppo | Scontrino stazione 1 | Comanda cumulativa |
|---|---|---|
| Speisen (100) | Stampante cucina | Stampante cucina |
| Salate (10003) | Stampante insalate | Stampante insalate |
| Getränke (200) | Stampante bancone | Stampante bancone |
| Kaffee & Kuchen (300) | Stampante bancone | Stampante bancone |
ℹ️ Nota: „Salate" sovrascrive l'ereditarietà di „Speisen" — gli ordini di insalata vanno alla stazione insalate, non in cucina.
Gruppi tavoli¶
| Gruppo tavoli | Tavoli | Particolarità |
|---|---|---|
| Zona interna | 1–20 | Opzioni di stampa standard |
| Terrazza | 21–30 | +0,50 € supplemento terrazza sulle bevande |
Regole di prezzo¶
Regola: Supplemento terrazza sulle bevande
| Impostazione | Valore |
|---|---|
| Gruppo tavoli | Terrazza |
| Supplemento | +0,50 € |
| Valido per | Gruppo „Getränke" |
Regola: Menù pranzo (Lun–Ven, 11:30–14:00)
| Impostazione | Valore |
|---|---|
| Giorni | Lun–Ven |
| Periodo | 11:30–14:00 |
| Prezzo fisso | 8,90 € |
| Valido per | Articolo „Tagesmenü" |
Modelli di opzioni¶
Modello: „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 €
Questo modello viene assegnato a tutte e 15 le pizze. Se Mario modifica il prezzo del formaggio extra, il nuovo prezzo vale immediatamente per tutte le pizze.
Svolgimento dell'ordine¶
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. Esempio pratico: Birreria all'aperto „Zum Löwen"¶
Descrizione dell'attività¶
- Osteria con sala (zona interna, 60 posti) e birreria all'aperto (100 posti)
- Entrambe le aree hanno un proprio impianto di spillatura (protocollo Gruber)
- La cucina serve entrambe le aree
- Nella birreria all'aperto c'è una stazione griglia separata
- 5 camerieri, 2 cuochi, 1 grigliatore
Hardware¶
| Dispositivo | Postazione | IP | Tipo |
|---|---|---|---|
| Stampante cassa | Cassa | 192.168.1.50 | ESC/POS |
| Stampante cucina | Cucina | 192.168.1.51 | ESC/POS |
| Stampante griglia | Griglia birreria all'aperto | 192.168.1.52 | ESC/POS |
| Impianto di spillatura sala | Sala (bancone) | 192.168.1.70 | Gruber TCP |
| Impianto di spillatura giardino | Birreria all'aperto (spillatura) | 192.168.1.71 | Gruber TCP |
Gruppi tavoli¶
| Gruppo tavoli | Tavoli | Descrizione |
|---|---|---|
| Sala | 1–15 | Zona interna, impianto di spillatura sala |
| Birreria all'aperto | 101–130 | Zona esterna, impianto di spillatura giardino |
Configurazione degli impianti di spillatura¶
Impianto 1: Rubinetto sala
| Impostazione | Valore |
|---|---|
| Nome | Rubinetto sala |
| Protocollo | Gruber |
| Connessione | TCP |
| IP | 192.168.1.70 |
| Porta | 3010 |
| Lunghezza PLU | 4 |
| Reset alla chiusura giornaliera | Sì |
Impianto 2: Rubinetto giardino
| Impostazione | Valore |
|---|---|
| Nome | Rubinetto giardino |
| Protocollo | Gruber |
| Connessione | TCP |
| IP | 192.168.1.71 |
| Porta | 3010 |
| Lunghezza PLU | 4 |
| Reset alla chiusura giornaliera | Sì |
Articolo birra con impianto di spillatura dipendente dall'area¶
Articolo: Helles 0,5l
| Campo | Valore |
|---|---|
| Nome | Helles 0,5l |
| Prezzo | 4,20 € |
| Classe fiscale | 19 % |
| Gruppo | Bier |
| PLU impianto di spillatura | 1 |
Opzioni di stampa:
| Impostazione | Valore |
|---|---|
| Impianto di spillatura standard | Rubinetto sala |
| Dipendente dall'area: Birreria all'aperto | Rubinetto giardino |
Articolo: Weißbier 0,5l
| Campo | Valore |
|---|---|
| PLU impianto di spillatura | 2 |
| Tutte le altre impostazioni | Come Helles, solo PLU diverso |
Articolo: Radler 0,5l
| Campo | Valore |
|---|---|
| PLU impianto di spillatura | 3 |
Tavoli con numeri tavolo per l'impianto di spillatura¶
| Tavolo DiKAS | N. tavolo spillatura | Impianto |
|---|---|---|
| Tavolo 1 (sala) | 1 | Rubinetto sala |
| Tavolo 2 (sala) | 2 | Rubinetto sala |
| ... | ... | ... |
| Tavolo 101 (giardino) | 1 | Rubinetto giardino |
| Tavolo 102 (giardino) | 2 | Rubinetto giardino |
ℹ️ Nota: I numeri tavolo per gli impianti di spillatura sono indipendenti per ogni impianto. Il tavolo 1 nella sala e il tavolo 101 nel giardino possono avere entrambi il n. tavolo spillatura 1 — appartengono a impianti diversi.
Configurazione delle stampanti per la cucina¶
| Gruppo | Stampante standard | Stampante birreria all'aperto |
|---|---|---|
| Speisen | Stampante cucina | Stampante cucina |
| Grillgerichte | Stampante cucina | Stampante griglia |
| Bier | — (solo impianto di spillatura) | — (solo impianto di spillatura) |
| Alkoholfrei | — (nessuno scontrino necessario) | — (nessuno scontrino necessario) |
Particolarità piatti alla griglia: Nella sala l'ordine va alla stampante cucina (la cucina prepara). Nella birreria all'aperto va alla stampante griglia (il grigliatore prepara direttamente).
Artikelgruppe: Grillgerichte
├── Standard-Druckoption: ExtraBon 1 → Küchendrucker
└── Bereichsabhängig: Biergarten → ExtraBon 1 → Grilldrucker
Regole di prezzo¶
Regola: Boccale birreria all'aperto
Per la Helles, nella birreria all'aperto è disponibile solo il boccale (1,0l), nella sala il mezzo litro (0,5l):
| Articolo | Sala | Birreria all'aperto |
|---|---|---|
| Helles 0,5l | 4,20 € | Nascosto |
| Helles Maß 1,0l | Nascosto | 8,90 € |
Questo viene gestito tramite regole di visibilità sul gruppo articoli:
- Gruppo „Bier Halbe" → Mostrare solo nel gruppo tavoli „Sala"
- Gruppo „Bier Maß" → Mostrare solo nel gruppo tavoli „Birreria all'aperto"
Svolgimento completo dell'ordine¶
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. Esempio pratico: Ristorante grande con 3 stazioni di cucina¶
Descrizione dell'attività¶
- Ristorante di fascia alta con 80 posti
- 3 stazioni di cucina: Cucina calda, Cucina fredda (insalate/carpaccio), Pasticceria
- Gestione portate: menù da 3–5 portate con preparazione sequenziale
- Bar con stampante propria
- Monitor cucina (KDS) in aggiunta alle stampanti
Hardware¶
| Dispositivo | Postazione | IP |
|---|---|---|
| Stampante cassa | Cassa | 192.168.1.50 |
| Stampante cucina calda | Stazione 1 | 192.168.1.51 |
| Stampante cucina fredda | Stazione 2 | 192.168.1.52 |
| Stampante pasticceria | Stazione 3 | 192.168.1.53 |
| Stampante bar | Bar | 192.168.1.54 |
| Monitor cucina | TV cucina | Client browser |
Struttura dei gruppi e assegnazione delle stampanti¶
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)
Particolarità piatti di pesce: Per determinati piatti di pesce il contorno (insalata) arriva dalla cucina fredda. Per questo il sottogruppo „Fisch" ha due stampanti per scontrino stazione: scontrino stazione 1 → cucina calda (pesce), scontrino stazione 2 → cucina fredda (contorno).
Gestione portate in dettaglio¶
Svolgimento di un menù da 4 portate:
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"
Configurazione per gli scontrini portata:
Sulla stampante per scontrino stazione deve essere attivato il campo „Scontrino portata". Allora questa stampante riceve automaticamente uno scontrino portata quando il cameriere cambia portata.
| Gruppo | Stampante scontrino stazione 1 | Scontrino portata |
|---|---|---|
| Vorspeisen warm | Stampante cucina calda | Sì |
| Vorspeisen kalt | Stampante cucina fredda | Sì |
| Hauptgerichte | Stampante cucina calda | Sì |
| Desserts | Stampante pasticceria | Sì |
| Getränke | Stampante bar | No |
Bevande senza scontrino portata: La stampante bar non riceve alcuno scontrino portata, perché le bevande vengono servite indipendentemente dalla sequenza delle portate.
Comanda cumulativa per l'expeditor¶
Lo chef (expeditor) coordina le stazioni. Egli riceve una comanda cumulativa con tutti gli ordini:
══════════════════════════════
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
══════════════════════════════
Configurazione: Oltre allo scontrino stazione su ogni stazione, la stampante standard (cassa/expeditor) riceve una comanda cumulativa con tutte le voci.
11. Domande frequenti (FAQ)¶
Articoli e gruppi¶
Posso avere un articolo in più gruppi contemporaneamente? No, un articolo appartiene sempre a esattamente un gruppo. È però possibile offrire lo stesso articolo in altri gruppi tramite gli articoli aggiuntivi (cross-sell).
Cosa succede se elimino un gruppo articoli? I gruppi possono essere eliminati solo se non vi sono più articoli associati. Spostare prima tutti gli articoli in un altro gruppo.
Posso modificare retroattivamente i prezzi degli articoli? Sì, ma la modifica vale solo per i nuovi ordini. Gli scontrini già registrati mantengono il vecchio prezzo. Le modifiche di prezzo vengono documentate nel registro delle modifiche dell'articolo (le ultime 100 modifiche).
Gestione delle stampanti¶
Cosa succede se una stampante non funziona? DiKAS tenta 5 volte con pause di 5 secondi di stampare lo scontrino. Se è configurata una stampante di backup, questa viene usata automaticamente. L'ordine viene comunque salvato — un errore di stampa non blocca mai la registrazione.
Posso modificare al volo le impostazioni della stampante? Sì, le modifiche valgono immediatamente al prossimo ordine. È inoltre possibile impostare una deviazione stampante temporanea quando una stampante è in manutenzione.
Come testo una nuova stampante? Tramite Admin → Impostazioni → Stampanti → „Stampa di prova" è possibile inviare uno scontrino di prova a ogni stampante configurata.
Regole di prezzo¶
Cosa succede in caso di regole sovrapposte? Le regole dell'articolo hanno la precedenza sulle regole del gruppo. All'interno di un livello viene applicata la prima regola applicabile.
Posso modificare i prezzi per determinati clienti? Sì, tramite i gruppi clienti nelle regole di prezzo. Creare un gruppo clienti „Clienti abituali" e definire una regola con il 10 % di sconto per questo gruppo.
Impianti di spillatura¶
La birra viene spillata anche se l'impianto è offline? No, l'impianto deve essere raggiungibile. Ma l'ordine viene comunque salvato — il cameriere deve poi spillare manualmente.
Posso vedere cosa è stato inviato all'impianto? Sì, tramite la vista di debug dell'impianto di spillatura (Admin → Impostazioni → Impianti di spillatura → Debug). Lì si vedono tutti i pacchetti di dati inviati e ricevuti.
Perché il mio articolo birra ha sia una stampante sia un impianto di spillatura? La stampante stampa uno scontrino come conferma dell'ordine (ad es. per l'addetto al bancone). L'impianto di spillatura spilla fisicamente la birra. Entrambi possono funzionare in parallelo. Quando l'impianto spilla automaticamente, spesso non serve più una stampante separata al bancone.
Prossimo passo¶
→ Articoli, stampanti e regole — Avvio rapido — La versione compatta per un avvio rapido
→ Stampante cucina e monitor cucina — Gestione portate e display cucina
→ Impostazioni — Tutte le possibilità di configurazione nell'area Admin