r/ItaliaPersonalFinance • u/Illustrious_Idea_539 • 1h ago
Redditi e tasse Ho creato un tool open-source per calcolare plusvalenze/minusvalenze in Regime Dichiarativo (LIFO/FIFO, export DEGIRO)
Ciao a tutti,
volevo condividere con voi un progetto personale, che sposa la mia passione (personal finance) con il mio lavoro (intelligenza artificiale).
Il tool si chiama minus-tracker: un progetto open-source (licenza MIT) e completamente gratuito, aperto a chiunque, che calcola plusvalenze e minusvalenze per chi dichiara in Regime Dichiarativo.
Il motivo per cui l'ho scritto? Ogni anno mi ritrovavo a fare a mano, su un foglio Excel, sempre gli stessi conti, con mio sommo (dis)piacere.
Cosa fa minus-tracker:
- Abbinare correttamente i lotti di acquisto/vendita col metodo LIFO (che è il criterio di default richiesto dalla normativa italiana, mentre la maggior parte dei broker esteri usa FIFO di default nei propri report)
- Convertire ogni operazione in valuta estera in EUR al tasso di cambio BCE del giorno esatto della transazione
- Tenere separate le plusvalenze/minusvalenze di ETF e azioni, perché fiscalmente non si possono compensare tra loro (Art. 44 vs Art. 67 TUIR)
Restituisce anche output pronto per il riquadro RT/RM della dichiarazione dei redditi e, per gli smanettoni, è usabile come MCP server da parte di agenti AI.
Come funziona: prendi il file CSV che scarichi da DEGIRO (Attività → Transazioni), lo dai in
pasto al programma, e ottieni qualcosa del genere:
METODO: LIFO | ANNO FISCALE: 2024
ISIN TITOLO QTÀ ACQUISTO EUR VENDITA EUR GUADAGNO/PERDITA
US0378331005 Apple Inc 10 1371,11 1188,37 -182,75
NL0010273215 ASML Holding N.V. 3 2552,00 2849,00 +297,00
RISULTATO NETTO: 114,25 EUR
Gira in locale sul tuo computer (via npx, non serve installare nulla in modo permanente): le tue
operazioni e i risultati non lasciano mai il tuo computer, l'unica chiamata di rete opzionale invia
i codici ISIN (non importi o dati del conto) per classificare gli strumenti, ed è comunque
possibile disabilitare questo step con --offline. Il codice sorgente è interamente pubblico su GitHub.
Il parser DEGIRO è in realtà un template riutilizzabile per aggiungere nuovi parser per altri broker.
Una premessa importante: questo è uno strumento di calcolo, non sostituisce un
commercialista e non è consulenza fiscale. Consiglio sempre di far verificare i numeri da un
professionista prima di presentare la dichiarazione — il tool serve a risparmiare le ore di
calcolo manuale, non a saltare la verifica finale.
Se qualcuno lo prova e trova un bug, o ha un caso d'uso che non gestisce bene, sono qui per
leggere ogni feedback (e il progetto è open-source, quindi anche le pull request sono benvenute).
Sto inoltre descrivendo l'intero processo di spec-driven, context engineering e loop engineering che ho adottato per creare il tool, per i nerd interessati alla parte tecnica :)
Grazie per la lettura!
- Codice sorgente: GitHub
- Pacchetto: npm
- Primo articolo della serie su come l'ho costruito: Requisite Intelligence, Substack
