dolibarr.bankimport/CHANGELOG.md
data fc380892f0 feat: PDF-Kontoauszüge per FinTS (HKEKP) abrufen
- Neue php-fints Segmente: HKEKPv2, HIEKPv2, HIEKPSv2
- Action-Klasse GetStatementPDF mit Pagination-Support
- Integration in pdfstatements.php (2-Spalten-Layout)
- Cronjob doAutoFetchPdf für automatischen Abruf
- Bank-Support-Prüfung via BPD (HIEKPS Parameter)

Hinweis: Nicht alle Banken unterstützen HKEKP

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-03-05 14:26:35 +01:00

6.5 KiB
Executable file

Changelog

Alle wesentlichen Änderungen an diesem Projekt werden in dieser Datei dokumentiert.

[3.5] - 2026-03-05

Hinzugefügt

  • PDF-Kontoauszüge per FinTS (HKEKP): Elektronische Kontoauszüge direkt von der Bank abrufen
    • Neue Segmente für php-fints: HKEKPv2, HIEKPv2, HIEKPSv2, ParameterKontoauszugPdf
    • Neue Action-Klasse: GetStatementPDF für PDF-Abruf
    • Integration in bestehende PDF-Kontoauszüge-Seite
    • Support für Base64-kodierte PDFs (automatische Erkennung aus BPD)
    • Hinweis: Nicht alle Banken unterstützen HKEKP - prüfbar via BPD-Parameter HIEKPS
  • Cronjob für automatischen PDF-Abruf: Neue geplante Aufgabe doAutoFetchPdf
    • Aktivierbar über Konstante BANKIMPORT_PDF_AUTO_ENABLED
    • Ruft automatisch neue PDF-Kontoauszüge ab und speichert sie

Geändert

  • PDF-Kontoauszüge-Seite: Neues Layout mit zwei Spalten (FinTS-Abruf links, Upload rechts)
  • fints.class.php: Neue Methoden getStatementPDF() und supportsPdfStatements()

