Soglie Varianza e Alert Automatici
Panoramica Alert
Il sistema di alert monitora automaticamente le sessioni di cassa ogni 15 minuti e genera notifiche quando rileva situazioni anomale. Gli alert vengono salvati nel database del tenant e inviati in tempo reale alle app collegate tramite il sistema di sync.
Ogni alert ha un livello di gravita:
- warning: situazione da monitorare
- critical: richiede intervento immediato (il livello scala automaticamente se il valore supera il doppio della soglia)
Tipi di Alert
SESSION_OVERTIME -- Sessione Prolungata
Scatta quando una sessione resta aperta oltre il tempo massimo configurato. Una sessione aperta troppo a lungo potrebbe indicare un operatore che ha dimenticato di chiudere il turno.
- Soglia default: 12 ore
- Severita: warning a 12h, critical a 24h
- Azione consigliata: contattare l'operatore o chiudere la sessione dalla console
HIGH_VARIANCE -- Varianza Elevata
Scatta alla chiusura di una sessione quando la differenza tra contante atteso e contato supera la soglia. Controllato sulle sessioni chiuse negli ultimi 30 minuti.
- Soglia default: 20,00 euro (valore assoluto)
- Severita: warning a 20 euro, critical a 40 euro
- Azione consigliata: verificare i movimenti della sessione, richiedere chiarimenti all'operatore
HIGH_CASH_LEVEL -- Livello Contante Elevato
Scatta quando il contante stimato nel cassetto di una sessione aperta supera il livello massimo consentito. Utile per sollecitare versamenti in banca o cassaforte.
- Soglia default: 2.000,00 euro
- Severita: warning a 2.000 euro, critical a 3.000 euro
- Azione consigliata: effettuare un versamento in banca/cassaforte
EXCESSIVE_VOIDS -- Storni Eccessivi
Scatta quando il numero di movimenti stornati in una sessione aperta supera il massimo consentito nell'ultima ora. Puo indicare errori frequenti o comportamenti sospetti.
- Soglia default: 3 storni/ora
- Severita: warning a 3, critical a 6
- Azione consigliata: verificare i motivi degli storni con l'operatore
Configurazione Soglie
Dalla console di amministrazione, accedere a Prima Nota > Alert > Configurazione:
| Parametro | Default | Descrizione |
|---|---|---|
maxSessionHours | 12 | Ore massime sessione aperta |
varianceThreshold | 20,00 | Soglia varianza in euro |
maxCashLevel | 2.000,00 | Massimo contante nel cassetto |
maxVoidsPerHour | 3 | Storni massimi per ora |
Le soglie sono configurabili per tenant. Se non impostati, valgono i valori default della piattaforma.
Deduplicazione
Per evitare notifiche ripetitive, lo stesso tipo di alert per la stessa sessione viene generato al massimo una volta ogni 2 ore. Trascorse le 2 ore, se la condizione persiste, viene creato un nuovo alert.
Gestione Alert
Gli alert non letti appaiono nel contatore badge della console admin. Per ogni alert e possibile:
- Visualizzare i dettagli: sessione coinvolta, operatore, valori anomali
- Prendere in carico (acknowledge): l'alert viene marcato come letto con timestamp e operatore
FAQ
D: Gli alert vengono inviati anche via email? R: Gli alert critical generano una notifica email all'amministratore del tenant tramite il servizio email della piattaforma.
D: Posso disattivare un tipo specifico di alert? R: Non e possibile disattivare un tipo, ma si possono impostare soglie molto alte per renderlo meno sensibile.
D: Come faccio a vedere la cronologia degli alert? R: Dalla console admin, sezione Prima Nota > Alert, con filtri per tipo, severita, periodo e stato di lettura.
Vedi Anche
- Configurazione Registratori e Causali -- Soglie per singolo registratore
- Sessioni Cassa -- Conteggio e varianza alla chiusura
- API Prima Nota -- Endpoint API per alert e configurazione