BankImport+ Benutzerhandbuch

1. Überblick

BankImportPlus ermöglicht es, Banktransaktionen direkt in Ihr Dolibarr-Bankkonto zu importieren. Das Modul erkennt automatisch, welche Buchungen bereits vorhanden sind (Duplikatschutz), und versucht, jede Transaktion einer offenen Rechnung oder einem Geschäftspartner zuzuordnen – so sparen Sie viel manuelle Arbeit bei der Bankabstimmung.

Das Modul bietet zwei Import-Methoden:

2. CSV-Import

2.1 Importvorlage erstellen

Eine Importvorlage beschreibt dem Modul, wie Ihre CSV-Datei aufgebaut ist: welche Spalte das Datum enthält, welche den Betrag, welche den Verwendungszweck usw. Sie müssen diese Vorlage nur einmalig pro Bank anlegen und können sie danach für alle zukünftigen Importe wiederverwenden.

💡 Tipp: Öffnen Sie Ihre CSV-Datei in Excel oder LibreOffice Calc, um die Spaltennummern zu ermitteln. Die erste Spalte ist Spalte 1, die zweite Spalte 2 usw. Prüfen Sie auch, ob die erste Zeile eine Überschrift enthält – das können Sie in der Vorlage angeben.
  1. Menü CSV Importvorlagen → Vorlage hinzufügen öffnen
  2. Einen aussagekräftigen Namen eingeben (z. B. „Erste Bank AT")
  3. Das zugehörige Dolibarr-Bankkonto aus der Liste wählen
  4. Für jedes Feld (Datum, Betrag, Geschäftspartner, Verwendungszweck) die Spaltennummer eintragen
  5. Datumsformat, Trennzeichen-Typ (Komma oder Semikolon) sowie Tausender- und Dezimaltrennzeichen wählen
  6. Auf Speichern klicken – die Vorlage steht sofort für den Import bereit
💡 Standard-Vorlage: In der Vorlagenliste können Sie eine Vorlage durch Klick auf das Stern-Symbol (☆) als Standard markieren. Die Standard-Vorlage wird auf der Upload-Seite automatisch vorausgewählt – Sie müssen sie nicht jedes Mal neu auswählen.

2.2 CSV-Datei importieren

Sobald Ihre Importvorlage angelegt ist, können Sie CSV-Dateien hochladen:

  1. Menü Bank-Daten importieren → mit CSV Datei öffnen
  2. Die gewünschte Importvorlage aus der Dropdown-Liste auswählen
  3. Auf Datei auswählen klicken und die Exportdatei Ihrer Bank hochladen
  4. Auf Auslesen klicken – das Modul liest die Datei ein und zeigt eine Vorschau
  5. In der Vorschau die gewünschten Transaktionen markieren und auf Importieren klicken
💡 Importieren & Datei löschen: Neben dem Button Importieren gibt es auch den Button Importieren & Datei löschen. Damit wird die hochgeladene CSV-Datei nach erfolgreichem Import automatisch vom Server entfernt.

2.3 Vorschau und Zuordnung

Die Vorschau zeigt alle eingelesenen Transaktionen nebeneinander mit den bereits in Dolibarr vorhandenen Bankbuchungen. So sehen Sie auf einen Blick, welche Buchungen neu sind und welche bereits existieren.

2.4 Lieferantenrechnung automatisch erstellen

Bei ausgehenden Zahlungen (negativer Betrag) kann das Modul automatisch eine Lieferantenrechnung in Dolibarr erstellen, validieren und als bezahlt markieren.

Voraussetzungen

Ablauf

  1. In der Vorschau-Tabelle erscheint für jeden negativen Betrag ohne vorhandene Dolibarr-Buchung eine Checkbox in der Spalte „LR"
  2. Setzen Sie das Häkchen bei den gewünschten Einträgen
  3. Wählen Sie im Dropdown Geschäftspartner den passenden Lieferanten aus
  4. Klicken Sie auf Importieren – das Modul erstellt für jeden markierten Eintrag automatisch eine Lieferantenrechnung

Jede erstellte Lieferantenrechnung enthält:

⚠️ Die Lieferantenrechnung wird nur erstellt, wenn ein Geschäftspartner ausgewählt ist. Fehlt der Geschäftspartner, erscheint eine Fehlermeldung und der Eintrag wird übersprungen.
💡 Die LR-Checkbox erscheint nur bei negativen Beträgen, die noch keine entsprechende Buchung in Dolibarr haben.

3. Enable Banking (direkter Bankimport)

3.1 Was ist Enable Banking?

Enable Banking ist ein europäischer Service, der es ermöglicht, Banktransaktionen sicher und direkt aus dem Online-Banking abzurufen – ohne manuelle CSV-Exporte. Die Verbindung erfolgt über den gesetzlich geregelten PSD2-Standard (EU-Richtlinie für offenes Bankwesen), bei dem Sie der Anwendung ausdrücklich Zugriff auf Ihre Kontodaten erteilen müssen.

Enable Banking unterstützt über 2.000 Banken in Europa, darunter österreichische Banken wie Erste Bank, Raiffeisen, Sparkasse, Volksbank und BAWAG sowie deutsche Banken wie Deutsche Bank, Commerzbank und Sparkasse.

Die Transaktionen werden immer manuell abgerufen – es gibt keinen automatischen Hintergrundprozess. Sie entscheiden selbst, wann Sie neue Buchungen holen.

3.2 Enable Banking Konto & App einrichten

⚠️ Diese Einrichtung erfordert einen Dolibarr-Benutzer mit Administrator-Rechten sowie Zugriff auf den Server, auf dem Dolibarr läuft.

Die Einrichtung ist einmalig und dauert ca. 15–20 Minuten.

1
Konto bei Enable Banking erstellen Besuchen Sie enablebanking.com und erstellen Sie ein kostenloses Konto. Nach der Registrierung erhalten Sie eine Bestätigungs-E-Mail – klicken Sie auf den Link darin, um Ihr Konto zu aktivieren.
2
Im Control Panel anmelden Melden Sie sich unter enablebanking.com/cp an (Control Panel). Hier verwalten Sie Ihre Anwendungen und API-Zugänge.
3
Neue Anwendung unter „API applications" anlegen Klicken Sie im Menü des Control Panels auf API applications und dann auf New Application. Es öffnet sich das Registrierungsformular für Ihre Anwendung.
4
Registrierungsformular ausfüllen

1. Umgebung wählen – „Production" klicken:
Klicken Sie auf die Schaltfläche Production (nicht Sandbox!). Sandbox ist nur für Entwickler und Testzwecke gedacht und unterstützt nur eine begrenzte Anzahl von Banken.

2. RSA-Schlüssel-Methode wählen:
Sie haben zwei Optionen – wählen Sie jene, die zu Ihren Kenntnissen passt:

  • „Generate in the browser" (empfohlen für Einsteiger): Enable Banking erzeugt das Schlüsselpaar automatisch im Browser. Der private Schlüssel wird nach der Registrierung sofort als Datei heruntergeladen. Kein Terminal oder technisches Vorwissen erforderlich.
  • „Generate outside the browser" (für technisch Erfahrene): Sie erstellen das Schlüsselpaar selbst und laden nur den öffentlichen Schlüssel hoch. Befehle im Terminal (Linux/Mac): openssl genrsa -out private_key.pem 2048 openssl rsa -in private_key.pem -pubout -out public_key.pem Laden Sie dann die erzeugte public_key.pem als Zertifikat hoch.

3. Formularfelder ausfüllen:

  • Application name: Ein beliebiger Name, z. B. „Dolibarr BankImportPlus"
  • Allowed redirect URLs: Die Callback-URL Ihrer Dolibarr-Installation (eine URL pro Zeile): https://your-dolibarr-instance.example.com/custom/bankimportplus/bankimportplus_eb_callback.php
  • Application description: Pflichtfeld – tragen Sie Bankimport+ for Dolibarr ein
  • Email for data protection matters: Ihre E-Mail-Adresse (für DSGVO/Datenschutz-Anfragen)
  • Privacy URL: Pflichtfeld – tragen Sie folgende URL ein: https://your-dolibarr-instance.example.com/custom/bankimportplus/bankimportplus_privacy.php
  • Terms URL: Pflichtfeld – tragen Sie folgende URL ein: https://your-dolibarr-instance.example.com/custom/bankimportplus/bankimportplus_terms.php

Klicken Sie abschließend auf Register.

5
Privaten Schlüssel sichern
  • Browser-Methode: Der private Schlüssel wird nach der Registrierung automatisch als Datei heruntergeladen. Speichern Sie diese Datei sofort sicher ab – Enable Banking speichert ihn nicht und er kann danach nicht mehr abgerufen werden!
  • Manuelle Methode: Verwenden Sie die private_key.pem-Datei, die Sie in Schritt 4 mit OpenSSL erzeugt haben.
6
App aktivieren – eigenes Bankkonto verknüpfen

Nach der Registrierung erscheint die App im Control Panel mit dem Status Inactive Um die Anwendung zu aktivieren, müssen Sie Ihr eigenes Bankkonto (jenes, von dem Sie Transaktionen importieren möchten) mit der Enable-Banking-App verknüpfen.

Klicken Sie auf die Schaltfläche Activate by linking accounts.

7
Bank aus der Liste auswählen und verknüpfen

Es erscheinen drei Auswahlfelder:

  1. Country: Land Ihrer Bank auswählen (z. B. „AT" für Österreich)
  2. ASPSP: Ihre Bank aus der Liste auswählen
  3. Usage type: Kontoart auswählen – „Private" oder „Business"

Klicken Sie anschließend auf Link.

8
Authentifizierung über das E-Banking Ihrer Bank abschließen

Sie werden zur Enable-Banking-Authentifizierungsseite weitergeleitet. Klicken Sie auf Authentifizierung fortsetzen, um fortzufahren.

Schließen Sie die Authentifizierung über die E-Banking-App Ihrer Bank ab – in der Regel über eine Push-Benachrichtigung, einen QR-Code-Scan oder einen SMS-Code in der mobilen Banking-App Ihrer Bank. Nach erfolgreicher Authentifizierung ist die App aktiviert und Ihr Bankkonto verknüpft.

💡 Diese Verknüpfung im Enable-Banking-Control-Panel dient der Aktivierung der Anwendung. Das Verbinden für den eigentlichen Datenabruf in Dolibarr erfolgt in Abschnitt 3.3.
9
App-ID notieren Nach der Registrierung sehen Sie in der Anwendungsübersicht die Application ID (z. B. „a1b2c3d4-e5f6-…"). Notieren oder kopieren Sie diese ID – Sie benötigen sie für die Dolibarr-Konfiguration.
10
Privaten Schlüssel sicher auf dem Server ablegen

Kopieren Sie private_key.pem auf den Server, auf dem Dolibarr läuft – aber außerhalb des Web-Verzeichnisses (nicht im htdocs-Ordner!). Notieren Sie den vollständigen Pfad, z. B.:

/home/dolibarr/keys/private_key.pem
⚠️ Der private Schlüssel darf niemals im öffentlich zugänglichen Web-Verzeichnis liegen! Stellen Sie sicher, dass nur der Webserver-Benutzer Lesezugriff auf die Datei hat.
11
Moduleinstellungen in Dolibarr konfigurieren

Öffnen Sie in Dolibarr: Administration → Module/Anwendungen → BankImportPlus → Einstellungen (Zahnrad-Symbol). Tragen Sie folgende Werte ein:

  • Enable Banking App-ID: die App-ID aus Schritt 9
  • Enable Banking Private-Key-Pfad: der vollständige Serverpfad aus Schritt 10 (z. B. /home/dolibarr/keys/private_key.pem)

Klicken Sie auf Speichern. Das Untermenü Enable Banking erscheint jetzt im linken Menü von BankImportPlus.

3.3 Bankkonto in Dolibarr verbinden

Sobald die Einstellungen gespeichert sind, können Sie Ihr Bankkonto verbinden:

  1. Menü Enable Banking → Bankkonto verbinden öffnen
  2. Das Land Ihrer Bank auswählen (z. B. „AT" für Österreich, „DE" für Deutschland)
  3. Auf Banken laden klicken und Ihre Bank aus der Liste auswählen
  4. Das entsprechende Dolibarr-Bankkonto auswählen, dem die Transaktionen zugeordnet werden sollen
  5. Auf Mit Bank verbinden klicken – Sie werden zur Login-Seite Ihrer Bank weitergeleitet
  6. Bei Ihrer Bank einloggen und den Datenzugriff für die Anwendung bestätigen (PSD2-Einwilligung)
  7. Sie werden automatisch zurück zu Dolibarr geleitet. Die Verbindung ist nun aktiv.
💡 Der Zugriff auf Ihre Bankdaten ist in der Regel 90 Tage gültig (je nach Bank). Kurz vor Ablauf zeigt das Modul eine Warnung an – klicken Sie dann auf Neu verbinden, um den Zugriff zu erneuern.

Meldet Ihre Bank nach der Authentifizierung mehrere Konten, erscheint eine Auswahlseite – wählen Sie dort das gewünschte Konto aus und bestätigen Sie.

Um eine bestehende EB-Verbindung zu entfernen, klicken Sie in der Verbindungsliste auf das Löschen-Symbol neben dem jeweiligen Konto.

3.4 Transaktionen manuell abrufen

Der Abruf von Transaktionen erfolgt immer manuell. Es gibt keinen automatischen Hintergrundprozess – Sie entscheiden selbst, wann Sie neue Buchungen aus Ihrer Bank holen möchten.

  1. Menü Bank-Daten importieren → mit Enable Banking öffnen
  2. Das verbundene Bankkonto und den gewünschten Zeitraum (Von – Bis) auswählen
  3. Auf Vorschau laden klicken – das Modul ruft die Transaktionen von Enable Banking ab
  4. In der Vorschau die gewünschten Transaktionen prüfen und auf Importieren klicken

4. Automatisches Matching (Rechnungen & Geschäftspartner)

Das Modul versucht automatisch, jede importierte Transaktion einer offenen Rechnung oder einem Geschäftspartner in Dolibarr zuzuordnen. Das funktioniert so:

  1. Rechnungsreferenz: Der Verwendungszweck der Transaktion wird nach Rechnungsnummern durchsucht (z. B. „RE-2025-0042"). Gefundene Nummern werden mit offenen Rechnungen in Dolibarr abgeglichen.
  2. Betrag: Zusätzlich zur Referenz wird geprüft, ob der Transaktionsbetrag mit dem Betrag einer offenen Rechnung übereinstimmt.
  3. IBAN: Falls im Datensatz eine Gegenstellen-IBAN vorhanden ist, wird geprüft, ob ein Dolibarr-Geschäftspartner mit dieser IBAN hinterlegt ist.
💡 Bei eingehenden Zahlungen (positiver Betrag) wird nach Kundenrechnungen gesucht. Bei ausgehenden Zahlungen (negativer Betrag) wird nach Lieferantenrechnungen gesucht. Es werden nur offene (noch unbezahlte) Rechnungen berücksichtigt.

Wurde keine automatische Zuordnung gefunden, können Sie in der Import-Vorschau Rechnung und Geschäftspartner manuell aus einer Dropdown-Liste auswählen.

5. Statistiken & Auswertungen

Unter dem Menüpunkt Statistik stehen zwei Auswertungen zur Verfügung:

Wählen Sie oben Monat und Jahr aus der Dropdown-Liste und klicken Sie auf Anzeigen.

💡 Die Statistiken berücksichtigen ausschließlich Transaktionen, die per CSV-Import eingelesen wurden. Buchungen aus Enable Banking sind in den Statistiken nicht enthalten.

6. Export

Unter Export können Sie Ihre importierten Banktransaktionen in verschiedenen Formaten herunterladen:

Wählen Sie einen Datumsbereich (Von – Bis) und optional ein bestimmtes Bankkonto. Wenn Sie kein Konto auswählen, werden alle Konten exportiert. Klicken Sie dann auf Export erstellen.

💡 Der Export umfasst ausschließlich Transaktionen, die per CSV-Import eingelesen wurden. Buchungen aus Enable Banking werden beim Export nicht berücksichtigt.

7. Import-Historie

Unter Import-Historie finden Sie eine vollständige Aufzeichnung aller bisherigen Importe. Für jeden Import werden angezeigt:

Die Historie dient als Nachweis und erleichtert die Fehlersuche bei unklaren Importen.

8. Moduleinstellungen

Die Einstellungsseite des Moduls ist erreichbar über: Administration → Module/Anwendungen → BankImportPlus → Einstellungen (Zahnrad-Symbol).

Einstellung Beschreibung
Rechnungen automatisch bezahlt setzen Wenn aktiv, wird eine zugeordnete Rechnung beim Import automatisch auf „Bezahlt" gesetzt. Standardmäßig aktiviert.
Enable Banking App-ID Die Application ID aus dem Enable Banking Control Panel – erforderlich für alle EB-Funktionen.
Enable Banking Private-Key-Pfad Vollständiger Serverpfad zur privaten RSA-Schlüsseldatei. Die Datei muss außerhalb des Web-Verzeichnisses liegen (nicht im htdocs-Ordner!).
Enable Banking Debug-Logging Aktiviert ausführliches Logging in das Apache-Error-Log. Nur zur Fehlersuche einschalten – im Normalbetrieb deaktiviert lassen.
EB Puffer-Tage Duplikaterkennung Anzahl der Tage, um die der Datumsbereich bei der Enable-Banking-Duplikaterkennung erweitert wird. Standard: 5 Tage. Erhöhen Sie diesen Wert, wenn Buchungen mit Valutadatum knapp außerhalb des Abrufzeitraums fälschlicherweise als Duplikate erkannt werden.
Landing Page nach Import URL der Seite, auf die nach einem erfolgreichen Import weitergeleitet wird. Standard: die BankImportPlus-Startseite.
↑ Nach oben