Progetto Riconcilia

Struttura del File di Input

Il file di input deve essere in formato Excel e contenere le seguenti colonne. Ogni colonna deve avere un tipo di dato specifico per essere elaborata correttamente dal programma:

Nome Colonna	Tipo di Dato	Descrizione
PROGR	Intero (int64)	Identificativo.
RIF	Decimale (float64)	Numero di riferimento (facoltativo).
STATUS	Testo (object)	Stato dell'operazione.
DATA INS	Data (datetime64)	Data di inserimento dell'operazione (formato GG/MM/AAAA).
DATA OP	Data (datetime64)	Data dell'operazione (formato GG/MM/AAAA).
ORA	Decimale (float64)	Ora dell'operazione (facoltativo).
DATA VAL	Data (datetime64)	Data di valutazione (formato GG/MM/AAAA).
TIPO OP	Testo (object)	Tipo di operazione (es. PRELEVAMENTO, CONFERIMENTO).
PORTAFOGLIO	Intero (int64)	Identificativo del portafoglio associato.
COD TITOLO	Testo (object)	Codice del titolo associato all'operazione.
COD ISIN	Testo (object)	Codice ISIN del titolo (facoltativo).
BLOOMBER TICKET	Testo (object)	Codice del ticket Bloomberg (facoltativo).
DIV TIT	Testo (object)	Divisa del titolo (es. EUR, USD, CHF).
QTA NOMINALE	Intero (int64)	Quantità nominale dell'operazione.
PREZZO	Decimale (float64)	Prezzo per unità.
RATEO	Decimale (float64)	Valore del rateo associato.
CAMBIO	Decimale (float64)	Tasso di cambio.
CONTROVALORE TOT	Decimale (float64)	Valore totale.
DIV REG	Testo (object)	Divisa (es. EUR).
COD CTP	Testo (object)	Codice contropartita associata all'operazione.
DESCRIZIONE	Testo (object)	Descrizione dettagliata dell'operazione.
COD NATURA	Decimale (float64)	Codice natura dell'operazione (es. 1, 3, 5, ecc.).

---

Mappatura COD NATURA

La colonna COD NATURA distingue le operazioni tra Prelevamenti e Conferimenti, con le seguenti categorie:

COD NATURA	Descrizione	Categoria (Prelevamento)	Categoria (Conferimento)
0	Prelievo Bonifico	Prelievi Bonifici	Conferimenti
1	Commissioni e Spese	Commissioni e Spese
2	Family Office	Family Office
3	Altre Commissioni	Commissioni e Spese
4	Imposte	Imposte
5	Interessi Passivi	Interessi Passivi
10	Giroconto	Giroconto	Giroconto
11	Trasferimenti	Trasferimenti	Trasferimenti
NaN (Vuoto)	Non specificato / Altro	Altro	Altro

Note Importanti:

• Tutti i valori nelle colonne richieste devono essere coerenti con il tipo di dato specificato. Ad esempio, DATA INS deve essere una data valida nel formato GG/MM/AAAA.
• Il programma si aspetta i nomi delle colonne esattamente come indicato sopra.
• Colonne facoltative (come ORA, RIF, ecc.) possono essere lasciate vuote o omesse, ma le colonne obbligatorie devono essere presenti.

Descrizione

Questo progetto è uno strumento per la gestione e analisi di dati finanziari. I file sono sotto src/:

1. riconcilia.py: L'interfaccia principale che gestisce i flussi di lavoro, i calcoli e la generazione di report.

2. elabora_dati.py: Raccolta di funzioni per la manipolazione e l'elaborazione dei file Excel. Necessario per il corretto funzionamento di riconcilia.py.

3. Elaborare i dati di input del cliente.

4. Generare report dettagliati in formato Excel e PDF.

5. Visualizzare panoramiche specifiche per banche e conti.

6. Effettuare la riconciliazione del rendiconto economico.

---

Requisiti

Assicurati di avere Python installato e le seguenti librerie:

• pandas
• numpy
• customtkinter
• tkinter
• fpdf
• PyPDF2

Per installarle:

pip install pandas numpy customtkinter fpdf PyPDF2

Avvio del Programma (File .py)

---

1. Esegui il file principale:

python riconcilia.py

2. Si aprirà un'interfaccia grafica per interagire con il programma.

Funzionamento

L'interfaccia principale fornisce 4 pulsanti principali:

1. Genera Report

• Genera i file Excel principali:

nome_cliente_prelevamento.xlsx
nome_cliente_conferimento.xlsx

Salva i file in:

• Cartella principale dei report: documenti_report/
• file Excel dettagliati: documenti_report/dettaglio_costi_banca/

Nota: I file nella cartella documenti_report/dettaglio_costi_banca/ possono essere gestiti manualmente per selezionare quali mantenere.

2. Panoramica Banche

Apre una nuova interfaccia che mostra una panoramica dettagliata per:

• Ogni banca.
• Ogni conto associato a ciascuna banca.

L'utente può:

• Inserire un valore NAV per ogni conto.
• Calcolare la percentuale del portafoglio in base al NAV.

3. Riconcilia

Apre una nuova interfaccia per:

• Mostrare i dettagli della riconciliazione economica.
• Generare automaticamente un PDF con il rendiconto economico.

4. Genera PDF

Genera un PDF per ogni file Excel salvato. Combina i PDF individuali in PDF finali per la stampa. Salva i PDF in: documenti_report/PDF/

Esecuzione del Programma (File .exe)

Per eseguire il programma:

1. Vai nella cartella bin/.
2. Esegui il file riconcilia.exe.
3. Segui le istruzioni nell'interfaccia per generare i report.

I report generati saranno salvati nella cartella documenti_report/ suddivisi tra documenti_report/PDF/ e documenti_report/dettaglio_costi_banca/.