KSIDol-Dokumentation > KSIDol-Module > Bankimport

Modulanleitung: Bankimport

Nicht-technische Bedienungsanleitung: wofür das Modul dient, wie man es benutzt und wie es mit Dolibarr zusammenspielt.

Importierte Bankformate5: CSV, OFX, QIF, CAMT.053, MT940

Abgeglichene BelegeRechnungen, Anzahlungen, Gutschriften, Löhne, Abgaben

Dolibarr-ZahlungNur nach menschlicher Prüfung erstellt

KompatibilitätDolibarr 18+ - PHP 8+

1. Moduluberblick

Bankimport (Bank Import) ist ein KSIDol-Modul, das Ihre Kontoauszüge in Dolibarr einliest und Ihnen hilft, jede Bewegung mit dem richtigen Buchhaltungsbeleg abzustimmen. Sie importieren eine Datei Ihrer Bank (oder bereiten ein API-Konnektorprofil vor), das Modul schlägt automatisch die Rechnungen, Anzahlungen, Gutschriften, Löhne oder Abgaben vor, die am besten zu jeder Zeile passen, und erstellt dann nach Ihrer Prüfung die native Dolibarr-Zahlung und gleicht die Rechnung aus. Das Ziel: weniger manuelle Erfassung, ein schnellerer Abgleich und eine stets aktuelle Buchhaltung, ohne das Modul jemals allein handeln zu lassen.

Es stützt sich vollständig auf native Dolibarr-Objekte: Bankkonten, Kunden- und Lieferantenrechnungen, Anzahlungen, Gutschriften, Löhne, Sozial-/Steuerabgaben und Zahlungsarten.
Keine Änderung am Dolibarr-Kern: Das Modul fügt seine eigenen Seiten und eigenen Tabellen im Menü Banken/Kassen hinzu.
Die Kontrolle bleibt beim Menschen: Die Dolibarr-Zahlung wird nie erstellt, ohne dass Sie die Zuordnung geprüft haben.
Sobald eine Bankbuchung bezahlt oder abgeglichen ist, wird sie gesperrt und nicht mehr erneut vorgeschlagen, was Doppelzahlungen vermeidet.

2. Import von Kontoauszügen

Die Seite Bankimport ermöglicht es, eine von Ihrer Bank bereitgestellte Datei zu laden und jeden Vorgang in eine abgleichbereite Buchung auf dem Dolibarr-Bankkonto Ihrer Wahl umzuwandeln.

Unterstützung von 5 Formaten: CSV, OFX, QIF, CAMT.053 XML und MT940 (.sta-Dateien), mit einer Option zur automatischen Formaterkennung.
Tolerante Verarbeitung von CSV-Exporten: unterschiedliche Trennzeichen, Windows/ISO-Kodierungen, alte Datumsangaben und getrennte Soll-/Haben-Spalten.
Auswahl des Ziel-Bankkontos in Dolibarr (ein Standardkonto kann in der Konfiguration vorausgewählt werden).
Jede importierte Datei wird zu einem identifizierten Import-Los mit einem Fingerabdruck, um nachzuverfolgen, was geladen wurde.
Dublettenschutz: Das Modul lehnt einen bereits vorhandenen Vorgang ab (Datei-Fingerabdruck und Geschäftsschlüssel Datum + Konto + Betrag + Bezeichnung + Gegenpartei).
Anzeige einer Diagnose der ersten fehlerhaften Zeilen, um eine fehlerhaft formatierte Datei zu korrigieren.
Sicherheitsprüfungen: erlaubte Dateiendungen und einstellbare maximale Importgröße.

3. Übersicht und Nachverfolgung der Importe

Die Startseite des Moduls bietet einen Überblick über die Abgleichaktivität und einen schnellen Zugriff auf die zuletzt importierten Vorgänge.

Vier bezifferte und anklickbare Kacheln: importierte Transaktionen, vorgeschlagene Zuordnungen, genehmigte Zeilen und ausgeführte Zahlungen.
Bereich Letzte Importe mit den jüngsten Losen: Datum, Quelle, Dateiname, Bankkonto (anklickbarer Link zum Kontodatensatz), Anzahl importierter/gelesener Zeilen, Dubletten und Status.
Nach Spalten sortierbare Liste und direkte Verknüpfungen zu Import, Zuordnungen und Import-Losen.

4. Intelligenter Abgleich der Buchungen

Die Seite Bankzuordnungen ist das Herzstück des Moduls: Sie vergleicht jede Bankzeile mit den offenen Belegen in Dolibarr und schlägt die besten Zuordnungen vor, ohne jemals an Ihrer Stelle zu entscheiden.

