Zum Hauptinhalt springen

So erstellst du die TradFi-Custom-CSV

🟣 Traditional-Finance-Anleitung

In dieser Anleitung erfährst du, wann du das TradFi-CSV-Format verwendest und wie du deine Transaktionen korrekt einträgst.

Was ist die TradFi-Custom-CSV von Finbooks?

Die TradFi-Custom-CSV ist ein Tabellenformat, mit dem du deine Traditional-Finance-Transaktionen in Finbooks importieren kannst. Nutze dieses Format in folgenden Fällen.

  • Du möchtest Transaktionen mit Aktien, Anleihen, ETFs, Derivaten oder ähnlichen Finanzinstrumenten importieren.

  • Finbooks unterstützt keine direkte API-Verbindung zu deiner Plattform.

  • Finbooks unterstützt das Exportformat deiner Plattform nicht.

Trage deine Transaktionen nach unserer Vorlage ein. So kannst du deine TradFi-Daten auch dann importieren, wenn Finbooks deine Plattform nicht direkt unterstützt.

ℹ️ Was ist eine CSV-Datei und wie bearbeite ich sie?

Wenn du mit CSV-Dateien noch nicht vertraut bist oder Hilfe beim Bearbeiten und Speichern brauchst, findest du die Schritte in dieser Anleitung. Alternativ kann unser CSV-Service die Formatierung für dich übernehmen.

Die CSV-Kopfzeile

Das TradFi-CSV-Format besteht aus 13 Spalten. In der ersten Zeile stehen die Spaltennamen. Jede Spalte hat einen eigenen Zweck und muss nach den unten beschriebenen Regeln ausgefüllt werden. Die Spaltenreihenfolge ist fest vorgegeben.

ASSET CLASS,TYPE,EXCHANGE CODE,CATEGORY,TRANSACTION DATE,OUTGOING ASSET,OUTGOING AMOUNT,INCOMING ASSET,INCOMING AMOUNT,FEE CURRENCY,FEE AMOUNT,POSITION ID,NOTES

Jede weitere Zeile steht für genau eine Transaktion und enthält ausschließlich die Daten dieser Transaktion.

Erklärung der einzelnen Spalten

Hier erfährst du, wie du jede CSV-Spalte verwendest, welche Werte zulässig sind und welche Felder je nach Transaktionsart Pflichtfelder oder optional sind.

ASSET CLASS

Diese Spalte ist immer ein Pflichtfeld. Sie gibt an, um welche Art von Finanzinstrument es sich handelt und welche Regeln für die Aufbereitung und die Steuerdaten gelten. Wenn bei einer Transaktion sowohl Fiatgeld als auch eine andere Anlageklasse beteiligt sind, gib die Anlageklasse des Finanzinstruments an.

  • Beim Kauf einer Aktie in USD lautet die Anlageklasse STOCK.

  • Beim Verkauf eines ETF gegen EUR lautet die Anlageklasse ETF.

Verwende Fiat Currency nur für Transaktionen, an denen ausschließlich Fiatwährungen beteiligt sind, zum Beispiel beim Umtausch von USD in EUR oder bei Zinszahlungen in Fiatgeld.

Zulässige Werte

  • Stock

  • ETF

  • Mutual Funds

  • Bond

  • Fiat Currency

  • CFD

  • Future

  • Option

  • Certificate

  • Warrants

TYPE

Diese Spalte ist immer ein Pflichtfeld. Sie zeigt, ob du einen Vermögenswert erhalten, ihn ausgegeben oder gesendet oder ihn gegen einen anderen Vermögenswert getauscht hast.

  • Incoming

  • Outgoing

  • Trade

EXCHANGE CODE

Finbooks benötigt diesen Code, um den richtigen Marktpreis für den Vermögenswert zu finden. Das Feld ist Pflicht, außer wenn ASSET CLASS auf CFD gesetzt ist. Gib den offiziellen Code des Markts oder Handelsplatzes an, an dem der Handel stattgefunden hat.

⚠️ Hinweis

