Gestione Ruolo Demanio

Documentazione operativa e descrizione analitica delle funzioni del programma

← Torna ai prodotti

Finalità del modulo

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.

2. Tabella tariffe tributi

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.

Tabella tariffe tributi
Archivio delle tariffe con codice, descrizione, importi e funzioni di gestione.

3. Tabella emissione ruoli

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.

Elenco ruoli
Elenco dei ruoli censiti nel sistema.

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.

Scheda ruolo
Maschera di definizione dei parametri del ruolo.
La scheda del ruolo definisce il contesto temporale e le regole di calcolo. Le concessioni e le tariffe da sole non bastano: senza questo livello il programma non sa su quale periodo lavorare e con quale logica emettere le posizioni.

4. Anagrafica soggetti contabili

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.

Anagrafica soggetti contabili
Ricerca e consultazione dell'anagrafica dei soggetti collegabili alle concessioni.

5. Giornale concessioni

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.

Filtro giornale concessioni
Maschera di impostazione dei criteri di estrazione.

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.

Elenco giornale concessioni
Elenco del giornale concessioni con totale complessivo e funzioni di esportazione.

6. Scheda della concessione

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.

Scheda concessione
Dettaglio completo della concessione con anagrafico, dati territoriali e voci tariffarie associate.

7. Gestione ruolo concessioni e calcolo del ruolo

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.

Maschera comandi calcolo ruolo
Schermata di comando per le principali azioni sul ruolo.

8. Risultato del calcolo: gestione ruolo concessioni

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.

Elenco ruolo concessioni
Griglia del ruolo generato con separazione tra bollette e voci.

9. Statistica avanzata del ruolo

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.

Statistiche avanzate riepilogo
Riepilogo statistico con indicatori sintetici, grafico a barre e graduatoria dei codici.

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.

Statistiche avanzate dettaglio
Incidenza percentuale e dettaglio completo dei codici che compongono il ruolo.
In termini pratici, la statistica avanzata chiude il ciclo del programma: dopo avere configurato, estratto, calcolato e prodotto il ruolo, consente di leggere come quel totale è distribuito e da quali voci nasce.

Sintesi operativa del flusso

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.