---
title: "Import Custom Trading e Crypto: Guida Completa"
description: "Come importare transazioni trading e crypto in formato CSV custom. Colonne, valori ammessi, errori comuni e template scaricabili."
canonical: "https://www.moneyviz.it/it/faq/import-formato-custom-trading-crypto"
url: "https://www.moneyviz.it/it/faq/import-formato-custom-trading-crypto"
lastmod: "2026-01-28T23:52:45+01:00"
source: "sitemap-md-generator"
generated_at: "2026-05-24T04:30:45+02:00"
---
## # 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

  warning  **Importante: Storico completo**

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.

    error  **Non modificare le intestazioni!**

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"`   lightbulb  **Simbolo o ISIN?**

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 |

   error  **ISIN non ammesso**

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:

1. Rileva che ne BTC ne ETH sono valute fiat
2. Crea automaticamente **2 transazioni**: SELL della prima + BUY della seconda
3. Forza la `valuta` a EUR per i calcoli fiscali
4. Se le fee sono in crypto, crea una **terza transazione FEE**

  swap_horiz  **Esempio pratico**

`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,`   warning  **FEE non puo essere C2C**

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 |

   block  **Tipi NON ammessi**

**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

  [description

#### Template vuoto Trading

File base con solo intestazioni](https://www.moneyviz.it/himoney/assets/downloads/templates/custom_trading_template.csv) [play_circle

#### Esempio base Trading

BUY, SELL, DIVIDEND semplici](https://www.moneyviz.it/himoney/assets/downloads/templates/custom_trading_example_basic.csv) [library_books

#### Esempio completo Trading

Tutte le casistiche: deposit, withdrawal, derivati, gift](https://www.moneyviz.it/himoney/assets/downloads/templates/custom_trading_example_full.csv)

### Custom Crypto

  [description

#### Template vuoto Crypto

File base con solo intestazioni](https://www.moneyviz.it/himoney/assets/downloads/templates/custom_crypto_template.csv) [play_circle

#### Esempio base Crypto

BUY e SELL semplici fiat-crypto](https://www.moneyviz.it/himoney/assets/downloads/templates/custom_crypto_example_basic.csv) [swap_horiz

#### Esempio Crypto-to-Crypto

Swap tra criptovalute (BTC-ETH, USDT-USDC)](https://www.moneyviz.it/himoney/assets/downloads/templates/custom_crypto_example_c2c.csv) [account_balance

#### Esempio DeFi

Staking, lending, airdrop con contract_address](https://www.moneyviz.it/himoney/assets/downloads/templates/custom_crypto_example_defi.csv) [library_books

#### Esempio completo Crypto

Tutte le casistiche: C2C, staking, airdrop, derivati](https://www.moneyviz.it/himoney/assets/downloads/templates/custom_crypto_example_full.csv)   verified  **Encoding UTF-8**

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.