Automatische Erzeugung von Vorschlägen (Kandidaten) für die zu bearbeitenden Buchungen.
Relevanz-Score, berechnet anhand mehrerer Kriterien: Betrag (exakt, nah, ungefähr, mit Gebühren/Rundung vereinbare Abweichung, Teilzahlung), Rechnungsreferenz, Name oder Code des Geschäftspartners, Richtung der Bewegung und Datumsnähe.
Jeder Vorschlag zeigt seine Gründe, gestützt auf den gefundenen Nachweis (Wort des Geschäftspartners, erkannte Referenz ...).
Tabs zur Nachverfolgung des Arbeitsablaufs: Zu bearbeiten, Genehmigt zu zahlen, Abgelehnt, Erledigt, Alle.
Erkennung der Zahlungsart (Scheck, Karte, Überweisung, Lastschrift, Wechsel, Bargeld) zum Vorausfüllen der Zahlungsweise.
Geführter Abgleich in einem eigenen Fenster: Bestätigung einer vorgeschlagenen Zuordnung, manuelle Zuweisung einer Rechnung oder Teileinzug mit abzugleichendem Betrag.
Aktionen pro Zeile: genehmigen, ablehnen, eine Ablehnung wieder öffnen, eine Genehmigung rückgängig machen, nach Zahlung sperren.
Bereits abgeglichene, bezahlte oder gesperrte Buchungen werden in neuen Berechnungen nicht mehr vorgeschlagen.
Abgleich mit bereits in Dolibarr vorhandenen Bankbuchungen möglich: in diesem Fall nur Abgleich, niemals eine zweite Zahlung.

5. Erstellung der Dolibarr-Zahlungen

Sobald eine Zuordnung bestätigt ist, erstellt das Modul die entsprechende native Dolibarr-Zahlung und aktualisiert den Beleg, sofern Sie dazu berechtigt sind.

Kundenrechnung ausgeglichen über eine native Kundenzahlung; Lieferantenrechnung über eine native Lieferantenzahlung.
Kunden- und Lieferanten-Anzahlungen werden ebenfalls für die Erstellung der Zahlung unterstützt.
Unbezahlte Löhne und Sozial-/Steuerabgaben: Erstellung der nativen Dolibarr-Lohn- oder Abgabenzahlung.
Die Zahlung erzeugt die Verknüpfung zur Rechnung, die Buchung auf dem Bankkonto und den Wechsel in den Status bezahlt, wenn der Beleg ausgeglichen ist.
Teilzahlung möglich durch Eingabe des abzugleichenden Betrags.
Sonderfall Gutschriften: Sie werden nur abgeglichen und gesperrt, ohne automatische Erstellung einer Zahlung.

6. Integration in die nativen Bank-Seiten von Dolibarr

Ab Version 1.3.0 erscheint das Modul direkt in den nativen Bankbuchungen von Dolibarr (Bank, Konto, Buchungen), ohne den gewohnten Bildschirm zu verlassen.

Schaltflache „Kontoauszug importieren“ in der Buchungsliste eines Kontos: Sie offnet ein Bestatigungsfenster (betroffene Bank und bereits importierte Auszuge) und nutzt anschliessend den Import des Moduls, ohne Doppelerfassung.
Spalte „Abgleich“ bei jeder Buchung: Sie unterscheidet auf einen Blick Zeilen, die uber einen Bank-Import-Stapel zugeordnet wurden, von jenen, die nativ in Dolibarr abgeglichen sind.
Aktion „Zuordnen“ bei einer nicht abgeglichenen Buchung: Sie offnet den Abgleich des Moduls, um die Buchung mit einer oder mehreren Rechnungen zu verknupfen.
Keine doppelte Bankbewegung: Die Zahlung wird an die bestehende Buchung angehangt (keine neue Zeile), danach wird der native Abgleich automatisch gesetzt, sobald die Buchung vollstandig zugeordnet ist.
Bidirektional: Zuordnungen und Abgleiche werden zwischen dem Modul und dem nativen Bank-Bildschirm von Dolibarr geteilt.
Aktiv sobald das Modul aktiviert ist: nach einem Update das Modul einfach deaktivieren und wieder aktivieren, um es zu registrieren, ohne manuelle Konfiguration. Kann in der Modulkonfiguration bei Bedarf deaktiviert werden.

7. Verwaltung der Import-Lose

Die Seite Import-Lose ermöglicht es, das Geladene zu überprüfen, dessen Details einzusehen und sauber aufzuräumen, insbesondere während der Testphasen.

Liste der Lose mit Referenz, Quelle, Datei, Datum, Anzahl vorhandener und geschützter Zeilen sowie Status.
Detail eines Loses: zeilenweise Einsicht der importierten Buchungen.
Löschen eines vollständigen Loses oder einer einzelnen Importzeile.
Bereits abgeglichene oder bezahlte Zeilen sind geschützt; ihr erzwungenes Löschen ist Administratoren vorbehalten und löscht niemals die bereits erstellten Dolibarr-Zahlungen.
Nützlich, um einen Testdatensatz vor der Produktivsetzung zurückzusetzen.

8. Bankkonnektoren (API-Vorbereitung)

Die Seite Bankkonnektoren ermöglicht es, Verbindungsprofile zu Bank-APIs anzulegen, um den Abruf der Buchungen zu automatisieren.

