Documentazione operativa e descrizione analitica delle funzioni del programma
Il programma di gestione del ruolo demanio consente di governare l'intero processo che va dalla configurazione delle tariffe alla produzione del ruolo annuale o periodico delle concessioni. Il modulo non si limita a memorizzare dati anagrafici: organizza le informazioni delle concessioni, collega le tariffe applicabili, costruisce il ruolo, produce il dettaglio economico per ogni posizione e mette a disposizione funzioni di controllo, stampa, esportazione e analisi statistica.
Il flusso logico del programma è composto da una sequenza precisa di fasi: definizione delle tariffe, definizione dei ruoli, gestione delle anagrafiche dei concessionari, gestione delle singole concessioni, estrazione e calcolo del giornale concessioni, generazione del ruolo, consultazione del dettaglio prodotto e lettura statistica degli importi ripartiti per codice tariffario o causale.
La tabella tariffe contiene l'archivio dei codici tariffari utilizzati dal programma per determinare le voci economiche delle concessioni. Ogni riga identifica una tariffa tramite un codice, una descrizione e i valori associati. La struttura della tabella è pensata per contenere sia il valore corrente sia il riferimento al valore precedente, così da gestire facilmente adeguamenti, confronti e revisioni.
Da questa schermata l'utente può inserire nuove tariffe, modificare quelle esistenti, eliminarle o duplicarle. Sono inoltre presenti funzioni di stampa ed esportazione in Excel, CSV e PDF. La tabella non è solo un archivio descrittivo: è una base di calcolo. Ogni errore in questa fase si riflette direttamente sugli importi prodotti nel ruolo.
La tabella emissione ruoli raccoglie l'elenco dei ruoli disponibili nel sistema. Ogni ruolo rappresenta un contenitore logico nel quale verranno poi inserite le bollette e le voci generate dal programma. In questa schermata l'utente seleziona il ruolo da gestire e può inserire o duplicare un nuovo esercizio di emissione.
La scheda del singolo ruolo consente di definire i parametri generali necessari al successivo calcolo. Tra i campi principali compaiono: codice ruolo, descrizione, stato del ruolo, data inizio e fine periodo, data bollette, scadenza bollette, tipologia di incasso, prefisso tariffe, stato tariffe del ruolo ed eventuale adeguamento ISTAT.
Sono presenti anche dati di simulazione e controllo, come importo calcolato, numero partite calcolate, eventuale gettito desiderato, percentuale anno e percentuale ISTAT. Questi campi servono a governare il comportamento del calcolo e a verificare il risultato prima della produzione definitiva del ruolo.
L'anagrafica soggetti contabili è l'archivio dei concessionari o comunque dei soggetti collegati alle concessioni. La schermata è organizzata come un elenco ricercabile e filtrabile per iniziale. Per ogni soggetto vengono mostrati codice, denominazione o cognome e nome, categoria, partita IVA, indirizzo, CAP, città, stato, IBAN, email e altri riferimenti.
In fondo alla maschera sono presenti indicatori riepilogativi, come il numero di selezionati e i totali economici di impegni, liquidazioni e accertamenti, ove collegati al modello dati generale dell'applicativo. Nel contesto del demanio, questa anagrafica è fondamentale perché ogni concessione deve essere associata a un soggetto intestatario.
Il giornale concessioni è la funzione di estrazione e costruzione dell'archivio operativo su cui il programma esegue le elaborazioni. La prima schermata consente di impostare i filtri di selezione: anagrafico, codice, codice fiscale, partita IVA, IBAN, luogo di residenza, provincia, indirizzo, concessione contenente un testo, intervallo di date, intervallo di numeri, importi, tariffa, preselle ed estrazioni. In pratica è il punto in cui si stabilisce quali concessioni o quali posizioni devono essere prese in considerazione per l'elaborazione.
Una volta eseguita l'elaborazione, il programma produce il giornale concessioni in forma tabellare. Qui ogni riga rappresenta una posizione estratta e vengono mostrati elementi quali codice concessione, preselle, inizio, fine, scadenza, indirizzo, importo, allegati, note e riferimenti ulteriori. La griglia mette a disposizione pulsanti di salvataggio, caricamento, ripristino dei default, azzeramento filtri, stampa, esportazione e grafico.
Questa schermata serve sia come controllo del materiale da cui nascerà il ruolo, sia come area intermedia per individuare anomalie, posizioni scadute, importi inattesi o dati incompleti prima della fase successiva di calcolo.
La scheda della concessione è il punto in cui si registrano i dati di dettaglio della singola posizione concessoria. I campi principali comprendono funzione, numero, data registrazione, anno, numero registrazione, descrizione, periodo dal/al, annotazioni, testo contenuto nella concessione, scadenza, numero concessione, subalterno, data concessione, stato, codice, indirizzo, civico, preselle, ricerca presella, gettito concessione, data calcolo e segnalazioni.
Nella stessa schermata è presente la sezione anagrafica dell'intestatario e un sistema di tab con aree collegate, tra cui concessioni, concessionari, ruoli e pagamenti, documenti e storico repertorio. Nel tab principale delle concessioni è visibile l'elenco degli allegati o delle voci tariffarie associate, con tipologia, tariffa, metri, importo, gestore, note e azioni di visualizzazione o eliminazione.
Dal punto di vista logico, questa scheda contiene il dato sorgente vero e proprio. Il ruolo non si inventa nulla: aggrega e calcola partendo da quello che qui è stato registrato.
La funzione di gestione ruolo concessioni è il punto di comando dell'elaborazione. L'utente seleziona il codice ruolo da trattare, l'azione da eseguire e, se necessario, il ruolo precedente da confrontare. Tra le azioni disponibili si vedono: genera tariffe ruolo, calcola ruolo, elenco ruolo, dettaglio ruolo, rivaluta tariffe ISTAT, emetti PagoPA, emetti fatture, archivia ruolo e confronta ruoli.
Questo menu azioni chiarisce la struttura del programma: il ruolo non è una sola stampa, ma un processo composto da più passaggi. Prima si generano o si consolidano le tariffe del ruolo, poi si effettua il calcolo, poi si consulta il risultato, si possono produrre gli output di incasso e infine archiviare o confrontare l'elaborazione con ruoli precedenti.
Nella stessa schermata sono presenti filtri ulteriori, come anagrafico da estrarre, dati fiscali e indirizzo di residenza, oltre a parametri addizionali come l'eventuale singola tariffa da calcolare. Questo significa che il ruolo può essere elaborato in modo massivo oppure in modo selettivo, su sottoinsiemi specifici di posizioni.
Dopo il calcolo, il ruolo viene presentato in una griglia dettagliata. Le righe sono di due tipi principali: BOLLETTA e VOCE. La bolletta rappresenta la testata della posizione economica emessa per un soggetto o per una concessione; la voce rappresenta il dettaglio dei singoli elementi economici che compongono l'importo complessivo.
Per ciascuna riga sono visibili dati quali concessione, tipo, preselle, data, inizio, fine, causale, descrizione, canoni e anagrafico. Il totale mostrato in basso sintetizza l'importo complessivo delle posizioni selezionate o elaborate. La presenza distinta di bollette e voci permette di capire sia l'importo finale richiesto al concessionario, sia il dettaglio tecnico che ha portato a quel totale.
La schermata mette a disposizione pulsanti per stampa, esportazione, salvataggio, caricamento e accesso alla statistica avanzata. In termini funzionali, qui l'utente verifica il risultato del motore di calcolo e può controllare se gli importi prodotti sono coerenti con le concessioni di origine e con le tariffe applicate.
La statistica avanzata legge il risultato del ruolo e ne costruisce una ripartizione per codice o causale, basandosi sui soli record di tipo VOCE con importi valorizzati. La prima sezione mostra i principali indicatori: totale importi, numero righe analizzate, numero di codici/causali raggruppati, importo massimo e importo medio. Sono inoltre evidenziati il codice principale e il relativo peso sul totale.
Il grafico a barre mette a confronto i codici con maggiore incidenza, mentre il pannello laterale elenca i codici più pesanti con importo e percentuale sul totale. Questa vista serve a capire subito quali tariffe o causali generano la quota principale del ruolo. Non è una funzione ornamentale: è una funzione di controllo gestionale.
La seconda parte della statistica approfondisce la lettura con un grafico di incidenza percentuale e con il dettaglio completo di tutti i codici. Per ogni codice vengono mostrati posizione, codice, causale, numero righe, importo complessivo delle voci, percentuale sul totale e importo medio. In questo modo l'utente può passare da una lettura sintetica a una lettura completamente analitica del ruolo.
La presenza di una lettura operativa testuale nella parte destra aiuta a interpretare rapidamente la concentrazione degli importi. Per esempio, se pochi codici coprono una quota molto alta del totale, il programma lo evidenzia immediatamente. Questo è utile sia per controlli interni sia per allegare una spiegazione numerica alla documentazione di emissione.
Il funzionamento del programma può essere riassunto in modo lineare: si definiscono le tariffe, si definiscono i ruoli, si censiscono i soggetti, si registrano e aggiornano le concessioni, si estrae il giornale concessioni, si esegue il calcolo del ruolo, si controlla il risultato in griglia e si analizza la composizione degli importi tramite la statistica avanzata.
Ogni fase dipende dalla qualità della fase precedente. Se le tariffe sono errate, il ruolo sarà errato. Se le concessioni sono incomplete, il giornale e il ruolo lo saranno a loro volta. Se il ruolo è corretto ma non viene letto nelle sue componenti, il controllo gestionale resta debole. Il modulo è quindi strutturato come una catena coerente di dati, regole di calcolo e strumenti di verifica.