@gabrielerandelli/minus-tracker 0.5.8 → 0.7.0

package/README.md

@@ -194,9 +194,22 @@ Esegui `minus-tracker rates --update`. Il comando `calc` esegue l'aggiornamento
 **LIFO o FIFO?**
 Il Regime Dichiarativo utilizza il LIFO come metodo predefinito ai sensi della normativa fiscale italiana. Il FIFO è disponibile per confronto. Consulta il tuo commercialista per conferma.
 
+### Limitazioni note
+
+minus-tracker aggrega le plusvalenze e le minusvalenze di **tutti gli strumenti finanziari in un'unica somma**, indipendentemente dalla loro categoria fiscale.
+
+La normativa italiana prevede che i **redditi diversi** (azioni, derivati, certificati — Art. 67 TUIR) e i **redditi di capitale** (ETF/fondi UCITS — Art. 44 TUIR) non possano essere compensati tra loro: una minusvalenza su un ETF non può ridurre la plusvalenza su un'azione, e viceversa.
+
+**Portafogli con soli titoli azionari o soli ETF:** il calcolo è corretto.
+**Portafogli misti (azioni + ETF):** il risultato netto riportato non è direttamente utilizzabile ai fini dichiarativi. In questo caso è necessario separare manualmente i lotti per categoria fiscale prima di presentare la dichiarazione, con l'assistenza di un commercialista.
+
 ### Avvertenza
 
-minus-tracker è un **ausilio al calcolo e non costituisce in alcun modo consulenza fiscale**. I report generati sono pensati per essere verificati e consegnati a un commercialista o a un professionista qualificato.
+minus-tracker è un **progetto personale** sviluppato a titolo privato e **non è in alcun modo affiliato, sponsorizzato o rappresentativo del datore di lavoro dell'autore o di qualsiasi altra organizzazione**.
+
+Il tool è fornito **esclusivamente come ausilio al calcolo** e **non costituisce consulenza fiscale, legale o finanziaria**. L'autore **declina ogni responsabilità** per eventuali errori nei calcoli, per un utilizzo improprio dello strumento o per le decisioni prese dall'utente finale sulla base dei report generati.
+
+Si raccomanda **sempre** di verificare i risultati con un commercialista o professionista fiscale qualificato prima di presentare qualsiasi dichiarazione.
 
 ---
 
@@ -413,12 +426,24 @@ The CSV contains a SELL for a position that has no prior BUY in the same file. T
 Run `minus-tracker rates --update`. The `calc` command also auto-updates if the snapshot is more than 7 days old.
 
 **LIFO or FIFO?**
-LIFO is the standard lot-matching method under Italian tax law for the Regime Dichiarativo. FIFO is available for comparison or other jurisdictions. Consult your commercialista for confirmation.
+LIFO is the standard lot-matching method under Italian tax law for the Regime Dichiarativo. FIFO is available for comparison or other jurisdictions. Consult your tax advisor for confirmation.
+
+### Known Limitations
+
+minus-tracker aggregates gains and losses from **all financial instruments into a single total**, regardless of their tax category.
+
+Italian law requires that **redditi diversi** (individual stocks, derivatives, certificates — Art. 67 TUIR) and **redditi di capitale** (ETFs / UCITS funds — Art. 44 TUIR) be kept separate: a loss on an ETF cannot offset a gain on a stock, and vice versa.
+
+**Portfolios holding only stocks or only ETFs:** the calculation is correct.
+**Mixed portfolios (stocks + ETFs):** the reported net result cannot be used directly for tax filing. In this case, lots must be manually separated by tax category before filing, with the help of a qualified tax advisor.
 
 ### Disclaimer
 
-minus-tracker is a **calculation aid, not tax advice**. Outputs are intended for review
-and handoff to a qualified commercialista.
+minus-tracker is a **personal project** developed in a private capacity and is **not affiliated with, endorsed by, or representative of the author's employer or any other organisation**.
+
+This tool is provided **solely as a calculation aid** and **does not constitute tax, legal, or financial advice**. The author **accepts no liability** for errors in the output, misuse of the tool, or any decisions made by end users based on the generated reports.
+
+You are **always** encouraged to review results with a qualified tax advisor before filing any return.
 
 ---