Glossario — Termini tecnici del sistema di cassa¶
Tutti i termini tecnici relativi a DiKAS, ai sistemi di cassa e all'IT per la ristorazione.
A¶
ACK / NACK¶
Segnali di conferma e di errore nella comunicazione con gli impianti di spillatura. ACK (Acknowledge) conferma la ricezione di un comando. NACK (Negative Acknowledge) segnala un errore — il comando viene ripetuto automaticamente.
Addimat¶
Produttore di impianti di spillatura. DiKAS supporta il protocollo Addimat (framing STX/ETX con checksum XOR-CRC) per la spillatura automatica delle bevande.
Allergeni (EU-14)¶
I 14 allergeni soggetti a obbligo di indicazione secondo il regolamento UE n. 1169/2011. DiKAS memorizza gli allergeni per articolo e li stampa sugli scontrini.
API (Application Programming Interface)¶
Interfaccia di programmazione. DiKAS offre oltre 120 endpoint REST-API per l'integrazione con sistemi esterni. Autenticazione tramite token JWT.
Gruppo articoli (Artikelgruppe)¶
Struttura di ordinamento per gli articoli. I gruppi sono organizzati in modo gerarchico (fino a 3 livelli) e determinano l'assegnazione della stampante, l'ordinamento nella cassa e l'analisi per gruppo merceologico. Le impostazioni della stampante vengono ereditate automaticamente dal gruppo di livello superiore.
Opzione articolo (Artikeloption)¶
Selezione aggiuntiva in un ordine (ad es. condimento extra, contorno, tipo di preparazione). Le opzioni possono avere un sovrapprezzo ed essere configurate come selezione obbligatoria o facoltativa.
Audit-Log¶
Protocollo a prova di revisione di tutte le operazioni rilevanti per la cassa. Viene tenuto automaticamente e può essere scaricato come file. Rilevante per le verifiche fiscali.
B¶
Backup¶
Salvataggio completo di tutti i dati DiKAS come file ZIP. Contiene tutti i documenti (JSONL compressi con Brotli) e gli allegati. Può essere ripristinato in modo selettivo (ad es. solo articoli o solo clienti).
Opzione di stampa dipendente dall'area (Bereichsabhängige Druckoption)¶
Controllo della stampante che utilizza stampanti diverse a seconda del gruppo tavoli (area di servizio). Esempio: gli ordini di birra nel giardino vanno alla stampante del giardino, nella sala alla stampante del bancone.
Ricevuta di rappresentanza (Bewirtungsbeleg)¶
Giustificativo fiscalmente rilevante per le spese di rappresentanza aziendali. DiKAS stampa automaticamente una ricevuta di rappresentanza con motivo, partecipanti e mancia.
Scontrino (Bon)¶
Scontrino di cassa. DiKAS distingue quattro tipi di scontrino: Fattura (per l'ospite), Comanda cumulativa (panoramica cucina), Scontrino stazione (singola stazione) e Scontrino di storno (annullamento).
BYOD (Bring Your Own Device)¶
Concetto secondo cui qualsiasi dispositivo può essere utilizzato come cassa — PC, tablet, smartphone. DiKAS funziona nel browser e non richiede hardware speciale.
C¶
Clean Architecture¶
Modello di architettura software. DiKAS è strutturato su quattro livelli: Domain (logica di business), Application (casi d'uso), Infrastructure (database, stampanti), Web (endpoint API).
CouchDB¶
Database NoSQL che DiKAS utilizza come archivio dati predefinito. Vantaggi: capacità offline tramite replica, modello dati a documenti, notifiche di modifica in tempo reale.
CQRS (Command Query Responsibility Segregation)¶
Modello di architettura che separa le operazioni di lettura e scrittura. DiKAS utilizza Command per le modifiche (effettuare un ordine, eseguire un pagamento) e Query per le interrogazioni (caricare articoli, visualizzare report).
D¶
DATEV¶
Software di contabilità standard in Germania. DiKAS esporta i dati di cassa nel formato DATEV (EXTF v13) con 7 diverse modalità di esportazione. Supporta archivi ZIP cifrati e invio via e-mail al commercialista.
Vendita diretta (Direktverkauf)¶
Operazione di cassa senza assegnazione a un tavolo. Ideale per chioschi, panetterie, edicole o servizio al bancone. Selezionare l'articolo, scegliere il metodo di pagamento, fatto.
Docker¶
Tecnologia a container per il deployment su server. DiKAS viene distribuito come singola immagine Docker (API + frontend in un unico container).
DSFinV-K¶
Interfaccia digitale dell'amministrazione finanziaria per i sistemi di cassa. Formato di esportazione standardizzato per le verifiche fiscali. DiKAS crea esportazioni conformi al DSFinV-K.
E¶
ESC/POS¶
Protocollo di stampa per stampanti termiche (stampanti scontrini). Sviluppato da Epson, supportato da quasi tutte le stampanti scontrini (Epson, Star, Bixolon, ecc.). DiKAS comunica con le stampanti ESC/POS tramite TCP/IP.
Scontrino stazione (ExtraBon)¶
Scontrino aggiuntivo che viene stampato automaticamente su una determinata stazione al momento di un ordine (ad es. cucina, bar, stazione insalate). Ogni articolo può avere fino a due stampanti per lo scontrino stazione.
F¶
FinTS (Financial Transaction Services)¶
Protocollo per l'online banking in Germania (successore di HBCI). DiKAS utilizza FinTS per il recupero automatico degli estratti conto ai fini dell'abbinamento dei pagamenti in entrata.
FlexCel¶
Libreria per la generazione di file Excel. DiKAS utilizza FlexCel per le esportazioni in Excel (rilevazione presenze, report, modelli DATEV).
FreeCount (numero gratuito)¶
Impostazione del gruppo di opzioni. Stabilisce quante delle opzioni selezionate più economiche sono gratuite. Esempio: „Una salsa inclusa" → FreeCount = 1.
G¶
Portata (Gang / Course)¶
Sequenza delle pietanze in un menù a più portate. DiKAS supporta la gestione delle portate: il cameriere cambia la portata e la cucina riceve uno scontrino di portata con l'informazione su quali piatti preparare successivamente.
Scontrino di portata (Gang-Bon)¶
Scontrino stampato automaticamente al cambio di portata. Informa la cucina che la portata successiva deve essere preparata. Viene stampato solo sulle stampanti con l'opzione scontrino di portata attivata.
GDPdU (GoBD)¶
Principi per la corretta tenuta e conservazione di libri, registrazioni e documenti in formato elettronico. DiKAS soddisfa i requisiti GoBD e crea esportazioni conformi al GDPdU.
Gruber¶
Produttore di impianti di spillatura. DiKAS supporta il protocollo Gruber (framing STX/ETX con handshake ENQ e checksum XOR opzionale).
Buono (Wertgutschein / Einzelgutschein)¶
DiKAS distingue due tipi di buono: buoni a valore (importo a piacere, IVA 0 % alla vendita, IVA al riscatto) e buoni monouso (per un determinato articolo, IVA normale alla vendita, 0 % al riscatto).
H¶
Hausbon (su fattura)¶
Metodo di pagamento „su fattura". L'importo viene registrato sul conto del cliente e può essere fatturato successivamente. Nessun effetto sulla cassa (non circola contante).
Hogatron¶
Produttore di impianti di spillatura (anche WMF). DiKAS supporta il protocollo Hogatron con lunghezze di campo configurabili.
J¶
JWT (JSON Web Token)¶
Meccanismo di autenticazione. DiKAS utilizza i token JWT per l'autenticazione dell'API. I token vengono emessi al login e inviati a ogni chiamata API.
K¶
KassenSichV¶
Regolamento tedesco per la sicurezza dei sistemi di cassa (Kassensicherungsverordnung). Obbligatorio in Germania dal 01.01.2020. Ogni cassa elettronica deve utilizzare una TSE (Technische Sicherheitseinrichtung) che firma le transazioni in modo a prova di manomissione.
KDS (Kitchen Display System)¶
Monitor cucina. Mostra gli ordini su uno schermo invece che su carta. DiKAS utilizza SignalR per gli aggiornamenti in tempo reale — i nuovi ordini compaiono immediatamente.
Credito cliente (Kundenguthaben)¶
Credito prepagato sul conto del cliente. DiKAS distingue AccountBalance (credito in contanti caricato) e BonusBalance (bonus di ricarica in percentuale/importo). Ricarica = IVA 0 %, riscatto = IVA normale.
M¶
MediatR¶
Libreria .NET per il pattern CQRS. Tutti i comandi (Command) e le interrogazioni (Query) di DiKAS vengono inoltrati tramite MediatR.
Consumo minimo (Mindestverzehr)¶
Importo minimo dell'ordine per ospite (ad es. nei club). Viene calcolato come sovrapprezzo al pagamento se l'ospite non ha raggiunto il consumo minimo.
N¶
NFC (Near Field Communication)¶
Comunicazione senza contatto a breve distanza. DiKAS utilizza l'NFC per l'accesso del personale (il cameriere avvicina il chip al lettore) e per i conti ospiti Disco (ID della carta).
NgRx Signal Store¶
Libreria Angular per la gestione globale dello stato. DiKAS utilizza il Signal Store (AppStore) per lo stato dell'applicazione nel frontend.
O¶
OpenBon¶
Posizione d'ordine aperta. Ogni articolo ordinato su un tavolo viene salvato come singolo documento OpenBon. Tutti gli OpenBon con lo stesso BonId appartengono a una sessione d'ordine. Al pagamento diventa un ReceiptItem.
Modello di opzioni (OptionTemplate)¶
Raccolta riutilizzabile di opzioni articolo. Viene creata una volta e può essere assegnata a più articoli. Le modifiche al modello valgono immediatamente per tutti gli articoli associati.
P¶
PLU (Price Look-Up)¶
Numero articolo per gli impianti di spillatura. Ogni rubinetto di spillatura ha un numero PLU. L'articolo in DiKAS viene collegato al rubinetto tramite il campo „PLU impianto di spillatura".
POS (Point of Sale)¶
Sistema di cassa / punto cassa. In DiKAS è l'area in cui si incassa (in contrapposizione all'area Admin per la gestione).
Regola di prezzo (Preisregel)¶
Modifica automatica del prezzo basata su condizioni come giorno della settimana, ora, gruppo tavoli, gruppo clienti o modalità di consegna. Le regole sull'articolo hanno la precedenza su quelle sul gruppo.
PrintPool¶
Servizio di stampa in background di DiKAS. Gestisce una coda di lavori di stampa, li invia alle stampanti tramite TCP e gestisce gli errori con tentativi automatici e stampanti di backup.
Q¶
QR-Code (TSE)¶
DiKAS stampa un codice QR sugli scontrini di cassa che contiene la firma TSE. Formato secondo DSFinV-K allegato I: numero di serie, contatore della firma, momento di inizio, momento di fine, firma.
R¶
Receipt (scontrino)¶
Scontrino di cassa dopo un pagamento. Contiene tutte le posizioni, la suddivisione fiscale, il/i metodo/i di pagamento e la firma TSE. Viene conservato in modo permanente nel database.
REST API¶
Interfaccia di programmazione tramite HTTP. DiKAS offre oltre 120 endpoint sotto /api/v1/... per tutte le funzioni: articoli, ordini, pagamenti, clienti, report, impostazioni.
S¶
Comanda cumulativa (Sammelbon)¶
Scontrino riepilogativo che raggruppa tutti gli articoli di un ordine per una determinata stazione. A differenza dello scontrino stazione (uno scontrino per articolo), la comanda cumulativa mostra tutte le posizioni in un colpo d'occhio.
Impianto di spillatura (Beverage Dispensing System)¶
Impianto automatico di spillatura delle bevande. DiKAS supporta Gruber, Addimat e Hogatron/WMF tramite Serial, TCP o UDP. Gli ordini attivano la spillatura automatica.
Addebito diretto SEPA¶
Procedura di incasso europea. DiKAS crea file SEPA-XML per l'incasso bancario automatico di fatture aperte e abbonamenti.
SignalR¶
Tecnologia di comunicazione in tempo reale. DiKAS utilizza SignalR per gli aggiornamenti in tempo reale nel monitor cucina, in caso di modifiche ai tavoli e modifiche di configurazione. Tutti i dispositivi connessi vedono le modifiche immediatamente.
Soft Delete¶
Meccanismo di cancellazione in cui i record non vengono eliminati fisicamente, ma contrassegnati come „eliminati". In questo modo rimangono presenti nei report e nei dati storici.
Pagamento separato (Split-Zahlung)¶
Pagamento suddiviso di una fattura. DiKAS supporta sia la suddivisione per posizioni (ogni ospite paga i propri articoli) sia per importo (divisione equa).
SQLite¶
Motore di database locale. DiKAS può essere utilizzato con SQLite in alternativa a CouchDB — ideale per installazioni monoutente e per l'app Android.
Articolo di sistema (System-Artikel)¶
Articoli predefiniti in DiKAS necessari per le funzioni interne (ad es. ricarica del credito, riscatto del buono, cauzione). Non possono essere eliminati.
T¶
Chiusura giornaliera (Z-Bericht)¶
Chiusura di un turno di lavoro. Riepiloga tutti i ricavi, i metodi di pagamento, le imposte e le differenze. Viene firmata TSE e stampata come PDF o scontrino. Reimposta l'impianto di spillatura (se configurato).
Gruppo tavoli (Tischgruppe)¶
Area di servizio nell'esercizio (ad es. sala interna, terrazza, giardino, VIP). I gruppi tavoli controllano l'assegnazione delle stampanti (opzioni di stampa dipendenti dall'area) e possono avere proprie regole di prezzo.
TSE (Technische Sicherheitseinrichtung)¶
Meccanismo di firma a prova di manomissione per i sistemi di cassa. In Germania obbligatorio dal 01.01.2020. DiKAS supporta la TSE hardware (Swissbit USB) e il proxy TSE (in rete). Ogni scontrino, ogni ordine e ogni chiusura giornaliera viene firmato.
V¶
Stampante virtuale (Virtueller Drucker)¶
Stampante segnaposto in DiKAS: Stampante cameriere (__kellner__) = la stampante del dispositivo corrente. Stampante predefinita (__standard__) = la stampante predefinita impostata nelle impostazioni.
Voucher¶
→ vedi Buono
Z¶
Articolo a tempo (Zeitartikel)¶
Articolo con fatturazione su base temporale (ad es. tavolo da biliardo, pista da bowling all'ora). Il prezzo viene calcolato automaticamente in base alla durata.
ZVT (Zahlungsverkehrstechnik)¶
Protocollo standard per la comunicazione tra il sistema di cassa e il terminale EC in Germania. DiKAS comunica tramite ZVT con qualsiasi terminale compatibile (Ingenico, Verifone, CCV ecc.) — senza vincolo a un determinato fornitore di pagamenti.
Passaggio successivo¶
→ Domande frequenti (FAQ) — Le domande e risposte più importanti
→ Risoluzione dei problemi — Quando qualcosa non funziona