Zum Hauptinhalt springen

Warum wurde meine CSV-Datei abgelehnt?

⚪️ Benutzeranleitung

Wenn du eine CSV- oder Excel-Datei hochlädst, prüft Finbooks Format und Inhalt, bevor etwas importiert wird. Entspricht die Datei nicht dem, was die Verbindung erwartet, wird sie als Abgelehnt markiert und es werden keine Transaktionen importiert.

In diesem Artikel erfährst du, wie du das Ergebnis liest, welche Ursachen für eine Ablehnung am häufigsten sind und was du als Nächstes tun kannst.


So findest du heraus, was schiefgelaufen ist

Direkt nach dem Klick auf CSV hochladen validiert Finbooks jede Datei und führt dich zum Schritt Importergebnisse prüfen. Gehe wie folgt vor, um das Ergebnis zu lesen:

  1. suche im Schritt Importergebnisse prüfen deine Datei in der Liste

  2. lies die Spalten Anzahl der Zeilen, Dateistatus und den Importstatus (siehe Tabelle unten)

  3. wenn die Datei Abgelehnt ist und eine Anzahl von Zeilen mit Fehlern angezeigt wird, klicke auf Fehler anzeigen, um die Detailansicht der Fehler zu öffnen. Dort siehst du den jeweiligen Fehler für jede Zeile

  4. klicke auf Fehler exportieren, um die Fehlerliste als CSV-Datei herunterzuladen

Lautet der Importstatus Ungültiges Format, steht kein Fehlerbericht zur Verfügung: Der Header der Datei ist fehlerhaft, daher gibt es keine Zeilenfehler, die angezeigt werden könnten. Prüfe den Header anhand der Anleitung für deine Verbindung.

Wenn der Header fehlerhaft ist, zeigt die App eine Schaltfläche Download template CSV an. Sie ist die schnellste Lösung: Lade die Vorlage herunter und kopiere deine Transaktionen hinein.

Importergebnis nach Dateistatus:

Dateistatus

Anzahl der Zeilen

Importstatus

Was das bedeutet

Hochgeladen

Anzahl der importierten Transaktionen

Importiert oder In Bearbeitung

das Format ist korrekt und die Datei wurde akzeptiert

Abgelehnt

0

Ungültiges Format

der Header der Datei ist fehlerhaft, es wurde nichts importiert und es steht kein Fehlerbericht zur Verfügung

Abgelehnt

0

Anzahl der Zeilen mit Fehlern

die Datei enthält Zeilen, die nicht gelesen werden können, daher wird die gesamte Datei abgelehnt und es wurde nichts importiert

⚠️ Fehler werden nicht gespeichert

Die Fehlerdetails sind nur verfügbar, solange du dich im Schritt Importergebnisse prüfen befindest. Wenn du die Seite verlässt oder einen neuen Upload startest, gehen sie verloren. Lade den Fehlerbericht mit Fehler exportieren herunter, bevor du die Seite verlässt, oder lade die Datei erneut hoch, um die Fehler noch einmal zu sehen.


Häufige Ablehnungsgründe und ihre Lösung

Gehe die folgenden Ursachen der Reihe nach durch. Die meisten Ablehnungen haben einen der ersten vier Gründe.

Der Dateityp passt nicht zur Verbindung

Manche Verbindungen akzeptieren nur CSV-Dateien, andere akzeptieren native Excel-Dateien (.xlsx). Welches Format unterstützt wird, findest du in der Verbindungsanleitung für deine Plattform.

Wenn die Anleitung die Datei genau so verlangt, wie die Plattform sie exportiert, lade sie unverändert hoch und konvertiere sie nicht. Wird eine Datei in einem anderen Format erneut gespeichert, kann sich ihre Struktur ändern.

Die Datei wurde bearbeitet oder erneut gespeichert

Wenn du eine CSV-Datei in Excel öffnest und erneut speicherst, können unsichtbare Änderungen hinzukommen, zum Beispiel zusätzliche Anführungszeichen im Header oder in den ersten Zeilen. Das reicht aus, damit die Datei abgelehnt wird.

Wenn du eine Datei prüfen möchtest, öffne sie in einem einfachen Texteditor (Editor unter Windows, TextEdit auf dem Mac). Mehr dazu findest du in Was ist eine CSV-Datei und wie bearbeite ich sie?

Die Datei ist nicht die, die die Verbindungsanleitung verlangt

Jede Verbindungsanleitung nennt den Bericht, den du herunterladen sollst. Ein anderer Bericht derselben Plattform oder eine Datei einer anderen Plattform entspricht nicht der erwarteten Struktur.

Prüfe, ob du die in der Anleitung verlangte Datei hochlädst, ob sie deine gesamte Historie abdeckt und ob du sie in die für diese Plattform erstellte Verbindung hochlädst.

Die Plattform wird mit einer nativen Datei nicht unterstützt

