In dieser Anleitung erfährst du, wann du das Finbooks-CSV-Format verwenden solltest und wie du deine Transaktionen korrekt darin einträgst.
Was ist die Finbooks Custom CSV?
Die Finbooks Custom CSV ist ein bestimmtes Tabellenformat, das du verwenden kannst, um deine Transaktionen in Finbooks zu importieren.
Du solltest dieses Format verwenden, wenn:
wir keine direkte API-Verbindung zu deiner Plattform unterstützen.
wir das native Exportformat deiner Plattform nicht unterstützen.
Unsere Custom CSV ist bewusst einfach aufgebaut. Trage deine Transaktionsdaten entsprechend unserer Vorlage ein und lade die Datei anschließend in Finbooks hoch. So kannst du deine Daten auch dann importieren, wenn deine Plattform nicht direkt unterstützt wird-
ℹ️ Was ist eine CSV-Datei und wie bearbeite ich sie?
Wenn du noch nicht mit CSV-Dateien vertraut bist oder Hilfe beim Bearbeiten und Speichern benötigst, findest du weitere Informationen in dieser Anleitung.
Alternativ kannst du unseren CSV-Service nutzen und die Formatierung für dich übernehmen lassen.
Das CSV-Format
Das Finbooks-CSV-Format besteht aus 13 Spalten. Die erste Zeile enthält den CSV-Header mit den Bezeichnungen der einzelnen Spalten. Jede Spalte erfüllt dabei einen bestimmten Zweck.
Die Spalten müssen nach bestimmten Regeln ausgefüllt werden, die in diesem Abschnitt erklärt werden, und immer in der vorgegebenen Reihenfolge bleiben.
Der erforderliche Header lautet immer:
TYPE,CATEGORY,TRANSACTION DATE,OUT CURRENCY,OUT AMOUNT,OUT FIAT VALUE,IN CURRENCY,IN AMOUNT,IN FIAT VALUE,FEE CURRENCY,FEE AMOUNT,NOTES,ORIGINAL ID
Einige Spalten können leer bleiben, wenn sie für die jeweilige Transaktion nicht relevant sind. Alle Header müssen jedoch enthalten sein.
Jede Zeile steht für eine einzelne Transaktion und darf ausschließlich die Daten dieser Transaktion enthalten.
Du musst die CSV-Datei nicht von Grund auf neu erstellen. Eine Vorlage mit bereits ausgefülltem Header kannst du hier herunterladen.
TYPE
Diese Spalte muss immer ausgefüllt werden.
Hier gibst du an, ob du bei der Transaktion ein Asset erhalten, ein Asset ausgegeben bzw. versendet oder ein Asset gegen ein anderes getauscht hast.
Folgende Werte werden akzeptiert:
Ingoing
Outgoing
Trade
CATEGORY
Diese Spalte muss immer ausgefüllt werden.
Kategorien helfen dabei, deine Steuerdaten zu strukturieren und sicherzustellen, dass die Software jede Transaktion steuerlich korrekt behandelt.
Rewards, die beispielsweise als Einkünfte berücksichtigt werden müssen, können als Earning oder Income kategorisiert werden, damit sie entsprechend den für dich geltenden steuerlichen Vorschriften behandelt werden.
Die standardmäßig und am häufigsten verwendete Kategorie ist Trading.
Weitere Informationen zu Transaktionskategorien und ihrer Verwendung findest du in diesem Artikel.
TRANSACTION DATE
Diese Spalte muss immer ausgefüllt werden. Sie gibt der Software an, wann die Transaktion stattgefunden hat.
Folgende Datumsformate 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
Dabei steht yyyy 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.
ℹ️ Datum und Uhrzeit müssen immer deiner lokalen Zeitzone entsprechen
Beim Hochladen einer Custom CSV kann Finbooks die Zeitzone, die von der Plattform beim Export der Transaktionen verwendet wurde, nicht automatisch erkennen.
Daher musst du alle Zeitangaben vor dem Upload manuell in deine aktuelle lokale Zeitzone umrechnen.
Wenn deine Transaktionen beispielsweise im UTC-Format exportiert wurden und du dich in Rom, Italien, befindest, musst du die Zeitangaben von UTC in CET (UTC+1) umrechnen.
Wenn eine Transaktion beispielsweise am 2. Januar 2024 um 21:45 Uhr stattgefunden hat, kann sie in einem der folgenden Formate importiert werden:
2024-01-02 21:45:00
2024-01-02 21:45
02-01-2024 21:45:00
02-01-2024 21:45
OUT CURRENCY
Gib den Ticker des Assets ein, das du ausgegeben oder versendet hast.
Dieses Feld ist für Outgoing- und Trade-Transaktionen verpflichtend.
Bei Ingoing-Transaktionen bleibt dieses Feld leer.
Beispiel: Wenn du 2,34 ETH verkauft hast, gib ETH ein.
OUT AMOUNT
Gib hier die Menge des Assets ein, das du ausgegeben oder versendet hast.
Dieses Feld ist für Outgoing- und Trade-Transaktionen verpflichtend.
Bei Ingoing-Transaktionen bleibt dieses Feld leer.
⚠️ Bei Kommas als Dezimaltrennzeichen Anführungszeichen verwenden
Wenn du ein Komma als Dezimaltrennzeichen verwendest, musst du den entsprechenden Wert in Anführungszeichen setzen ("xxxx,xx").
Diese Regel gilt für jedes Feld, in dem du numerische Werte mit einem Komma als Dezimaltrennzeichen eingibst.
Beispiel: Du möchtest eine eingehende Transaktion über 2.999,85 € importieren.
Falsches Zeilenformat
Incoming,Trading,13/04/2022 19:04,EUR,2999,85,,,,,,,,
Korrekte Zeilenformate
Incoming,Trading,13/04/2022 19:04,EUR,"2999,85",,,,,,,, Incoming,Trading,13/04/2022 19:04,EUR,2999.85,,,,,,,,
OUT FIAT VALUE
Gib den Gesamtwert des ausgegebenen Assets in deiner Fiatwährung ein.
Dieses Feld ist für Outgoing- und Trade-Transaktionen optional.
Bei Incoming-Transaktionen bleibt dieses Feld leer.
Beispiel: Wenn du ein Krypto-Asset im Gesamtwert von 2.456,87 € verkauft hast, gib 2456.87 oder "2456,87" ein.
IN CURRENCY
Gib den Ticker des Assets ein, das du erhalten hast.
Dieses Feld ist für Incoming- und Trade-Transaktionen verpflichtend.
Bei Outgoing-Transaktionen bleibt dieses Feld leer.
Beispiel: Wenn du 0,23 BTC gekauft hast, gib BTC ein.
IN AMOUNT
Gib hier die Menge des Assets ein, das du erhalten hast.
Dieses Feld ist für Incoming- und Trade-Transaktionen verpflichtend.
Bei Outgoing-Transaktionen bleibt dieses Feld leer.
Beispiel: Wenn du 2,34 BTC erhalten hast, gib 2.34 oder "2,34" ein.
IN FIAT VALUE
Gib den Gesamtwert des erhaltenen Assets in deiner Fiatwährung ein.
Dieses Feld ist für Incoming- und Trade-Transaktionen optional. Wenn du es leer lässt, verwendet Finbooks den zum Zeitpunkt der Transaktion verfügbaren Marktwert.
Bei Outgoing-Transaktionen bleibt dieses Feld leer.
Beispiel: Wenn das erhaltene Krypto-Asset insgesamt 2.000,34 € wert war, gib 2000.34 oder "2000,34" ein.
FEE CURRENCY
Gib hier den Ticker des Assets ein, mit dem du die Gebühren bezahlt hast.
Dieses Feld ist für alle Transaktionen optional und muss nur ausgefüllt werden, wenn Gebühren angefallen sind.
Beispiel: Wenn du 0,0034 ETH als Gebühr bezahlt hast, gib ETH ein.
FEE AMOUNT
Gib hier die Menge des Assets ein, die du als Gebühr bezahlt hast.
Dieses Feld ist für alle Transaktionen optional und muss nur ausgefüllt werden, wenn Gebühren angefallen sind.
Beispiel: Wenn du 0,0034 ETH als Gebühr bezahlt hast, gib 0.0034 oder "0,0034" ein.
NOTES
In diesem Feld kannst du Notizen zu einer Transaktion eintragen.
Die hier eingegebenen Kommentare werden nach dem Import in den Transaktionsdetails in Finbooks angezeigt.
Dieses Feld ist immer optional und darf maximal 200 Zeichen enthalten.
ORIGINAL ID
In diesem Feld kannst du die von der Börse oder Blockchain bereitgestellte eindeutige ID der Transaktion eintragen, beispielsweise den Transaction Hash.
Dadurch kannst du eine Transaktion in Finbooks leichter ihrer ursprünglichen Quelle zuordnen. Nach dem Import wird die ID in den Transaktionsdetails angezeigt.
Dieses Feld ist immer optional.
So trägst du eine Trade-Transaktion ein
Für eine Trade-Transaktion musst du folgende Spalten ausfüllen:
TYPE
CATEGORY
TRANSACTION DATE
OUT CURRENCY
OUT AMOUNT
IN CURRENCY
IN AMOUNT
FEE CURRENCY (nur wenn für die Transaktion eine Gebühr bezahlt wurde)
FEE AMOUNT (nur wenn für die Transaktion eine Gebühr bezahlt wurde)
Beispiel: Am 01.01.2025 um 13:34:56 Uhr hast du 15,45 ETH gegen 1 BTC getauscht. Der Trade hatte zu diesem Zeitpunkt einen Wert von 30.000,00 € und du hast eine Gebühr von 2,00 € bezahlt.
Wenn du den Fiatwert angeben möchtest:
Trade,Trading,01-01-2025 13:34:56,ETH,15.45,30000,BTC,1,30000,EUR,2,,,
Wenn du ein Komma als Dezimaltrennzeichen verwendest:
Trade,Trading,01-01-2025 13:34:56,ETH,"15,45",30000,BTC,1,30000,EUR,2,,,
Beachte, dass in diesem Fall auch der Header des entsprechenden Feldes in Anführungszeichen gesetzt werden muss, zum Beispiel "IN AMOUNT".
Wenn du keinen Fiatwert angeben möchtest und stattdessen den Marktpreis zum Zeitpunkt der Transaktion verwenden möchtest:
Trade,Trading,01-01-2025 13:34:56,ETH,,15.45,BTC,1,,EUR,2,,,
Wenn du eine Notiz hinzufügen möchtest:
Trade,Trading,01-01-2025 13:34:56,ETH,,15.45,BTC,1,,EUR,2,This is a note,,
So trägst du eine Ingoing-Transaktion ein
Für eine Ingoing-Transaktion musst du folgende Spalten ausfüllen:
TYPE
CATEGORY
TRANSACTION DATE
IN CURRENCY
IN AMOUNT
FEE CURRENCY (nur wenn für die Transaktion eine Gebühr bezahlt wurde)
FEE AMOUNT (nur wenn für die Transaktion eine Gebühr bezahlt wurde)
Beispiel: Am 26.12.2025 um 14:41:01 Uhr hast du mit deiner Karte 3 BTC im Gesamtwert von 120.000,00 € gekauft und dafür eine Gebühr von 0,05 BTC bezahlt.
Wenn du den Fiatwert angeben möchtest:
Incoming,Trading,26-12-2025 14:41:01,BTC,3,120000,,,,,BTC,0.05,,,
Wenn du keinen Fiatwert angeben möchtest und stattdessen den Marktpreis zum Zeitpunkt der Transaktion verwenden möchtest:
Incoming,Trading,26-12-2025 14:41:01,BTC,3,,,,,,BTC,0.05,,,
So trägst du eine Outgoing-Transaktion ein
Für eine Outgoing-Transaktion musst du folgende Spalten ausfüllen:
TYPE
CATEGORY
TRANSACTION DATE
OUT CURRENCY
OUT AMOUNT
FEE CURRENCY (nur wenn für die Transaktion eine Gebühr bezahlt wurde)
FEE AMOUNT (nur wenn für die Transaktion eine Gebühr bezahlt wurde)
Beispiel: Am 13.05.2025 um 10:12 Uhr hast du 2.500,00 USDT im Gesamtwert von 2.200,00 € versendet und dafür eine Gebühr von 1,55 USD bezahlt.
Wenn du den Fiatwert angeben möchtest:
Incoming,Trading,13-05-2025 10:12,,,,USDT,2500,2200,,USD,1.55,,,
Wenn du keinen Fiatwert angeben möchtest und stattdessen den Marktpreis zum Zeitpunkt der Transaktion verwenden möchtest:
Incoming,Trading,13-05-2025 10:12,,,,USDT,2500,,,USD,1.55,,,