Technisch

  • Erweiterung der php-fints Bibliothek um HKEKP-Unterstützung (Segment/EKP/*)
  • Neue Action-Klasse mit Pagination-Support für große PDF-Auszüge

[3.1] - 2026-03-05

Hinzugefügt

  • Skonto-Erkennung: Multi-Invoice-Matching erkennt jetzt Skonto-Abzüge bis 3%
  • Automatische Skonto-Verarbeitung: Zahlungen werden proportional auf Rechnungen verteilt
  • Skonto-Vermerk: Rechnungen werden mit close_code='discount_vat' als bezahlt markiert
  • Skonto-Dokumentation: Notiz zeigt Skonto-Betrag pro Rechnung

Verbessert

  • Match-Sortierung: Matches mit näherem Betrag werden jetzt bevorzugt angezeigt
  • Multi-Match Score: Von 90 auf 98 erhöht, damit Sammelzahlungen vor Einzelmatches erscheinen
  • Sammelzahlungen mit Skonto werden jetzt korrekt als Gruppe erkannt (statt einzelner Rechnungen)

Beispiel

Transaktion -523,40€ mit 3 Rechnungen (Summe 529,69€):

  • Erkennt 6,29€ Skonto-Abzug
  • Verteilt proportional: 59,37€ + 206,72€ + 257,32€
  • Markiert alle 3 als "bezahlt mit Skonto"

[3.0] - 2026-03-05

Hinzugefügt

  • Repair-Seite: Neue Admin-Seite zum Reparieren verwaister Transaktionen
    • Findet Transaktionen die als "Neu" markiert sind, obwohl Zahlung bereits existiert
    • Ermöglicht manuelles oder Batch-Reparieren
    • Erreichbar über Admin-Setup → Admin-Werkzeuge
  • Admin-Werkzeuge Sektion: Neuer Bereich im Setup für Wartungsfunktionen

Geändert

  • Filter für bezahlte Rechnungen: Zeigt jetzt alle bezahlten Rechnungen die noch nicht über BankImport verknüpft sind
    • Prüft nur BankImport-Verknüpfung (nicht mehr payment.fk_bank)
    • Ermöglicht nachträgliche Verknüpfung von extern bezahlten Rechnungen

[2.9] - 2026-02-23

Entfernt

  • Browser Push-Notifications: Entfernt zugunsten von GlobalNotify
    • bankimport_notify.js.php gelöscht
    • Benachrichtigungen laufen jetzt zentral über GlobalNotify-Widget

[2.8] - 2026-02-23

Hinzugefügt

  • GlobalNotify Integration: Benachrichtigungen über das zentrale GlobalNotify-Modul
    • TAN-Anforderung: Sofortige Benachrichtigung wenn Bank TAN verlangt
    • Login-Fehler: Warnung bei fehlgeschlagenem Bank-Login
    • Session abgelaufen: Info wenn neue Authentifizierung nötig
    • Cron pausiert: Warnung wenn automatischer Import pausiert wurde
  • Zahlungsabgleich-Benachrichtigungen:
    • Info über neue importierte Bankbuchungen
    • Aktion erforderlich wenn unzugeordnete Buchungen warten
  • Helper-Funktion: BankImportTransaction::notify() für sichere GlobalNotify-Nutzung

Hinweis

GlobalNotify ist optional. Ohne das Modul werden Benachrichtigungen ins Dolibarr-Log geschrieben.

[2.7] - 2026-02-23

Hinzugefügt

  • Dediziertes Cron-Logging: Separate Log-Datei unter /documents/bankimport/logs/cron_bankimport.log
  • Shutdown Handler: Fängt fatale PHP-Fehler ab und protokolliert sie
  • Pause-Mechanismus: Cron pausiert automatisch nach 3 aufeinanderfolgenden Fehlern (60 Min)
  • Auth-Fehler-Erkennung: Erkennt Bank-Authentifizierungsfehler und pausiert um Kontosperrung zu vermeiden
  • Cron-Monitor Admin-Seite: Neue Seite unter Admin > BankImport > Cron-Monitor zeigt Status, Logs und ermöglicht Pause/Resume

Verbessert

  • Robustere Fehlerbehandlung mit try/catch für alle Operationen
  • Detailliertes Logging mit Zeitstempeln und Elapsed-Time
  • Fehler-Zähler verhindert wiederholte fehlgeschlagene Versuche

[2.6] - 2026-02-20

Hinzugefügt

  • Multi-Rechnungszahlungen: Eine Bankbuchung kann jetzt mit mehreren Rechnungen verknüpft werden (Sammelzahlungen)
  • Zahlungsverknüpfung aufheben: Falsche Zuordnungen können über "Verknüpfung aufheben" korrigiert werden
  • Detailansicht Verknüpfungen: In der Buchungsdetailansicht werden verknüpfte Zahlungen, Rechnungen und Bank-Einträge angezeigt
  • Bezahlte Rechnungen verknüpfen: Bereits bezahlte Rechnungen können mit Bankbuchungen verknüpft werden (für nachträgliche Bank-Zuordnung)

Verbessert

  • Bessere Anzeige von Multi-Invoice-Matches im Zahlungsabgleich
  • Flexible Rechnungsauswahl per Checkbox bei Sammelzahlungen

[1.7] - 2026-02-20

Hinzugefügt

  • Multi-Rechnungszahlungen: Eine Bankbuchung kann jetzt mit mehreren Rechnungen verknüpft werden (Sammelzahlungen)
  • Zahlungsverknüpfung aufheben: Falsche Zuordnungen können über "Verknüpfung aufheben" korrigiert werden
  • Detailansicht Verknüpfungen: In der Buchungsdetailansicht werden verknüpfte Zahlungen, Rechnungen und Bank-Einträge angezeigt
  • Bezahlte Rechnungen verknüpfen: Bereits bezahlte Rechnungen können mit Bankbuchungen verknüpft werden (für nachträgliche Bank-Zuordnung)

Verbessert

  • Bessere Anzeige von Multi-Invoice-Matches im Zahlungsabgleich
  • Flexible Rechnungsauswahl per Checkbox bei Sammelzahlungen

[1.6] - 2026-02-15

Hinzugefügt

  • PDF-Kontoauszüge: Upload und Verwaltung mit automatischer Metadaten-Erkennung
  • Mehrfach-Upload für PDF-Kontoauszüge
  • Erinnerungsfunktion für veraltete Kontoauszüge
  • Dashboard-Widget für offene Zuordnungen

Verbessert

  • Optimierte Buchungszuordnung mit Scoring-System
  • Verbesserte Benutzeroberfläche

[1.5] - 2026-02-01

Hinzugefügt

  • Automatischer Import via Cronjob
  • Unterstützung für SecureGo Plus (Decoupled TAN)
  • Automatische Kontoerkennung

Verbessert

  • Stabilere FinTS-Verbindung
  • Bessere Fehlerbehandlung

[1.0] - 2026-01-15

Erste Version

  • FinTS/HBCI-Anbindung für deutsche Banken
  • Import von Kontobuchungen
  • Grundlegende Buchungszuordnung zu Rechnungen
  • Integration in Dolibarr-Menüstruktur