Unterstützt Finbooks die native Datei der Plattform nicht, kann der Export der Plattform nicht unverändert hochgeladen werden. Du musst deine Transaktionen in die Finbooks Custom CSV übertragen und in eine Custom-Verbindung hochladen.

Die Custom CSV entspricht nicht dem Finbooks-Format

Wenn du eine Custom CSV erstellt hast, wird die Datei abgelehnt, sobald ihr Header oder ihre Spalten nicht der Vorlage entsprechen:

  • die erste Zeile muss der Header sein und genau einer Finbooks-Vorlage entsprechen: gleiche Spaltennamen, gleiche Reihenfolge, keine zusätzlichen oder fehlenden Spalten

  • alle 13 Spalten müssen vorhanden sein, auch wenn einige leer sind

  • jede Zeile ist eine einzelne Transaktion

  • Pflichtspalten müssen immer ausgefüllt sein

Bei der Krypto-Custom-CSV kann der Header auf Englisch, Italienisch, Französisch, Spanisch oder Portugiesisch sein, sofern er genau einer Finbooks-Vorlage entspricht. Bei der TradFi-Custom-CSV muss der Header auf Englisch sein.

Als Trennzeichen zwischen den Spalten kannst du entweder ein Komma oder ein Semikolon verwenden.

Der Header der Krypto-Custom-CSV lautet auf Englisch:

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

Der Header der TradFi-Custom-CSV (nur auf Englisch) lautet:

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

Du kannst mit der Krypto-Vorlage beginnen, die den Header bereits enthält.

Wenn der Header fehlerhaft ist, zeigt die App eine Schaltfläche Download template CSV an: Lade die Vorlage herunter und kopiere deine Transaktionen hinein. Für die TradFi-Custom-CSV gibt es keinen Link zu einer Vorlage, folge daher der TradFi-Anleitung.

ℹ️ Krypto und traditionelle Finanzen sind getrennt

Verwende die Krypto-Custom-CSV für Krypto und die TradFi-Custom-CSV für traditionelle Anlagen. Wenn du in deinem Konto nur den Bereich Traditionelle Finanzen siehst, lies How to enable the Crypto section.

Das Datum hat kein unterstütztes Format

Die Spalte TRANSACTION DATE ist ein Pflichtfeld und muss eines dieser Formate verwenden:

  • yyyy-MM-dd HH:mm:ss

  • yyyy-MM-dd HH:mm

  • dd/MM/yyyy HH:mm:ss

  • dd/MM/yyyy HH:mm

Eine Transaktion vom 02. Januar 2024 um 21:45 Uhr kann zum Beispiel als 2024-01-02 21:45 oder 02/01/2024 21:45 geschrieben werden.

Datum und Uhrzeit müssen außerdem deiner lokalen Zeitzone entsprechen. Finbooks kann die von der Plattform verwendete Zeitzone nicht erkennen, rechne die Zeitangaben daher vor dem Upload in deine lokale Zeit um.

Zahlen verwenden ein Dezimalkomma

Wenn du ein Komma als Dezimaltrennzeichen verwendest, musst du die Zahl in Anführungszeichen setzen. Andernfalls wird das Komma als Spaltentrenner gelesen und die Zeile wird fehlerhaft. Du kannst auch einen Punkt als Dezimaltrennzeichen verwenden.

Format

Beispiel

Ergebnis

Dezimalkomma ohne Anführungszeichen

2999,85

falsch

Dezimalkomma mit Anführungszeichen

"2999,85"

richtig

Dezimalpunkt

2999.85

richtig

Pflichtwerte fehlen

Was du ausfüllen musst, hängt vom Transaktionstyp ab:

  • Incoming, das erhaltene Asset und die erhaltene Menge

  • Outgoing, das gesendete Asset und die gesendete Menge

  • Trade, sowohl das gesendete als auch das erhaltene Asset und die jeweilige Menge

Jede Zeile benötigt außerdem Typ, Kategorie und Datum. Die vollständige Liste der Spalten findest du in der Anleitung für Krypto oder traditionelle Finanzen.

Die Plattform hat ihr Exportformat geändert

Plattformen aktualisieren ihre Dateien von Zeit zu Zeit. Das kann zu einem nicht unterstützten Format, fehlenden Spalten, nicht erkannten Transaktionstypen oder nicht mehr passenden Headern führen.

Wenn du glaubst, dass die Datei unterstützt werden sollte, wende dich an den Finbooks-Support. Details findest du im Abschnitt unten.


Häufige Fehlermeldungen

Meldung

Was sie meistens bedeutet

Some errors were found in the header: one or more column headers do not match our required format, and we are unable to suggest a valid correction.

der Header der Datei entspricht nicht dem erwarteten: prüfe den Dateityp, prüfe, ob die Datei bearbeitet wurde, und prüfe, ob der Header genau mit der Verbindungsanleitung oder der Custom-CSV-Vorlage übereinstimmt

Unrecognised columns: no Finbooks CSV template matches this file

