Bankexport — Systembeschreibung
Datenmodell von Überweisungsstapeln, Positionen und Vorlagen, Regeln der Rechnungsübernahme, Prüfungen der pain.001-XML-Erzeugung und Berechtigungsebenen.
Überblick
Verwaltung von Überweisungsstapeln: Rechnungen (aus einer Mehrfachauswahl der Rechnungsliste), manuelle und Vorlagenpositionen in einem Stapel, je Position mit Valutadatum, Betrag und Empfängerkonto. Aus dem Stapel lässt sich ein ISO-20022-XML pain.001.001.03 mit ERSTE- oder UniCredit-Protokoll herunterladen.
Datenmodell
Die Tabellennamen tragen in der Datenbank das eigene Präfix der Installation.
| Tabelle | Zweck | Hauptfelder |
|---|---|---|
bank_export_batch | Stapelkopf | Name, Mandant, Belastungskonto, Protokoll, Status (0 = Entwurf, 1 = Erstellt), generated_at, created_by |
bank_export_item | Stapelposition | Quelle (Rechnung, manuell, Vorlage), Partnername, Kontonummer, Betrag, Valutadatum, Notiz |
bank_export_template | Vorlage einer wiederkehrenden Überweisung | global, ohne Firmenbeschränkung; Status |
invoice, bankaccount, company | gelesene Stammdaten | offener Betrag, Fälligkeit, Standardkonto |
Ablauf
- Neuer Stapel: Status Entwurf (0) mit dem anlegenden Benutzer. Name, Mandant und Bankkonto sind Pflicht; der Mandant muss in der Inhaltsberechtigung liegen.
- Position: Die Kontonummer wird auf 24 Stellen normalisiert; die Notiz hat höchstens 140 Zeichen.
- Rechnungen hinzufügen: Empfängerkonto ist das Standardkonto des Lieferanten in der Rechnungswährung (
company::getDefaultBankaccountId), Betrag der offene Betrag (ersatzweise brutto), Valutadatum die Fälligkeit, Notiz die Rechnungsnummer plus das systemeigene Zeichen mit der Rechnungskennung, das der Bankimport exakt erkennt. Rechnungen, die schon im Stapel sind, entfallen; die Liste der Rechnungen ohne Kontonummer wird zurückgegeben. Im Modal lässt sich auch ein neuer Stapel anlegen. - Erzeugung: prüft die IBAN des Belastungskontos sowie je Position eine gültige normalisierte IBAN, einen positiven Betrag und ein Valutadatum; baut das XML (das Rechnungszeichen kommt auch dann in den Verwendungszweck, wenn er von Hand geändert wurde), setzt den Stapel auf Erstellt (1) und liefert ihn als Download (Dateiname z. B.
ERSTE_2026-11-20_batch12.xml). Bei Fehlern Weiterleitung zum Formular, die Meldung reist in der Sitzung. - Löschen: Ein Entwurfsstapel wird physisch mit seinen Positionen gelöscht; ein erstellter Stapel nicht. Eine Vorlage nur, wenn keine Stapelposition auf sie verweist.
Berechtigungen
- Ebene 1: Die Seite öffnet sich mit Grundzugriff auf den Pfad; Speichern, Positions-, Vorlagen-, Erzeugungs- und Löschvorgänge verlangen zusätzlich das Änderungsrecht.
- Ebene 2:
list,add(die Schaltfläche; das Speichern eines neuen Datensatzes verlangtadd, ohne Katalogzeileedit),edit,generate,delete,debug(SQL der Stapelliste). - Ebene 3: Die Liste ist auf die erlaubten Firmen des Benutzers beschränkt (leer bei gesperrtem Filter); Kopf-, Positions-, Vorlagenpositions-, Erzeugungs- und Löschvorgänge prüfen, ob der Mandant des Stapels in der Inhaltsberechtigung liegt; die Rechnungsübernahme filtert zusätzlich auf den Eigentümer-Mandanten der Rechnungen. Vorlagen sind global.
Bekannte Einschränkungen
- Positionsvorgänge prüfen den Stapelstatus nicht; auch Positionen eines erstellten Stapels sind änderbar.
- Die erzeugte Datei wird nicht in der Dokumentenzentrale abgelegt.