dolibarr.bankimport/README.md
data 94efa59df3 v1.7: Multi-invoice payments and payment unlinking
- Add multi-invoice payment support (link one bank transaction to multiple invoices)
- Add payment unlinking feature to correct wrong matches
- Show linked payments, invoices and bank entries in transaction detail view
- Allow linking already paid invoices to bank transactions
- Update README with new features
- Add CHANGELOG.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-20 09:00:05 +01:00

3.3 KiB
Executable file

BANKIMPORT FOR DOLIBARR ERP & CRM

Dolibarr-Modul zum Import von Kontoauszügen und Buchungen über die FinTS/HBCI-Schnittstelle deutscher Banken.

Features

  • FinTS/HBCI-Anbindung: Automatischer Abruf von Kontobuchungen über die FinTS-Schnittstelle (getestet mit VR-Banken/Atruvia)
  • TAN-Verfahren: Unterstützung von SecureGo Plus (Decoupled TAN) für die TAN-Bestätigung per App
  • Automatischer Import: Cronjob-basierter Import von Buchungen (täglich, zweimal wöchentlich oder wöchentlich)
  • Buchungszuordnung: Automatische Zuordnung importierter Buchungen zu Rechnungen anhand von Referenznummern, Beträgen, Namen und IBAN
  • Multi-Rechnungszahlungen: Verknüpfung einer Bankbuchung mit mehreren Rechnungen (Sammelzahlungen)
  • Zahlungsverknüpfung korrigieren: Möglichkeit falsche Zuordnungen aufzuheben und neu zu verknüpfen
  • PDF-Kontoauszüge: Upload und Verwaltung von PDF-Kontoauszügen mit automatischer Metadaten-Erkennung (Auszugsnummer, Zeitraum, Saldo)
  • Mehrfach-Upload: Gleichzeitiger Upload mehrerer PDF-Kontoauszüge
  • Dashboard: Übersichtsseite mit den letzten Buchungen und Kontoauszügen
  • Erinnerungsfunktion: Konfigurierbare Warnung wenn Kontoauszüge nicht aktuell sind
  • Integration: Einbindung in das Dolibarr-Menü "Banken und Kasse"

Voraussetzungen

  • Dolibarr ERP & CRM >= 16.0
  • PHP >= 8.0
  • pdfinfo und pdftotext (Paket poppler-utils) für die PDF-Metadaten-Erkennung
  • Zugang zu einer Bank mit FinTS/HBCI-Schnittstelle

Installation

Aus dem Git-Repository

cd /path/to/dolibarr/custom
git clone <repository-url> bankimport
cd bankimport
composer install

Aktivierung

  1. In Dolibarr als Administrator anmelden
  2. Unter "Einstellungen" > "Module/Applikationen" das Modul "Bankimport" aktivieren
  3. Unter "Banken und Kasse" > "Bankimport" die FinTS-Verbindungsdaten konfigurieren

Konfiguration

FinTS-Verbindung

  • FinTS Server URL: Die FinTS-URL Ihrer Bank (z.B. https://fints1.atruvia.de/cgi-bin/hbciservlet für VR-Banken)
  • Bankleitzahl (BLZ): 8-stellige Bankleitzahl
  • Benutzerkennung: Ihre Online-Banking Benutzerkennung
  • PIN: Wird verschlüsselt in der Datenbank gespeichert
  • IBAN: Kontonummer/IBAN des abzurufenden Kontos

Automatischer Import

Der automatische Import kann im Admin-Bereich aktiviert werden. Die Buchungen werden dann per Dolibarr-Cronjob abgerufen. Unterstützte Intervalle: täglich, zweimal wöchentlich, wöchentlich.

PDF-Upload Einstellungen

  • Upload-Modus: Automatisch (Metadaten aus PDF extrahieren) oder Manuell
  • Erinnerung: Konfigurierbare Warnung wenn der letzte Kontoauszug älter als X Monate ist

Berechtigungen

  • Bankimport lesen: Buchungen und Kontoauszüge ansehen
  • Bankimport schreiben: Kontoauszüge abrufen und PDF hochladen
  • Bankimport löschen: Buchungen und Kontoauszüge löschen

Technische Details

Verwendete Bibliotheken

Datenbank-Tabellen

  • llx_bankimport_transaction - Importierte Buchungen
  • llx_bankimport_statement - PDF-Kontoauszüge

Lizenz

GPLv3 oder (nach Wahl) jede spätere Version. Siehe Datei COPYING für weitere Informationen.

Autor

Eduard Wisch - data IT solution