Manuale Utente - Safety21 Financial

Benvenuti nel manuale utente dell'applicativo Safety21 Financial. Questo documento descrive tutte le funzionalità disponibili per la gestione dei flussi finanziari, della riconciliazione incassi, della gestione verbali e delle comunicazioni interne.

Indice

1. Accesso e Home Page
2. Gestione Enti Creditori
3. Gestione Flussi CBI
   • Caricamento File
   • Lista File
   • Dettaglio e Riconciliazione
   • Data Pagamento Diversa da Data Accredito
   • Aggregazione Transazioni Parziali
   • Pagamenti Rateali (Determine)
4. Contabilità
   • Contabilità Provvisoria e Definitiva
   • Storico Estrazioni Contabili
5. Ricerca Pagamenti Efil
6. Gestione Verbali
   • Ricerca Verbali
   • Modifica Veicolo
   • Stampa Unione (Generazione Documenti)
7. Chat e Comunicazioni
8. Attività di Sistema
9. Domande Frequenti

---

1. Accesso e Home Page

Dopo aver effettuato il login con le proprie credenziali, l'utente accede alla Home Page. La pagina presenta un video di sfondo istituzionale e un menu di navigazione principale per accedere alle diverse sezioni dell'applicativo.

---

2. Gestione Enti Creditori

Questa sezione permette di gestire l'anagrafica degli Enti Creditori censiti nel sistema.

• Visualizzazione: Elenco paginato degli enti con possibilità di filtro.
• Creazione/Modifica: È possibile aggiungere nuovi enti o modificare quelli esistenti inserendo dati come:
  • Codice Ente
  • Denominazione
  • Codice Ufficio / Tipo Ufficio
  • Codice Catastale Comune
  • Ufficio Pagatore
• Importazione: Funzionalità per importare massivamente gli enti da file esterni (se supportato).

---

3. Gestione Flussi CBI

Il cuore dell'applicativo è la gestione dei flussi CBI per la riconciliazione degli incassi.

3.1. Caricamento File

L'utente può caricare nuovi file CBI nel sistema.

• Il sistema analizza il contenuto del file, estrae l'header, il footer e le singole transazioni.
• Viene creato un record per il file e le relative transazioni vengono salvate per la lavorazione.

3.2. Lista File

Visualizza l'elenco di tutti i file CBI caricati.

• Stato: Permette di vedere se è presente la "Data Trasmissione Seda" o è ancora in lavorazione.
• Selezione Multipla: È possibile selezionare più file tramite le checkbox per eseguire operazioni bulk.
• Colonna "Totale Contabilizzato": Mostra l'importo totale delle transazioni già esportate e il numero di estrazioni effettuate (tra parentesi).
• Righe verdi: I file evidenziati in verde sono completamente contabilizzati (tutte le transazioni lavorabili rendicontate e incluse in contabilità definitiva).

Selettore Righe per Pagina

Un selettore "Righe per pagina" è disponibile sia sopra che sotto la griglia. Valori selezionabili: 10, 25, 50 (default), 100, 200.

• Accanto al selettore superiore è mostrato il contatore totale dei file (es. "Totale: 142").
• Al cambio di selezione, la pagina si ricarica mantenendo i filtri attivi e riportando la navigazione alla prima pagina.

Azioni Singole

• Dettaglio: Accede alla pagina di lavorazione del file.
• Elimina: Rimuove il file e le transazioni associate (se non consolidato).
• Cont. Provvisorio: Apre un'anteprima del file contabile con possibilità di download senza impatti.
• Cont. Definitivo: Apre un'anteprima del file contabile con possibilità di conferma definitiva.
• Storico Estrazioni Contabili: Mostra tutte le estrazioni effettuate per il file (vedi Storico Estrazioni).

Azioni Bulk (su selezione multipla)

• Riepilogo: Visualizza un riepilogo aggregato dei file selezionati.
• Cont. Provvisorio: Apre un'anteprima del file contabile provvisorio aggregato.
• Cont. Definitivo: Apre un'anteprima del file contabile definitivo per tutti i file selezionati (non disponibile per file già trasmessi a SEDA).

3.3. Dettaglio e Riconciliazione

Nella pagina di dettaglio del file, l'operatore lavora sulle singole transazioni.

Filtri

La sezione filtri permette di ricercare rapidamente le transazioni desiderate:

• Data Contabile Da/A: Filtra per intervallo di date
• Importo Min/Max: Filtra per range di importo
• Stato: Mostra solo transazioni quadrate (verde) o non quadrate (rosso)
• Cerca in Causale: Ricerca testuale nella causale
• Rendicontabile: Filtra per transazioni rendicontabili/non rendicontabili
• Lavorabile: Filtra per transazioni lavorabili o escluse
  • Solo Lavorabili (default): Mostra solo le transazioni attive
  • Tutti: Mostra tutte le transazioni
  • Solo Non Lavorabili: Mostra solo le transazioni escluse

Tabella Transazioni

La tabella offre una visione immediata dello stato di ogni transazione:

• Indicatori Visivi:
  • Verde Chiaro: L'importo della transazione corrisponde esattamente al totale degli incassi agganciati nel sistema.
  • Rosso Chiaro: C'è una discrepanza tra l'importo della transazione e gli incassi trovati.
  • Grigio con testo barrato: Transazione marcata come "Non Lavorabile".
• Colonna "Lavorabile": Switch che indica se la transazione è lavorabile o esclusa.
• Colonna "Incassi Agganciati": Mostra il numero di pagamenti trovati e il loro importo totale (es. 3 / € 150,00).
• Colonna "Rend.": Mostra un badge "SI" verde se la transazione è stata marcata come "Rendicontabile".
• Colonna "Data Cont.": Indica la Data Contabile della transazione (data effettiva di ricezione fondi).
• Colonna "Data Pagamento": Se valorizzata, mostra la data effettiva di pagamento con icona calendario arancione (vedi Data Pagamento Diversa).

Nel pannello "Dettaglio incassi" il sistema espone i pagamenti del flusso con aggregazione coerente per comando e verbale, evitando errori di caricamento quando la stessa estrazione combina importi aggregati e riferimenti anagrafici del pagamento.

• Colonna "Già Contabilizzato": Badge Verde "Sì" se la transazione è stata inclusa in una contabilità definitiva (tooltip con data), Badge Grigio "No" altrimenti.

Gestione Transazioni Non Lavorabili

Le transazioni possono essere marcate come "Non Lavorabili" quando non sono pertinenti o devono essere escluse dalla lavorazione:

• Singola transazione: Utilizzare lo switch nella colonna "Lavorabile"
• Azioni Bulk: Selezionare più transazioni con le checkbox e usare i pulsanti:
  • Imposta Non Lavorabile: Esclude le transazioni selezionate
  • Imposta Lavorabile: Ripristina le transazioni escluse

Le transazioni non lavorabili:

• Rimangono nel database e non vengono eliminate
• Sono visualizzate con sfondo grigio e testo barrato
• Sono nascoste per default (filtro "Solo Lavorabili" attivo)
• Non vengono considerate nei conteggi e nei report

Menu Azioni (per singola transazione)

Cliccando sul pulsante "Actions" di una riga:

1. Edit: Modifica manuale dei dati della transazione (inclusa la Data Pagamento). Per i bonifici manuali, la scelta del Comune aggiorna subito la ricerca degli incassi candidati del verbale selezionato.
2. Aggancia Incassi: Avvia la procedura automatica per cercare e collegare i pagamenti nel sistema (basandosi sulla causale/URI).
3. Dettaglio Incassi: Apre una finestra con l'elenco dettagliato dei pagamenti agganciati (Ente, Comando, Data, Importo, Causale, IUV). Per i pagamenti rateali mostra anche la suddivisione Spese/Bolli/Sanzione.
4. Rendicontabile: Marca la transazione come verificata e pronta per la rendicontazione.

Quando l'operatore preme Salva nella modale di modifica:

1. il sistema salva i dati della transazione e l'eventuale collegamento manuale selezionato;
2. la modale si chiude automaticamente;
3. la pagina di dettaglio ricarica la riga aggiornata.

Se l'importo della transazione è superiore all'incasso originario selezionato, il sistema non perde l'eccedenza: la ripartisce con la logica standard dell'applicativo, coprendo prima Spese, poi Tariffa/Recupero e infine Sanzione. L'eventuale residuo finale resta nella quota Sanzione e continua a rientrare nelle somme da riversare all'ente.

Nel campo Importo della modale il sistema accetta la virgola decimale in formato italiano, ad esempio 63,10.

Per cambiare l'associazione di un incasso già salvato è sufficiente riaprire Edit, selezionare un altro incasso del verbale e premere di nuovo Salva.

Per rimuovere il collegamento manuale usare il pulsante Azzera collegamento manuale nella modale e poi salvare. Se la transazione è già Rendicontabile, occorre prima togliere quel flag dalla griglia di dettaglio e solo dopo azzerare il collegamento.

Se nel verbale esistono pagamenti precedenti nello storico Titano ma Financial non dispone ancora di una cache CBI per quel verbale, il sistema blocca il salvataggio del collegamento manuale. In questo caso l'operatore deve verificare prima la contabilizzazione pregressa del verbale e solo dopo ripetere l'associazione dell'incasso.

3.4. Data Pagamento Diversa da Data Accredito

In alcuni casi, la data effettiva del pagamento può essere diversa dalla data di accredito bancario (Data Valuta). Questo accade quando il contribuente paga il giorno X ma la banca accredita il giorno X+N.

In questi scenari il sistema non trova la corrispondenza automatica perché cerca con la data sbagliata.

Come Inserire la Data Pagamento

1. Dalla pagina Dettaglio File CBI, individuare la transazione problematica
2. Cliccare sul menu Actions → Edit
3. Nel campo "Data Pagamento" inserire la data effettiva del pagamento
4. Cliccare Salva

⚠️ Vincolo: La Data Pagamento deve essere minore o uguale alla Data Valuta.

Effetto sulla Ricerca Pagamenti

Parametro Query	Con Data Pagamento compilata	Con Data Pagamento vuota (standard)
PaymentDate	Data Pagamento inserita	Data Valuta
CreditDate	Data Valuta	Data Valuta

Effetto sulla Contabilità

Nella contabilità estratta, la Data Pagamento sarà sempre uguale alla Data Valuta (data accredito), indipendentemente dalla data inserita. La funzionalità serve solo per la ricerca nel repository pagamenti.

Flusso di Lavoro

1. L'operatore nota che una transazione non quadra (rosso)
2. Verifica nel sistema esterno la data effettiva del pagamento
3. Inserisce la Data Pagamento corretta in Edit
4. Riesegue "Aggancia Incassi" — il sistema ora trova correttamente i pagamenti
5. Marca la transazione come rendicontabile

3.5. Aggregazione Transazioni Parziali

Quando le transazioni CBI relative allo stesso flusso di riversamento arrivano in giorni diversi (transazioni parziali), è necessario aggregarle per distribuire correttamente i pagamenti.

