In diesem Artikel
Diese neue Funktion ermöglicht es Ihnen, Ihre Buchhaltung automatisch mit Banktransaktionen aus Camt-Dateien (052, 053, 054) zu aktualisieren. Dank dieser Neuerung können Sie:
- Den gesamten Buchungsprozess von Transaktionen beschleunigen.
- Das Risiko manueller Fehler reduzieren.
- Dopplungen vermeiden, da nur Transaktionen importiert werden, die noch nicht in Ihrer Buchhaltung vorhanden sind.
Das Programm liest die Camt-Dateien aus einem ausgewählten Ordner, speichert deren Inhalt in einer lokalen Datenbank und erkennt alle neuen, noch nicht verbuchten Transaktionen. Diese werden dann für den Import in Ihre Buchhaltung vorgeschlagen, wodurch das Finanzmanagement erheblich vereinfacht wird. Nach dem Import können Sie außerdem von Auto-Vervollständigungsregeln profitieren, um Ihre Arbeit weiter zu optimieren.
Diese Funktion befindet sich derzeit in einer BETA-Version und steht für experimentelle Zwecke mit Banana Accounting Plus (Advanced-Plan) in der doppelten Buchhaltung oder in Einnahmen & Ausgaben-Buchhaltungen zur Verfügung. Wir freuen uns über alle Anregungen und Feedback, um diese Funktion zu verbessern.
Voraussetzungen
- Verwenden Sie Banana accounting Dev-Channel mit dem Advanced-Plan.
- Verwenden Sie eine Buchhaltung mit doppelter Buchhaltung oder Einnahmen & Ausgaben.
Datenvorbereitung
Bevor Sie mit dem Import beginnen, stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen:
- Organisation der Camt-Dateien:
Erstellen Sie einen eigenen Ordner, der alle Camt-Dateien (*.xml) enthält, die Sie in Ihre Buchhaltung importieren möchten.
Sie können die Dateien im Ordner nach Bedarf organisieren, beispielsweise nach Buchungsjahr oder nach Finanzinstitut. - Zugriffsberechtigungen:
Stellen Sie sicher, dass der ausgewählte Ordner sowohl vom Programm gelesen als auch beschrieben werden kann. Dies gewährleistet eine korrekte Speicherung der Daten und Importinformationen. - IBAN-Einstellungen:
Für jedes Konto in der Buchhaltung stellen Sie sicher, dass die IBAN in der Spalte „BankIban“ der Tabelle „Accounts“ eingetragen ist.- Falls die Spalte nicht vorhanden ist, fügen Sie sie über das Menü hinzu: Werkzeuge → Funktionen hinzufügen/entfernen →Adress-Spalten der Konten-Tabelle hinzufügen.
- Schreiben Sie die IBAN in Großbuchstaben, ohne Leer- oder Sonderzeichen.
- Swiss Camt ISO20022 Reader Erweiterung:
Installieren Sie die Swiss Camt ISO20022 Reader-Erweiterung. Diese ist erforderlich, damit das Programm Camt-Dateien korrekt interpretieren und den Importvorgang starten kann.
Erste Verwendung
Wenn Sie den im Menü Aktionen verfügbaren Befehl "Banktransaktionen im ISO20022-Format importieren" zum ersten Mal verwenden, fordert das Programm Sie auf, den Ordner mit den Camt-Dateien auszuwählen. Diese Auswahl wird gespeichert, sodass das Programm bei zukünftigen Importen automatisch denselben Ordner verwendet, ohne erneut nach dem Pfad zu fragen.
Beachten Sie, dass der erste Durchlauf mehr Zeit in Anspruch nehmen kann. Das Programm muss alle im Ordner enthaltenen Dateien lesen, verarbeiten und speichern sowie den Inhalt jeder Datei analysieren. Während dieser Phase zeigt eine Fortschrittsanzeige (Progress Bar) den aktuellen Status des Vorgangs an, sowohl in Prozent als auch in Bezug auf die bereits verarbeiteten Dateien im Verhältnis zur Gesamtzahl. Der gleiche Fortschrittsbalken wird sowohl während des Lesens der Dateien aus dem Ordner als auch beim Öffnen und Lesen ihres Inhalts angezeigt.
Bei nachfolgenden Importen verläuft der Prozess deutlich schneller, da das Programm nur den Inhalt neuer Dateien liest und importiert, da es bereits weiß, welche Daten zuvor gespeichert wurden. Auf diese Weise benötigen zukünftige Vorgänge erheblich weniger Zeit und sorgen für einen reibungsloseren, effizienteren Arbeitsablauf.
Dateiverarbeitung
Die Verarbeitung der Camt-Dateien erfolgt in zwei getrennten Phasen:
- Lesen der Dateien im Ordner:
In der ersten Phase analysiert das Programm den ausgewählten Ordner und erkennt alle vorhandenen Dateien, die dann der internen Datenbank hinzugefügt werden. Während dieses Vorgangs wird eine Fortschrittsanzeige eingeblendet, die angibt, wie viel des Einlesevorgangs bereits abgeschlossen ist, gemessen an der Gesamtzahl der Dateien. - Lesen des Dateiinhalts:
Nach Abschluss des Datei-Lesevorgangs wechselt das Programm zur zweiten Phase, in der es die in der Datenbank gespeicherten Dateien öffnet, ihren Inhalt liest und die Daten verarbeitet. Auch in dieser Phase wird eine spezielle Fortschrittsanzeige angezeigt, die deutlich den Fertigstellungsprozentsatz und die Anzahl der verarbeiteten Dateien zeigt.
Wenn einer dieser Prozesse aus irgendeinem Grund unterbrochen wird, behält das Programm die bereits gespeicherten Daten bei. Beim nächsten Importvorgang setzt es automatisch an der Stelle fort, an der es zuvor aufgehört hat, ohne von vorne beginnen zu müssen. Dies gewährleistet einen effizienten Arbeitsablauf und vermeidet die erneute Verarbeitung bereits abgeschlossener Schritte.
Dialog für den Import von Banktransaktionen
Der Import-Dialog bietet einen Überblick über die verarbeiteten Dateien, die verwendeten Parameter und die zu importierenden Transaktionen. Sie können die Parameter im Dialog jederzeit ändern, und die Daten werden sofort neu berechnet.
Registerkarte „Folder“
Die Registerkarte „Folder“ bietet eine Gesamtübersicht des Imports, zeigt den aktuell ausgewählten Ordner, die zu verarbeitenden Dateien und einige Optionen zur Filterung des Inhalts.
- Select Folder:
Hier können Sie den Pfad des Arbeitsordners einsehen und ändern. Das Programm überprüft ständig die Gültigkeit des ausgewählten Pfads und zeigt eine Fehlermeldung an, wenn der Ordner nicht existiert oder nicht zugänglich ist. - Umbenennen oder Verschieben des Ordners:
Wenn Sie den Namen oder den Speicherort des Ordners ändern, denken Sie daran, den Pfad in diesem Dialog anzupassen. Das Programm speichert den zuletzt verwendeten Pfad und zeigt eine Warnung an, wenn er nicht gefunden werden kann. - Umbenennen von Dateien im Ordner:
Sie können die Dateien im Ordner frei umbenennen; das Programm verlässt sich nicht auf den Dateinamen, sondern auf den Inhalt. Selbst wenn zwei Dateien unterschiedliche Namen, aber identischen Inhalt haben, betrachtet das Programm sie als Duplikate und importiert nur eine davon. - Ignore Subfolders:
Diese Option ist standardmäßig aktiviert und ermöglicht es, die in Unterordnern befindlichen Dateien von der Verarbeitung auszuschließen. Dies ist nützlich, wenn Sie beispielsweise nur Dateien importieren möchten, die für den aktuellen Buchungszeitraum relevant sind, und ältere oder nicht zutreffende Daten vermeiden wollen. Wenn Sie diese Option deaktivieren, werden alle Camt-Dateien in Unterverzeichnissen in die Datenbank aufgenommen, unabhängig von Datum oder Ordnerstruktur. - Ignore Files Older Than...:
Wenn Sie in diesem Feld ein Datum festlegen, liest das Programm den Inhalt von Dateien, die älter als dieses Datum sind, nicht ein. Standardmäßig werden Dateien, die älter als das Eröffnungsdatum der Buchhaltung sind, zwar in der Datenbank gespeichert, aber nicht analysiert. Wenn Sie dieses Datum anpassen, können Sie den Zeitfilter weiter verfeinern. Wenn Sie ein ungültiges Datum eingeben, ersetzt das Programm es automatisch durch das aktuelle Datum. - Read All Files:
Wenn Sie auf diese Schaltfläche klicken, erzwingen Sie das sofortige erneute Einlesen aller Dateien im Ordner, anstatt auf die tägliche Routineprüfung zu warten. Diese Funktion ist besonders nützlich, wenn Sie neue Dateien hinzugefügt haben und diese sofort importieren möchten, ohne auf das nächste automatische Update warten zu müssen.
Registerkarte „Bank Accounts“
Die Registerkarte „Bank Accounts“ bietet einen detaillierten Überblick über alle in Ihrer Buchhaltung vorhandenen Bankkonten. Für jedes Konto zeigt das Programm sowohl statische Informationen (wie den aktuellen Buchhaltungssaldo) als auch dynamische Daten an, die auf den neuesten Importen basieren.
Angezeigte Informationen für jedes Konto
- Accounting Balance:
Zeigt den aktuellen in der Buchhaltung erfassten Betrag für dieses Konto. - Last Bank Balance:
Zeigt den letzten von den Camt-Dateien erfassten Banksaldo. Dies ermöglicht einen unmittelbaren Vergleich des in Ihrer Buchhaltung erfassten Betrags mit dem tatsächlichen Bankguthaben. - New Transactions:
Gibt an, wie viele neue, noch nicht in der Buchhaltung erfasste Bewegungen in den Camt-Dateien gefunden wurden. - Total New Transactions:
Zeigt den Gesamtwert der neuen Transaktionen, die für dieses Konto importiert werden sollen, und hilft Ihnen so, schnell das Ausmaß der noch zu verbuchenden Vorgänge einzuschätzen. - Last Import:
Gibt das Datum an, an dem der Ordner zuletzt vollständig eingelesen wurde, und bietet so einen nützlichen zeitlichen Bezugspunkt für die letzte Aktualisierung. - Status:
- Updated: Für dieses Konto wurden keine neuen Bewegungen zum Import gefunden.
- New transactions: Es wurden neue, nicht verbuchte Bewegungen gefunden, die für den Import in die Buchhaltung bereitstehen.
Registerkarte „Transaction Details“
In der Registerkarte „Transaction Details“ finden Sie alle in den Camt-Dateien erkannten Bankvorgänge, die noch nicht in die Buchhaltung importiert wurden, nach Konten gruppiert. Diese Ansicht ermöglicht es Ihnen, ausstehende Bewegungen schnell zu analysieren, ihre Relevanz zu prüfen und auszuwählen, welche Sie importieren möchten.
- Auswahl der zu importierenden Transaktionen:
Sie können vorübergehend bestimmte Transaktionen oder, falls gewünscht, alle Transaktionen eines bestimmten Kontos mit den entsprechenden Kontrollkästchen ausschließen. Ausgeschlossene Transaktionen werden nicht dauerhaft entfernt; sie werden beim nächsten Öffnen des Dialogs erneut vorgeschlagen, sodass Sie ihre Importentscheidung jederzeit überdenken können. Derzeit ist es nicht möglich, eine Transaktion dauerhaft auszuschließen. - Betrachte nur Transaktionen ab einem bestimmten Datum:
Um die Anzahl der angezeigten Bewegungen zu reduzieren, können Sie ein Datum festlegen, ab dem neue Transaktionen für den Import berücksichtigt werden sollen. Standardmäßig verwendet das Programm das Eröffnungsdatum der Buchhaltung. Wenn Sie ein anderes Datum einstellen, zeigt das Programm nur Vorgänge an, die nach diesem Tag stattfinden, und ignoriert frühere. Diese Funktion ist besonders nützlich, wenn in der Vergangenheit Transaktionen ohne eine eindeutige ID (Spalte ExternalReference) importiert wurden, typischerweise beim Import aus CSV-Dateien. In solchen Fällen genügt es, ein Datum nach der letzten verbuchten Transaktion festzulegen, um ältere Vorgänge nicht erneut vorzuschlagen. Wenn Sie ein ungültiges Datum eingeben, ersetzt das Programm es automatisch durch das aktuelle Datum. - Eindeutige Identifizierung von Transaktionen:
Transaktionen aus Camt-Dateien (052, 053, 054) sollten immer eine eindeutige ID gemäß dem ISO20022-Standard enthalten. Diese Kennung ermöglicht es dem Programm, genau zu bestimmen, welche Bewegungen bereits importiert wurden und welche neu sind, wodurch das Risiko von Duplikaten oder Fehlern verringert wird.
Registerkarte „Settings“
Settings Tab
In der Registerkarte „Settings“ können Sie einige erweiterte Aspekte des Importvorgangs verwalten, einschließlich der Möglichkeit, den Ursprungszustand der Daten wiederherzustellen und festzulegen, wie bereits verarbeitete Dateien erkannt werden.
- Delete Saved Data:
Diese Funktion ermöglicht es Ihnen, alle Daten im Zusammenhang mit früheren Importen aus der internen Datenbank zu löschen. Sobald die Löschung bestätigt ist, werden Sie automatisch zur Registerkarte „Folder“ weitergeleitet, wo die Standardwerte wiederhergestellt werden.- New Import: Wenn Sie nach dem Löschen der Daten einen neuen Import durchführen möchten, klicken Sie einfach auf die Schaltfläche „Read all files“.
- Limited Impact on Import Data: Das Löschen von Daten aus der internen Datenbank hat keinen Einfluss auf bereits in der Buchhaltung vorhandene Informationen.
- Complete Database Removal: Der hier verfügbare Befehl löscht nur die Tabelleninhalte der Datenbank. Wenn Sie die Datenbank vollständig entfernen möchten, müssen Sie die Datei „*.db“ im ausgewählten Ordner manuell löschen.
- Always Verify the Existence of Files Using Hashing:
Diese Option ermöglicht es Ihnen festzulegen, wie das Programm bereits verarbeitete Dateien erkennt:- Hashing (langsamer): Wenn Sie diese Option auswählen, berechnet das Programm einen eindeutigen Hash für jede Datei. Dies stellt eine genaue Erkennung von Duplikaten sicher, auch wenn sich Namen oder Pfade ändern. Allerdings kann dieses Verfahren die Dateieinlesung verlangsamen.
- Name, Datum und Größe prüfen (Standard): Wenn das Kontrollkästchen nicht ausgewählt ist, vergleicht das Programm einfach den Dateinamen (einschließlich Pfad), das Erstellungsdatum und die Dateigröße, um die Eindeutigkeit zu bestimmen. Dieser Ansatz ist schneller, aber unter Umständen nicht so robust in Szenarien, in denen Dateien umbenannt werden, während der Inhalt gleich bleibt.
Datenbankdatei
Das Programm verwendet eine SQLite-Datenbank, um importbezogene Daten zu speichern. Wenn Sie diese Funktion zum ersten Mal aktivieren und der ausgewählte Ordner gültig ist, wird darin eine Datenbankdatei (*.db
) erstellt.
Es ist wichtig, diese Datei weder zu verschieben noch zu löschen, da das Programm sie als Referenz für alle nachfolgenden Vorgänge verwendet. Bei Verlust oder Löschung der Datei erzeugt das Programm eine neue .db
-Datei, was Sie dazu zwingt, alle Dateien im Ordner erneut einzulesen und zu verarbeiten.
Was wird in der Datenbank gespeichert?
- Dateiliste:
Alle im Ordner erkannten Dateien werden gespeichert. Wenn Sie in den Einstellungen festgelegt haben, Unterordner zu ignorieren, werden darin enthaltene Dateien nicht gespeichert. Diese Option ist standardmäßig aktiviert. - Bankkonten und zugehörige Daten:
Die Datenbank speichert Informationen über die in der Buchhaltung vorhandenen Bankkonten. Wenn diese Daten in der Buchhaltung geändert werden, aktualisiert die Datenbank ihre Informationen entsprechend. - Importierte Transaktionen:
Die in den geöffneten und gelesenen Dateien gefundenen Transaktionen werden in der Datenbank gespeichert, sodass Sie sie später erneut verarbeiten oder anzeigen können, ohne die Dateien erneut einlesen zu müssen. - Importverlauf:
Das Programm zeichnet auf, wer die Importvorgänge ausgeführt hat, wann sie durchgeführt wurden und mit welcher Softwareversion. Dies sorgt für eine detaillierte historische Nachverfolgbarkeit der Aktivitäten.
Logdatei
Während des Importvorgangs erzeugt das Programm eine Logdatei, um potenzielle Probleme zu erkennen und zu diagnostizieren. Im Falle von Anomalien oder unerwartetem Verhalten liefert die Logdatei detaillierte Informationen über die durchgeführten Vorgänge und hilft Entwicklern dabei, die Fehlerquelle zu verstehen.
Wenn Sie Hilfe beim Auffinden oder Interpretieren der Logdatei benötigen, wenden Sie sich bitte an unser Support-Team. Es wird Sie Schritt für Schritt dabei unterstützen, die Datei in Ihrem aktiven Verzeichnis zu finden.
Fehlersuche
Wenn trotz korrekt ausgewähltem Ordner keine zu importierenden Transaktionen angezeigt werden, überprüfen Sie Folgendes:
- Bankkonten: Stellen Sie sicher, dass die Daten zu den Bankkonten (einschließlich der IBANs) in der „Accounts“-Tabelle vollständig und korrekt sind.
- Buchungszeitraum: Prüfen Sie, ob der aktuell eingestellte Buchungszeitraum die Daten der zu importierenden Transaktionen umfasst. Wenn die Transaktionen außerhalb des festgelegten Zeitraums liegen, werden sie vom Programm nicht zum Import vorgeschlagen.
Sollte das Problem nach diesen Überprüfungen weiterhin bestehen, wenden Sie sich bitte an unseren technischen Support, um weitere Hilfe zu erhalten.