Fehlt der Code oder ist er falsch, kann Finbooks den passenden Marktpreis möglicherweise nicht abrufen.

CATEGORY

Diese Spalte ist immer ein Pflichtfeld. Die Kategorie hilft Finbooks, Transaktionen für Berichte und Steuerdaten richtig einzuordnen.

  • Trading

  • Interest

  • Dividend

  • Fee

  • Tax

  • Deposit

  • Withdraw

  • PNL

  • Split

  • Reverse splits

TRANSACTION DATE

Diese Spalte ist immer ein Pflichtfeld. Sie gibt an, wann die Transaktion stattgefunden hat. Folgende Formate werden unterstützt.

  • yyyy-MM-dd HH:mm:ss

  • yyyy-MM-dd HH:mm

  • dd/MM/yyyy HH:mm:ss

  • dd/MM/yyyy HH:mm

yyyy steht für das Jahr, MM für den Monat, dd für den Tag, HH für die Stunde, mm für die Minuten und ss für die Sekunden. Eine Transaktion am 2. Januar 2024 um 21:45 Uhr kannst du so importieren.

  • 2024-01-02 21:45:00

  • 2024-01-02 21:45

  • 02/01/2024 21:45:00

  • 02/01/2024 21:45

OUTGOING ASSET

Gib den Ticker des abgegangenen Vermögenswerts ein. Das Feld ist bei Outgoing- und Trade-Transaktionen Pflicht. Bei Incoming-Transaktionen bleibt es leer.

ℹ️ So setzt sich der Ticker einer Option zusammen

Verwende für Optionen das OCC-Optionssymbol. Es besteht aus vier Teilen.

  • Ticker der zugrunde liegenden Aktie oder des ETF, mit Leerzeichen auf sechs Zeichen aufgefüllt

  • Verfallsdatum mit sechs Ziffern im Format yymmdd

  • Optionstyp P für Put oder C für Call

  • Ausübungspreis × 1.000, auf acht Ziffern mit führenden Nullen aufgefüllt

ℹ️ So gibst du den Ticker eines Futures an

Verwende für Futures das Standardsymbol des jeweiligen Futures-Kontrakts.

OUTGOING AMOUNT

Gib den Betrag oder die Menge des abgegangenen Vermögenswerts ein. Das Feld ist bei Outgoing- und Trade-Transaktionen Pflicht. Bei Incoming-Transaktionen bleibt es leer.

⚠️ Setze Beträge mit Dezimalkomma in Anführungszeichen

Wenn du ein Komma als Dezimaltrennzeichen verwendest, setze den Zahlenwert in doppelte Anführungszeichen. Das gilt für alle Zahlenfelder. Für einen eingehenden Betrag von 2.999,85 € sieht die Zeile beispielsweise so aus.

Falsch

Fiat Currency,Incoming,XNAS,Deposit,13/04/2022 19:04,,,EUR,2999,85,,,,

Richtig

Fiat Currency,Incoming,XNAS,Deposit,13/04/2022 19:04,,,EUR,"2999,85",,,,
Fiat Currency,Incoming,XNAS,Deposit,13/04/2022 19:04,,,EUR,2999.85,,,,

INCOMING ASSET

Gib den Ticker oder die Kennung des erhaltenen Vermögenswerts ein. Das Feld ist bei Incoming- und Trade-Transaktionen Pflicht. Bei Outgoing-Transaktionen bleibt es leer. Es gelten dieselben Formate wie bei OUTGOING ASSET.

INCOMING AMOUNT

Gib den Betrag oder die Menge des erhaltenen Vermögenswerts ein. Das Feld ist bei Incoming- und Trade-Transaktionen Pflicht. Bei Outgoing-Transaktionen bleibt es leer.

⚠️ Setze Beträge mit Dezimalkomma in Anführungszeichen

Für INCOMING AMOUNT gilt dieselbe Regel wie für OUTGOING AMOUNT.

FEE CURRENCY

Gib den Ticker der Währung ein, in der du die Gebühr bezahlt hast. Lass das Feld leer, wenn keine Gebühr angefallen ist.

FEE AMOUNT