der Header entspricht keiner Finbooks-Vorlage in einer der unterstützten Sprachen: vergleiche den Header mit der Vorlage und korrigiere Namen und Reihenfolge, oder beginne mit Download template CSV noch einmal mit der Vorlage

Unrecognized section

die Datei enthält einen Abschnitt, den die Software nicht erkennt: lade genau den Bericht hoch, den die Verbindungsanleitung verlangt, unbearbeitet

Wenn du eine unerwartete technische Fehlermeldung siehst, wende dich an den Finbooks-Support und hänge die Datei an.


Es gibt keine teilweisen Importe

Finbooks importiert eine Datei ganz oder gar nicht. Enthält auch nur eine Zeile einen Fehler, wird die gesamte Datei abgelehnt und es werden keine Transaktionen aus dieser Datei importiert.

Wenn der Importstatus eine Anzahl von Zeilen mit Fehlern anzeigt, öffne Fehler anzeigen, um zu sehen, warum jede Zeile fehlgeschlagen ist. Korrigiere diese Zeilen in der Quelldatei und lade die Datei erneut hoch. Da aus der abgelehnten Datei nichts importiert wurde, entstehen durch das Hochladen der korrigierten Datei keine Duplikate.


Was du als Nächstes tun kannst

Gehe nach einer Ablehnung wie folgt vor:

  1. wenn der Importstatus Zeilen mit Fehlern anzeigt, öffne Fehler anzeigen und lade die Liste mit Fehler exportieren herunter. Wird Ungültiges Format angezeigt, gibt es keinen Fehlerbericht: Prüfe stattdessen den Header

  2. vergleiche den Fehler mit den oben genannten Ursachen und korrigiere die Datei. Ist der Header fehlerhaft, klicke auf Download template CSV und kopiere deine Transaktionen in die Vorlage

  3. lade die korrigierte Datei erneut hoch:

    • klicke bei einer bestehenden Verbindung im Menü auf der linken Seite auf Verbindungen, klicke am Ende der Verbindungszeile auf die drei Punkte und wähle Neue CSV hinzufügen

    • klicke im letzten Schritt des Upload-Vorgangs auf Neue CSV importieren

  4. prüfe das neue Ergebnis unter Importergebnisse prüfen

Wenn du die Datei nicht selbst erstellen möchtest, kannst du den kostenpflichtigen CSV-Datei-Konvertierungsservice nutzen. Das Ergebnis hängt von den Daten ab, die du bereitstellst.


So erreichst du den Support

Wird die Datei weiterhin abgelehnt, wende dich per Chat oder an customer.support@finbooks.com an den Finbooks-Support und sende:

  • den Namen der Datei und die Plattform, von der sie stammt

  • die Originaldatei, genau so, wie du sie heruntergeladen hast

  • den mit Fehler exportieren heruntergeladenen Fehlerbericht

Unser Team prüft, ob das Format unterstützt wird, und hilft dir beim nächsten Schritt.

Den vollständigen Upload-Vorgang findest du in So lädst du eine CSV-Datei hoch.


Kurze Antworten

Kann ich eine Excel-Datei hochladen?

Das hängt von der Verbindung ab. Manche Verbindungen akzeptieren native Excel-Dateien (.xlsx), andere nur CSV. Schau in der Verbindungsanleitung für deine Plattform nach.

Warum zeigt meine Datei Ungültiges Format an?

Ungültiges Format bedeutet, dass der Header der Datei fehlerhaft ist. Die gesamte Datei wurde deshalb abgelehnt und es wurden keine Transaktionen importiert. Prüfe, ob du die in der Anleitung verlangte Datei unbearbeitet hochlädst oder ob der Header deiner Custom CSV genau einer Finbooks-Vorlage entspricht. Am schnellsten hilft die Schaltfläche Download template CSV: Lade die Vorlage herunter und kopiere deine Transaktionen hinein.

Warum funktioniert Importergebnisse prüfen nicht mehr, nachdem ich die Seite verlassen habe?

Die Fehlerdetails werden nicht gespeichert, sobald du den Upload-Vorgang verlässt. Lade die Datei erneut hoch und klicke auf Fehler anzeigen, bevor du die Seite verlässt.

Werden aus einer abgelehnten Datei Transaktionen importiert?

Nein. Eine Datei wird ganz oder gar nicht importiert: Enthält eine Zeile einen Fehler, wird die gesamte Datei abgelehnt. Bei einer Abgelehnt-Datei zeigt Anzahl der Zeilen den Wert 0, weil keine Transaktionen importiert wurden.

Kann ich einen Fehlerbericht für eine Datei mit Ungültigem Format herunterladen?

Nein. Ungültiges Format bedeutet, dass der Header der Datei fehlerhaft ist, daher steht kein Fehlerbericht zur Verfügung. Prüfe den Header anhand der Verbindungsanleitung.

Hat dies deine Frage beantwortet?