• Non ci sono risultati.

Disegno architettura di Business Intelligence prodotto CRM

N/A
N/A
Protected

Academic year: 2021

Condividi "Disegno architettura di Business Intelligence prodotto CRM"

Copied!
182
0
0

Testo completo

(1)

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:

(2)
(3)

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).

(4)

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

(5)

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

(6)

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

(7)

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

(8)

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

(9)

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.

(10)

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.

(11)

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.

(12)

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).

(13)

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

(14)

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

(15)

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à

(16)

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

(17)

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

(18)

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

(19)

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

(20)

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

(21)

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)

(22)

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

(23)

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.

(24)

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

(25)

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

(26)

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

(27)

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

(28)

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

(29)

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

(30)

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

(31)

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

(32)

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)

(33)

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.

(34)

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

(35)

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

(36)

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

(37)

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

(38)

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.

(39)

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

(40)

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)

(41)

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)

(42)

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

(43)

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.

(44)

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

(45)

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

(46)

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

(47)

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

(48)

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

(49)

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

Riferimenti

Documenti correlati

Politecnico di Milano – Ingegneria Industriale.

Il file estratto con l’elenco delle fatture emesse nel trimestre sarà la tabella «Sales» del database relazionale.. Le anagrafiche dei clienti –

Entro i successivi 15 giorni solari, rispetto alla riunione di avvio delle attività (Kick of Meeting), il Fornitore deve sottoporre a Nucleco per benestare un Piano della

Art. 8 Dopo la conclusione del contratto che in base alla legge o ai.. regolamenti amministrativi acquista efficacia solo dopo la ratifica o la registrazione,

b) L’elettricista o impresa cui si affidano i lavori devono essere iscritti alla C.C.I.A.A. contenente la specifica abilitazione e la nomina del Responsabile Tecnico, che firma,

b) addebito diretto sul c/c del Cliente (RID): resta inteso che, nel caso di addebito diretto sul conto corrente del Cliente (RID), il Finanziatore addebiterà per ogni singola rata

− la struttura di memorizzazione per i processi ricorsivi è la pila delle invocazioni ricorsive che viene generata automaticamente dalla JVM durante l’esecuzione di un

Dovranno essere eseguite analisi aria-ambiente in MOCF come di seguito indicato (Protocollo 7).