Identificazione

Le transazioni parziali condividono lo stesso ID Flusso Riversamento (estratto dalla causale) ma hanno date contabili diverse. Il sistema le identifica automaticamente durante l'upload.

Creazione Aggregazione

1. Dalla pagina dettaglio di una transazione, cliccare su "Aggrega Transazioni"
2. Il sistema mostra le transazioni candidate con lo stesso ID Flusso
3. Selezionare le transazioni da aggregare (minimo 2)
4. Cliccare su "Crea Aggregazione"

Distribuzione Pagamenti

1. Cliccare su "Esegui Distribuzione" per avviare la distribuzione euristica automatica
2. Il sistema assegna i pagamenti alle transazioni basandosi su:
   • Corrispondenza importi
   • Prossimità delle date
3. Se gli importi non corrispondono, lo stato passa a "Con Errori"

Assegnazione Manuale

Quando la distribuzione automatica non riesce a quadrare gli importi:

1. Cliccare su "Assegnazione Manuale"
2. Selezionare il pagamento da assegnare
3. Scegliere la transazione di destinazione
4. Il pagamento erediterà la DataContabile e DataRiversamento dalla transazione selezionata

Finalizzazione e Sincronizzazione

Quando gli importi corrispondono:

1. Cliccare su "Finalizza e Sincronizza"
2. Il sistema aggiorna DataContabile e DataRiversamento su PaymentRepository
3. L'aggregazione diventa non modificabile (Completed)

In caso di errori durante la sincronizzazione, lo stato passa a "Sincronizzazione Fallita" o "Parzialmente Fallita" e viene mostrato il pulsante "Ritenta Sincronizzazione".

Stati dell'Aggregazione

Stato	Descrizione
Bozza	Aggregazione in fase di configurazione
Validata	Distribuzione completata, importi corrispondenti
Con Errori	Mismatch importi, richiede intervento manuale
Completata	Finalizzata e sincronizzata con successo
Sincronizzazione Fallita	Errori durante la sincronizzazione

Eliminazione Aggregazione

Le aggregazioni possono essere eliminate solo se non finalizzate:

1. Aprire il dettaglio dell'aggregazione → "Elimina" → Confermare
2. Le transazioni tornano allo stato standalone

3.6. Pagamenti Rateali (Determine)

Il sistema gestisce automaticamente la riconciliazione dei pagamenti rateali provenienti da determine (piani di ammortamento). Quando un pagamento non viene trovato con il percorso standard (per PaymentUID), il sistema attiva un algoritmo di fallback che:

1. Identifica la determina associata al pagamento
2. Recupera i verbali prodromici collegati alla determina
3. Distribuisce l'importo della rata sui verbali tramite un algoritmo waterfall

Algoritmo Waterfall

Ordinamento verbali: Data violazione crescente, poi ID verbale crescente (il verbale più vecchio viene coperto per primo).

Ordinamento pagamenti: Data pagamento crescente, poi PaymentUID crescente.

Per ogni pagamento:

