Bankauszug-Import und Abgleich für Dolibarr


Bank Import für Dolibarr
Importieren Sie Ihre Kontoauszüge, erhalten Sie bewertete Abgleiche mit Ihren Rechnungen und erstellen Sie native Dolibarr-Zahlungen — nach menschlicher Validierung
   Multiformat-Import
   Bankabgleich
   Bewertete Abgleiche
   Native Zahlungen
   Menschliche Validierung
   Dublettenschutz
   CSV · OFX · QIF · CAMT.053 · MT940

Übersicht

Bank Import ist ein externes Modul für Dolibarr ERP/CRM (Herausgeber KSIDol), das den Bankabgleich vom Auszug bis zur Zahlung automatisiert.

Es importiert die Buchungen eines Kontoauszugs (CSV, OFX, QIF, CAMT.053, MT940), schlägt bewertete Abgleiche mit Ihren offenen Rechnungen, Anzahlungen, Löhnen und Abgaben vor und erstellt anschließend die nativen Dolibarr-Zahlungen — erst nach Ihrer Validierung. Das Modul schlägt vor, der Benutzer entscheidet: Keine Zahlung wird automatisch erstellt, keine bestehende Buchung wird geändert oder gelöscht.

Das Modul verändert keine Datei des Dolibarr-Kerns.

Herausgeber und Support

Element Information
Herausgeber KSIDol
Spezialität Dolibarr-Integrator
Dienstleistungen Maßgeschneiderte Entwicklung, SaaS-Hosting, Dolibarr-Betreuung
Website https://www.ksidol.io
Support support@ksidol.io
Dolistore-Module https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search=

Modulinformationen

Information Detail
Modulname Bank Import
Hauptzweck Kontoauszüge importieren und Dolibarr-Zahlungen nach bewertetem Abgleich erstellen
Typ Externes Dolibarr-Modul
Familie Finanzen / Buchhaltung
Dokumentierte Version 24.0.0
Dolibarr-Kompatibilität Dolibarr 18.0 bis 24.x
PHP-Kompatibilität PHP 8.0 oder höher
Änderung des Dolibarr-Kerns Nein
Lizenz GNU GPLv3
Verfügbare Sprachen Französisch, Englisch, Deutsch, Spanisch, Italienisch

Offizielle Links

Ziele des Moduls

Den Zeitaufwand für den Bankabgleich reduzieren und dabei die menschliche Kontrolle über jede Zahlung behalten:

  • einen Auszug von jeder Bank dank Multiformat-Erkennung importieren;
  • jede Buchung automatisch mit den offenen Dolibarr-Belegen abgleichen, mit Score und Begründungen;
  • den richtigen Abgleich validieren, Modus und Datum wählen und dann die native Dolibarr-Zahlung erstellen;
  • niemals eine bestehende Buchung anrühren: Das Modul schlägt vor, der Mensch genehmigt.

Für wen?

  • Kleinstunternehmen, KMU und Vereine, die ihre Zahlungseingänge noch von Hand erfassen.
  • Buchhalter und Verwalter, die einen Auszug in wenigen Minuten abstimmen wollen, ohne Doppelerfassung.
  • Dolibarr-Integratoren, die einen zuverlässigen, die Unveränderlichkeit wahrenden Bankabgleich suchen.

Hauptfunktionen

  • Multiformat-Import: CSV (Trennzeichen und Soll-/Haben-Spalten erkannt, tolerante Kodierung), OFX (STMTTRN-Blöcke), QIF, CAMT.053 XML (Ntry-Einträge), MT940 (:61:/:86:). Format automatisch erkannt oder manuell gewählt.
  • Dublettenschutz: aus Konto, Quelle, Referenz, Daten, Betrag, normalisiertem Verwendungszweck und Gegenpartei berechneter Fingerabdruck; bereits importierte Zeilen werden nie erneut eingespielt.
  • Bewerteter Abgleich: Vergleich von Betrag (exakt, nah, Gebühren-/Rundungsdifferenz, Teilzahlung), Rechnungsreferenz (und deren Varianten), Drittzahler (Name, Wörter, Code), Bankrichtung und Datum. Jeder Kandidat zeigt seinen Score und seine Begründungen.
  • Abgleichquellen: Kunden-/Lieferantenrechnungen und Anzahlungen, Gutschriften (nur Verknüpfung), unbezahlte Löhne und unbezahlte Sozial-/Steuerabgaben (aktivierbar) sowie bestehende native Bankbuchungen (nur Verknüpfung, ohne Doppelzahlung).
  • Validierung und Zahlung: Genehmigung einer Zeile (oder Teilzuordnung), Wahl von Modus und Datum, dann Erstellung der nativen Dolibarr-Zahlung (Rechnungs-, Lohn- oder Abgabenzahlung) und der Bankbuchung; Sperrung des Abgleichs.
  • Erkennung des Zahlungstyps: Scheck, Karte, Überweisung, Lastschrift, domizilierter Wechsel, Bargeld.
  • Verwaltung der Importstapel: Löschen eines Stapels oder einer Zeile, Zurücksetzen der Testsätze; verknüpfte/bezahlte/gesperrte Zeilen sind geschützt; eine bereits erstellte Dolibarr-Zahlung wird nie gelöscht.
  • Dashboard: KPIs (Transaktionen, Kandidaten, genehmigt, ausgeführte Zahlungen) und Flussfilter (zu bearbeiten, genehmigt zur Zahlung, abgelehnt, abgeschlossen).

Menüs

