In questa guida troverai tutto ciò che devi sapere su quando utilizzare il formato CSV TradFi e su come inserire correttamente le tue transazioni al suo interno.
Cos'è il CSV custom TradFi di Finbooks?
Il CSV custom TradFi di Finbooks è un formato di foglio di calcolo specifico che accettiamo per l'importazione delle tue transazioni finanziarie tradizionali.
Dovresti utilizzare questo formato se:
stai cercando di importare transazioni che coinvolgono strumenti finanziari tradizionali come azioni, obbligazioni, ETF, derivati e simili.
non supportiamo una connessione API diretta alla tua piattaforma
non supportiamo il formato di esportazione nativo della piattaforma
Il nostro CSV personalizzato è progettato per essere semplice e intuitivo. Basta compilare i dettagli della transazione seguendo il nostro modello e potrai importare i tuoi dati TradFi anche se la tua piattaforma non è direttamente supportata.
ℹ️ Che cos'è un file CSV e come modificarlo
Se non hai familiarità con i file CSV o hai bisogno di aiuto per modificarli e salvarli, consulta questa guida. In alternativa, puoi lasciare che il nostro servizio CSV gestisca la formattazione per te. Per saperne di più, consulta questa guida.
L'intestazione CSV
Il formato CSV TradFi è composto da 13 colonne. La prima riga contiene l'intestazione CSV, con il titolo di ciascuna colonna, e ogni colonna ha uno scopo diverso.
Le colonne devono essere compilate secondo regole specifiche (spiegate in questa sezione) e devono rimanere nell'ordine corretto.
Questa sarà sempre l'intestazione richiesta:
CLASSE DI ATTIVITÀ, TIPO, CODICE DI SCAMBIO, CATEGORIA, DATA DELLA TRANSAZIONE, ATTIVITÀ IN USCITA, IMPORTO IN USCITA, ATTIVITÀ IN ENTRATA, IMPORTO IN ENTRATA, VALUTA DELLA COMMISSIONE, IMPORTO DELLA COMMISSIONE, ID POSIZIONE, NOTE
Ogni riga rappresenta una singola transazione e deve contenere solo i dati relativi a tale transazione.
Spiegazione di ciascuna colonna
Qui puoi trovare una spiegazione su come deve essere utilizzata ciascuna colonna del CSV e quali valori sono accettati. Forniamo anche informazioni su quando una colonna deve essere compilata, quando non deve essere compilata e quando è facoltativa in base al tipo di transazione che si desidera rappresentare.
ASSET CLASS
La compilazione di questa colonna è sempre obbligatoria. Questo campo è necessario per identificare il tipo di strumento finanziario coinvolto nella transazione e per determinare quali regole contabili e fiscali si applicano.
Se la transazione coinvolge sia valuta fiat che un'altra asset class, ad esempio quando si acquista o si vende un'azione, questo campo deve sempre essere compilato con la classe di attività dello strumento finanziario diverso dalla valuta fiat.
Ad esempio:
quando si acquista un'azione utilizzando USD, la classe di attività deve essere STOCK
quando si vende un ETF in EUR, la Classe di attività deve essere ETF
La classe di attività deve essere impostata su Valuta fiat solo quando la transazione coinvolge esclusivamente valute fiat, come ad esempio:
un'operazione da USD a EUR
ricezione di interessi pagati in valuta fiat
I valori accettati sono:
Stock
ETF
Mutual funds
Bonds
Forex
CFD
Futures
Options
Certificates
Warrants
TYPE
La compilazione di questa colonna è sempre obbligatoria. Questa colonna viene utilizzata per specificare se nella transazione hai ricevuto un bene, pagato o inviato un bene, oppure scambiato un bene con un altro.
I valori accettati sono:
Incoming
Outgoing
Trade
EXCHANGE CODE
Questo campo è necessario per trovare il prezzo di mercato corretto relativo all'asset. È sempre obbligatorio, tranne quando il campo Asset Class della transazione è CFD.
Il formato accettato è il codice ufficiale della borsa o della sede in cui è avvenuta la negoziazione.
⚠️ Nota bene
Se il codice di borsa è mancante o errato, il software potrebbe non essere in grado di recuperare il prezzo di mercato corretto per l'asset.
CATEGORY
La compilazione di questa colonna è sempre obbligatoria. Le categorie aiutano a organizzare la contabilità e garantiscono che il software tratti correttamente ogni transazione ai fini della rendicontazione e della fiscalità.
I valori accettati sono:
Trading
Interest
Dividends
Fees
Tax
Deposit
Withdraw
PNL
Split
Reverse split
DATA DELLA TRANSAZIONE
La compilazione di questa colonna è sempre obbligatoria. Consente al software di comprendere quando è avvenuta una transazione. Di seguito è riportato l'elenco dei formati supportati:
aaaa-MM-gg HH:mm:ss
aaaa-MM-gg HH:mm
gg/MM/aaaa HH:mm:ss
gg/MM/aaaa HH:mm
Dove aaaa è l'anno, MM è il mese, gg è il giorno, hh è l'ora, mm sono i minuti e ss sono i secondi.
Ad esempio, se una transazione è avvenuta il 2 gennaio 2024 alle 21:45, può essere importata come:
2024-01-02 21:45:00
2024-01-02 21:45
02-01-2024 21:45:00
02-01-2024 21:45
OUTGOING ASSET
Inserisci il ticker dell'asset che hai inviato. Questo campo è obbligatorio per le transazioni in uscita e di scambio. Lascia questo campo vuoto per le transazioni in entrata.
ℹ️ Come comporre il ticker dell'opzione
Per archiviare correttamente le transazioni di opzioni è necessario utilizzare il simbolo dell'opzione OCC. Questo è composto da quattro parti:
Simbolo principale del titolo o dell'ETF sottostante, riempito con spazi fino a 6 caratteri
Data di scadenza, 6 cifre nel formato aammgg
Tipo di opzione, P o C, per put o call
Prezzo di esercizio, come prezzo x 1000 (dollari e millesimi di dollaro o millesimi di dollaro adeguati), preceduto da zeri fino a 8 cifre
ℹ️ Come comporre il proprio ticker future
Per registrare correttamente le tue transazioni future devi utilizzare il simbolo standard del contratto future. Puoi consultare questa guida per scoprire come funziona.
OUTGOING AMOUNT
Inserisci qui l'importo (o la quantità) dell'asset che hai inviato. Questo campo è obbligatorio per le transazioni in uscita e di negoziazione. Lascia questo campo vuoto per le transazioni in entrata.
⚠️ Ricordati delle virgolette in caso di virgole all'interno dell'importo
Se utilizzi una virgola come separatore decimale, devi racchiudere gli importi e le intestazioni tra virgolette ("xxxx.xx").
Questa regola deve essere applicata a tutti i campi in cui si inseriscono valori numerici che utilizzano una virgola per indicare gli importi decimali.
Ad esempio, devi importare una transazione in entrata di € 2.999,85
Formato di riga errato
In entrata, Trading, 13/04/2022 19:04, EUR, 2999,85,,,,,,,,
Formati di riga corretti
In entrata, Trading, 13/04/2022 19:04, EUR, "2999,85",,,,,,,,
In entrata, Trading, 13/04/2022 19:04, EUR, 2999,85,,,,,,,,
INCOMING ASSET
Inserisci l'identificativo dell'asset che hai ricevuto. Questo campo è obbligatorio per le transazioni in entrata e di trading. Lascia questo campo vuoto per le transazioni in uscita.
I formati accettati sono gli stessi delle risorse in uscita.
INCOMING AMOUNT
Inserisci qui l'importo (o la quantità) dell'asset che hai ricevuto. Questo campo è obbligatorio per le transazioni in entrata e di scambio. Lascia questo campo vuoto per le transazioni in uscita.
⚠️ Ricordati di usare le virgolette in caso di virgole all'interno dell'importo
La stessa regola descritta per l'importo in uscita si applica all'importo in entrata.
FEE CURRENCY
Inserisci qui il ticker della valuta che hai utilizzato per pagare le commissioni. Questo campo è facoltativo per tutte le transazioni, dovresti compilarlo solo se hai pagato delle commissioni.
FEE AMOUNT
Inserisci qui l'importo della commissione che hai pagato. Questo campo è facoltativo, ma diventa obbligatorio se viene compilato il campo Valuta della commissione.
POSITION ID
Questo campo è facoltativo, ma deve essere utilizzato ogni volta che una transazione deve essere esplicitamente collegata a un'attività sottostante specifica. L'ID posizione consente al sistema di associare correttamente i movimenti che sono economicamente collegati allo stesso strumento finanziario.
In particolare, dovrebbe essere utilizzato per:
collegare le commissioni all'asset a cui si riferiscono
associare coupon, dividendi e distribuzioni al titolo, obbligazione o ETF corretto
tracciare le posizioni CFD durante il loro ciclo di vita, comprese le operazioni di apertura, adeguamento e chiusura
Ad esempio, se si riceve un dividendo in USD da Apple, è necessario includere un identificatore strutturato nell'ID posizione in modo che l'importo fiat in entrata sia correttamente collegato all'azione sottostante.
In questi casi, l'ID posizione deve seguire questo formato: Ticker, Classe di attività, Mercato.
Ad esempio: AAPL, Azioni, Stati Uniti
L'utilizzo di questa combinazione strutturata garantisce che le transazioni correlate siano chiaramente identificate, raggruppate in modo coerente ed elaborate secondo le corrette regole contabili.
NOTES
Questo campo può essere utilizzato per inserire note relative a una transazione. I commenti inseriti qui verranno visualizzati nei dettagli della transazione una volta importati in Finbooks.
Questo campo è sempre facoltativo.
Come inserire una transazione di trading
Le colonne che è necessario compilare per una transazione commerciale sono:
asset class
type
exchange code
category
transaction date
outgoing asset
outgoing amount
incoming asset
incoming amount
fee currency, solo se è stata pagata una commissione
fee amount, solo se è stata pagata una commissione
Ad esempio, il 01/01/2025 alle 13:34:56 hai acquistato 10 AAPL pagando 1500 USD e hai pagato una commissione di 5 USD:
STOCK,Trade,XNAS,Trading,01/01/2025 13:34:56,USD,1500,AAPL,10,USD,5,,
Se utilizzi una virgola come separatore decimale:
STOCK,Trade,XNAS,Trading,01/01/2025 13:34:56,USD,"1500,00",AAPL,10,USD,"5,00",,
Come inserire una transazione in entrata
Le colonne che è necessario compilare per una transazione in entrata sono:
asset class
type
exchange code
category
transaction date
incoming asset
incoming amount
fee currency, solo se è stata pagata una commissione
fee amount, solo se è stata pagata una commissione
Ad esempio, il 26/12/2025 alle 14:41:01 hai ricevuto un dividendo di 50 USD.
AZIONI,In entrata,XNAS,Dividendo,26/12/2025 14:41:01,,,USD,50,,,"RACE, Azioni, MI",
Come inserire una transazione in uscita
Le colonne che devi compilare per una transazione in uscita sono:
asset class
type
exchange code
category
transaction date
outgoing asset
outgoing amount
fee currency, solo se è stata pagata una commissione
fee amount, solo se è stata pagata una commissione
Ad esempio, il 13/05/2025 alle 10:12 hai pagato una commissione di 1,55 USD.
Valuta fiat, in uscita, XNAS, commissione, 13/05/2025 10:12, USD, 1,55,,,,,AAPL, Azioni, Stati Uniti
Se utilizzi la virgola come separatore decimale:
Valuta fiat, In uscita, XNAS, Commissione, 13/05/2025 10:12, USD, "1,55",,,,,AAPL, Azioni, Stati Uniti,