1. Trova il primo verbale con residuo > 0
2. Copre prima le Spese residue (spese di notifica/procedura)
3. Poi copre i Bolli/Recupero tariffario residui
4. Il resto viene attribuito alla Sanzione (può eccedere l'importo originale per maggiorazioni/interessi)
5. Se tutti i verbali sono coperti, l'overflow va sull'ultimo verbale

Ricalcolo Cumulativo

L'algoritmo riesegue l'intero storico dei pagamenti della determina (non solo quelli del file CBI corrente). Questo garantisce attribuzioni consistenti anche quando le rate arrivano su file CBI diversi nel tempo.

Impatto per l'Operatore

Questa funzionalità è completamente automatica:

• L'operatore non deve intervenire manualmente
• Le transazioni CBI con pagamenti rateali vengono agganciate automaticamente
• Nel dettaglio incassi, i pagamenti mostrano la suddivisione tra Spese, Bolli e Sanzione per ogni verbale

---

4. Contabilità

4.1. Contabilità Provvisoria e Definitiva

Sia la Contabilità Provvisoria che la Definitiva utilizzano lo stesso flusso con anteprima:

1. Selezione: Utente seleziona uno o più file CBI dalla lista
2. Apertura Preview: Click su "Cont. Provvisorio" o "Cont. Definitivo"
3. Visualizzazione Anteprima:
   • Modal con header blu per Provvisorio, verde per Definitivo
   • Tabella con i dati che verranno inclusi nel file
   • Tab per vedere il contenuto raw del file
4. Download:
   • Provvisorio: Pulsante "Scarica Provvisorio" — scarica senza impatti sul sistema
   • Definitivo: Pulsante "Conferma Definitivo e Scarica" — richiede conferma, poi imposta le date e scarica

Nota: Le operazioni singole e bulk utilizzano la stessa logica interna. Il sistema usa le stesse API passando i file selezionati.

Effetti della Contabilità Definitiva

Quando viene confermato il download del file definitivo, il sistema:

1. Imposta la Data Trasmissione SEDA sul file CBI
2. Aggiorna la Data Trasmissione su tutti i pagamenti collegati alle transazioni rendicontabili
3. Ricarica la pagina per mostrare la data aggiornata nella griglia

Una volta trasmesso a SEDA, il file non può generare nuovamente il definitivo: il pulsante viene disabilitato con l'icona del lucchetto.

Estrazioni Incrementali

È possibile effettuare estrazioni contabili incrementali:

• Ogni estrazione include solo le transazioni rendicontabili non ancora esportate
• Se nuove transazioni vengono marcate come rendicontabili dopo una prima estrazione, una nuova estrazione includerà solo queste nuove righe
• Non c'è più un blocco dopo la prima estrazione definitiva

Avviso per File Già Trasmessi

Quando la selezione include file già trasmessi a SEDA:

• Viene visualizzato un avviso arancione nella parte superiore del modal
• L'avviso elenca i nomi dei file già trasmessi
• Il pulsante "Conferma Definitivo e Scarica" viene disabilitato
• L'utente deve rimuovere i file già trasmessi dalla selezione prima di procedere

4.2. Storico Estrazioni Contabili

La funzionalità Storico Estrazioni Contabili permette di tracciare e visualizzare tutte le estrazioni di contabilità definitiva effettuate per ogni file CBI.

Consultazione

1. Nella lista file CBI, cliccare sul menu azioni (⋮) del file desiderato
2. Selezionare "Storico Estrazioni Contabili"
3. Si aprirà una finestra con l'elenco di tutte le estrazioni effettuate

Informazioni Visualizzate

Per ogni estrazione vengono mostrate:

• Data/ora dell'estrazione
• Utente che ha effettuato l'estrazione
• Numero transazioni incluse
• Importo totale esportato
• Nome file generato (se disponibile)

Cliccando sull'intestazione di ogni estrazione, è possibile espandere il dettaglio con: elenco transazioni, importi, date contabili/valuta, data di trasferimento e pagamenti collegati.

Download e Anteprima File Archiviati

Per ogni estrazione contabile effettuata dopo il 18/12/2025, il sistema archivia una copia del file generato:

• Download: Scarica il file esattamente come generato al momento dell'estrazione.
• Anteprima: Mostra i dati contenuti nel file in formato tabellare, senza scaricare.

Nota: Per le estrazioni precedenti a questa data, verrà mostrato il messaggio "File non archiviato".

Flusso di Lavoro Tipico

1. Prima estrazione: L'operatore marca come rendicontabili le transazioni pronte e crea la contabilità definitiva
2. Lavorazione successiva: Nuove transazioni vengono lavorate e marcate come rendicontabili
3. Seconda estrazione: Una nuova contabilità definitiva include solo le nuove righe
4. Consultazione: È sempre possibile consultare lo storico per vedere cosa è stato esportato e quando

---

5. Ricerca Pagamenti Efil

5.1. Pagamenti Per Date

La pagina Efil > Pagamenti Per Date permette di cercare i pagamenti ricevuti in un determinato intervallo di date direttamente dal servizio Efil.

5.2. Filtri Lato Client (Subfiltro)

Poiché Efil non supporta filtri avanzati nella ricerca, è disponibile un pannello di subfiltro lato client che filtra i risultati già scaricati:

• Cliccare su "Mostra/Nascondi Subfiltro" per aprire il pannello
• Campi filtro disponibili:
  • IUV
  • Debitore
  • Codice Fiscale / P.IVA
  • Numero Avviso
  • Importo Min/Max
  • Causale
  • Servizio
  • Canale di Pagamento
  • ID Riscossione
  • ID Flusso
• Il filtraggio è in tempo reale mentre si digita
• Il contatore in alto mostra quanti record corrispondono ai filtri

5.3. Colorazione Righe

• Verde: Pagamento con ID Flusso Riversamento presente — è stato riversato.
• Rosso: Pagamento senza ID Flusso Riversamento — non risulta ancora riversato.

---

6. Gestione Verbali

6.1. Ricerca Verbali

Accesso

La pagina Ricerca Verbali è raggiungibile dal menu principale (icona ⚖️). L'accesso richiede il permesso Financial.RicercaVerbali.

Filtri di Ricerca

Filtro	Descrizione
Identificativo Atto	Codice ADI del verbale
Numero di Protocollo	Numero protocollo assegnato
Numero di Registro	Numero di registro
Targa	Targa del veicolo coinvolto
Codice Fiscale / P.IVA	CF o P.IVA del soggetto obbligato
Data Violazione Da/A	Intervallo di date della violazione
Stato Atto	Selezione multipla tra gli stati disponibili

Regola di validazione: Il filtro per Data Violazione e/o Stato Atto non può essere utilizzato da solo — è necessario specificare almeno un filtro testuale (Identificativo Atto, Protocollo, Registro, Targa o Codice Fiscale). Un avviso arancione ricorda questa regola.

Risultati

La griglia mostra le colonne: Comando, Comune, Identificativo Atto, Numero Protocollo, Numero Registro, Targa, Stato Atto, Causale Archiviazione, Dettagli Archiviazione, Causale Stand-By, Data Creazione, Importo Sanzione, Importo Spese, Importo Pagato, Data Validazione, Data Violazione, Data Ultima Spedizione.

Azioni su Singolo Verbale

Azione	Permesso Richiesto	Descrizione
Modifica Veicolo	ModificaVeicolo	Apre la modale per modificare targa e tipo veicolo
Storia Modifiche	—	Espande il dettaglio dei log di modifica sul verbale
Stampa Unione	StampaUnione	Apre la modale per generare un documento DOCX
Aggiungi alla Bag	—	Aggiunge il verbale alla Bag per operazioni multi-verbale

Nota: "Modifica Veicolo" è disponibile solo se il verbale è in uno stato modificabile.

Selezione Multipla e Azioni Bulk

La griglia supporta la selezione tramite checkbox (incluso "Seleziona Tutti"). La barra azioni bulk offre:

• Stampa Unione: genera un documento per tutti i verbali selezionati
• Aggiungi alla Bag: aggiunge tutti i verbali selezionati alla Bag

La Bag

La Bag è un contenitore temporaneo (lato client) che consente di accumulare verbali da ricerche diverse per poi operare su tutti contemporaneamente.

1. Aggiungere verbali alla Bag usando il menu singolo o la selezione multipla
2. Il pulsante "Bag" in alto a destra mostra il badge con il conteggio
3. Cliccando su "Bag" si apre/chiude il pannello con i verbali inseriti
4. Dalla Bag è possibile:
   • Stampa Unione da Bag: genera un documento per tutti i verbali nella Bag
   • Svuota: rimuove tutti i verbali dalla Bag
   • Rimuovi singolo: rimuove un verbale specifico

Nota: La Bag persiste durante la sessione del browser (localStorage) ma non è condivisa tra utenti o dispositivi.

6.2. Modifica Veicolo

Scopo

Permette di correggere targa e/o tipo veicolo su un verbale direttamente dal sistema Financial, senza dover accedere al sistema Titano.

Accesso

Dalla pagina Ricerca Verbali, menu azioni → "Modifica Veicolo". Richiede il permesso Financial.RicercaVerbali.ModificaVeicolo.

La Modale di Modifica

La modale presenta:

• L'Identificativo Atto del verbale in sola lettura
• I dati attuali del veicolo (targa e tipo veicolo correnti)
• Il campo Targa per inserire la nuova targa (conversione automatica in maiuscolo)
• Il campo Tipo Veicolo con selettore a tendina con tutte le tipologie disponibili

Validazioni

• Almeno uno dei due campi deve essere compilato
• La targa viene validata tramite ItalianToolkit (deve corrispondere a un formato targa riconosciuto)
• Se la validazione non supera, viene mostrato un errore "Targa non valida"

Tracciamento Modifiche

Ogni modifica viene registrata con: data/ora, utente, valori precedenti e nuovi. La Storia Modifiche è consultabile dal menu azioni → "Storia Modifiche" direttamente nella griglia.

6.3. Stampa Unione (Generazione Documenti)

Introduzione

La funzionalità Stampa Unione genera documenti DOCX personalizzati partendo da un template Word e dai dati dei verbali selezionati. Il sistema sostituisce automaticamente i placeholder nel template con i dati reali.

Accesso

• Singolo verbale: menu azioni → "Stampa Unione"
• Selezione multipla: barra bulk → "Stampa Unione"
• Dalla Bag: pulsante "Stampa Unione da Bag"

Richiede il permesso Financial.RicercaVerbali.StampaUnione.

Flusso di Lavoro

1. Selezione verbali: selezionare uno o più verbali
2. Apertura modale: la modale mostra le figure coinvolte per ogni verbale
3. Selezione figure: spuntare/deselezionare le figure da includere nel documento
4. Scelta template: scegliere un template salvato a sistema oppure caricare un file .docx
5. Generazione: cliccare "Genera Documento" per scaricare il DOCX finale

Figure Coinvolte

Per ogni verbale, la modale elenca le figure coinvolte (proprietario, obbligato in solido, conducente, ecc.) con:

• Tipo di figura (badge colorato)
• Nome/Cognome o Ragione Sociale
• Codice Fiscale

L'utente può deselezionare figure che non devono comparire nel documento generato.

Template

Template Salvati a Sistema: salvati centralmente per essere riutilizzati da tutti gli operatori. Per eliminare un template: selezionarlo e cliccare l'icona cestino (richiede permesso GestioneTemplate).

Upload Template: È possibile caricare un file .docx per un uso estemporaneo. Dopo il caricamento, è possibile salvarlo a sistema per riutilizzi futuri (pulsante "Salva Template").

Template di Esempio: Scaricabile dalla modale cliccando "Scarica Template Esempio".

Placeholder Disponibili

Il template utilizza la sintassi Handlebars. Nella modale sono consultabili tre sezioni espandibili:

Sezione	Contenuto
Campi Disponibili	Placeholder singoli (es. {{adi_code}}, {{vehicle_plate}}, {{sanction_amount}})
Liste (Soggetti)	Elenchi iterabili con {{#each ...}} (es. figure coinvolte, pagamenti, spedizioni)
Helpers Disponibili	Funzioni di formattazione (date, valute, condizionali)

Esempio di uso in testo:

Spett.le {{#each soggetti}}{{this.surname}} {{this.name}}{{/each}}

Verbale n. {{adi_code}} del {{format_date violation_date "dd/MM/yyyy"}}
Importo sanzione: {{format_currency sanction_amount}}

Tabelle dinamiche:

{{|| soggetti h=1}}
| {{surname}} | {{name}} | {{tax_code}} |
{{/ soggetti}}

Campi con Calcolo Importi per Scadenza

Il sistema calcola automaticamente i totali dovuti in base alla tempistica di pagamento:

Campo	Descrizione
total_5_days	Importo totale dovuto se pagato entro 5 giorni
total_60_days	Importo totale dovuto se pagato entro 60 giorni
total_over_60_days	Importo totale dovuto se pagato oltre 60 giorni

---

7. Chat e Comunicazioni

Il sistema include un modulo di chat integrato per la comunicazione tra gli utenti.

• Messaggi: Invio e ricezione di messaggi testuali.
• Allegati: Possibilità di scambiare file.
• Notifiche: Conteggio dei messaggi non letti.

---

8. Attività di Sistema

Sezione di audit e monitoraggio che registra le operazioni principali effettuate nel sistema (es. caricamento file, modifiche dati), utile per tracciare la storia delle attività.

---

9. Domande Frequenti

Riconciliazione e Data Pagamento

D: Devo sempre compilare la Data Pagamento? R: No, solo quando la data effettiva del pagamento è diversa dalla Data Valuta e il sistema non trova automaticamente i pagamenti.

D: Posso inserire una Data Pagamento successiva alla Data Valuta? R: No, il sistema non lo permette. La data di pagamento deve sempre essere precedente o uguale alla data di accredito.

D: La Data Pagamento viene usata per la contabilità? R: No, nella contabilità viene sempre usata la Data Valuta. La Data Pagamento serve solo per la ricerca dei pagamenti.

Contabilità

D: Posso riestrarre un file già trasmesso a SEDA? R: No, una volta che un file è stato trasmesso a SEDA non è possibile generare nuovamente il definitivo. Il pulsante viene disabilitato.

D: Come funzionano le estrazioni incrementali? R: Ogni estrazione include solo le transazioni rendicontabili non ancora esportate. Si possono effettuare più estrazioni successive sullo stesso file CBI.

Verbali

D: Perché non vedo il pulsante "Modifica Veicolo"? R: Il pulsante appare solo se l'utente ha il permesso ModificaVeicolo e il verbale è in uno stato che ne consente la modifica.

D: La Bag si perde se chiudo il browser? R: La Bag è salvata nel localStorage del browser. Resta disponibile finché non si svuota manualmente o non si cancellano i dati del sito.

---

Documento aggiornato al 20/04/2026

Manuale Utente - Safety21 Financial

Benvenuti nel manuale utente dell'applicativo Safety21 Financial. Questo documento descrive tutte le funzionalità disponibili per la gestione dei flussi finanziari, della riconciliazione incassi, della gestione verbali e delle comunicazioni interne.

Indice

1. Accesso e Home Page
2. Gestione Enti Creditori
3. Gestione Flussi CBI
   • Caricamento File
   • Lista File
   • Dettaglio e Riconciliazione
   • Data Pagamento Diversa da Data Accredito
   • Aggregazione Transazioni Parziali
   • Pagamenti Rateali (Determine)
4. Contabilità
   • Contabilità Provvisoria e Definitiva
   • Storico Estrazioni Contabili
5. Ricerca Pagamenti Efil
6. Gestione Verbali
   • Ricerca Verbali
   • Modifica Veicolo
   • Stampa Unione (Generazione Documenti)
7. Chat e Comunicazioni
8. Attività di Sistema
9. Domande Frequenti

---

1. Accesso e Home Page

Dopo aver effettuato il login con le proprie credenziali, l'utente accede alla Home Page. La pagina presenta un video di sfondo istituzionale e un menu di navigazione principale per accedere alle diverse sezioni dell'applicativo.

---

2. Gestione Enti Creditori

Questa sezione permette di gestire l'anagrafica degli Enti Creditori censiti nel sistema.

• Visualizzazione: Elenco paginato degli enti con possibilità di filtro.
• Creazione/Modifica: È possibile aggiungere nuovi enti o modificare quelli esistenti inserendo dati come:
  • Codice Ente
  • Denominazione
  • Codice Ufficio / Tipo Ufficio
  • Codice Catastale Comune
  • Ufficio Pagatore
• Importazione: Funzionalità per importare massivamente gli enti da file esterni (se supportato).

---

3. Gestione Flussi CBI

Il cuore dell'applicativo è la gestione dei flussi CBI per la riconciliazione degli incassi.

3.1. Caricamento File

L'utente può caricare nuovi file CBI nel sistema.

• Il sistema analizza il contenuto del file, estrae l'header, il footer e le singole transazioni.
• Viene creato un record per il file e le relative transazioni vengono salvate per la lavorazione.

3.2. Lista File

Visualizza l'elenco di tutti i file CBI caricati.

• Stato: Permette di vedere se è presente la "Data Trasmissione Seda" o è ancora in lavorazione.
• Selezione Multipla: È possibile selezionare più file tramite le checkbox per eseguire operazioni bulk.
• Colonna "Totale Contabilizzato": Mostra l'importo totale delle transazioni già esportate e il numero di estrazioni effettuate (tra parentesi).
• Righe verdi: I file evidenziati in verde sono completamente contabilizzati (tutte le transazioni lavorabili rendicontate e incluse in contabilità definitiva).

Selettore Righe per Pagina

Un selettore "Righe per pagina" è disponibile sia sopra che sotto la griglia. Valori selezionabili: 10, 25, 50 (default), 100, 200.

• Accanto al selettore superiore è mostrato il contatore totale dei file (es. "Totale: 142").
• Al cambio di selezione, la pagina si ricarica mantenendo i filtri attivi e riportando la navigazione alla prima pagina.

Azioni Singole

• Dettaglio: Accede alla pagina di lavorazione del file.
• Elimina: Rimuove il file e le transazioni associate (se non consolidato).
• Cont. Provvisorio: Apre un'anteprima del file contabile con possibilità di download senza impatti.
• Cont. Definitivo: Apre un'anteprima del file contabile con possibilità di conferma definitiva.
• Storico Estrazioni Contabili: Mostra tutte le estrazioni effettuate per il file (vedi Storico Estrazioni).

Azioni Bulk (su selezione multipla)

• Riepilogo: Visualizza un riepilogo aggregato dei file selezionati.
• Cont. Provvisorio: Apre un'anteprima del file contabile provvisorio aggregato.
• Cont. Definitivo: Apre un'anteprima del file contabile definitivo per tutti i file selezionati (non disponibile per file già trasmessi a SEDA).

3.3. Dettaglio e Riconciliazione

Nella pagina di dettaglio del file, l'operatore lavora sulle singole transazioni.

Filtri

La sezione filtri permette di ricercare rapidamente le transazioni desiderate:

• Data Contabile Da/A: Filtra per intervallo di date
• Importo Min/Max: Filtra per range di importo
• Stato: Mostra solo transazioni quadrate (verde) o non quadrate (rosso)
• Cerca in Causale: Ricerca testuale nella causale
• Rendicontabile: Filtra per transazioni rendicontabili/non rendicontabili
• Lavorabile: Filtra per transazioni lavorabili o escluse
  • Solo Lavorabili (default): Mostra solo le transazioni attive
  • Tutti: Mostra tutte le transazioni
  • Solo Non Lavorabili: Mostra solo le transazioni escluse

Tabella Transazioni

La tabella offre una visione immediata dello stato di ogni transazione:

• Indicatori Visivi:
  • Verde Chiaro: L'importo della transazione corrisponde esattamente al totale degli incassi agganciati nel sistema.
  • Rosso Chiaro: C'è una discrepanza tra l'importo della transazione e gli incassi trovati.
  • Grigio con testo barrato: Transazione marcata come "Non Lavorabile".
• Colonna "Lavorabile": Switch che indica se la transazione è lavorabile o esclusa.
• Colonna "Incassi Agganciati": Mostra il numero di pagamenti trovati e il loro importo totale (es. 3 / € 150,00).
• Colonna "Rend.": Mostra un badge "SI" verde se la transazione è stata marcata come "Rendicontabile".
• Colonna "Data Cont.": Indica la Data Contabile della transazione (data effettiva di ricezione fondi).
• Colonna "Data Pagamento": Se valorizzata, mostra la data effettiva di pagamento con icona calendario arancione (vedi Data Pagamento Diversa).
• Colonna "Già Contabilizzato": Badge Verde "Sì" se la transazione è stata inclusa in una contabilità definitiva (tooltip con data), Badge Grigio "No" altrimenti.

Gestione Transazioni Non Lavorabili

Le transazioni possono essere marcate come "Non Lavorabili" quando non sono pertinenti o devono essere escluse dalla lavorazione:

• Singola transazione: Utilizzare lo switch nella colonna "Lavorabile"
• Azioni Bulk: Selezionare più transazioni con le checkbox e usare i pulsanti:
  • Imposta Non Lavorabile: Esclude le transazioni selezionate
  • Imposta Lavorabile: Ripristina le transazioni escluse

Le transazioni non lavorabili:

• Rimangono nel database e non vengono eliminate
• Sono visualizzate con sfondo grigio e testo barrato
• Sono nascoste per default (filtro "Solo Lavorabili" attivo)
• Non vengono considerate nei conteggi e nei report

Menu Azioni (per singola transazione)

Cliccando sul pulsante "Actions" di una riga:

1. Edit: Modifica manuale dei dati della transazione (inclusa la Data Pagamento). Per i bonifici manuali, la scelta del Comune aggiorna subito la ricerca degli incassi candidati del verbale selezionato.
2. Aggancia Incassi: Avvia la procedura automatica per cercare e collegare i pagamenti nel sistema (basandosi sulla causale/URI).
3. Dettaglio Incassi: Apre una finestra con l'elenco dettagliato dei pagamenti agganciati (Ente, Comando, Data, Importo, Causale, IUV). Per i pagamenti rateali mostra anche la suddivisione Spese/Bolli/Sanzione.
4. Rendicontabile: Marca la transazione come verificata e pronta per la rendicontazione.

Quando l'operatore preme Salva nella modale di modifica:

1. il sistema salva i dati della transazione e l'eventuale collegamento manuale selezionato;
2. la modale si chiude automaticamente;
3. la pagina di dettaglio ricarica la riga aggiornata.

Per cambiare l'associazione di un incasso già salvato è sufficiente riaprire Edit, selezionare un altro incasso del verbale e premere di nuovo Salva.

Per rimuovere il collegamento manuale usare il pulsante Azzera collegamento manuale nella modale e poi salvare. Se la transazione è già Rendicontabile, occorre prima togliere quel flag dalla griglia di dettaglio e solo dopo azzerare il collegamento.

3.4. Data Pagamento Diversa da Data Accredito

In alcuni casi, la data effettiva del pagamento può essere diversa dalla data di accredito bancario (Data Valuta). Questo accade quando il contribuente paga il giorno X ma la banca accredita il giorno X+N.

In questi scenari il sistema non trova la corrispondenza automatica perché cerca con la data sbagliata.

Come Inserire la Data Pagamento

1. Dalla pagina Dettaglio File CBI, individuare la transazione problematica
2. Cliccare sul menu Actions → Edit
3. Nel campo "Data Pagamento" inserire la data effettiva del pagamento
4. Cliccare Salva

⚠️ Vincolo: La Data Pagamento deve essere minore o uguale alla Data Valuta.

Effetto sulla Ricerca Pagamenti

Parametro Query	Con Data Pagamento compilata	Con Data Pagamento vuota (standard)
PaymentDate	Data Pagamento inserita	Data Valuta
CreditDate	Data Valuta	Data Valuta

Effetto sulla Contabilità

Nella contabilità estratta, la Data Pagamento sarà sempre uguale alla Data Valuta (data accredito), indipendentemente dalla data inserita. La funzionalità serve solo per la ricerca nel repository pagamenti.

Flusso di Lavoro

1. L'operatore nota che una transazione non quadra (rosso)
2. Verifica nel sistema esterno la data effettiva del pagamento
3. Inserisce la Data Pagamento corretta in Edit
4. Riesegue "Aggancia Incassi" — il sistema ora trova correttamente i pagamenti
5. Marca la transazione come rendicontabile

3.5. Aggregazione Transazioni Parziali

Quando le transazioni CBI relative allo stesso flusso di riversamento arrivano in giorni diversi (transazioni parziali), è necessario aggregarle per distribuire correttamente i pagamenti.

Identificazione

Le transazioni parziali condividono lo stesso ID Flusso Riversamento (estratto dalla causale) ma hanno date contabili diverse. Il sistema le identifica automaticamente durante l'upload.

Creazione Aggregazione

1. Dalla pagina dettaglio di una transazione, cliccare su "Aggrega Transazioni"
2. Il sistema mostra le transazioni candidate con lo stesso ID Flusso
3. Selezionare le transazioni da aggregare (minimo 2)
4. Cliccare su "Crea Aggregazione"

Distribuzione Pagamenti

1. Cliccare su "Esegui Distribuzione" per avviare la distribuzione euristica automatica
2. Il sistema assegna i pagamenti alle transazioni basandosi su:
   • Corrispondenza importi
   • Prossimità delle date
3. Se gli importi non corrispondono, lo stato passa a "Con Errori"

Assegnazione Manuale

Quando la distribuzione automatica non riesce a quadrare gli importi:

1. Cliccare su "Assegnazione Manuale"
2. Selezionare il pagamento da assegnare
3. Scegliere la transazione di destinazione
4. Il pagamento erediterà la DataContabile e DataRiversamento dalla transazione selezionata

Finalizzazione e Sincronizzazione

Quando gli importi corrispondono:

1. Cliccare su "Finalizza e Sincronizza"
2. Il sistema aggiorna DataContabile e DataRiversamento su PaymentRepository
3. L'aggregazione diventa non modificabile (Completed)

In caso di errori durante la sincronizzazione, lo stato passa a "Sincronizzazione Fallita" o "Parzialmente Fallita" e viene mostrato il pulsante "Ritenta Sincronizzazione".

Stati dell'Aggregazione

Stato	Descrizione
Bozza	Aggregazione in fase di configurazione
Validata	Distribuzione completata, importi corrispondenti
Con Errori	Mismatch importi, richiede intervento manuale
Completata	Finalizzata e sincronizzata con successo
Sincronizzazione Fallita	Errori durante la sincronizzazione

Eliminazione Aggregazione

Le aggregazioni possono essere eliminate solo se non finalizzate:

1. Aprire il dettaglio dell'aggregazione → "Elimina" → Confermare
2. Le transazioni tornano allo stato standalone

3.6. Pagamenti Rateali (Determine)

Il sistema gestisce automaticamente la riconciliazione dei pagamenti rateali provenienti da determine (piani di ammortamento). Quando un pagamento non viene trovato con il percorso standard (per PaymentUID), il sistema attiva un algoritmo di fallback che:

1. Identifica la determina associata al pagamento
2. Recupera i verbali prodromici collegati alla determina
3. Distribuisce l'importo della rata sui verbali tramite un algoritmo waterfall

Algoritmo Waterfall

Ordinamento verbali: Data violazione crescente, poi ID verbale crescente (il verbale più vecchio viene coperto per primo).

Ordinamento pagamenti: Data pagamento crescente, poi PaymentUID crescente.

Per ogni pagamento:

1. Trova il primo verbale con residuo > 0
2. Copre prima le Spese residue (spese di notifica/procedura)
3. Poi copre i Bolli/Recupero tariffario residui
4. Il resto viene attribuito alla Sanzione (può eccedere l'importo originale per maggiorazioni/interessi)
5. Se tutti i verbali sono coperti, l'overflow va sull'ultimo verbale

Ricalcolo Cumulativo

L'algoritmo riesegue l'intero storico dei pagamenti della determina (non solo quelli del file CBI corrente). Questo garantisce attribuzioni consistenti anche quando le rate arrivano su file CBI diversi nel tempo.

Impatto per l'Operatore

Questa funzionalità è completamente automatica:

• L'operatore non deve intervenire manualmente
• Le transazioni CBI con pagamenti rateali vengono agganciate automaticamente
• Nel dettaglio incassi, i pagamenti mostrano la suddivisione tra Spese, Bolli e Sanzione per ogni verbale

---

4. Contabilità

4.1. Contabilità Provvisoria e Definitiva

Sia la Contabilità Provvisoria che la Definitiva utilizzano lo stesso flusso con anteprima:

1. Selezione: Utente seleziona uno o più file CBI dalla lista
2. Apertura Preview: Click su "Cont. Provvisorio" o "Cont. Definitivo"
3. Visualizzazione Anteprima:
   • Modal con header blu per Provvisorio, verde per Definitivo
   • Tabella con i dati che verranno inclusi nel file
   • Tab per vedere il contenuto raw del file
4. Download:
   • Provvisorio: Pulsante "Scarica Provvisorio" — scarica senza impatti sul sistema
   • Definitivo: Pulsante "Conferma Definitivo e Scarica" — richiede conferma, poi imposta le date e scarica

Nota tecnica: Le operazioni singole e bulk utilizzano la stessa logica interna. Il sistema usa le stesse API passando i file selezionati.

Effetti della Contabilità Definitiva

Quando viene confermato il download del file definitivo, il sistema:

1. Imposta la Data Trasmissione SEDA sul file CBI
2. Aggiorna la Data Trasmissione su tutti i pagamenti collegati alle transazioni rendicontabili
3. Ricarica la pagina per mostrare la data aggiornata nella griglia

Una volta trasmesso a SEDA, il file non può generare nuovamente il definitivo: il pulsante viene disabilitato con l'icona del lucchetto.

Estrazioni Incrementali

È possibile effettuare estrazioni contabili incrementali:

• Ogni estrazione include solo le transazioni rendicontabili non ancora esportate
• Se nuove transazioni vengono marcate come rendicontabili dopo una prima estrazione, una nuova estrazione includerà solo queste nuove righe
• Non c'è più un blocco dopo la prima estrazione definitiva

Avviso per File Già Trasmessi

Quando la selezione include file già trasmessi a SEDA:

• Viene visualizzato un avviso arancione nella parte superiore del modal
• L'avviso elenca i nomi dei file già trasmessi
• Il pulsante "Conferma Definitivo e Scarica" viene disabilitato
• L'utente deve rimuovere i file già trasmessi dalla selezione prima di procedere

4.2. Storico Estrazioni Contabili

La funzionalità Storico Estrazioni Contabili permette di tracciare e visualizzare tutte le estrazioni di contabilità definitiva effettuate per ogni file CBI.

Consultazione

1. Nella lista file CBI, cliccare sul menu azioni (⋮) del file desiderato
2. Selezionare "Storico Estrazioni Contabili"
3. Si aprirà una finestra con l'elenco di tutte le estrazioni effettuate

Informazioni Visualizzate

Per ogni estrazione vengono mostrate:

• Data/ora dell'estrazione
• Utente che ha effettuato l'estrazione
• Numero transazioni incluse
• Importo totale esportato
• Nome file generato (se disponibile)

Cliccando sull'intestazione di ogni estrazione, è possibile espandere il dettaglio con: elenco transazioni, importi, date contabili/valuta, data di trasferimento e pagamenti collegati.

Download e Anteprima File Archiviati

Per ogni estrazione contabile effettuata dopo il 18/12/2025, il sistema archivia una copia del file generato:

• Download: Scarica il file esattamente come generato al momento dell'estrazione.
• Anteprima: Mostra i dati contenuti nel file in formato tabellare, senza scaricare.

Nota: Per le estrazioni precedenti a questa data, verrà mostrato il messaggio "File non archiviato".

Flusso di Lavoro Tipico

1. Prima estrazione: L'operatore marca come rendicontabili le transazioni pronte e crea la contabilità definitiva
2. Lavorazione successiva: Nuove transazioni vengono lavorate e marcate come rendicontabili
3. Seconda estrazione: Una nuova contabilità definitiva include solo le nuove righe
4. Consultazione: È sempre possibile consultare lo storico per vedere cosa è stato esportato e quando

---

5. Ricerca Pagamenti Efil

5.1. Pagamenti Per Date

La pagina Efil > Pagamenti Per Date permette di cercare i pagamenti ricevuti in un determinato intervallo di date direttamente dal servizio Efil.

5.2. Filtri Lato Client (Subfiltro)

Poiché Efil non supporta filtri avanzati nella ricerca, è disponibile un pannello di subfiltro lato client che filtra i risultati già scaricati:

• Cliccare su "Mostra/Nascondi Subfiltro" per aprire il pannello
• Campi filtro disponibili:
  • IUV
  • Debitore
  • Codice Fiscale / P.IVA
  • Numero Avviso
  • Importo Min/Max
  • Causale
  • Servizio
  • Canale di Pagamento
  • ID Riscossione
  • ID Flusso
• Il filtraggio è in tempo reale mentre si digita
• Il contatore in alto mostra quanti record corrispondono ai filtri

5.3. Colorazione Righe

• Verde: Pagamento con ID Flusso Riversamento presente — è stato riversato.
• Rosso: Pagamento senza ID Flusso Riversamento — non risulta ancora riversato.

---

6. Gestione Verbali

6.1. Ricerca Verbali

Accesso

La pagina Ricerca Verbali è raggiungibile dal menu principale (icona ⚖️). L'accesso richiede il permesso Financial.RicercaVerbali.

Filtri di Ricerca

Filtro	Descrizione
Identificativo Atto	Codice ADI del verbale
Numero di Protocollo	Numero protocollo assegnato
Numero di Registro	Numero di registro
Targa	Targa del veicolo coinvolto
Codice Fiscale / P.IVA	CF o P.IVA del soggetto obbligato
Data Violazione Da/A	Intervallo di date della violazione
Stato Atto	Selezione multipla tra gli stati disponibili

Regola di validazione: Il filtro per Data Violazione e/o Stato Atto non può essere utilizzato da solo — è necessario specificare almeno un filtro testuale (Identificativo Atto, Protocollo, Registro, Targa o Codice Fiscale). Un avviso arancione ricorda questa regola.

Risultati

La griglia mostra le colonne: Comando, Comune, Identificativo Atto, Numero Protocollo, Numero Registro, Targa, Stato Atto, Causale Archiviazione, Dettagli Archiviazione, Causale Stand-By, Data Creazione, Importo Sanzione, Importo Spese, Importo Pagato, Data Validazione, Data Violazione, Data Ultima Spedizione.

Azioni su Singolo Verbale

Azione	Permesso Richiesto	Descrizione
Modifica Veicolo	ModificaVeicolo	Apre la modale per modificare targa e tipo veicolo
Storia Modifiche	—	Espande il dettaglio dei log di modifica sul verbale
Stampa Unione	StampaUnione	Apre la modale per generare un documento DOCX
Aggiungi alla Bag	—	Aggiunge il verbale alla Bag per operazioni multi-verbale

Nota: "Modifica Veicolo" è disponibile solo se il verbale è in uno stato modificabile.

Selezione Multipla e Azioni Bulk

La griglia supporta la selezione tramite checkbox (incluso "Seleziona Tutti"). La barra azioni bulk offre:

• Stampa Unione: genera un documento per tutti i verbali selezionati
• Aggiungi alla Bag: aggiunge tutti i verbali selezionati alla Bag

La Bag

La Bag è un contenitore temporaneo (lato client) che consente di accumulare verbali da ricerche diverse per poi operare su tutti contemporaneamente.

1. Aggiungere verbali alla Bag usando il menu singolo o la selezione multipla
2. Il pulsante "Bag" in alto a destra mostra il badge con il conteggio
3. Cliccando su "Bag" si apre/chiude il pannello con i verbali inseriti
4. Dalla Bag è possibile:
   • Stampa Unione da Bag: genera un documento per tutti i verbali nella Bag
   • Svuota: rimuove tutti i verbali dalla Bag
   • Rimuovi singolo: rimuove un verbale specifico

Nota: La Bag persiste durante la sessione del browser (localStorage) ma non è condivisa tra utenti o dispositivi.

6.2. Modifica Veicolo

Scopo

Permette di correggere targa e/o tipo veicolo su un verbale direttamente dal sistema Financial, senza dover accedere al sistema Titano.

Accesso

Dalla pagina Ricerca Verbali, menu azioni → "Modifica Veicolo". Richiede il permesso Financial.RicercaVerbali.ModificaVeicolo.

La Modale di Modifica

La modale presenta:

• L'Identificativo Atto del verbale in sola lettura
• I dati attuali del veicolo (targa e tipo veicolo correnti)
• Il campo Targa per inserire la nuova targa (conversione automatica in maiuscolo)
• Il campo Tipo Veicolo con selettore a tendina con tutte le tipologie disponibili

Validazioni

• Almeno uno dei due campi deve essere compilato
• La targa viene validata tramite ItalianToolkit (deve corrispondere a un formato targa riconosciuto)
• Se la validazione non supera, viene mostrato un errore "Targa non valida"

Tracciamento Modifiche

Ogni modifica viene registrata con: data/ora, utente, valori precedenti e nuovi. La Storia Modifiche è consultabile dal menu azioni → "Storia Modifiche" direttamente nella griglia.

6.3. Stampa Unione (Generazione Documenti)

Introduzione

La funzionalità Stampa Unione genera documenti DOCX personalizzati partendo da un template Word e dai dati dei verbali selezionati. Il sistema sostituisce automaticamente i placeholder nel template con i dati reali.

Accesso

• Singolo verbale: menu azioni → "Stampa Unione"
• Selezione multipla: barra bulk → "Stampa Unione"
• Dalla Bag: pulsante "Stampa Unione da Bag"

Richiede il permesso Financial.RicercaVerbali.StampaUnione.

Flusso di Lavoro

1. Selezione verbali: selezionare uno o più verbali
2. Apertura modale: la modale mostra le figure coinvolte per ogni verbale
3. Selezione figure: spuntare/deselezionare le figure da includere nel documento
4. Scelta template: scegliere un template salvato a sistema oppure caricare un file .docx
5. Generazione: cliccare "Genera Documento" per scaricare il DOCX finale

Figure Coinvolte

Per ogni verbale, la modale elenca le figure coinvolte (proprietario, obbligato in solido, conducente, ecc.) con:

• Tipo di figura (badge colorato)
• Nome/Cognome o Ragione Sociale
• Codice Fiscale

L'utente può deselezionare figure che non devono comparire nel documento generato.

Template

Template Salvati a Sistema: salvati centralmente per essere riutilizzati da tutti gli operatori. Per eliminare un template: selezionarlo e cliccare l'icona cestino (richiede permesso GestioneTemplate).

Upload Template: È possibile caricare un file .docx per un uso estemporaneo. Dopo il caricamento, è possibile salvarlo a sistema per riutilizzi futuri (pulsante "Salva Template").

Template di Esempio: Scaricabile dalla modale cliccando "Scarica Template Esempio".

Placeholder Disponibili

Il template utilizza la sintassi Handlebars. Nella modale sono consultabili tre sezioni espandibili:

Sezione	Contenuto
Campi Disponibili	Placeholder singoli (es. {{adi_code}}, {{vehicle_plate}}, {{sanction_amount}})
Liste (Soggetti)	Elenchi iterabili con {{#each ...}} (es. figure coinvolte, pagamenti, spedizioni)
Helpers Disponibili	Funzioni di formattazione (date, valute, condizionali)

Esempio di uso in testo:

Spett.le {{#each soggetti}}{{this.surname}} {{this.name}}{{/each}}

Verbale n. {{adi_code}} del {{format_date violation_date "dd/MM/yyyy"}}
Importo sanzione: {{format_currency sanction_amount}}

Tabelle dinamiche:

{{|| soggetti h=1}}
| {{surname}} | {{name}} | {{tax_code}} |
{{/ soggetti}}

Campi con Calcolo Importi per Scadenza

Il sistema calcola automaticamente i totali dovuti in base alla tempistica di pagamento:

Campo	Descrizione
total_5_days	Importo totale dovuto se pagato entro 5 giorni
total_60_days	Importo totale dovuto se pagato entro 60 giorni
total_over_60_days	Importo totale dovuto se pagato oltre 60 giorni

---

7. Chat e Comunicazioni

Il sistema include un modulo di chat integrato per la comunicazione tra gli utenti.

• Messaggi: Invio e ricezione di messaggi testuali.
• Allegati: Possibilità di scambiare file.
• Notifiche: Conteggio dei messaggi non letti.

---

8. Attività di Sistema

Sezione di audit e monitoraggio che registra le operazioni principali effettuate nel sistema (es. caricamento file, modifiche dati), utile per tracciare la storia delle attività.

---

9. Domande Frequenti

Riconciliazione e Data Pagamento

D: Devo sempre compilare la Data Pagamento? R: No, solo quando la data effettiva del pagamento è diversa dalla Data Valuta e il sistema non trova automaticamente i pagamenti.

D: Posso inserire una Data Pagamento successiva alla Data Valuta? R: No, il sistema non lo permette. La data di pagamento deve sempre essere precedente o uguale alla data di accredito.

D: La Data Pagamento viene usata per la contabilità? R: No, nella contabilità viene sempre usata la Data Valuta. La Data Pagamento serve solo per la ricerca dei pagamenti.

Contabilità

D: Posso riestrarre un file già trasmesso a SEDA? R: No, una volta che un file è stato trasmesso a SEDA non è possibile generare nuovamente il definitivo. Il pulsante viene disabilitato.

D: Come funzionano le estrazioni incrementali? R: Ogni estrazione include solo le transazioni rendicontabili non ancora esportate. Si possono effettuare più estrazioni successive sullo stesso file CBI.

Verbali

D: Perché non vedo il pulsante "Modifica Veicolo"? R: Il pulsante appare solo se l'utente ha il permesso ModificaVeicolo e il verbale è in uno stato che ne consente la modifica.

D: La Bag si perde se chiudo il browser? R: La Bag è salvata nel localStorage del browser. Resta disponibile finché non si svuota manualmente o non si cancellano i dati del sito.

---

Documento aggiornato al 20/04/2026

Manuale Utente - Safety21 Financial

Benvenuti nel manuale utente dell'applicativo Safety21 Financial. Questo documento descrive tutte le funzionalità disponibili per la gestione dei flussi finanziari, degli enti creditori e delle comunicazioni interne.

Indice

1. Accesso e Home Page
2. Gestione Enti Creditori
3. Gestione Flussi CBI
   • Caricamento File
   • Lista File
   • Dettaglio e Riconciliazione
4. Chat e Comunicazioni
5. Attività di Sistema
6. Aggregazione Transazioni Parziali
7. Storico Estrazioni Contabili
8. Ricerca Pagamenti Efil
9. Data Pagamento Diversa da Data Accredito
10. Selettore Righe per Pagina (Lista File CBI)
11. Ricerca Verbali
12. Modifica Veicolo
13. Stampa Unione (Generazione Documenti)
14. Gestione Automatica Pagamenti Rateali

---

1. Accesso e Home Page

Dopo aver effettuato il login con le proprie credenziali, l'utente accede alla Home Page. La pagina presenta un video di sfondo istituzionale e un menu di navigazione principale per accedere alle diverse sezioni dell'applicativo.

2. Gestione Enti Creditori

Questa sezione permette di gestire l'anagrafica degli Enti Creditori censiti nel sistema.

• Visualizzazione: Elenco paginato degli enti con possibilità di filtro.
• Creazione/Modifica: È possibile aggiungere nuovi enti o modificare quelli esistenti inserendo dati come:
  • Codice Ente
  • Denominazione
  • Codice Ufficio / Tipo Ufficio
  • Codice Catastale Comune
  • Ufficio Pagatore
• Importazione: Funzionalità per importare massivamente gli enti da file esterni (se supportato).

3. Gestione Flussi CBI

Il cuore dell'applicativo è la gestione dei flussi CBI per la riconciliazione degli incassi.

3.1. Caricamento File

L'utente può caricare nuovi file CBI nel sistema.

• Il sistema analizza il contenuto del file, estrae l'header, il footer e le singole transazioni.
• Viene creato un record per il file e le relative transazioni vengono salvate per la lavorazione.

3.2. Lista File

Visualizza l'elenco di tutti i file CBI caricati.

• Stato: Permette di vedere se è presente la "Data Tramissione Seda" o è ancora in lavorazione.
• Selezione Multipla: È possibile selezionare più file tramite le checkbox per eseguire operazioni bulk.
• Azioni Singole:
  • Dettaglio: Accede alla pagina di lavorazione del file.
  • Elimina: Rimuove il file e le transazioni associate (se non consolidato).
  • Cont. Provvisorio: Apre un'anteprima del file contabile con possibilità di download senza impatti.
  • Cont. Definitivo: Apre un'anteprima del file contabile con possibilità di conferma definitiva.
• Azioni Bulk (su selezione multipla):
  • Riepilogo: Visualizza un riepilogo aggregato dei file selezionati.
  • Cont. Provvisorio: Apre un'anteprima del file contabile provvisorio aggregato.
  • Cont. Definitivo: Apre un'anteprima del file contabile definitivo per tutti i file selezionati (non disponibile per file già trasmessi a SEDA).

Nota tecnica: Le operazioni singole e bulk utilizzano la stessa logica interna. Quando si opera su un singolo file, il sistema utilizza le stesse API bulk passando il file come unico elemento. Questo garantisce comportamento consistente in entrambi gli scenari.

Flusso Contabilità con Preview

Sia la Contabilità Provvisoria che la Definitiva utilizzano lo stesso flusso con anteprima:

1. Selezione: Utente seleziona uno o più file CBI
2. Apertura Preview: Click su "Cont. Provvisorio" o "Cont. Definitivo"
3. Visualizzazione Anteprima:
   • Modal con header blu per Provvisorio, verde per Definitivo
   • Tabella con i dati che verranno inclusi nel file
   • Tab per vedere il contenuto raw del file
4. Download:
   • Provvisorio: Pulsante "Scarica Provvisorio" - scarica senza impatti sul sistema
   • Definitivo: Pulsante "Conferma Definitivo e Scarica" - richiede conferma, poi imposta le date e scarica

Nota sulla Contabilità Definitiva

Quando viene confermato il download del file di Contabilità Definitiva, il sistema esegue automaticamente le seguenti operazioni:

1. Imposta la Data Trasmissione SEDA sul file CBI
2. Aggiorna la Data Trasmissione su tutti i pagamenti collegati alle transazioni rendicontabili del file
3. Ricarica la pagina per mostrare la data aggiornata nella griglia

Una volta che un file è stato trasmesso a SEDA, non sarà più possibile generare nuovamente il file definitivo. Il pulsante verrà disabilitato e apparirà con l'icona del lucchetto.

Avviso per File Già Trasmessi

Quando si tenta di aprire la preview della Contabilità Definitiva per una selezione di file che include file già trasmessi a SEDA:

• Viene visualizzato un avviso arancione nella parte superiore del modal
• L'avviso elenca i nomi dei file già trasmessi
• Il pulsante "Conferma Definitivo e Scarica" viene disabilitato
• L'utente deve rimuovere i file già trasmessi dalla selezione prima di poter procedere

Questo controllo garantisce che i file già rendicontati non vengano reinviati accidentalmente.

3.3. Dettaglio e Riconciliazione

Nella pagina di dettaglio del file, l'operatore lavora sulle singole transazioni.

Filtri

La sezione filtri permette di ricercare rapidamente le transazioni desiderate:

• Data Contabile Da/A: Filtra per intervallo di date
• Importo Min/Max: Filtra per range di importo
• Stato: Mostra solo transazioni quadrate (verde) o non quadrate (rosso)
• Cerca in Causale: Ricerca testuale nella causale
• Rendicontabile: Filtra per transazioni rendicontabili/non rendicontabili
• Lavorabile: Filtra per transazioni lavorabili o escluse
  • Solo Lavorabili (default): Mostra solo le transazioni attive
  • Tutti: Mostra tutte le transazioni
  • Solo Non Lavorabili: Mostra solo le transazioni escluse

Tabella Transazioni

La tabella offre una visione immediata dello stato di ogni transazione:

• Indicatori Visivi:
  • Verde Chiaro: L'importo della transazione corrisponde esattamente al totale degli incassi agganciati nel sistema.
  • Rosso Chiaro: C'è una discrepanza tra l'importo della transazione e gli incassi trovati.
  • Grigio con testo barrato: Transazione marcata come "Non Lavorabile".
• Colonna "Lavorabile": Switch che indica se la transazione è lavorabile o esclusa.
• Colonna "Incassi Agganciati": Mostra il numero di pagamenti trovati e il loro importo totale (es. 3 / € 150,00).
• Colonna "Rend.": Mostra un badge "SI" verde se la transazione è stata marcata come "Rendicontabile".
• Colonna "Data Cont.": Indica la Data Contabile della transazione (data effettiva di ricezione fondi).

Gestione Transazioni Non Lavorabili

Le transazioni possono essere marcate come "Non Lavorabili" quando non sono pertinenti o devono essere escluse dalla lavorazione:

• Singola transazione: Utilizzare lo switch nella colonna "Lavorabile"
• Azioni Bulk: Selezionare più transazioni con le checkbox e usare i pulsanti:
  • Imposta Non Lavorabile: Esclude le transazioni selezionate
  • Imposta Lavorabile: Ripristina le transazioni escluse

Le transazioni non lavorabili:

• Rimangono nel database e non vengono eliminate
• Sono visualizzate con sfondo grigio e testo barrato
• Sono nascoste per default (filtro "Solo Lavorabili" attivo)
• Non vengono considerate nei conteggi e nei report (se configurato)

Menu Azioni (per singola transazione)

Cliccando sul pulsante "Actions" di una riga:

1. Edit: Modifica manuale dei dati della transazione.
2. Aggancia Incassi: Avvia la procedura automatica per cercare e collegare i pagamenti nel sistema (basandosi sulla causale/URI).
3. Dettaglio Incassi: Apre una finestra con l'elenco dettagliato dei pagamenti agganciati (Ente, Comando, Data, Importo, Causale, IUV). Utile per indagare sulle discrepanze.
4. Rendicontabile: Marca la transazione come verificata e pronta per la rendicontazione.

4. Chat e Comunicazioni

Il sistema include un modulo di chat integrato per la comunicazione tra gli utenti.

• Messaggi: Invio e ricezione di messaggi testuali.
• Allegati: Possibilità di scambiare file.
• Notifiche: Conteggio dei messaggi non letti.

5. Attività di Sistema

Sezione di audit e monitoraggio che registra le operazioni principali effettuate nel sistema (es. caricamento file, modifiche dati), utile per tracciare la storia delle attività.

6. Aggregazione Transazioni Parziali

Quando le transazioni CBI relative allo stesso flusso di riversamento arrivano in giorni diversi (transazioni parziali), è necessario aggregarle manualmente per distribuire correttamente i pagamenti.

6.1. Identificazione Transazioni Parziali

Le transazioni parziali condividono lo stesso ID Flusso Riversamento (estratto dalla causale) ma hanno date contabili diverse. Il sistema le identifica automaticamente durante l'upload.

6.2. Creazione Aggregazione

1. Dalla pagina dettaglio di una transazione, cliccare su "Aggrega Transazioni"
2. Il sistema mostra le transazioni candidate con lo stesso ID Flusso
3. Selezionare le transazioni da aggregare (minimo 2)
4. Cliccare su "Crea Aggregazione"

6.3. Distribuzione Pagamenti

Dopo la creazione dell'aggregazione:

1. Cliccare su "Esegui Distribuzione" per avviare la distribuzione euristica automatica
2. Il sistema assegna i pagamenti alle transazioni basandosi su:
   • Corrispondenza importi
   • Prossimità delle date
3. Se gli importi non corrispondono, lo stato passa a "Con Errori"

6.4. Assegnazione Manuale

Quando la distribuzione automatica non riesce a quadrare gli importi:

1. Cliccare su "Assegnazione Manuale"
2. Selezionare il pagamento da assegnare
3. Scegliere la transazione di destinazione
4. Il pagamento erediterà la DataContabile e DataRiversamento dalla transazione selezionata

6.5. Finalizzazione e Sincronizzazione

Quando gli importi corrispondono:

1. Cliccare su "Finalizza e Sincronizza"
2. Il sistema aggiorna DataContabile e DataRiversamento su PaymentRepository
3. L'aggregazione diventa non modificabile (Completed)

6.6. Gestione Errori di Sincronizzazione

In caso di errori durante la sincronizzazione:

• Lo stato passa a "Sincronizzazione Fallita" o "Parzialmente Fallita"
• Viene mostrato il pulsante "Ritenta Sincronizzazione"
• L'operatore può rivedere gli errori e riprovare la sincronizzazione

6.7. Stati dell'Aggregazione

Stato	Descrizione
Bozza	Aggregazione in fase di configurazione
Validata	Distribuzione completata, importi corrispondenti
Con Errori	Mismatch importi, richiede intervento manuale
Completata	Finalizzata e sincronizzata con successo
Sincronizzazione Fallita	Errori durante la sincronizzazione

6.8. Eliminazione Aggregazione

Le aggregazioni possono essere eliminate solo se non finalizzate:

1. Aprire il dettaglio dell'aggregazione
2. Cliccare su "Elimina"
3. Confermare l'operazione
4. Le transazioni tornano allo stato standalone

---

7. Storico Estrazioni Contabili

7.1. Introduzione

La funzionalità Storico Estrazioni Contabili permette di tracciare e visualizzare tutte le estrazioni di contabilità definitiva effettuate per ogni file CBI.

7.2. Estrazioni Incrementali

È ora possibile effettuare estrazioni contabili incrementali. Questo significa che:

• Ogni estrazione include solo le transazioni rendicontabili non ancora esportate
• Se nuove transazioni vengono marcate come rendicontabili dopo una prima estrazione, sarà possibile effettuare una nuova estrazione che includerà solo queste nuove righe
• Non c'è più un blocco dopo la prima estrazione definitiva

7.3. Indicatori nella Lista File CBI

Colonna "Totale Contabilizzato"

Nella lista dei file CBI è presente la colonna Totale Contabilizzato che mostra:

• L'importo totale delle transazioni già esportate
• Il numero di estrazioni effettuate (tra parentesi)

Righe Colorate in Verde

Le righe evidenziate in verde indicano che il file CBI è completamente contabilizzato, ovvero:

• Tutte le transazioni lavorabili sono state rendicontate
• Tutte le transazioni rendicontabili sono state incluse in una contabilità definitiva

7.4. Consultazione dello Storico

Per visualizzare lo storico delle estrazioni:

1. Nella lista file CBI, cliccare sul menu azioni (⋮) del file desiderato
2. Selezionare "Storico Estrazioni Contabili"
3. Si aprirà una finestra con l'elenco di tutte le estrazioni effettuate

Informazioni Visualizzate

Per ogni estrazione vengono mostrate:

• Data/ora dell'estrazione
• Utente che ha effettuato l'estrazione
• Numero transazioni incluse
• Importo totale esportato
• Nome file generato (se disponibile)

Dettaglio Transazioni

Cliccando sull'intestazione di ogni estrazione, è possibile espandere il dettaglio per vedere:

• Elenco completo delle transazioni incluse
• Importo di ogni transazione
• Data contabile e data valuta
• Data di trasferimento assegnata
• Numero e importo dei pagamenti collegati

7.5. Download e Anteprima File Archiviati

Per ogni estrazione contabile effettuata dopo il 18/12/2025, il sistema archivia una copia del file generato. Dalla finestra storico:

• Download: Cliccando sull'icona di download, è possibile scaricare il file esattamente come generato al momento dell'estrazione.
• Anteprima: Cliccando sull'icona di anteprima, si apre una finestra che mostra i dati contenuti nel file in formato tabellare, senza dover scaricare il file.

Nota: Per le estrazioni precedenti a questa data, il file non è stato archiviato e verrà mostrato il messaggio "File non archiviato".

7.6. Indicazione Transazioni Già Contabilizzate

Nella pagina di dettaglio del file CBI, ogni transazione mostra una nuova colonna "Già Contabilizzato":

• Badge Verde "Sì": La transazione è stata inclusa in una contabilità definitiva. Passando il mouse sul badge, viene mostrata la data di contabilizzazione.
• Badge Grigio "No": La transazione non è ancora stata contabilizzata.

Questo permette all'operatore di vedere immediatamente quali transazioni sono già state esportate e quali sono ancora da lavorare.

7.7. Flusso di Lavoro Tipico

1. Prima estrazione: L'operatore marca come rendicontabili le transazioni pronte e crea la contabilità definitiva
2. Lavorazione successiva: Nuove transazioni vengono lavorate e marcate come rendicontabili
3. Seconda estrazione: L'operatore crea una nuova contabilità definitiva che include solo le nuove righe
4. Consultazione: È sempre possibile consultare lo storico per vedere cosa è stato esportato e quando

---

8. Ricerca Pagamenti Efil

8.1. Pagamenti Per Date

Per gli intervalli più ampi il sistema suddivide automaticamente la ricerca in più chiamate e mantiene un risultato temporaneo in cache per 30 minuti sullo stesso intervallo date.

Se durante una ricerca estesa il browser viene aggiornato, la sessione client scade oppure la richiesta viene interrotta, è possibile rilanciare subito la stessa ricerca: il sistema riutilizza la cache temporanea quando disponibile e riduce i tempi del nuovo tentativo. La pagina Efil > Pagamenti Per Date permette di cercare i pagamenti ricevuti in un determinato intervallo di date direttamente dal servizio Efil.

8.2. Filtri Lato Client (Subfiltro)

Poiché Efil non supporta filtri avanzati nella ricerca, è disponibile un pannello di subfiltro lato client che permette di filtrare i risultati già scaricati:

• Cliccare su "Mostra/Nascondi Subfiltro" per aprire il pannello
• Campi filtro disponibili:
  • IUV
  • Debitore
  • Codice Fiscale / P.IVA
  • Numero Avviso
  • Importo Min/Max
  • Causale
  • Servizio
  • Canale di Pagamento
  • ID Riscossione
  • ID Flusso
• Il filtraggio è in tempo reale mentre si digita
• Il contatore in alto mostra quanti record corrispondono ai filtri

8.3. Colorazione Righe

Le righe nella tabella sono colorate per identificare rapidamente lo stato dei pagamenti:

• Verde (table-success): Pagamento con ID Flusso Riversamento presente - il pagamento è stato riversato.
• Rosso (table-danger): Pagamento senza ID Flusso Riversamento - il pagamento non risulta ancora riversato.

---

9. Data Pagamento Diversa da Data Accredito

9.1. Quando Utilizzare Questa Funzionalità

In alcuni casi, la data effettiva del pagamento può essere diversa dalla data di accredito bancario (Data Valuta). Questo accade tipicamente quando:

• Il contribuente effettua il pagamento il giorno X
• La banca accredita l'importo il giorno X+N (dopo alcuni giorni lavorativi)

Esempio concreto:

• Pagamento effettuato: 15 Gennaio 2026
• Accredito bancario: 18 Gennaio 2026
• La transazione CBI riporta Data Valuta = 18/01/2026

In questi scenari, il sistema non riesce a trovare la corrispondenza automatica con i pagamenti nel repository perché cerca con la data sbagliata.

9.2. Come Inserire la Data Pagamento

1. Dalla pagina Dettaglio File CBI, individuare la transazione problematica
2. Cliccare sul menu Actions → Edit
3. Nel campo "Data Pagamento" inserire la data effettiva del pagamento
4. Cliccare Salva

⚠️ Vincolo importante: La Data Pagamento deve essere minore o uguale alla Data Valuta. Non è possibile inserire una data di pagamento successiva alla data di accredito.

9.3. Indicatore Visivo nella Griglia

Le transazioni con Data Pagamento valorizzata sono facilmente identificabili nella griglia:

• Viene mostrata una colonna dedicata "Data Pagamento"
• Se la data è valorizzata, appare con un'icona calendario (⚠️) arancione
• Se la data non è valorizzata, appare un trattino "-"

9.4. Come Funziona la Ricerca Pagamenti

Quando una transazione ha il campo Data Pagamento compilato:

Parametro Query	Valore Utilizzato
Data Pagamento (PaymentDate)	Data Pagamento inserita
Data Accredito (CreditDate)	Data Valuta della transazione

Quando il campo Data Pagamento è vuoto (comportamento standard):

Parametro Query	Valore Utilizzato
Data Pagamento (PaymentDate)	Data Valuta
Data Accredito (CreditDate)	Data Valuta

9.5. Impatto sulla Contabilità

📋 Nota tecnica: Nella contabilità estratta, la Data Pagamento sarà sempre uguale alla Data Valuta (data accredito), indipendentemente dalla data di pagamento effettiva inserita.

Questo garantisce coerenza nei file contabili:

• Le date nel file estratto corrispondono sempre alla data di accredito bancario
• La funzionalità Data Pagamento serve solo per la ricerca nel repository pagamenti

9.6. Flusso di Lavoro Tipico

1. Identificazione problema: L'operatore nota che una transazione non quadra (rosso) nonostante dovrebbero esserci pagamenti collegati
2. Verifica date: Controlla nel sistema esterno la data effettiva del pagamento
3. Modifica transazione: Inserisce la Data Pagamento corretta
4. Riaggiancio: Il sistema ora trova correttamente i pagamenti
5. Rendicontazione: L'operatore marca la transazione come rendicontabile

9.7. Domande Frequenti

D: Devo sempre compilare la Data Pagamento? R: No, solo quando la data effettiva del pagamento è diversa dalla Data Valuta e il sistema non trova automaticamente i pagamenti.

D: Posso inserire una Data Pagamento successiva alla Data Valuta? R: No, il sistema non lo permette. La data di pagamento deve sempre essere precedente o uguale alla data di accredito.

D: La Data Pagamento viene usata per la contabilità? R: No, nella contabilità viene sempre usata la Data Valuta. La Data Pagamento serve solo per la ricerca dei pagamenti.

---

10. Selettore Righe per Pagina (Lista File CBI)

10.1. Descrizione

Nella lista dei file CBI è ora disponibile un selettore "Righe per pagina" posizionato sia sopra che sotto la griglia, per permettere all'operatore di regolare rapidamente la quantità di risultati visualizzati.

10.2. Opzioni Disponibili

I valori selezionabili sono: 10, 25, 50 (default), 100, 200.

10.3. Comportamento

• Accanto al selettore superiore è mostrato il contatore totale dei file (es. "Totale: 142").
• Al cambio di selezione, la pagina si ricarica mantenendo i filtri attivi e riportando la navigazione alla prima pagina.
• Il selettore inferiore è affiancato alla paginazione numerica per comodità di navigazione su elenchi lunghi.

---

11. Ricerca Verbali

11.1. Accesso

La pagina Ricerca Verbali è raggiungibile dal menu principale (icona ⚖️ gavel). L'accesso richiede il permesso Financial.RicercaVerbali.

11.2. Filtri di Ricerca

Il pannello filtri permette di ricercare i verbali nel database con i seguenti campi:

Filtro	Descrizione
Identificativo Atto	Codice ADI del verbale
Numero di Protocollo	Numero protocollo assegnato
Numero di Registro	Numero di registro
Targa	Targa del veicolo coinvolto
Codice Fiscale / P.IVA	CF o P.IVA del soggetto obbligato
Data Violazione Da/A	Intervallo di date della violazione
Stato Atto	Selezione multipla tra gli stati disponibili

Regola di Validazione

Il filtro per Data Violazione e/o Stato Atto non può essere utilizzato da solo: è necessario specificare almeno un filtro testuale (Identificativo Atto, Protocollo, Registro, Targa o Codice Fiscale). Un avviso arancione ricorda all'utente questa regola.

11.3. Risultati

La griglia risultati mostra le seguenti colonne:

• Comando, Comune, Identificativo Atto, Numero Protocollo, Numero Registro, Targa
• Stato Atto, Causale Archiviazione, Dettagli Archiviazione, Causale Stand-By
• Data Creazione, Importo Sanzione, Importo Spese, Importo Pagato
• Data Validazione, Data Violazione, Data Ultima Spedizione

11.4. Azioni su Singolo Verbale

Cliccando il pulsante "Actions" di ogni riga, il menu contestuale propone:

Azione	Permesso Richiesto	Descrizione
Modifica Veicolo	ModificaVeicolo	Apre la modale per modificare targa e tipo veicolo
Storia Modifiche	—	Espande il dettaglio dei log di modifica effettuati sul verbale
Stampa Unione	StampaUnione	Apre la modale per generare un documento DOCX per il verbale
Aggiungi alla Bag	—	Aggiunge il verbale alla Bag per operazioni multi-verbale

Nota: L'azione "Modifica Veicolo" è disponibile solo se il verbale è in uno stato modificabile (CanBeModified).

11.5. Selezione Multipla e Azioni Bulk

La griglia supporta la selezione tramite checkbox (incluso "Seleziona Tutti"). Quando almeno un verbale è selezionato, appare la barra azioni bulk con:

• Stampa Unione: genera un documento per tutti i verbali selezionati
• Aggiungi alla Bag: aggiunge tutti i verbali selezionati alla Bag

11.6. La Bag

La Bag è un contenitore temporaneo (lato client) che consente di accumulare verbali da ricerche diverse per poi operare su tutti contemporaneamente.

Come Funziona

1. Aggiungere verbali alla Bag usando il menu singolo o la selezione multipla
2. Il pulsante "Bag" in alto a destra mostra il badge con il conteggio
3. Cliccando su "Bag" si apre/chiude il pannello che elenca i verbali inseriti
4. Dalla Bag è possibile:
   • Stampa Unione da Bag: genera un documento per tutti i verbali nella Bag
   • Svuota: rimuove tutti i verbali dalla Bag
   • Rimuovi singolo: rimuove un verbale specifico dalla Bag

Nota: La Bag persiste durante la sessione del browser (localStorage) ma non è condivisa tra utenti o dispositivi.

---

12. Modifica Veicolo

12.1. Scopo

Permette di correggere targa e/o tipo veicolo su un verbale direttamente dal sistema Financial, senza dover accedere al sistema Titano.

12.2. Accesso

La funzionalità è disponibile dalla pagina Ricerca Verbali, menu azioni → "Modifica Veicolo". Richiede il permesso Financial.RicercaVerbali.ModificaVeicolo.

12.3. La Modale di Modifica

La modale presenta:

• L'Identificativo Atto del verbale in sola lettura
• I dati attuali del veicolo (targa e tipo veicolo correnti)
• Il campo Targa per inserire la nuova targa (conversione automatica in maiuscolo)
• Il campo Tipo Veicolo con un selettore a tendina con tutte le tipologie disponibili

12.4. Validazioni

• Almeno uno dei due campi deve essere compilato
• La targa viene validata tramite ItalianToolkit (deve corrispondere a un formato targa riconosciuto)
• Se la validazione non supera, viene mostrato un errore "Targa non valida"

12.5. Tracciamento Modifiche

Ogni modifica effettuata viene registrata nella tabella AppModificheVerbaleLog con:

• Data e ora della modifica
• Utente che ha eseguito la modifica
• Valori precedenti e nuovi

La Storia Modifiche è consultabile dal menu azioni → "Storia Modifiche" direttamente nella griglia.

---

13. Stampa Unione (Generazione Documenti)

13.1. Introduzione

La funzionalità Stampa Unione permette di generare documenti DOCX personalizzati partendo da un template Word e dai dati dei verbali selezionati. Il sistema sostituisce automaticamente i placeholder nel template con i dati reali del verbale.

13.2. Accesso

Disponibile dalla pagina Ricerca Verbali:

• Singolo verbale: menu azioni → "Stampa Unione"
• Selezione multipla: barra bulk → "Stampa Unione"
• Dalla Bag: pulsante "Stampa Unione da Bag"

Richiede il permesso Financial.RicercaVerbali.StampaUnione.

13.3. Flusso di Lavoro

1. Selezione verbali: selezionare uno o più verbali
2. Apertura modale: la modale mostra le figure coinvolte per ogni verbale
3. Selezione figure: spuntare/deselezionare le figure da includere nel documento
4. Scelta template: scegliere un template salvato a sistema oppure caricare un file .docx
5. Generazione: cliccare "Genera Documento" per scaricare il DOCX finale

13.4. Figure Coinvolte

Per ogni verbale, la modale elenca le figure coinvolte (proprietario, obbligato in solido, conducente, ecc.) con:

• Tipo di figura (badge colorato)
• Nome/Cognome o Ragione Sociale
• Codice Fiscale

L'utente può deselezionare figure che non devono comparire nel documento generato.

13.5. Template

Template Salvati a Sistema

I template possono essere salvati centralmente per essere riutilizzati da tutti gli operatori:

• Selezionare un template dal menu a tendina
• Per eliminare un template: selezionarlo e cliccare l'icona cestino (richiede permesso GestioneTemplate)

Upload Template

In alternativa, è possibile caricare un file .docx per un uso estemporaneo:

• Formati accettati: solo .docx
• Dopo il caricamento, è possibile salvarlo a sistema per riutilizzi futuri (pulsante "Salva Template")

Template di Esempio

È disponibile un template di esempio scaricabile cliccando "Scarica Template Esempio" nella modale. Questo template mostra l'uso corretto di tutti i placeholder disponibili.

13.6. Placeholder Disponibili

Il template utilizza la sintassi Handlebars. Nella modale sono consultabili tre sezioni espandibili:

Sezione	Contenuto
Campi Disponibili	Placeholder singoli (es. {{adi_code}}, {{vehicle_plate}}, {{sanction_amount}})
Liste (Soggetti)	Elenchi iterabili con {{#each ...}} (es. figure coinvolte, pagamenti, spedizioni)
Helpers Disponibili	Funzioni di formattazione (date, valute, condizionali)

Esempio di Placeholder nel Template

Spett.le {{#each soggetti}}{{this.surname}} {{this.name}}{{/each}}

Verbale n. {{adi_code}} del {{format_date violation_date "dd/MM/yyyy"}}
Importo sanzione: {{format_currency sanction_amount}}

Tabelle Dinamiche

Per generare tabelle Word con righe ripetute:

{{|| soggetti h=1}}
| {{surname}} | {{name}} | {{tax_code}} |
{{/ soggetti}}

13.7. Campi con Calcolo Importi per Scadenza

Il sistema calcola automaticamente i totali dovuti in base alla tempistica di pagamento:

Campo	Descrizione
total_5_days	Importo totale dovuto se pagato entro 5 giorni
total_60_days	Importo totale dovuto se pagato entro 60 giorni
total_over_60_days	Importo totale dovuto se pagato oltre 60 giorni

Questi campi sono disponibili come placeholder nei template di stampa unione.

---

14. Gestione Automatica Pagamenti Rateali (Determine)

14.1. Descrizione

Il sistema gestisce automaticamente la riconciliazione dei pagamenti rateali provenienti da determine (piani di ammortamento). Quando un pagamento non viene trovato con il percorso standard (per PaymentUID), il sistema attiva un algoritmo di fallback che:

1. Identifica la determina associata al pagamento
2. Recupera i verbali prodromici collegati alla determina
3. Distribuisce l'importo della rata sui verbali tramite un algoritmo waterfall

14.2. Algoritmo Waterfall

La distribuzione dei pagamenti segue regole precise:

Ordinamento verbali: Data violazione crescente, poi ID verbale crescente (il verbale più vecchio viene coperto per primo).

Ordinamento pagamenti: Data pagamento crescente, poi PaymentUID crescente.

Per ogni pagamento:

1. Trova il primo verbale con residuo > 0
2. Copre prima le Spese residue (spese di notifica/procedura)
3. Poi copre i Bolli/Recupero tariffario residui
4. Il resto viene attribuito alla Sanzione (può eccedere l'importo originale per maggiorazioni/interessi)
5. Se tutti i verbali sono coperti, l'overflow va sull'ultimo verbale

14.3. Ricalcolo Cumulativo

L'algoritmo riesegue l'intero storico dei pagamenti della determina (non solo quelli del file CBI corrente). Questo garantisce attribuzioni consistenti anche quando le rate arrivano su file CBI diversi nel tempo.

14.4. Impatto per l'Operatore

Questa funzionalità è completamente automatica:

• L'operatore non deve intervenire manualmente
• Le transazioni CBI con pagamenti rateali vengono agganciate automaticamente
• Nel dettaglio incassi, i pagamenti mostrano la suddivisione tra Spese, Bolli e Sanzione per ogni verbale

---

Documento aggiornato al 20/04/2026 - Aggiunte sezioni: Selettore Righe per Pagina, Ricerca Verbali, Modifica Veicolo, Stampa Unione, Gestione Pagamenti Rateali