Unter dem Hauptmenü Bank fügt das Modul hinzu:

  • Dashboard — Abgleichindikatoren
  • Bankimport — Hochladen einer Auszugsdatei
  • Bankabgleiche — Buchungen, bewertete Kandidaten und Validierung
  • Importstapel — Detail, Löschen, Zurücksetzen
  • Bankkonnektoren — Konnektorprofile (Administrator)
  • Konfiguration — Moduleinstellungen

Konfiguration

Über Startseite → Konfiguration → Module → Bank Import:

  • Standard-Bankkonto (BANKIMPORT_DEFAULT_BANK_ACCOUNT_ID);
  • Standard-Zahlungsmodus (BANKIMPORT_DEFAULT_PAYMENT_MODE_ID);
  • Betragstoleranz (BANKIMPORT_AMOUNT_TOLERANCE, Standard 0,02);
  • Score „starker Kandidat" (BANKIMPORT_AUTO_APPROVE_SCORE, Standard 90);
  • Mindest-Abgleichscore (BANKIMPORT_MATCH_MIN_SCORE, Standard 40);
  • max. Anzahl der pro Transaktion analysierten Rechnungen (BANKIMPORT_MATCH_SCAN_LIMIT, Standard 1000);
  • max. Kandidaten pro Transaktion (BANKIMPORT_MATCH_TOP_PER_TRANSACTION, Standard 10);
  • maximale Größe einer importierten Datei (BANKIMPORT_IMPORT_MAX_FILESIZE_MB, Standard 20 MB);
  • auch in Löhnen / Sozial- und Steuerabgaben suchen (standardmäßig aktiviert).

Benutzerberechtigungen

Das Modul definiert fünf Berechtigungen:

  • Lesen von Bank Import — Dashboard und Listen (read)
  • Importieren von Kontoauszügen — Hochladen und Lesen der Dateien (import)
  • Erzeugen und Validieren der Abgleiche — Berechnung, Genehmigung/Ablehnung, Verknüpfung (match)
  • Erstellen der Dolibarr-Zahlungen — native Zahlungen nach Validierung (pay)
  • Verwalten von Bank Import — Konfiguration, Konnektoren, Stapel (admin)

Typischer Ablauf

  1. Importieren Sie eine Auszugsdatei (Bankimport).
  2. Erzeugen Sie die Abgleiche (Bankabgleiche).
  3. Prüfen Sie Score und Begründungen jedes Kandidaten.
  4. Genehmigen Sie den richtigen Abgleich, wählen Sie Modus und Zahlungseingangsdatum.
  5. Die native Dolibarr-Zahlung wird erstellt, die Bankbuchung befüllt und der Abgleich gesperrt.

Technischer Hinweis

  • Tabellen: llx_bankimport_transaction, llx_bankimport_import, llx_bankimport_match, llx_bankimport_connector.
  • Eingehaltene Dolibarr-Standards: Rechte, CSRF-Token, GETPOST, Escaping.
  • Konnektor-Geheimnisse werden referenziert (Name eines außerhalb des Webroots verwalteten Geheimnisses), nie im Klartext gespeichert.
  • Unveränderlichkeit: Das Modul erstellt native Zahlungen nach menschlicher Validierung; es ändert oder löscht keine bestehende Buchhaltungsbuchung und löscht nie eine bereits erstellte Zahlung.
  • Keine Änderung des Dolibarr-Kerns.

Installation

  1. Entpacken Sie das Archiv, um einen Ordner bankimport/ zu erhalten.
  2. Kopieren Sie ihn in htdocs/custom/ Ihres Dolibarr.
  3. Aktivieren Sie das Modul über Startseite → Konfiguration → Module/Anwendungen (Familie Finanzen).
  4. Öffnen Sie die Konfiguration und wählen Sie ein Standard-Bankkonto und einen Standard-Zahlungsmodus.

Aktualisierung

  1. Ersetzen Sie den Ordner htdocs/custom/bankimport/ durch die neue Version.
  2. Laden Sie eine Verwaltungsseite neu: fehlende Tabellen und Konstanten werden automatisch und idempotent erstellt.
  3. Die Aktualisierung löscht keine bestehenden Daten.

Problembehebung

  • Keine Zeile beim CSV-Import erkannt: prüfen Sie das Trennzeichen und das Vorhandensein einer Kopfzeile (Spalten Datum, Verwendungszweck, Betrag, Währung, Drittzahler).
  • Datei abgelehnt: die konfigurierte Maximalgröße wurde überschritten (BANKIMPORT_IMPORT_MAX_FILESIZE_MB).
  • Kein Kandidat: senken Sie den Mindestscore, erhöhen Sie das Analyselimit oder prüfen Sie, dass die Rechnungen tatsächlich offen sind.
  • Kein Zahlungsmodus: aktivieren Sie mindestens einen Zahlungsmodus in Dolibarr.

Siehe auch

  • KSIDol Signatur-Terminal: Unterschrift aller nativen Dolibarr-Belege, kompatibel mit allen KSIDol-Modulen.
  • Kompatibilität: Dolibarr 18.0 bis 24.x — PHP 8.0+ — Lizenz GPLv3 — Herausgeber: KSIDol.

Zusammenfassung

Bank Import importiert Ihre Kontoauszüge (CSV, OFX, QIF, CAMT.053, MT940), gleicht jede Buchung mit einem Score und Begründungen mit Ihren offenen Rechnungen und Belegen ab und erstellt anschließend die nativen Dolibarr-Zahlungen nach Validierung — ohne jemals eine bestehende Buchung zu ändern oder die Unveränderlichkeit zu brechen.