Erstellung von Profilen vom Typ PSD2/AISP, EBICS oder Custom JSON.
Eingabe des Dienstleisters oder der Bank, der API-URL, des verknüpften Bankkontos und des Aktiv-Status.
Das Geheimnis wird nie im Klartext gespeichert: Man gibt eine Geheimnis-Referenz an (Umgebungsvariable oder Server-Geheimnis), eingegeben in einem geschützten Feld.
Hinweis, der daran erinnert, dass eine Bank-API einen eigenen Vertrag/Dienstleister voraussetzt.
Zu beachten: Die tatsächliche Synchronisation erfordert einen bank- oder dienstleisterspezifischen Adapter; die Profile bereiten die Integration vor, lösen aber standardmäßig keinen automatischen Import aus.

9. Modulkonfiguration

Der Konfigurationsbildschirm passt das Verhalten des Moduls an Ihr Unternehmen und an Ihre Art des Abgleichs an.

Standard-Bankkonto, das für Importe und Zahlungen verwendet wird.
Standard-Zahlungsart, die bei der Bestätigung vorgeschlagen wird.
Betragstoleranz, um Rundungen oder kleine Gebühren aufzufangen (Standard 0,02).
Starker Kandidaten-Score und minimaler Zuordnungs-Score, um die Feinheit der Vorschläge einzustellen.
Maximale Anzahl analysierter Rechnungen und Anzahl je Buchung behaltener Kandidaten (Leistung).
Maximale Größe der importierten Dateien.
Zu aktivierende/deaktivierende Optionen: auch in den Löhnen suchen, auch in den Sozial-/Steuerabgaben suchen und nach der Betragsabweichung filtern (vermeidet Vorschläge, deren Betrag keinen Bezug hat).

10. Zugriffsrechte (Berechtigungen)

Das Modul stellt eigene Dolibarr-Rechte bereit, um Einsicht, Import, Abgleich und die buchhalterische Aktion zu trennen.

Bank Import lesen: Übersicht und Buchungen einsehen.
Kontoauszüge importieren.
Zuordnungen erzeugen und bestätigen.
Dolibarr-Zahlungen erstellen (buchhalterische Aktion).
Bank Import verwalten: Konfiguration und Konnektoren.
Diese Trennung erlaubt es zum Beispiel, einen Mitarbeiter importieren und abgleichen zu lassen, ohne ihn zur Erstellung der Zahlungen zu berechtigen.

11. Verknupfungen mit Dolibarr

Das Modul arbeitet nicht isoliert: Es ist mit den nativen Bausteinen von Dolibarr verzahnt.

Bankkonten (Banken/Kassen) : Jeder Import zielt auf ein Dolibarr-Bankkonto; bei der Zahlung wird die Buchung über den nativen Ablauf auf dieses Konto gebucht, und das Konto bleibt von der Übersicht aus anklickbar.
Kundenrechnungen : Einzahlungsbuchungen werden mit offenen Kundenrechnungen abgeglichen; die Bestätigung erstellt eine native Kundenzahlung und gleicht die Rechnung aus, wenn der Betrag vollständig ist.
Lieferantenrechnungen : Auszahlungen werden mit Lieferantenrechnungen abgeglichen; die Bestätigung erstellt eine native Lieferantenzahlung und aktualisiert die Rechnung.
Anzahlungen und Gutschriften : Kunden-/Lieferanten-Anzahlungsrechnungen können eine Zahlung erzeugen; Kunden- und Lieferantengutschriften werden nur abgeglichen und gesperrt, ohne automatische Zahlung.
Geschäftspartner (Firmen) : Das Modul erkennt den Geschäftspartner in der Bankbezeichnung (Name, Schlüsselwörter, Code), um die richtigen Belege vorzuschlagen, gestützt auf die Dolibarr-Geschäftspartner.
Löhne und Sozial-/Steuerabgaben : Optional werden unbezahlte Löhne und Sozial-/Steuerabgaben vorgeschlagen; die Bestätigung erstellt die native Dolibarr-Lohn- oder Abgabenzahlung.
Zahlungsarten : Die vorgeschlagene Zahlungsart stammt aus dem Wörterbuch der aktiven Dolibarr-Zahlungsarten (c_paiement) und kann je nach Vorgangstyp vorab erkannt werden.
Buchhaltung und Belegstatus : Da die Zahlungen von den nativen Mechanismen von Dolibarr erstellt werden, fließen sie in die Standardbuchhaltung ein und setzen ausgeglichene Rechnungen auf den Status bezahlt, mit der zugehörigen Bankzeile.
Bank / Abgleich : Das Modul integriert sich in die native Bankbuchungsseite (Bank, Konto, Buchungen): Import-Schaltflache, Zuordnungsspalte und Aktion „Zuordnen“. Erzeugte Zahlungen werden an die bestehende Buchung angehangt und setzen den nativen Abgleich von Dolibarr, ohne eine doppelte Bewegung zu erzeugen.