Zum Hauptinhalt springen

Buchhaltungskonten-Typen (TransactionAccountTypes)

Zweck​

TransactionAccountType klassifiziert Buchhaltungskonten und steuert deren Sync-Faehigkeiten. Pro Typ wird gepflegt, ob automatischer Sync (finAPI/Pleo) oder nur manuelle Erfassung möglich ist, welches UI-Icon angezeigt wird und in welcher Reihenfolge der Typ in Auswahllisten erscheint.

Typische Codes (System-Typen): BANK, PAYPAL, CREDIT_CARD, CASH. System-Typen sind durch isSystemType = true markiert und nicht editierbar.

Voraussetzungen​

- Berechtigung `view:TransactionAccountType` zur Anzeige der Liste. - Berechtigung `create:TransactionAccountType` und `update:TransactionAccountType` für eigene Typen. - System-Typen werden durch Initial-Seed gesetzt; eigene Typen koennen ergaenzt werden.

Berechtigungen (CASL)​

ActionSubjectWirkungKeycloak-Rolle
viewFE_TransactionAccountType, TransactionAccountTypeListe/Detail aufrufbar—
create/update/deleteTransactionAccountTypePflegenAPP_SPEAMCORE_CREATE/UPDATE/DELETE_TRANSACTION_ACCOUNT_TYPE

Schritt-für-Schritt-Anleitung​

Eigenen Konto-Typ anlegen​

  1. Konto-Typen (/transaction-account-types) → + Neu.
  2. code vergeben (eindeutig, GROSSBUCHSTABEN, z. B. WALLET).
  3. name pflegen (z. B. „Wallet").
  4. iconName setzen — Icon-Bibliothek ist react-icons (z. B. FiCreditCard, FaPaypal, FiDollarSign).
  5. supportsAutoSync und supportsManualEntry wählen je nach Konto-Verhalten.
  6. sortOrder anpassen, um die Reihenfolge in Dropdowns zu steuern.

System-Typen pflegen​

System-Typen (isSystemType = true) sind nicht editierbar. Änderungen am Verhalten erfolgen über das BE-Seed.

Listenansicht — transaction-account-types

Toolbar (Detail-Seite)​

Schlanke Toolbar oben rechts:

IconAktion (aria-label)CASLWirkung
←Zurückgehen—Zurück zur Liste.
🏠Zur Startseite gehen—Springt auf das Dashboard / /.
⏮/◀/▶/⏭Pagination—Navigation durch die gefilterte Liste — Massen-Bearbeitung ohne Liste-Sprung.

Wie auf jeder Detail-Seite verfuegbar — siehe Floating-Quickbar:

  • KAL. (Mini-Kalender)
  • ZEIT (Persoenliche Wochen-Arbeitszeit)
  • ARBEIT (Eigene bevorstehende Aufträge)

Felder und Eingaben​

FeldnamePflichtDatentypWirkung beim AusfuellenVoraussetzung
codejaString (50, unique)Eindeutiger technischer Code (z. B. BANK, PAYPAL). Wird in TransactionAccount.transactionAccountTypeId indirekt referenziert. Read-only nach Anlage.—
namejaString (255)Anzeigename in Liste und Selectors.—
iconNameneinString (100)Name eines react-icons-Icons (z. B. FiCreditCard). Wird in Liste und im TransactionAccount-Selector angezeigt.—
supportsAutoSyncjaBooleantrue: erlaubt finAPI-/Pleo-Sync. false: nur manuell. Default false.Sync-Provider muss konfiguriert sein.
supportsManualEntryjaBooleantrue: Anwender koennen Buchungen direkt erfassen. Default true.—
isSystemTypeja (read-only)Booleantrue: nicht editierbar. Wird vom Initial-Seed gesetzt.—
sortOrderjaIntegerReihenfolge im Dropdown (kleiner = oben). Default 0.—

Wiederverwendbare Konzepte​

Verknuepfungen zu anderen Modulen​

Häufige Fehler und Lösungen​

FehlerLösung
Eigener Typ erscheint nicht in Konto-AnlagesortOrder-Wert prüfen, Typ koennte ans Ende verschoben sein.
code schon vergebenEindeutigen Code wählen (System-Typen sind reserviert: BANK, PAYPAL, CREDIT_CARD, CASH).
Auto-Sync funktioniert nichtsupportsAutoSync = true reicht nicht — der Provider (finAPI / Pleo) muss konfiguriert und aktiv sein.

API/Schnittstellen​

MethodeEndpointZweckCASL
GET/api/transaction-account-typesListe (FULLTEXT-Suche auf name+code)view TransactionAccountType
POST/api/transaction-account-typesAnlegencreate TransactionAccountType
GET/api/transaction-account-types/:idDetailview TransactionAccountType
PATCH/api/transaction-account-types/:idÄndernupdate TransactionAccountType
DELETE/api/transaction-account-types/:idSoft-Deletedelete TransactionAccountType

Versionshinweise​

  • 2026-04-30: Initiale Veroeffentlichung.