Universit`a degli Studi di Pisa
DIPARTIMENTO DI INFORMATICA
Corso di Laurea Magistrale in Data Science and Business Informatics
Disegno architettura di Business
Intelligence prodotto CRM
Candidato:
Martina Gaggioli
Tutore Aziendale:
Ing. Rolando Russo
Tutore Accademico:
Prof. Giuseppe Prencipe
Controrelatore:
Sommario
Il settore dei prodotti CRM (Customer Relationship Management ) permette alle aziende di intraprendere una politica basata sulla lunga distanza e orientata alla fidelizzazione dei clienti e ad un conseguente ritorno monetario.
A causa della varietà delle categorie di interesse che possono essere coinvolte in un tale pro-dotto, si rende necessaria un’analisi ad alto livello delle informazioni, anche incrociando dati provenienti da più categorie, al fine di evidenziare e studiare i comportamenti dei clienti. L’organizzazione dei dati raccolti per un prodotto data warehouse CRM consente non solo di integrare informazioni provenienti da diverse sorgenti, qualora ve ne sia la necessità, ma soprattutto di rispondere a domande complesse e mirate sui dati, di supporto alle decisioni aziendali.
In questa tesi viene descritto il processo di progettazione di un data warehouse di supporto all’attività di reporting ed analisi dei dati per un prodotto CRM per un’azienda di vendita di energia elettrica e gas. Vengono dettagliate le fasi del processo quali l’analisi del caso di studio e dell’unica sorgente di dati, la raccolta e l’analisi dei requisiti, la progettazione concettuale e logica del data warehouse e la realizzazione delle procedure di Estrazione, Trasformazione e Caricamento. A dimostrazione delle potenzialità della soluzione sviluppata vengono inoltre riportati alcuni esempi di analisi interattive dei dati e di report che possono essere generati in tempo reale facendo uso di un sistema OLAP (On-Line Analytical Processing).
Indice
1 Introduzione 1
1.1 Rassegna della letteratura . . . 2
1.2 Contenuto della tesi . . . 2
2 Analisi delle fonti di dati 4 2.1 Fatturazione . . . 5 2.1.1 Corpo . . . 5 2.1.2 Vettoriamento . . . 6 2.1.3 Voci di riepilogo . . . 9 2.1.4 Testata . . . 11 2.1.5 Emissione . . . 14 2.2 Consumi . . . 15 2.3 Contratti e Condizioni (CRM) . . . 17 2.3.1 Contratti . . . 17 2.3.2 Condizioni economiche . . . 20 2.3.3 Condizioni fiscali . . . 22 2.3.4 Condizioni di agevolazione . . . 22 2.3.5 Condizioni di business . . . 23 2.3.6 Opzione tariffaria . . . 25
2.3.7 Modalità di spedizione della fattura . . . 25
2.3.8 Offerte . . . 25
2.3.9 Prodotti . . . 27
2.4.1 Utenze . . . 28 2.4.2 Misuratori . . . 30 2.4.3 Apparecchiature collegate . . . 33 2.5 Credito . . . 34 2.5.1 Scadenzario clienti . . . 34 2.5.2 Pagamenti . . . 35 2.5.3 Partite contabili . . . 36
2.5.4 Schede contabili dei clienti . . . 37
2.5.5 Accordi di rientro . . . 37
2.5.6 Pratiche di recupero e morosità . . . 38
2.6 Altre tabelle interessate . . . 41
2.6.1 Società . . . 41 2.6.2 Geografia . . . 41 2.6.3 Utenze vettoriate . . . 43 2.6.4 Soggetti . . . 43 2.6.5 Calendario . . . 44 2.6.6 Agenti . . . 45 2.6.7 Voci contabili . . . 45
3 Progettazione concettuale dei data mart 46 3.1 Introduzione al Data Warehousing . . . 46
3.1.1 Dimensional Fact Model . . . 48
3.2 Billing . . . 50
3.2.1 Specifica dei Requisiti . . . 50
3.2.2 Progettazione concettuale del data mart Billing . . . 61
3.3 Consumi . . . 62
3.3.1 Specifica dei Requisiti . . . 62
3.3.2 Progettazione concettuale del data mart Consumi . . . 65
3.4 Contratti e Condizioni (CRM) . . . 66
3.4.2 Progettazione concettuale del data mart Contratti e Condizioni
(CRM) . . . 75
3.5 Utenze e Misuratori . . . 75
3.5.1 Specifica dei Requisiti . . . 76
3.5.2 Progettazione concettuale del data mart Utenze e Misuratori . . 83
3.6 Credito . . . 83
3.6.1 Specifica dei Requisiti . . . 84
3.6.2 Progettazione concettuale del data mart Credito . . . 90
3.7 Dimensioni conformi per il Drill Accross . . . 91
4 Progettazione logica dei data mart e del data warehouse 93 4.1 Tabelle aggiuntive per il Drill Accross . . . 93
4.2 Progettazione concettuale finale e progettazione logica del data mart Billing . . . 94
4.2.1 Billing - Corpo . . . 96
4.2.2 Dimensioni . . . 99
4.2.3 Billing - Testata . . . 102
4.3 Progettazione concettuale finale e progettazione logica del data mart Consumi . . . 105
4.4 Progettazione concettuale finale e progettazione logica del data mart Contratti e Condizioni (CRM) . . . 108
4.4.1 Dimensioni . . . 110
4.5 Progettazione concettuale finale e progettazione logica del data mart Utenze e Misuratori . . . 113
4.5.1 Dimensioni . . . 115
4.6 Progettazione concettuale finale e progettazione logica del data mart Credito . . . 117
4.6.1 Dimensioni . . . 119
5 Procedure di Estrazione, Trasformazione e Caricamento 125
5.1 SQL Server Management Studio . . . 125
5.2 Estrazione . . . 127 5.3 Trasformazione . . . 128 5.4 Caricamento . . . 130 5.4.1 Fatti . . . 131 5.4.2 Dimensioni . . . 132 6 Analisi multidimensionale 134 6.1 Sistemi OLAP . . . 134
6.2 SQL Server Analysis Services . . . 135
6.3 Strumento di reportistica . . . 136
6.4 Analisi delle righe delle fatture . . . 137
6.5 Analisi delle testate delle fatture . . . 139
6.6 Analisi dei consumi . . . 140
6.7 Analisi di contratti e condizioni . . . 142
6.8 Analisi di utenze e misuratori . . . 144
6.9 Analisi del credito . . . 146
6.10 Misura aggiuntiva . . . 149
7 Conclusioni 151 A Glossario 154 A.1 Generali . . . 154
A.1.1 Caratteristiche commerciali della fornitura . . . 154
A.1.2 Dati relativi alle letture e ai consumi . . . 154
A.2 Energia elettrica . . . 155
A.2.1 Caratteristiche tecniche della fornitura . . . 155
A.2.2 Dati relativi alle letture e ai consumi . . . 155
A.2.3 Informazioni necessarie per valorizzazione corrispettivi . . . 155
A.3 Gas . . . 156
A.3.2 Informazioni necessarie per valorizzazione corrispettivi . . . 157
B Caso di studio 158 B.1 Il caso di studio . . . 158
B.2 Analisi delle righe delle fatture . . . 158
B.3 Analisi delle testate delle fatture . . . 161
B.4 Analisi dei consumi . . . 163
B.5 Analisi di contratti e condizioni . . . 165
B.6 Analisi di utenze e misuratori . . . 167
B.7 Analisi del credito . . . 169
Ringraziamenti 173
Capitolo 1
Introduzione
Il tirocinio oggetto di questa relazione è stato svolto presso un’azienda che opera nel settore delle Utilities.
Con il termine "prodotto CRM" (Customer Relationship Management ) si fa riferimen-to ad un insieme di processi creati per supportare una strategia aziendale basata sulla lunga distanza, al fine di fidelizzare i clienti ed avere, allo stesso tempo, un ritorno monetario.
La struttura di un CRM può essere divisa in operazionale ed analitica, dove il primo caso si riferisce all’automazione dei processi aziendali, mentre l’altro all’analisi del com-portamento e delle caratteristiche dei clienti, al fine di favorire le strategie di gestione aziendale nei loro confronti.
Poiché l’azienda aveva già a disposizione il database operazionale del CRM, il tirocinio oggetto della tesi si è concentrato sullo sviluppo del data warehouse ad esso collegato. L’organizzazione dei dati di questa struttura consente di far fronte alle esigenze azien-dali, quali il mantenimento di informazioni storicizzate e la possibilità di effettuare interrogazioni puntuali, relative a business questions esplicitate durante la fase di spe-cifica dei requisiti. L’obiettivo di questa tesi è quello di documentare le fasi di progetta-zione e sviluppo del data warehouse, finalizzato alla memorizzaprogetta-zione delle informazioni richieste riguardo gli ambiti di interesse del CRM, di supporto all’attività di reporting ed analisi dei dati.
informa-zioni, la formalizzazione dei requisiti aziendali, la progettazione concettuale e logica del data warehouse. A questi seguiranno la descrizione delle procedure di Estrazione, Trasformazione e Caricamento implementate e, per concludere, alcuni esempi di analisi multidimensionali svolte sui dati, tramite l’uso di un sistema OLAP, che permette di estrarre interattivamente le informazioni di interesse per l’utente finale.
1.1
Rassegna della letteratura
Le informazioni relative alla progettazione del data warehouse, in particolare per ciò che riguarda le tecniche di modellazione, la documentazione relativa alla specifica dei requisiti ed il procedimento utilizzato sono state estratte dal testo di Antonio Albano [1].
Riguardo la documentazione relativa alla fonte dei dati, sono state utilizzati documenti aziendali interni e non reperibili in rete [6] e [7].
Infine, per la descrizione delle funzionalità dei software SQL Server Management Studio e Microsoft SQL Server Analysis Services, utilizzati rispettivamente per la realizzazione delle fasi di ETL e sviluppo del data cube, oltre che per gli esempi di codice SQL utilizzato, si fa riferimento alla documentazione ufficiale Microsoft Online, riportata nel sito di Microsoft Docs [3].
In aggiunta, per le spiegazioni di termini specifici o poco chiari, si riporta il glossario estrapolato dal sito dell’Autorità di Regolazione per Energia Reti e Ambiente (ARERA) [4] e [5].
1.2
Contenuto della tesi
All’interno della tesi verranno analizzate nel dettaglio le fasi del processo di pro-gettazione e sviluppo del data warehouse: l’analisi della sorgente dei dati, la raccolta e l’analisi dei requisiti, la progettazione concettuale e logica del data warehouse, la realizzazione delle procedure di Estrazione, Trasformazione e Caricamento e, infine, alcuni esempi di analisi multidimensionali svolte sui dati, che possono essere eseguite per rispondere ai requisiti chiesti durante le fasi iniziali.
In particolare, la tesi in oggetto si svilupperà nei seguenti capitoli.
Il Capitolo 2 introduce, dopo una breve descrizione della base di dati utilizzata, le tabelle che verranno utilizzate nelle fasi successive divise per categoria di riferimento, ove possibile.
Nel Capitolo 3 vengono descritte le fasi dell’analisi dei requisiti e della progettazio-ne concettuale dei data mart che andranno a formare il data warehouse, dove ognuno dei quali riguarda un ambito di riferimento diverso. Al termine del capitolo, inoltre, verranno introdotte alcune dimensioni che verranno utilizzate per l’operazione di Drill Accross tra i data mart.
Il Capitolo 4 analizza gli aspetti riguardanti la trasformazione dallo schema concet-tuale al logico, inizialmente di ogni singolo data mart, per poi passare all’intero data warehouse. Inoltre, verranno analizzate alcune modifiche alle decisioni prese nella fase precedente.
Il Capitolo 5 comprende il processo di Estrazione, Trasformazione e Caricamento delle informazioni nella struttura di destinazione, in seguito all’introduzione dello strumento utilizzato per la definizione della presente fase: SQL Server Management Studio. Nel Capitolo 6 viene descritta la fase di sviluppo del data cube, mediante alcuni esempi di analisi multidimensionali svolti sui dati, facendo uso del motore OLAP di Microsoft SQL Server Analysis Services.
Per concludere, in seguito al Capitolo 7 riguardante le conclusioni, sarà possibile consultare l’Appendice A relativo al Glossario dei termini.
Capitolo 2
Analisi delle fonti di dati
I dati relativi agli argomenti trattati dal presente progetto di tesi potrebbero essere contenuti in fonti di dati diverse e fortemente eterogenee tra loro, a causa delle loro diversità. Generalmente, infatti, i data warehouse vengono creati per rendere omogenei dati provenienti da diverse fonti, al fine di crearne un unico insieme omogeneo.
In questo particolare caso, invece, si ha un’unica origine di dati, rappresentata dal database operazionale del prodotto RETI [6], anche quest’ultimo di proprietà dell’a-zienda dove è stato svolto il tirocinio, rivolto ad aziende di distribuzione e vendita di energia elettrica, gas e acqua. Questo ha favorito notevolmente la fase di unificazione dei dati, nonostante il numero elevato di tabelle da cui estrarli.
Dato proprio il numero elevato, dopo una descrizione introduttiva, ne verrà data una più specifica riguardo le tabelle principali, divise per categoria di riferimento, all’in-terno delle quali verranno differenziati tra parentesi gli attributi delle singole fonti di energia interessate, ove necessario. Per motivi di riservatezza aziendale, inoltre, i nomi degli attributi sono stati sostituiti con degli alias.
In caso di eventuali termini tecnici poco chiari sarà possibile consultare il Glossario (Appendice A).
2.1
Fatturazione
La sezione della fonte di dati relativa alla fatturazione permette di tenere sotto controllo e modificare le informazioni riguardanti le bollette emesse dall’azienda che usufruisce del database. La gestione di queste azioni avviene tramite diverse tabelle, che suddividono le fatture in base alle diverse granularità e caratteristiche:
1. corpo; 2. vettoriamento; 3. voci di riepilogo; 4. testata; 5. emissione. 2.1.1 Corpo
Una bolletta è una fatturazione (postale o elettronica) di un contratto di fornitura di servizi, relativa, nel caso in oggetto, alla somministrazione di energia elettrica e gas. Le righe del corpo delle bollette, oltre ai costi relativi al mese di competenza, possono contenere anche eventuali storni che rettificano i valori precedenti (per esempio nel caso di conguagli), prezzi unitari differenziati per scaglioni di costo o eventuali riduzioni di prezzo [4] e [5].
Di seguito verrà descritta la tabella della base di dati relativa.
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA integer Identificatore della riga
VETTO integer Identificatore della riga di vettoriamento
NUM integer Numero dello scaglione
CODS integer Codice dello scaglione
CODT integer Codice della tariffa
TIPO string Descrizione del tipo di valore
QUAN float Quantità
IMPO float Valore dell’imponibile
IMPUNI float Valore dell’importo unitario
UM string Unità di misura
IVA% float Aliquota IVA in percentuale
VIVA string Valore dell’IVA
TEST string Identificatore della testata
TEST2 string Identificatore dell’eventuale testata di conguaglio
RICAL string Descrizione dell’eventuale tipo di ricalcolo
TRICAL string Identificatore del tipo di ricalcolo
RRICAL integer Identificatore riga di ricalcolo
STORNO integer Identificatore riga da stornare
ORIGINE integer Identificatore riga di origine
2.1.2 Vettoriamento
Con il termine vettoriamento si intende il servizio di trasporto da un punto (deno-minato immissione) ad un altro (prelievo) attraverso apposite infrastrutture: nel caso dell’energia elettrica, per esempio, avviene grazie alla Rete di Trasmissione Nazionale e alle reti di distribuzione.
La tabella seguente riguarda proprio il vettoriamento considerato all’interno delle bol-lette, suddiviso per il mese di competenza. La granularità di queste righe è supe-riore a quelle del corpo della fattura, in quanto le seconde suddividono un singolo vettoriamento in diverse voci di costo.
Attributo Tipo Descrizione
RIGA integer Identificatore della riga
AZIENDA string Identificatore dell’azienda di fatturazione
TEST string Identificatore della testata
TEST2 string Identificatore dell’eventuale testata di conguaglio
PDP string Identificatore del punto di prelievo
FOTO string Identificatore dell’eventuale utenza fotovoltaica
collegata al punto di prelievo
TARI string Identificatore dell’opzione tariffaria
MESE string Mese di competenza
DATAI string Data di inizio dell’utenza nel mese di fatturazione
DATAF string Data di fine dell’utenza nel mese di fatturazione
Attributo Tipo Descrizione
UTIL string Identificatore dell’utilizzo
CODRID string Codice della riduzione
DRID string Descrizione della riduzione
ACCISA string Identificatore del tipo di trattamento accisa (Gas)
AGEVOL% float Valore percentuale di applicazione
dell’agevolazione
TIPTENS string Identificatore del tipo di tensione (EE) o del
trattamento territoriale (Gas)
RUOLO string Flag relativo al ruolo
TIPOL string Flag relativo alla tipologia
TRATTAM string Flag relativo al tipo di trattamento
POTDISP float Valore della potenza disponibile
TARIFFA string Identificatore dell’ambito tariffario (Gas)
IMPI string Identificatore dell’impianto di vettoriamento
REG string Identificatore della regione del vettoriamento
COMUNE string Identificatore del comune del vettoriamento
PROV string Identificatore della provincia del vettoriamento
ZTARIF string Identificatore dell’eventuale zona tariffaria
ZCLI string Identificatore della zona climatica
FOGNA string Flag di applicazione del canone di fognatura
(Acqua)
CONS string Flag relativo all’eventuale presenza di consumo
TDOCU string Flag sul tipo di documento identificativo
CONS1 integer Valore del consumo di energia attiva (EE) o del
consumo annuo (Acqua)
CONS2 float Valore del consumo progressivo in Mc (Gas) o del
consumo da fatturare (Acqua)
CONS3 float Valore del consumo in Mc (Gas) o del (consumo
da fatturare*Numero giorni nel periodo/365,0) (Acqua)
CONS4 integer Valore del consumo progressivo annuo (EE)
EA1 integer Valore di energia attiva fascia 1 (EE) o di unità
EA2 integer Valore di energia attiva fascia 2 (EE) o di consumo convenuto (Acqua)
EA3 integer Valore di energia attiva fascia 3 (EE) o di
consumo reale (per canoni) (Acqua)
ER1 integer Valore di energia reattiva fascia 1 (EE)
ER2 integer Valore di energia reattiva fascia 2 (EE)
ER3 integer Valore di energia reattiva fascia 3 (EE)
CONSP float Valore del consumo in fascia on-peak (EE)
CONSOP float Valore del consumo in fascia off-peak (EE)
VETTGG integer Valore del numero dei giorni di vettoriamento
VETTMM float Valore del numero di mesi di vettoriamento
QFGG integer Valore del numero dei giorni per il calcolo delle
quote fisse (H2O)
QFMM float Valore del numero di mesi per il calcolo delle
quote fisse (H2O)
ANTINC integer Valore del numero di apparati antincendio
QFTIP string Flag relativo al tipo di calcolo della quota fissa
TIPL string Flag del tipo di lettura del misuratore
RIDUZ string Identificatore dell’eventuale riduzione
VETTA string Anno di vettoriamento
VETTM string Mese di vettoriamento
PCSCO float PCS convenzionale
PCSFA float PCS di fatturazione
PCSTA string Flag relativo all’applicazione delle tariffe del servizio
di tutela
DICHCONS string Flag relativo all’eventuale presenza della
dichiarazione consumi
RIGAP integer Identificatore della riga padre
ORIGINE integer Identificatore della riga origine
REGIME string Flag relativo al regime di mercato
ENERV string Flag relativo all’eventuale azienda energivora
2.1.3 Voci di riepilogo
Le righe del corpo delle bollette ed i vettoriamenti confluiscono nelle voci di riepilo-go, che svolgono una funzione di sunto delle singole voci già descritte. Inoltre, questa sezione comprende anche eventuali arrotondamenti o rettifiche ai costi e le eventuali righe preparate, così definite per la possibilità dell’azienda di fatturazione di creare ed aggiungere altre righe personalizzate alla bolletta. Di seguito verranno evidenziate le tabelle principali utilizzate, rispettivamente di voci e descrizioni delle stesse.
Voci
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA integer Identificatore della riga
TEST string Identificatore della testata
PDP string Identificatore del punto di prelievo
RIGAI integer Identificatore della riga interna
RIFA string Anno di riferimento
RIFM string Mese di riferimento
DESCR string Descrizione della riga
VIVA string Valore dell’IVA
IVA% float Aliquota IVA in percentuale
QUAN float Quantità
NUM integer Numero dello scaglione
CODS integer Codice dello scaglione
DATAI string Data di inizio del periodo bollettato
DATAF string Data di fine del periodo bollettato
PRZLIS float Valore del prezzo di listino
PRZRIF float Valore del prezzo di riferimento
PRZU float Valore del prezzo unitario praticato
IVA float Valore IVA nella riga
NETTO float Valore del totale netto nella riga
RIGAP string Identificatore della riga preparata
VOCE string Identificatore della voce della bolletta
BOLRIF string Identificatore della bolletta di riferimento
LIMI float Valore del limite inferiore del consumo agevolato
LIMS float Valore del limite superiore del consumo agevolato
NOTE string Note
FRS string Flag relativo a conguagli o rettifiche
FLI string Valore relativo al tipo di fascia o scaglione
PCSFA float Valore del PCS di fatturazione, in caso di conguagli
Descrizioni delle voci
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA string Identificatore della riga
SERV string Identificatore del servizio
TARI string Identificatore delle componenti tariffarie
RIGAI integer Identificatore della riga interna
VOCCOD string Identificatore della voce della bolletta
VOCDES string Descrizione della voce della bolletta
TIPO string Descrizione del tipo di voce della bolletta
CODGES string Descrizione della gestione della voce
CODCR string Descrizione del conto di ricavo
VIVA string Valore dell’IVA
VIVAR string Valore dell’aliquota IVA ridotta
IVAX string Flag relativo all’applicazione dell’IVA ridotta
XIVAX string Flag relativo all’uso esclusivo dell’IVA della voce
STATO string Flag relativo allo stato di attivazione della riga
FORNI string Identificatore dell’IVA della fornitura
CODTOT string Identificatore del raggruppamento dei totali nel
quadro di sintesi
ACCO string Flag relativo alla ritenuta d’acconto
2.1.4 Testata
La testata della fattura comprende la parte descrittiva, relativa ai dati dell’azienda di fatturazione, del cliente finale, del contratto e della fattura stessa, oltre ai costi di riepilogo finali, come per esempio l’importo totale e il totale da pagare.
Le testate hanno una competenza diversa rispetto alle parti precedentemente descritte, poiché possono comprendere diversi mesi o anni, come per esempio nel caso dei con-guagli. Inoltre, hanno la possibilità di essere estese, nel caso del "multisito", dove una stessa testata può raggruppare più utenze relative allo stesso soggetto finale.
Verranno descritte di seguito le tabelle della base di dati relative agli argomenti in oggetto, differenziando la semplice testata dall’estensione del multisito.
Testata Fattura
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
TEST string Identificatore della testata
ORD string Identificatore dell’ordine di fatturazione
SERV string Identificatore del servizio
CONTR string Identificatore del contratto
SOGG string Identificatore del cliente finale
STORNA string Identificatore della bolletta stornata
MULTI string Flag relativo al multisito
RATA string Flag relativo al pagamento rateizzato
NBOL string Numero della bolletta
ESCC string Esercizio contabile corrente
EMI string Data di emissione della bolletta
CHIUS string Flag relativo alla chiusura del contratto precedente
alla fine del periodo della bolletta
CONES string Stato della contabilità esterna
TIPO string Descrizione del tipo di documento (Fattura / Nota di
credito)
STATO string Flag sullo stato attuale della bolletta
ORIG string Flag relativo al tipo di origine del documento
PAGA string Identificatore del pagamento
IMPAZZ float Valore dell’imponibile prima dell’eventuale
azzeramento
TOTALE float Valore dell’importo totale del documento
IMPO float Valore dell’imponibile totale
TOTTAX float Valore dell’importo totale dell’imposta
DPAGA string Data del pagamento
CODCLI string Codice del cliente finale
CF string Codice fiscale del cliente finale
PIVA string Partita IVA del cliente finale
RAGSOC string Ragione sociale del cliente finale
LOC string Località del cliente finale
FRAZ string Frazione del cliente finale
CAP string CAP del cliente finale
COMUNE string Comune del cliente finale
PROV string Provincia del cliente finale
NAZ string Nazione del cliente finale
PRESSO string Valore del campo Presso
LOCS string Località di spedizione
FRAZS string Frazione di spedizione
CAPS string CAP di spedizione
COMUNES string Comune di spedizione
PROVS string Provincia di spedizione
NAZS string Nazione di spedizione
BANCA string Nome della banca del pagamento
DEB string Codice di cliente debitore
NOTE string Note sulla bolletta
RATE string Flag di eventuale rateizzazione
SPED string Identificatore della modalità di spedizione
IMPSP float Valore dell’importo delle spese di spedizione
CODSP string Codice della modalità di spedizione
Attributo Tipo Descrizione
IVA1 string Identificatore dell’aliquota IVA dello storno oltre 1
anno
TOTP float Valore del totale da pagare
MULTIS string Identificatore del modello di stampa della bolletta 2.0
DATAIN string Data e ora di inserimento
UTIN string Nome dell’utente di inserimento
ORIG string Documento di origine
Multisito
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
TEST string Identificatore della testata
PDP string Identificatore del punto di prelievo
CONTR string Identificatore del contratto
SOGG string Identificatore del cliente finale
SERV string Identificatore del servizio
TIPCAL string Flag relativo al tipo di calcolo (Gas)
CHIUS string Flag relativo alla chiusura del contratto precedente
alla fine del periodo della bolletta
DATAI string Data di inizio del periodo fatturato
DATAF string Data di fine del periodo fatturato
DATAUL string Data dell’ultima lettura fatturata
LETSTI integer Valore della lettura stimata a fine bolletta
VALLET integer Valore dell’ultima lettura fatturata
CONS string Flag relativo alla presenza di consumo
DATAC string Data di ripartenza dell’acconto
MESEI string Mese di inizio del periodo di bollettazione
MESE string Mese della bolletta (ultimo del trimestre)
STATL string Flag relativo allo stato di lavorazione della bolletta
CONGU string Flag sul conguaglio dei minimi
QT1 float Quantità fatturata (Gas: SMc, H2O: Mc, EE: kWh)
QT2 integer Quantità 2 fatturata (EE: kvarh)
CODCLI string Codice del cliente finale
CF string Codice fiscale del cliente finale
PIVA string Partita IVA del cliente finale
RAGSOC string Ragione sociale del cliente finale
LOC string Località del cliente finale
FRAZ string Frazione del cliente finale
CAP string CAP del cliente finale
COMUNE string Comune del cliente finale
PROV string Provincia del cliente finale
NAZ string Nazione del cliente finale
TIPTAR string Flag sul tipo di tariffazione
AUTOL string Flag relativo all’autolettura
DATAINA string Data di inizio dell’autolettura
DATAFIA string Data massima di autolettura ammessa
DATAFU string Data della futura lettura stimata
VALFU integer Valore della futura lettura stimata
MERC string Flag relativo al mercato (Gas, EE)
GG string Giorno di fine competenza della bolletta
MORA string Flag relativo alla morosità del cliente
INDEN string Flag relativo all’indennizzo
DATAL string Data limite per l’emissione della bolletta
DATAIN string Data e ora di inserimento
UTIN string Nome dell’utente di inserimento
2.1.5 Emissione
Le bollette, una volta create e completate, vengono emesse e contabilizzate ai fini fiscali. Nella tabella successiva finiscono proprio le bollette in questo stato, a cui si aggiungono quelle che sono state cancellate durante la fase finale, per esempio per errori o modifiche da effettuare.
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
TEST string Identificatore della testata
Attributo Tipo Descrizione
SERV string Identificatore del servizio
SOGG string Identificatore del cliente finale
DATAF string Data della fattura
NUM integer Numero della fattura
SER string Seriale della fattura completo
IMPO float Valore dell’imponibile
IVA float Valore dell’IVA
PAGA string Identificatore del pagamento
TIPO string Descrizione del tipo di documento
GEN string Flag sulla modalità di generazione della riga
EMIS string Flag relativo all’emissione della fattura
CONTA string Flag relativo alla contabilizzazione della bolletta
CANC string Flag relativo all’eliminazione della bolletta
BOLLO string Flag di esclusione del bollo
BOLIMP float Valore dell’importo del bollo
PADRE string Identificatore della fattura padre
SPLP string Flag relativo allo split payment
FTOTP float Valore del totale da pagare
RITE string Flag relativo alla ritenuta d’acconto
2.2
Consumi
La gestione dei consumi viene trattata in una tabella separata rispetto alla fattura-zione, in quanto vengono considerate le letture reali o stimate di un punto di prelievo della durata di un mese. In ogni caso, all’interno del prodotto RETI la tabella in oggetto e quelle relative alla fatturazione sono ovviamente in comunicazione, in modo da poter fatturare in base ai valori dei consumi ivi contenuti.
Di seguito verrà analizzata proprio la tabella dei consumi, contenente tutti i valori dell’energia divisa per le fasce di costo, nel caso dell’energia elettrica, ed il consumo del gas.
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA integer Identificatore della riga
MESE string Mese di competenza
PDP string Identificatore del punto di prelievo
UTVET string Identificatore dell’utenza vettoriata
SOGG string Identificatore del cliente finale
LETI string Lettura iniziale
LETF string Lettura finale
PROFI string Flag di generazione del profilo del consumo
CONS string Flag del tipo di consumo (Reale / Stimato)
TIPL string Flag del tipo di lettura del misuratore
GGI string Giorno iniziale del mese
GGF string Giorno finale del mese
NGG integer Numero di giorni di competenza
GCI float Valore del consumo indicato (Gas) o del picco
massimo (EE)
GCM float Valore del consumo in unità modificate (Gas) o
dell’energia attiva (EE)
ECR float Valore del consumo di energia reattiva (EE)
EA1 integer Valore dell’energia attiva F1 (EE)
ER1 integer Valore dell’energia reattiva F1 (EE)
EA2 integer Valore dell’energia attiva F2 (EE)
ER2 integer Valore dell’energia reattiva F2 (EE)
EA3 integer Valore dell’energia attiva F3 (EE)
ER3 integer Valore dell’energia reattiva F3 (EE)
CONSA integer Valore del consumo di energia attiva tra le due letture
CONSR integer Valore del consumo di energia reattiva tra le due
letture
GGL integer Numero di giorni tra le due letture
ONP integer Valore dei consumi on-peak
2.3
Contratti e Condizioni (CRM)
La sezione dell’origine dei dati relativa ai contratti permette di tenere sotto controllo e modificare le informazioni riguardanti tutto ciò che è stato stipulato dall’azienda che usufruisce del database. La gestione di queste azioni avviene tramite diverse tabelle, che suddividono i contratti e le condizioni in base alle diverse caratteristiche:
1. contratti; 2. condizioni economiche; 3. condizioni fiscali; 4. condizioni di agevolazione; 5. condizioni di business; 6. opzione tariffaria;
7. modalità di spedizione della fattura; 8. offerte;
9. prodotti. 2.3.1 Contratti
La tabella in oggetto contiene tutti i contratti stipulati dall’azienda. Ogni contratto comprende informazioni riguardanti il cliente finale con cui è stato stabilito l’accordo, il punto di prelievo interessato, le informazioni temporali relative ad eventuali rinnovi o passaggi da/verso altri concorrenti, oltre alle informazioni relative alla fornitura. Un caso particolare è il contratto definito "master", definito in caso di multisito, da cui vengono originati altri contratti singoli, con il campo CONTRM valorizzato con la chiave del primo contratto.
Questa tabella costituisce la base a cui, eventualmente, sono collegate le condizioni e le offerte che verranno trattate nelle sezioni successive.
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
CONTR string Identificatore del contratto
CONTRM string Identificatore del contratto master
CODRIF string Riferimento esterno
CODALE string Codice autolettura
CODAG string Codice acquirente (Gas)
CAC string Causale di apertura del contratto
BOLSOS string Flag di bollettazione sospesa
BSOSD string Descrizione sospensione bollettazione
BSOSC string Causale sospensione della bollettazione
SERV string Identificatore del servizio
PDP string Identificatore del punto di prelievo
UTEIND string Indirizzo del punto di prelievo
UTECAP string CAP del punto di prelievo
UTECIT string Comune del punto di prelievo
ZOT string Zona tariffaria (se diversa dal comune)
SOGG string Identificatore del cliente finale
SCLI string Identificatore della scheda contabile del cliente
CODAC string Codice di amministrazione del contratto
DATAFR string Data della firma del contratto
MMV integer Mesi di validità del contratto
DATAI string Data di inizio del contratto
DATAF string Data di fine del contratto
DATAT string Data termine del contratto
FRI string Flag relativo al tipo di rinnovo
DATAR string Data di rinnovo o disdetta
CONTF string Flag di fine del contratto
CODRIN string Codice del contratto di provenienza su rinnovo
CODVOL string Codice del contratto di provenienza da voltura
VOLCON string Flag relativo alla continuità di consumi con l’azienda
di provenienza della voltura
NCON integer Numero di concessioni gestite
CATPAG string Flag relativo al cattivo pagatore
RATE string Identificatore del piano di rientro o rateizzazione
NOTE string Note sul contratto
Attributo Tipo Descrizione
MERC string Flag relativo al mercato (Gas, EE)
TIPOCF string Flag relativo alla tipologia di cliente finale
TRATT string Flag relativo al trattamento
VENFON string Flag relativo alla tipologia di vendita o fornitura
VIVAR string Valore dell’aliquota IVA ridotta
DIVAR string Data di richiesta dell’IVA ridotta
PIVAR string Protocollo interno del documento di richiesta IVA
ridotta
RESI string Nome della residenza
STRADA string Strada della residenza
NC integer Numero civico di residenza
NCE string Estensione del numero civico
LOC string Località di residenza
FRAZ string Frazione di residenza
CAP string CAP di residenza
COMUNE string Comune di residenza
PROV string Provincia di residenza
NAZ string Nazione di residenza
RIFCLI string Riferimento del cliente fornito dallo stesso
STATO string Flag sullo stato del contratto
PAGA string Descrizione del tipo di pagamento
CODSP string Codice della modalità di spedizione
PRESSO string Valore del campo "Presso"
DUL string Data dell’ultima lettura fatturata
QFA integer Quantita fatturata in acconto su sistema esterno
CPASWI float Valore del consumo progressivo ante switch
CPESWI float Valore del consumo per produzione e autoproduzione
ante switch (EE)
ULV integer Valore dell’ultima lettura da voltura
SCON string Flag di eventuale sconto (Gas)
FMT string Flag relativo all’addebito della manutenzione
URS string Nome dell’operatore che ha effettuato l’ultimo
URD string Data e ora dell’ultimo rinnovo del contratto
LOTTO string Codice del lotto di fatturazione
LOTTD string Descrizione del lotto di fatturazione
QUALT string Qualifica del titolare
QCAN integer Valore del consumo annuo assegnato
FATTIP string Identificatore del tipo di fatturazione
AUCON string Flag relativo all’autoconsumo
ANNULL string Identificatore della causale di annullamento del
contratto
DCP string Data di revisione del cattivo pagatore
NOTECP string Note relative al cattivo pagatore
CODRAM string Codice di riferimento dell’amministrazione
CODCOM string Codice relativo alla commessa o convenzione
PERC float Valore percentuale di ripartizione in base ai millesimi
RITACC string Identificatore della ritenuta d’acconto
MULTIS string Identificatore del modello di stampa della bolletta 2.0
UIS string Nome dell’operatore che ha inserito il contratto
UID string Data di inserimento del contratto
LOTTOO string Lotto originario
CATME string Flag relativo alla categoria merceologica
2.3.2 Condizioni economiche
Le condizioni economiche comprendono i costi che verranno applicati al cliente finale e le caratteristiche della fornitura collegate al contratto di riferimento.
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA string Identificatore della condizione
CONTR string Identificatore del contratto
DATAI string Data di inizio della validità della condizione
DATAF string Data di fine della validità della condizione
SERV string Identificatore del servizio
Attributo Tipo Descrizione
PCI float Valore della potenza contrattualmente impegnata
PF float Valore della potenza in franchigia
PMG float Valore della pressione minima garantita
SYS string Flag relativo al tipo di sistema
TTE string Flag relativo al tipo di tensione
TEN float Valore della tensione
INTER string Flag relativo all’interrompibilità della fornitura
FRESI string Flag relativo alla residenza
TARI string Identificatore dell’opzione tariffaria
TIPU string Flag relativo al tipo d’uso
TRAG string Flag sul tipo di trattamento dell’accisa (Gas)
ACC% float Valore percentuale dell’accisa contrattuale
NOACC string Flag relativo all’esenzione dalle accise
NOADD string Flag relativo all’esenzione addizionale
FOGNA string Flag sul contributo della fognatura (Acqua)
DEPU string Flag sul contributo della depurazione (Acqua)
NOMOR string Flag di esenzione dagli interessi di mora
CAC integer Valore del consumo annuo concordato
NAA integer Numero di apparati antincendio
CPROF string Codice del profilo di prelievo
FBO string Flag relativo alla frequenza di bollettazione
AML string Anno di riferimento alle tariffe del mercato libero
MML string Mese di riferimento alle tariffe del mercato libero
FDA string Flag relativo all’attivazione del deposito cauzionale
PCSTA string Flag relativo all’applicazione delle tariffe del servizio
di tutela
DICHC string Flag relativo all’eventuale presenza della
dichiarazione consumi
AGENTE string Identificatore dell’agente
DAG string Data di validità dell’agente
DRIN string Data di rinnovo
DRNOT string Note sul rinnovo
PRECON string Identificatore del precontratto
CATUG string Categoria d’uso (Gas)
PRELG string Classe di prelievo (Gas)
PROD string Identificatore del prodotto collegato
INCC string Flag di inserimento in fase di creazione del contratto
CEMAS string Flag relativo alla condizione economica master
RIPA string Identificatore della ripartizione delle fasce
TOFF string Identificatore della testata offerta
2.3.3 Condizioni fiscali
Le condizioni fiscali comprendono le informazioni riguardanti l’aliquota IVA con-cordata, in allegato al contratto, con relativi periodi di durata delle stesse.
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA string Identificatore della condizione
CONTR string Identificatore del contratto
DATAI string Data di inizio della validità della condizione
DATAF string Data di fine della validità della condizione
VIVAR string Valore dell’aliquota IVA ridotta
PIVAR string Protocollo interno del documento di richiesta IVA
ridotta
PRECON string Identificatore del precontratto
INCC string Flag di inserimento in fase di creazione del
contratto
IVA% float Valore percentuale di applicazione dell’aliquota
IVA
2.3.4 Condizioni di agevolazione
Le condizioni di agevolazione comprendono le informazioni riguardanti le eventuali riduzioni in allegato al contratto, con relativi periodi di durata delle stesse.
Attributo Tipo Descrizione
Attributo Tipo Descrizione
RIGA string Identificatore della condizione
CONTR string Identificatore del contratto
CODRID string Codice della riduzione
DRID string Descrizione della riduzione
DATAI string Data di inizio della validità della condizione
DATAF string Data di fine della validità della condizione
VUS float Valore unitario dello sconto (ce)
MEUR float Moltiplicatore (e)
PRECON string Identificatore del precontratto
INCC string Flag di inserimento in fase di creazione del
contratto
RIGOF string Identificatore della riga di offerta
UM string Unità di misura
2.3.5 Condizioni di business
Le condizioni di business comprendono le informazioni riguardanti i prezzi relativi alle fasce di consumo e/o alle quote fisse in allegato al contratto, con relativi periodi di durata delle stesse.
In questo caso, le tabelle di interesse sono due e con granularità diversa: si riferiscono rispettivamente ai parametri definiti nelle condizioni e alle righe dettagliate di questi ultimi. Come nei casi precedenti, verranno analizzate separatamente.
Parametri delle condizioni
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA string Identificatore della condizione
CONTR string Identificatore del contratto
QDIS float Valore della quota fissa sostitutiva della distribuzione
UQD string Unità di misura della quota fissa
QFM float Valore della quota fissa mensile
UQF string Unità di misura della quota fissa mensile
CAG integer Valore della capacità giornaliera (Gas)
PCSRI float PCS di riferimento
DATAI string Data di inizio della validità dei parametri
DATAF string Data di fine della validità dei parametri
TRATT string Flag relativo al trattamento
PCSTA string Flag relativo all’applicazione delle tariffe del servizio
di tutela
PRECON string Identificatore del precontratto
INCC string Flag di inserimento in fase di creazione del contratto
XPR string Flag relativo al prezzo da maggiorare
Righe dei parametri
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA string Identificatore del parametro
PARAM string Identificatore del parametro
PAN string Identificatore del paniere
NUM integer Numero dello scaglione
CODS integer Codice dello scaglione
LISC float Limite inferiore di scaglione
LSSC float Limite superiore di scaglione
VA1 float Valore del prezzo alla stipula del contratto (Gas) o
del prezzo fisso in F1 o on-peak (EE)
VA2 float Valore dell’indice energetico alla stipula del contratto
(Gas) o del prezzo fisso in F2 o off-peak (EE)
VA3 float Valore del prezzo fisso in F3 (EE)
UV1 string Unità di misura
UV2 string Unità di misura di VA2 (Gas)
VS1 float Valore spread in F1 o on-peak (EE)
VS2 float Valore spread in F2 o off-peak (EE)
VS3 float Valore spread in F3 (EE)
2.3.6 Opzione tariffaria
La tabella seguente comprende le informazioni riguardanti le tipologie delle tariffe in allegato al contratto, con relativi periodi di durata delle stesse.
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA string Identificatore dell’opzione
SERV string Identificatore del servizio
DOT string Descrizione dell’opzione tariffaria
DATAI string Data di inizio della validità dell’opzione
DATAF string Data di fine della validità dell’opzione
TPCC string Flag sulla tipologia di condizione contrattuale
ORD integer Valore di ordinamento
STATO string Flag sullo stato dell’opzione
2.3.7 Modalità di spedizione della fattura
La tabella seguente riguarda le informazioni riguardanti le possibili modalità di spedizione della fattura allegabili al contratto, con relativo importo da addebitare, qualora presente.
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA string Identificatore della modalità
MOD string Flag sul tipo di modalità
DMOD string Descrizione della modalità
VSF float Valore dell’importo da addebitare
STATO string Flag sullo stato della modalità
PAGA string Codice della modalità di pagamento
2.3.8 Offerte
La sezione in oggetto descrive le tabelle comprendenti le informazioni sulle offerte in allegato al contratto, con relativi periodi di durata degli stessi.
diver-se: come nel caso della fatturazione (Sezione 2.1), si riferiscono rispettivamente alle testate ed alle righe delle offerte, e, anche in questo caso, le tabelle verranno analizzate separatamente.
Testata dell’offerta
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA string Identificatore della testata
ORD integer Ordine di priorità dell’offerta
CODOF string Codice univoco dell’offerta
DESOF string Descrizione dell’offerta
DATAI string Data di inizio della validità della testata
DATAF string Data di fine della validità della testata
VINCO string Identificatore della combinazione dei vincoli
GGVAL integer Numero di giorni di comporto sulla validità
STATO string Flag sullo stato della testata
ATTI string Flag di attivazione
VOL string Flag di voltura
SWI string Flag di switch
DECO string Descrizione commerciale
DEVI string Descrizione dei vincoli
DESNM string Nome della testata
GROS string Identificatore del grossista
Righe dell’offerta
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA string Identificatore della riga
TOFF string Identificatore della testata offerta
PROD string Identificatore del prodotto collegato
CONCM string Identificatore delle condizioni commerciali
VINCO string Identificatore della combinazione dei vincoli
Attributo Tipo Descrizione
UM string Unità di misura del periodo di validità
NPER integer Numero di periodi di validità
DEC string Flag sulla decorrenza del periodo
SCFM string Flag sulla scadenza a fine mese
DATAI string Data di inizio della validità della riga
DATAF string Data di fine della validità della riga
AAT string Anno di applicazione della tariffa
MAT string Mese di applicazione della tariffa
2.3.9 Prodotti
In questa sezione vengono analizzati i contenuti su cui si basano le offerte della sezione 2.3.8, ovvero i prodotti.
Come nella sezione precedente, le tabelle di interesse sono due e con granularità e informazioni diverse, che si riferiscono rispettivamente al tipo di prodotto ed al prodotto stesso, e, anche in questo caso, le tabelle verranno analizzate separatamente.
Tipo di prodotto
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA string Identificatore del tipo di prodotto
CODTP string Codice della tipologia prodotto
DESTP string Descrizione della tipologia prodotto
STATO string Flag sullo stato del tipo di prodotto
SERV string Identificatore del servizio
MERC string Flag relativo al mercato (Gas, EE)
TIPTAR string Flag sul tipo di tariffazione
TRATT string Flag relativo al trattamento
Prodotto
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
CONCO string Identificatore delle condizioni contrattuali
PRODC string Codice univoco del prodotto
PRODD string Descrizione del prodotto
DATAI string Data di inizio della validità del prodotto
DATAF string Data di fine della validità del prodotto
VINCO string Identificatore della combinazione dei vincoli
TPROD string Identificatore del tipo di prodotto
STATO string Flag sullo stato del prodotto
RUOLO string Flag relativo al ruolo
RAC string Flag sulla rata costante
PAR string Identificatore della riga dei parametri
TARI string Identificatore dell’opzione tariffaria
2.4
Utenze e Misuratori
La sezione della fonte dei dati in oggetto permette di tenere sotto controllo ed aggiornare tutto ciò che riguarda le utenze ed i misuratori controllati dall’azienda che usufruisce del database. La gestione di queste azioni avviene tramite diverse tabelle, in base alle caratteristiche:
1. utenze; 2. misuratori;
3. apparecchiature collegate. 2.4.1 Utenze
Le utenze riguardano la fruizione del bene interessato, in questo caso specifico ener-gia elettrica e gas. All’interno della tabella seguente sono presenti le informazioni relative alla geolocalizzazione dell’utenza, dell’utilizzatore e delle anagrafiche generiche del misuratore installato.
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
PDP string Identificatore del punto di prelievo
Attributo Tipo Descrizione
CODUTE string Codice prima utenza
CODUTE2 string Codice seconda utenza
RUOLO string Flag relativo al ruolo
DUT string Descrizione dell’utenza
PDPC string Utenza collegata
COMUNE string Identificatore del comune
PDR string Identificatore del punto di consegna
TUTE string Identificatore del tipo d’utenza
POT float Valore della potenza massima (kW)
PRM float Valore della portata massima
PMA float Valore della potenza massima allacciabile
RID% float Valore percentuale a cui viene ridotta la
potenza
SYS string Flag relativo al tipo di sistema
TEN float Valore della tensione dell’impianto
TRSF string Flag relativo alla trasformazione (EE)
UTI string Utilizzatore dell’utenza
IND string Indirizzo e località dell’utilizzatore
CAP string CAP dell’utilizzatore
COMU string Comune dell’utilizzatore
PROV string Provincia dell’utilizzatore
TEL string Telefono dell’utilizzatore
PIVATIT string Partita IVA del titolare del PDP
CFTIT string Codice fiscale del titolare del PDP
STRADA string Identificatore della strada
POSX float Coordinata cartografica x
POSY float Coordinata cartografica y
POSZ float Coordinata cartografica z
STRAMI string Identificatore della strada del misuratore
NCM integer Numero civico del misuratore
NCAM string Estensione del numero civico del misuratore
DATAI string Data di allaccio del misuratore
PRES float Valore della pressione
ALTI integer Valore dell’altitudine
NOTE string Note sull’ubicazione del misuratore
ACCE string Flag sull’accessibilità del misuratore
HACCE string Orario di accessibilità
TAP string Flag sul tipo di apparecchiatura
NAA integer Numero di apparati antincendio
CONS string Flag relativo alla presenza di consumo
UNS string Valore delle unità servite
USP string Flag relativo all’uso previsto
CL float Classe prevista del PDR
CGR string Codice del gruppo di riduzione
RIDIN string Flag sulla presenza del riduttore integrato
FONTI string Identificatore delle fonti di energia primaria
TECNO string Identificatore della tecnologia dell’impianto
IMCO string Flag sull’impianto cogenerativo ad alto
rendimento
TPP string Valore della tensione al PDP
NOTE2 string Note generiche
DATAM string Data di messa in servizio del contatore
elettronico
FLE string Frequenza della lettura
UTIL string Flag sull’utilizzabilità del PDR/POD
STL string Flag sulla presenza del sistema di telelettura
ALTR integer Numero di ulteriori apparecchiature
ABIP string Flag sui servizi ad abitazioni private
DAT string Flag di distribuzione in alta tensione
DATAV string Data dell’ultima verifica documentata
2.4.2 Misuratori
I misuratori sono degli strumenti che permettono di raccogliere dati di consumo, analizzarli e confrontarli per avere una visione reale della situazione.
rispetti-vamente alle anagrafiche generiche dei misuratori e a quelli effettirispetti-vamente installati. Anagrafiche dei misuratori
Attributo Tipo Descrizione
AZIENDA string Identicatore dell’azienda di fatturazione
MISU string Identicatore del misuratore
PDP string Identicatore del punto di prelievo
MAGAZ string Flag relativo al magazzino seriale
DATAI string Data di installazione del misuratore
DATAF string Data di rimozione del misuratore
CODMS string Codice della matricola seriale
TEC string Tecnologia di misura
MOD string Modello del misuratore
MAR string Marca del misuratore
AF string Anno di fatturazione del misuratore
CLA float Classe del misuratore
PMI float Portata minima del misuratore
PMA float Portata o potenza massima
NCM integer Numero delle cifre del misuratore
NDM integer Numero dei decimali del misuratore
TIPL string Flag del tipo di lettura del misuratore
LIM integer Valore di lettura iniziale
LEM integer Valore di lettura alla rimozione
DRIM string Flag sull’evento successivo alla rimozione
DTL string Data di telelettura
PTL string Flag relativo alla predisposizione alla telelettura
FTL string Flag sulla fase di telelettura
EMIS string Flag sull’emissione di impulsi
NC string Numero del certificato
DATAC string Data del certificato
DTDP string Data di denuncia della posa
DTDR string Data di denuncia della rimozione
ACM string Flag sull’oggetto alternativo alla correzione
FCON string Fornitura del connettore
USOT string Flag sull’uso temporaneo
DSHA string Data di telelettura shadow
TMIS string Flag sul tipo di misuratore (Gas)
PRT string Protocollo
TEL string Telefono
TELD string Telefono per linea dati
OPE string Operatore telefonico
Misuratori installati
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
MISS string Identificatore del misuratore installato
PDP string Identificatore del punto di prelievo
MISU string Identificatore del misuratore
NOTEU string Note sull’ubicazione del misuratore
SYSL string Flag relativo al sistema di lettura
DATAI string Data di attivazione del misuratore
DATAF string Data di chiusura del misuratore
CODPC string Codice della matricola del computer
PMI float Portata minima
PMA float Portata o potenza massima
NCM integer Numero delle cifre
NCR integer Numero delle cifre del ripetitore
NCC integer Numero delle cifre corrette
LICO float Lettura iniziale
LIRI float Lettura iniziale del ripetitore
LIUC float Lettura iniziale delle unità corrette
ER% float Valore percentuale di erogazione prevista
CCO float Coefficiente correttivo K
BAR float Pressione atmosferica di riferimento (bar)
TER float Temperatura (◦C)
Attributo Tipo Descrizione
SIG string Numero del sigillo
LETA string Identificatore della lettura di apertura
LETC string Identificatore della lettura di chiusura
DTL string Data di inizio della telelettura
NOTV string Data della notifica al venditore
NOTE string Note generiche
2.4.3 Apparecchiature collegate
Le apparecchiature collegate sono degli strumenti utili a correggere le letture del misuratore installato su un punto di prelievo. Possono essere di vario tipo (corret-tore standard, modem o SIM) e, quindi, all’interno della tabella seguente verranno identificati i campi valorizzati nei casi specifici, evidenziando il tipo tra parentesi.
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
COLL string Identificatore dell’apparecchiatura collegata
PDP string Identificatore del punto di prelievo
MISU string Identificatore del misuratore
CODC string Codice del correttore
TIPC string Flag relativo al tipo di correttore
MOD string Modello
MAR string Marca
AF string Anno di fabbricazione
PI float Valore della potenza minima
PM float Valore della potenza massima
NCC integer Numero delle cifre
LIC float Valore della lettura iniziale
LRC float Valore della lettura alla rimozione
DATAI string Data di installazione del correttore
DATAF string Data di rimozione del correttore
CAT string Flag sulla categoria del correttore
TEL string Telefono (Modem)
TELD string Telefono per linea dati (Modem)
PIN string PIN (Sim)
PUK string PUK (Sim)
GSM string Flag sulla presenza del segnale GSM (Sim)
USOT string Flag sull’uso temporaneo
NOTE string Note sulle apparecchiature
2.5
Credito
La sezione della fonte dei dati in oggetto permette di tenere sotto controllo e ag-giornare le informazioni riguardanti la contabilità relativa all’azienda che usufruisce del database. La gestione di queste azioni avviene tramite diverse tabelle, in base alle caratteristiche:
1. scadenzario clienti; 2. pagamenti;
3. partite contabili;
4. schede contabili dei clienti; 5. accordi di rientro;
6. pratiche di recupero e morosità. 2.5.1 Scadenzario clienti
La tabella descritta di seguito gestisce le scadenze e le quantità di denaro che l’azienda deve incassare dai clienti, in cambio dell’erogazione dei servizi concordati. Una stessa scadenza, qualora vi sia la necessità, può essere rateizzata in tranches future: in questo caso, la scadenza originaria viene chiusa con un pagamento fittizio nella tabella descritta della sezione successiva, per poi inserire tante righe quante sono le rate nella tabella attuale, valorizzando il campo DATAO con la data di scadenza iniziale, ormai chiusa.
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
SCAD string Identificatore della riga dello scadenzario
Attributo Tipo Descrizione
DATAS string Data di scadenza
VASC float Ammontare della scadenza
PRCO string Identificatore della partita contabile
TEST string Identificatore del documento relativo
ACCO string Identificatore dell’accordo di rateizzazione
DATAC string Data di inizio del conteggio degli interessi
GGCI integer Giorni per il calcolo di interessi
CALC string Flag per ignorare la scadenza per il calcolo di
interessi
NSP integer Numero di scadenza nella partita
NOTI string Note interne
NOTE string Note esterne
DARI string Data di rilevazione dell’insoluto
NPRI integer Numero progressivo degli insoluti
GSOL string Flag di gestione solleciti
PRMOR string Identificatore della pratica di morosità
VAIT float Importo dell’addebito degl interessi
PAGA string Mezzo di pagamento
SCCO string Flag sulla contestazione della scadenza
DATAM string Data di mora
RIC string Flag sul ricalcolo della morosità
RATEI string Identificatore della scadenza iniziale
VASO float Ammontare della scadenza originaria
PENF integer Valore di penale fissa se pagamento ritardato
SALO float Valore del saldo operativo
2.5.2 Pagamenti
La tabella descritta nella sezione in oggetto gestisce i pagamenti e le quantità di denaro che l’azienda ha incassato dai clienti, oltre ad informazioni relative alla causale e alla data del pagamento. Il caso di pagamento fittizio, già accennato nella sezione precedente, verrà gestito con un particolare valore del campo TIPM.
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA integer Identificatore della riga
PRCO string Identificatore della partita contabile
MOVI string Identificatore del movimento contabile
SCAD string Identificatore della riga dello scadenzario
INCA string Identificatore dell’incasso
COMP string Identificatore della compensazione
DATAP string Data del pagamento
VISC float Valore dell’importo assegnato alla scadenza
TIPM string Flag relativo al tipo di movimento
FCE string Flag relativo al calcolo degli interessi di mora
CASSA string Identificatore del movimento di cassa
2.5.3 Partite contabili
La tabella seguente descrive la situazione delle due tabelle precedenti ad un livello più alto: alla creazione di una nuova riga nello scadenzario viene creata una riga con-tenente le informazioni visibili in tabella, mentre al saldo della partita, corrispondente al pagamento della cifra richiesta (righe contenute nella tabella dei pagamenti), viene valorizzato il flag del campo SALD.
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
PRCO string Identificatore della partita contabile
DATAR string Data di registrazione
DESCM string Descrizione del movimento della partita
TEST string Identificatore del documento relativo
PIANO string Identificatore del piano di rientro
SCLI string Identificatore della scheda contabile del cliente
SALD string Flag relativo alla partita saldata
MOVP string Flag relativo ai movimenti previsionali
PINC string Flag relativo alla partita incerta
2.5.4 Schede contabili dei clienti
La tabella in oggetto comprende i riferimenti essenziali al cliente ed al venditore, ai fini della contabilità, servendo da ponte con le tabelle contenenti tutte le informazioni specifiche.
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
SCLI string Identificatore della scheda contabile del cliente
SOGG string Identificatore del cliente finale
VEND string Identificatore del venditore
2.5.5 Accordi di rientro
I piani di rientro vengono concordati nel caso in cui un cliente abbia un debito verso l’azienda e debba essere definito un modo per riscuoterlo tramite la rateizzazione del valore passivo.
La gestione di queste pratiche viene definita tramite la tabella seguente, contenente i riferimenti temporali del documento, compresi il numero e la frequenza delle rate, oltre ai valori conteggiati del debito.
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA integer Identificatore della riga
SCLI string Identificatore della scheda contabile del cliente
CODPR string Codice in chiaro
STATO string Flag sullo stato dell’accordo
DATAR string Data di richiesta del cliente
DATAP string Data della proposta
DATSP string Data di scadenza della proposta
DATAA string Data di accettazione dell’accordo
DATCO string Data di contabilizzazione
DATRC string Data di riferimento per il calcolo degli interessi
DATNS string Data iniziale del calcolo delle nuove scadenze
VITS float Valore dell’importo totale iniziale delle scadenze
VIP float Valore degli interessi pregressi
VSA float Valore delle spese accessorie
VTI float Valore del tasso di interesse da applicare
TFIS string Flag sul tipo di fatturazione degli interessi
pregressi
TEST string Identificatore del documento relativo
NRA integer Numero rate dell’accordo
RATE string Flag relativo alla cadenza delle rate
NGG integer Numero di giorni tra le rate
GGF integer Numero del giorno in cui far cadere la scadenza
MPC string Identificatore della modalità di pagamento
concordata
CONI string Identificatore del conto di incasso
TAI string Flag sul tipo di addebito degli interessi
FID string Flag sul tipo di fatturazione degli interessi di
dilazione
NOTE string Note esterne
NOTI string Note interne
2.5.6 Pratiche di recupero e morosità
La sezione in oggetto comprende tutto ciò che riguarda le azioni eseguite verso clienti morosi, divise per consequenzialità e granularità nelle cinque tabelle successive: in seguito ad una scadenza insoluta, viene aperta una pratica di recupero crediti e stilato un documento diviso in testata e righe, come già visto in fatturazione (Sezione 2.1), dove ad ogni riga corrisponde un’azione da eseguire ed un importo sollecitato. Scadenze insolute
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA integer Identificatore della riga
SCAD string Identificatore della riga dello scadenzario
Attributo Tipo Descrizione
VIII float Valore dell’importo iniziale insoluto
DATRI string Data di rilevazione dell’insoluto
PREC string Identificatore delle pratiche di recupero crediti
DATII string Data d’ingresso nella pratica di recupero
INAN string Flag di insoluto annullato
ISOS string Flag di insoluto sospeso
TRIL string Flag sul tipo di rilevazione
DATAC string Data dell’accordo
PRECU string Identificatore dell’ultima pratica di recupero chiusa
DATAC string Data di chiusura dell’insoluto
VIISA float Valore dell’importo dell’insoluto saldato dal cliente
VISAC float Valore dell’importo dell’insoluto spostato su
accordi di rientro
VIIST float Valore dell’importa dell’insoluto stornato
VIIP float Valore dell’importo dell’insoluto passato a perdita
NOTE string Note sulle pratiche
Pratiche di recupero crediti
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA integer Identificatore della riga
CODPRA string Codice della pratica
DATAI string Data di apertura della pratica
DATAF string Data di chiusura della pratica
CLCON string Identificatore del cliente contabile
STATO string Flag sullo stato attuale della pratica
NOTE string Note
MORV string Identificatore della vecchia pratica di morosità
Testata del documento
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
DATAI string Data di creazione dell’azione
STATO string Flag sullo stato attuale della testata
UFFL string Identificatore dell’ufficio legale
Righe del documento
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA integer Identificatore della riga
TESTA string Identificatore della testata azione
PREC string Identificatore delle pratiche di recupero
crediti
CODAZ string Identificatore dell’azione
CONTR string Identificatore del contratto
PDP string Identificatore del punto di prelievo
DATEA string Data di esecuzione dell’azione
DATLE string Data di lavorazione esterna
DATRC string Data di ricezione della conferma
DATCC string Data concessa al cliente
DATAF string Data del termine dell’azione
DATAR string Data della ricezione dell’avviso
NOTE string Note
ESITO string Flag sull’esito dell’azione
RIGAA2 string Identificatore dell’azione successiva
RIGAP string Identificatore dell’azione padre
ESCL string Flag di esclusione
GG1 integer Numero giorni in stato "Nuova"
GG2 integer Numero giorni tra esecuzione e conferma
della ricezione
GG3 integer Numero giorni concessi al destinatario
dell’azione per inviare il pagamento
FERC string Flag sull’evento di ricezione
Azioni
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA integer Identificatore della riga
SCADI string Identificatore delle scadenze insolute
RIGAA string Identificatore della riga d’azione
VIII float Valore dell’importo insoluto ad inizio azione
GSUCI string Flag sulla gestione successiva dell’insoluto
2.6
Altre tabelle interessate
Di seguito verranno analizzate le altre tabelle collegate alle sezioni precedenti ma non strettamente appartenenti, che hanno avuto un ruolo importante nella creazione e nello sviluppo del progetto oggetto di questa tesi.
Per semplicità di comprensione, sono state divise per argomento. 2.6.1 Società
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
NOME string Nome della società
2.6.2 Geografia Comuni
Attributo Tipo Descrizione
AZIENDA string Identificatore dell’azienda di fatturazione
RIGA integer Identificatore della riga
CISTAT string Codice ISTAT
NOME string Nome del comune
PROV string Nome della provincia
REG string Nome della regione
GAS string Flag di servizio gas
H2O string Flag di servizio acqua