Firefly III: CSV-Konfiguration und Dublettenprüfung

Eine wiederverwendete Konfiguration des Firefly III Data Importer gehört zu einem Dateiaufbau und einer Installation, nicht nur zu einem Banknamen. Änderungen an Spaltenrollen oder Kontozuordnung können zugleich die Dublettenprüfung beeinflussen. Kontrollieren Sie beides vor der nächsten Übernahme.

Für reine PDF-Quellen exportiert LocalExtract lokal CSV. Es erzeugt keine Firefly-Kontokennungen, keine Data-Importer-JSON-Konfiguration und keinen validierten Import. Die CSV-Spalten heißen date,description,amount.

Konfiguration an den tatsächlichen Aufbau binden

Die offizielle Konfigurationsreferenz beschreibt Schemaversion 3. Vergleichen Sie Trennzeichen, Kopfzeile, Datumsformat, roles, do_mapping, mapping und default_account mit genau dieser Datei. Spalten werden ab null gezählt: Eine zusätzliche erste Spalte kann eine bekannte Konfiguration ungültig machen.

Kontokennungen und Namenszuordnungen gehören zur Zielinstallation. Eine beigesteuerte Bankkonfiguration ist ein Ansatzpunkt, kein Nachweis passender Konten und Exportfelder. Bewahren Sie private Konfigurationen geschützt auf; sie können Kontonamen und andere Finanzkennungen enthalten. Veröffentlichen Sie keine echte Konfiguration als Fehlerbeispiel.

Drei Dublettenmodi auseinanderhalten

Die Dublettenreferenz unterscheidet none, classic und cell. ignore_duplicate_lines ist eine zusätzliche Prüfung von Quellzeilen, kein anderer Name für sämtliche Datenbankprüfungen.

Classic bildet einen Hash aus den für den Import zugeordneten Daten nach Rollen- und Mapping-Anwendung. Spätere Regeln, Webhooks oder Bearbeitungen berechnen diesen ursprünglichen Hash nicht neu. Andere Rollen oder Zuordnungen können deshalb die Vergleichsdarstellung desselben Bankereignisses verändern.

Cell verwendet unique_column_index und unique_column_type. Prüfen Sie, ob die gewählte Quellspalte tatsächlich stabile, eindeutige Kennungen enthält. Datum, Betrag oder wiederkehrender Zahlungspartner sind nicht automatisch eindeutig. Zwei echte Zahlungen gleichen Betrags bleiben getrennt.

Vor dem Senden validieren

Der Dateiimportablauf trennt Konvertierung/Validierung vom Senden an Firefly III. Prüfen Sie Konto, Datum, Vorzeichen und Kennung in der Vorschau. Eine erfolgreiche Vorschau beweist keine gespeicherten Transaktionen. Überspringt die Konfiguration ein Formular, ist der unsichtbare Schritt keine erneute Kontrolle.

Die erfundene Datei enthält Date, Reference, Amount. Eine zusätzliche erste Account-Spalte verschiebt Reference von Index 1 auf 2. Das synthetische Aufbau-/Identitäts-Arbeitsblatt prüft die Verschiebung und erhält zwei gleich hohe Zahlungen mit verschiedenen Kennungen. Es modelliert die Feldauswahl; Firefly und dessen Dublettenalgorithmus wurden nicht ausgeführt.

Bewahren Sie geprüften Aufbau, Konfiguration und tatsächliches Ergebnis zusammen auf. Bei verändertem Dublettenverhalten vergleichen Sie diese Grundlagen, bevor Sie die Prüfung abschwächen. Der CSV-Überlappungsleitfaden behandelt Quelldateien; hier werden Data-Importer-Konfiguration und Erkennung gemeinsam geprüft. PDF lokal vorbereiten und Felder für das tatsächliche Ziel kontrollieren.

Offizielle Firefly-III-Dokumentation am 16. Oktober 2026 geprüft.