Quando usare il formato Custom?
Il formato Custom ti permette di importare transazioni da qualsiasi intermediario, anche se non direttamente supportato da MoneyViz. Esistono due varianti:
- Custom Trading - Per azioni, ETF, CFD, derivati, Forex
- Custom PHP/Crypto - Per criptovalute, token, DeFi
Importa sempre tutte le transazioni dall'inizio, anche se si riferiscono ad anni precedenti a quello da dichiarare. MoneyViz ha bisogno dello storico completo per calcolare correttamente plusvalenze e minusvalenze.
La prima riga del file CSV contiene i nomi delle colonne. Non rinominare, non rimuovere e non riordinare le colonne. Il sistema si aspetta esattamente le intestazioni presenti nel template. Modifica solo i dati a partire dalla riga 2.
Regole generali:
- I tipi transazione sono case-insensitive (BUY = buy = Buy)
- I numeri decimali accettano sia
.che, - Le date non possono essere nel futuro
Custom Trading: Azioni, ETF, Derivati
Usa questo formato per importare transazioni da broker trading (azioni, ETF, CFD, futures, opzioni, Forex).
Colonne del file CSV
| Colonna | Obbl. | Tipo | Valori/Formato | Note |
|---|---|---|---|---|
data |
Obbl. | Data | dd/mm/yyyy o yyyy-mm-dd |
No date future. Accetta anche formato Excel. |
tipo |
Obbl. | Stringa | BUY, SELL, DIVIDEND, DEPOSIT, WITHDRAWAL, FEE, GIFT, EARN, DERIVATIVE_PL |
Case insensitive |
valuta |
Obbl. | Stringa | EUR, USD, GBP, CHF, etc. |
Codice ISO 4217. Solo valute fiat. |
qt |
Obbl. | Numero | Decimale con . o , |
Quantita di titoli/quote |
borsa |
Obbl. | Stringa | MIL, NASDAQ, NYSE, XETRA, LSE, etc. |
Codice exchange. Se non esiste viene creato. |
simboloazienda |
Cond. | Stringa | AAPL, MSFT, ENEL, etc. |
Obbligatorio se ISIN non presente |
isin |
Cond. | Stringa | 12 caratteri (es. IT0003128367) |
Obbligatorio se simbolo non presente |
prezzo |
Opz. | Numero | Prezzo unitario | Se vuoto, calcolato automaticamente |
commissioni |
Opz. | Numero | Importo commissioni | |
valuta_commissioni |
Opz. | Stringa | EUR, USD, etc. |
Se diversa dalla valuta principale |
cambio |
Opz. | Numero | Tasso di cambio | Override manuale del cambio EUR/valuta |
note |
Opz. | Stringa | Testo libero | Descrizione aggiuntiva |
Esempio base
data,tipo,valuta,qt,borsa,simboloazienda,isin,prezzo,commissioni,valuta_commissioni,cambio,note
01/03/2024,BUY,EUR,100,MIL,ENEL,IT0003128367,6.50,2.50,EUR,,Acquisto Enel
15/06/2024,SELL,EUR,50,MIL,ENEL,IT0003128367,7.20,2.50,EUR,,Vendita parziale
01/09/2024,DIVIDEND,EUR,1,MIL,ENEL,IT0003128367,25.00,,,,"Dividendo Q3"
Devi compilare almeno uno tra simboloazienda e isin.
Se compili entrambi, il sistema usa l'ISIN per il matching. L'ISIN e preferibile
perche piu preciso (stesso ticker puo esistere su borse diverse).
Custom Crypto: Criptovalute e Token
Usa questo formato per importare transazioni da exchange crypto, wallet, DeFi, staking.
Colonne del file CSV
| Colonna | Obbl. | Tipo | Valori/Formato | Note |
|---|---|---|---|---|
data |
Obbl. | Data | dd/mm/yyyy o yyyy-mm-dd |
No date future |
tipo |
Obbl. | Stringa | BUY, SELL, DEPOSIT, WITHDRAWAL, FEE, GIFT, EARN, DERIVATIVE_PL |
Case insensitive. DIVIDEND non ammesso per crypto. |
valuta |
Obbl. | Stringa | EUR, USD, GBP |
Solo fiat. Se inserisci crypto viene forzata a EUR. |
qt |
Obbl. | Numero | Decimale (fino a 21 cifre) | Quantita crypto acquistata/venduta |
borsa |
Obbl. | Stringa | CC |
Usa sempre CC per le importazioni crypto custom. |
simboloazienda |
Obbl. | Stringa | BTC-EUR, ETH-USD, BTC-ETH |
Formato: CRYPTO-VALUTA. Per C2C: CRYPTO-CRYPTO. |
isin |
Opz. | Stringa | lasciare vuoto | Non valorizzare. La colonna deve esistere ma restare vuota. |
prezzo |
Opz. | Numero | Prezzo unitario in valuta | Se vuoto, recuperato automaticamente |
commissioni |
Opz. | Numero | Fee in crypto o fiat | Se in crypto, crea transazione FEE separata |
valuta_commissioni |
Opz. | Stringa | BTC, ETH, EUR, etc. |
Se crypto, genera transazione FEE separata |
cambio |
Opz. | Numero | Tasso EUR/USD | Override manuale |
note |
Opz. | Stringa | Testo libero | Descrizione |
contract_address |
Opz. | Stringa | 0x... |
Per token ERC20/BEP20 non standard |
Nel formato Custom Crypto la colonna isin non deve essere presente.
Se la valorizzi, riceverai un errore. Per identificare token usa contract_address.
Esempio base
data,tipo,valuta,qt,borsa,simboloazienda,isin,prezzo,commissioni,valuta_commissioni,cambio,note,contract_address
01/01/2024,BUY,EUR,0.5,CC,BTC-EUR,,42000.00,10.50,EUR,,Primo acquisto BTC,
15/01/2024,BUY,EUR,2.0,CC,ETH-EUR,,2200.00,5.50,EUR,,Acquisto Ethereum,
01/03/2024,SELL,EUR,0.1,CC,BTC-EUR,,48000.00,12.00,EUR,,Vendita parziale,
Crypto-to-Crypto (C2C): Swap tra criptovalute
Quando scambi una crypto per un'altra (es. BTC per ETH), il sistema rileva automaticamente che si tratta di uno swap C2C e crea le transazioni corrette.
Come funziona
Quando simboloazienda contiene due crypto separate da -
(es. BTC-ETH), il sistema:
- Rileva che ne BTC ne ETH sono valute fiat
- Crea automaticamente 2 transazioni: SELL della prima + BUY della seconda
- Forza la
valutaa EUR per i calcoli fiscali - Se le fee sono in crypto, crea una terza transazione FEE
BTC-ETH con tipo BUY, qt=1.5, prezzo=15.5
Il sistema interpreta: "Compro 1.5 ETH pagando 15.5 BTC per ogni ETH"
Risultato: SELL di (1.5 x 15.5) = 23.25 BTC + BUY di 1.5 ETH
Esempio CSV per swap
data,tipo,valuta,qt,borsa,simboloazienda,isin,prezzo,commissioni,valuta_commissioni,cambio,note,contract_address
01/02/2024,BUY,EUR,1.5,CC,BTC-ETH,,15.5,0.001,ETH,,Swap BTC per ETH,
15/02/2024,BUY,EUR,1000,CC,USDT-USDC,,1.0,0.5,USDC,,Swap stablecoin,
Il tipo FEE non puo avere un simbolo C2C (es. USDT-USDC).
Le fee devono essere in una singola crypto o fiat.
Tipi di transazione ammessi
Questi sono i tipi di transazione che puoi usare nel campo tipo:
| Tipo | Descrizione | Esempio d'uso |
|---|---|---|
BUY |
Acquisto di titoli/crypto | Compri 100 azioni Apple, compri 0.5 BTC |
SELL |
Vendita di titoli/crypto | Vendi 50 azioni Enel, vendi 1 ETH |
DEPOSIT |
Deposito di fondi o crypto | Depositi 1000 EUR sul broker, trasferisci BTC da altro wallet |
WITHDRAWAL |
Prelievo di fondi o crypto | Prelevi EUR dal broker, invii ETH ad altro wallet |
DIVIDEND |
Dividendo ricevuto (solo Trading) | Ricevi dividendo trimestrale da Enel |
FEE |
Commissione pagata | Commissione custodia, gas fee blockchain |
GIFT |
Titoli/crypto ricevuti gratuitamente | Airdrop, bonus, referral, azioni regalo |
EARN |
Proventi da staking/lending | Reward staking ETH, interessi lending USDC |
DERIVATIVE_PL |
Profit/Loss da derivati | P/L futures, opzioni, CFD |
Non usare TRADE_BUY o TRADE_SELL nel CSV.
Questi tipi sono usati internamente dal sistema per le transazioni C2C
e genereranno un errore se inseriti manualmente.
Errori comuni e soluzioni
Errori di formato
| Messaggio | Causa | Soluzione |
|---|---|---|
| "Si prega di non modificare la prima riga del file modello" | Header CSV modificato o colonne aggiunte/rimosse | Scarica un nuovo template e ricopia i dati |
| "Il formato del file e sbagliato o il file e vuoto" | File vuoto o formato non riconosciuto | Verifica che il file abbia righe di dati oltre all'header |
| "Formato Data Non Valido... formato GG/MM/AAAA" | Data in formato americano (MM/DD/YYYY) | Usa formato europeo: dd/mm/yyyy o ISO: yyyy-mm-dd |
| "Caratteri non ammessi nella colonna Prezzo (formule es. 10*15)" | Formula Excel invece di numero | Converti le formule in valori prima di esportare |
| "Nessun carattere speciale tranne '-', '.' ammessi" | Caratteri speciali nel simbolo | Rimuovi caratteri speciali (es. $, #, @) dal simbolo |
Errori specifici Crypto
| Messaggio | Causa | Soluzione |
|---|---|---|
| "Per le importazioni crypto il campo ISIN non deve essere valorizzato" | Colonna ISIN presente nel file Crypto | Rimuovi la colonna ISIN. Usa contract_address per i token. |
| "Se la crypto ha simbolo '-EUR' anche la valuta deve essere EUR" | Mismatch tra simbolo e valuta | Se usi BTC-EUR, la valuta deve essere EUR |
| "FEE non puo essere uno swap tra crypto" | Tipo FEE con simbolo C2C | Le FEE devono avere simbolo singolo (es. ETH-EUR, non ETH-BTC) |
Errori tabelle collegate
| Elemento | Comportamento |
|---|---|
| Valuta non riconosciuta |
Trading: Errore "valuta non valida" Crypto: Viene forzata automaticamente a EUR |
| Exchange/Borsa non esistente | Viene creato automaticamente come exchange custom. Nessun errore. |
| Ticker/Simbolo non trovato | Viene creato automaticamente come ticker custom. Nessun errore. |
Valute fiat supportate
Le valute fiat riconosciute sono (codice ISO 4217):
EUR, USD, GBP, CHF, JPY, AUD, CAD, SEK, NOK, DKK, PLN, CZK, HUF, RON, BGN, HRK, TRY, RUB, CNY, HKD, SGD, KRW, INR, BRL, MXN, ZAR, NZD, ILS, THB, MYR, PHP, IDR, VND, AED, SAR
Download template ed esempi
Custom Trading
Template vuoto Trading
File base con solo intestazioni
Esempio base Trading
BUY, SELL, DIVIDEND semplici
Esempio completo Trading
Tutte le casistiche: deposit, withdrawal, derivati, gift
Custom Crypto
Template vuoto Crypto
File base con solo intestazioni
Esempio base Crypto
BUY e SELL semplici fiat-crypto
Esempio Crypto-to-Crypto
Swap tra criptovalute (BTC-ETH, USDT-USDC)
Esempio DeFi
Staking, lending, airdrop con contract_address
Esempio completo Crypto
Tutte le casistiche: C2C, staking, airdrop, derivati
Tutti i file sono in formato UTF-8. Se modifichi con Excel, assicurati di salvare come "CSV UTF-8 (delimitato da virgole)" per preservare i caratteri speciali.