View source for Bankauszug-Import und Abgleich für Dolibarr

[[Category:Complementary modules]]
[[Category:K.S.I]]
[[Category:Financial]]
[[Category:Interface]]

{{TemplateDocDev}}
{{TemplateDocUtil}}

<div style="border:1px solid #d7e3f4; border-radius:14px; padding:22px; margin:12px 0 22px 0; background:linear-gradient(135deg,#f6faff,#ffffff); box-shadow:0 2px 10px rgba(20,60,110,0.08);">
  <div style="font-size:28px; font-weight:700; color:#17365d; margin-bottom:8px;">Bank Import für Dolibarr</div>
  <div style="font-size:18px; color:#345; margin-bottom:14px;">Importieren Sie Ihre Kontoauszüge, erhalten Sie bewertete Abgleiche mit Ihren Rechnungen und erstellen Sie native Dolibarr-Zahlungen — nach menschlicher Validierung</div>
  <div style="display:flex; flex-wrap:wrap; gap:8px; margin-top:10px;">
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Multiformat-Import</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Bankabgleich</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Bewertete Abgleiche</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Native Zahlungen</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Menschliche Validierung</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Dublettenschutz</span>
    <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">CSV · OFX · QIF · CAMT.053 · MT940</span>
  </div>
</div>

== Ü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 ==

{| class="wikitable" style="width:100%; border-collapse:collapse;"
! style="width:24%; background:#f0f6ff;" | Element
! style="background:#f0f6ff;" | 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 ==

{| class="wikitable" style="width:100%;"
! style="width:24%; background:#f7f7f7;" | Information
! style="background:#f7f7f7;" | 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 ==

* Demonstrationsvideo: [https://youtu.be/zm1yBnvbWJg Bank Import — Demo (YouTube)]
* Shop: [https://www.ksidol.io KSIDol.io]
* Modulseite: [https://www.ksidol.io/de/modules/detail?module=main_module_bankimport ksidol.io/de]
* K.S.I-Herausgeberseite auf DoliStore: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= K.S.I-Module auf DoliStore]

== 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 (<code>BANKIMPORT_DEFAULT_BANK_ACCOUNT_ID</code>);
* Standard-Zahlungsmodus (<code>BANKIMPORT_DEFAULT_PAYMENT_MODE_ID</code>);
* Betragstoleranz (<code>BANKIMPORT_AMOUNT_TOLERANCE</code>, Standard 0,02);
* Score „starker Kandidat" (<code>BANKIMPORT_AUTO_APPROVE_SCORE</code>, Standard 90);
* Mindest-Abgleichscore (<code>BANKIMPORT_MATCH_MIN_SCORE</code>, Standard 40);
* max. Anzahl der pro Transaktion analysierten Rechnungen (<code>BANKIMPORT_MATCH_SCAN_LIMIT</code>, Standard 1000);
* max. Kandidaten pro Transaktion (<code>BANKIMPORT_MATCH_TOP_PER_TRANSACTION</code>, Standard 10);
* maximale Größe einer importierten Datei (<code>BANKIMPORT_IMPORT_MAX_FILESIZE_MB</code>, 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 ==

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

== Technischer Hinweis ==

* Tabellen: <code>llx_bankimport_transaction</code>, <code>llx_bankimport_import</code>, <code>llx_bankimport_match</code>, <code>llx_bankimport_connector</code>.
* Eingehaltene Dolibarr-Standards: Rechte, CSRF-Token, <code>GETPOST</code>, 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 ==

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

== Aktualisierung ==

# Ersetzen Sie den Ordner <code>htdocs/custom/bankimport/</code> durch die neue Version.
# Laden Sie eine Verwaltungsseite neu: fehlende Tabellen und Konstanten werden automatisch und idempotent erstellt.
# 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 (<code>BANKIMPORT_IMPORT_MAX_FILESIZE_MB</code>).
* '''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.