In dieser Anleitung erfährst du, wie du eine oder mehrere CSV-Dateien über die CSV-Importfunktion in dein Finbooks-Konto hochlädst.

⚠️ CSV-Uploads werden für API-Verbindungen nicht unterstützt

Es ist nicht möglich, CSV-Dateien in Verbindungen hochzuladen, die über eine API erstellt wurden. CSV-Uploads stehen ausschließlich für Verbindungen zur Verfügung, die den Import per CSV ausdrücklich unterstützen.

Verbindungen, die ausschließlich eine API-Anbindung unterstützen, erlauben keinen Transaktionsimport per CSV-Datei.

So greifst du auf den CSV-Upload zu

Der Einstieg hängt davon ab, ob die Verbindung bereits in deinem Konto vorhanden ist.

Nachfolgend findest du die Vorgehensweise für beide Fälle.

Wenn du eine CSV-Datei in eine bestehende Verbindung hochladen möchtest

Falls du die Verbindung bereits erstellt hast, kannst du neue CSV-Dateien wie folgt hochladen:

Klicke im Menü auf der linken Seite auf Verbindungen.
Suche die gewünschte Verbindung in der Liste.
Klicke am rechten Ende der Zeile auf die drei Punkte und wähle anschließend Neue CSV hinzufügen. Du wirst daraufhin zum CSV-Upload weitergeleitet.

Wenn du eine neue Verbindung erstellen möchtest

Um deine erste CSV-Datei zu importieren, musst du zunächst eine neue Verbindung erstellen. Gehe dazu wie folgt vor:

Klicke oben rechts auf Verbindung hinzufügen.
Nutze die Such- und Filterfunktion, um deine Börse, Wallet oder Blockchain zu finden. Klicke anschließend auf das Verbindungssymbol, um die Seite Verbindung erstellen zu öffnen.
Vergib einen eindeutigen Namen für deine neue Verbindung.
Klicke auf Verbindung erstellen. Die Verbindung wird angelegt und du wirst automatisch zum CSV-Upload weitergeleitet.

CSV-Dateien hochladen

Der CSV-Upload besteht aus zwei Schritten.

Erster Schritt – Dateien auswählen und hochladen

Sobald du den CSV-Upload geöffnet hast, kannst du eine oder mehrere CSV-Dateien gleichzeitig importieren:

Klicke auf das Feld Durchsuchen.
Wähle eine oder mehrere CSV-Dateien aus den Ordnern auf deinem Gerät aus.
Die ausgewählten Dateien werden sofort in der Dateiliste darunter angezeigt.
Falls du versehentlich eine falsche Datei hinzugefügt hast, klicke neben ihrem Namen auf Entfernen.
Sobald deine Auswahl vollständig ist, klicke unten rechts auf CSV hochladen.
Während Finbooks das Dateiformat und den Inhalt überprüft, wird ein Pop-up angezeigt, das den Fortschritt der Prüfung darstellt.
Sobald die Überprüfung abgeschlossen ist, wirst du automatisch zum nächsten Schritt weitergeleitet.

ℹ️ Du kannst mehrere CSV-Dateien gleichzeitig hochladen

Jede Datei wird nach dem Klick auf CSV hochladen unabhängig geprüft. So kannst du für jede Datei sehen, ob sie erfolgreich akzeptiert wurde, abgelehnt wurde oder sich noch in der Verarbeitung befindet.

Zweiter Schritt – Importergebnisse prüfen

Im Schritt Importergebnisse prüfen siehst du, welche Dateien erfolgreich akzeptiert oder abgelehnt wurden.

Akzeptiert

Wenn das Dateiformat korrekt ist, zeigt die Spalte Anzahl der Zeilen die Anzahl der aus dieser Datei importierten Transaktionen an.

In der Spalte Dateistatus wird Hochgeladen angezeigt. Der Importstatus lautet entweder Importiert oder In Bearbeitung, falls der Import noch nicht abgeschlossen ist.

Abgelehnt

Ist das Dateiformat fehlerhaft, zeigt die Spalte Anzahl der Zeilen den Wert 0, da keine Transaktionen importiert wurden.

Der Dateistatus lautet Abgelehnt. Im Importstatus wird angezeigt, ob der Dateikopf fehlerhaft ist (Ungültiges Format) oder wie viele Zeilen Fehler enthalten.

Wenn du auf Fehler anzeigen klickst, öffnet sich die Detailansicht mit einer Übersicht aller Fehler. Dort kannst du für jede betroffene Zeile den jeweiligen Fehler einsehen und über Fehler exportieren einen CSV-Bericht mit der vollständigen Fehlerliste herunterladen.

⚠️ Errors are not stored
If you wish to keep a record of what went wrong, make sure to download the error report before leaving the page or starting a new upload session. Otherwise you'll need to upload again the file to check the errors inside.

ℹ️ Common causes of rejection

CSV file are always subject to changes and update form the exchanges.
This can lead to:

unsupported format or contains missing columns
unrecognized transaction types
headers don't match the required structure

If you believe the file format should be supported, please contact Finbooks Support with the file name and type so our team can verify and assist.