Gib die Höhe der Gebühr ein. Das Feld ist optional und wird zum Pflichtfeld, sobald FEE CURRENCY ausgefüllt ist.

POSITION ID

Dieses Feld ist optional. Gib jedoch eine Positions-ID an, wenn Finbooks eine Transaktion einem bestimmten Basiswert zuordnen muss. Die Positions-ID verknüpft Vorgänge, die wirtschaftlich zum selben Finanzinstrument gehören. Verwende sie insbesondere, um

  • Gebühren dem zugehörigen Vermögenswert zuzuordnen,

  • Kupons, Dividenden und Ausschüttungen der richtigen Aktie, Anleihe oder dem richtigen ETF zuzuordnen,

  • CFD-Positionen von der Eröffnung über Anpassungen bis zur Schließung nachzuverfolgen.

Wenn du etwa eine Apple-Dividende in USD erhältst, gib eine Positions-ID an, damit Finbooks den Zahlungseingang der Aktie zuordnen kann. Das Format lautet Ticker, Anlageklasse, Markt, zum Beispiel AAPL, Stock, US. Mit dieser Kombination kann Finbooks zusammengehörige Transaktionen eindeutig erkennen, gruppieren und nach den passenden Regeln verarbeiten.

NOTES

Hier kannst du optional Anmerkungen zur Transaktion eintragen. Nach dem Import zeigt Finbooks sie in den Transaktionsdetails an.

So erfasst du eine Trade-Transaktion

Fülle für eine Trade-Transaktion diese Spalten aus.

  • ASSET CLASS

  • TYPE

  • EXCHANGE CODE

  • CATEGORY

  • TRANSACTION DATE

  • OUTGOING ASSET

  • OUTGOING AMOUNT

  • INCOMING ASSET

  • INCOMING AMOUNT

  • FEE CURRENCY (falls eine Gebühr angefallen ist)

  • FEE AMOUNT (falls eine Gebühr angefallen ist)

Beispiel. Am 01.01.2025 um 13:34:56 Uhr kaufst du 10 AAPL für 1.500 USD und zahlst 5 USD Gebühr.

STOCK,Trade,XNAS,Trading,01/01/2025 13:34:56,USD,1500,AAPL,10,USD,5,,

Mit Dezimalkomma

STOCK,Trade,XNAS,Trading,01/01/2025 13:34:56,USD,"1500,00",AAPL,10,USD,"5,00",,

So erfasst du eine Incoming-Transaktion

Fülle für eine Incoming-Transaktion diese Spalten aus.

  • ASSET CLASS

  • TYPE

  • EXCHANGE CODE

  • CATEGORY

  • TRANSACTION DATE

  • INCOMING ASSET

  • INCOMING AMOUNT

  • FEE CURRENCY (falls eine Gebühr angefallen ist)

  • FEE AMOUNT (falls eine Gebühr angefallen ist)

Beispiel. Am 26.12.2025 um 14:41:01 Uhr erhältst du eine Dividende von 50 USD.

STOCK,Incoming,XNAS,Dividend,26/12/2025 14:41:01,,,USD,50,,,"RACE, Stock, MI",

So erfasst du eine Outgoing-Transaktion

Fülle für eine Outgoing-Transaktion diese Spalten aus.

  • ASSET CLASS

  • TYPE

  • EXCHANGE CODE

  • CATEGORY

  • TRANSACTION DATE

  • OUTGOING ASSET

  • OUTGOING AMOUNT

  • FEE CURRENCY (falls eine Gebühr angefallen ist)

  • FEE AMOUNT (falls eine Gebühr angefallen ist)

Beispiel. Am 13.05.2025 um 10:12 Uhr zahlst du eine Provision von 1,55 USD.

Fiat Currency,Outgoing,XNAS,Fee,13/05/2025 10:12,USD,1.55,,,,,"AAPL, Stock, US",

Mit Dezimalkomma

Fiat Currency,Outgoing,XNAS,Fee,13/05/2025 10:12,USD,"1,55",,,,,"AAPL, Stock, US",
Hat dies deine Frage beantwortet?