Auto-Allocation und Match-Engine
Zweck
Die Auto-Allocation-Engine in SpeamCore vergleicht offene Transaktionen (typischerweise Bank-Buchungen aus dem finAPI-Sync) mit:
- offenen Customer-Open-Items und Supplier-Open-Items,
- offenen Sales-Documents und Purchase-Documents,
- Cross-Source-Gegen-Buchungen (z. B. Bank gegen Pleo-Karte).
Pro Transaktion werden ein oder mehrere TransactionMatchProposal-Einträge mit confidence-Score und matchReasons erzeugt. Hohe Confidence wird automatisch angewendet, mittlere bleibt zur Prüfung in /transaction-cockpit, niedrige wird als Vorschlag verworfen.
Workflow
Scoring — wie die Engine arbeitet
Pro Vorschlag wird der confidence-Score (0–100) aus mehreren matchReasons aggregiert. Typische Reasons:
| Reason | Score-Anteil | Detail-Beispiel |
|---|---|---|
amountExact | hoch | Brutto-Betrag stimmt exakt mit OpenItem-Restbetrag |
amountWithinTolerance | mittel | Differenz unter X EUR oder Y % |
customerMatch | hoch | Counterparty-Daten matchen Kunde aus Beleg |
referenceContains | hoch | Verwendungszweck enthält Beleg-Nummer |
paymentDateClose | gering | Buchungsdatum nahe Faelligkeit |
crossSourceCounterpart | hoch | Bank-Buchung gegen Pleo-Karte (Spiegel-Betrag) |
Wirkung: Mehrere Reasons summieren sich zur Gesamt-Confidence. Cross-Source-Matches haben oft eine eigene Score-Logik.
Confidence-Tiers (visuell)
| Confidence | Tier | Verhalten |
|---|---|---|
| 95–100 | Hoch (gruen) | Auto-Apply (sofern aktiviert), sonst Top-Vorschlag im Cockpit |
| 50–94 | Mittel (gelb) | Vorschlag wird angezeigt, Anwender muss freigeben |
| 0–49 | Niedrig (rot) | Wird angelegt, aber niedrig priorisiert |
auto_applied/approved | (hellgruen) | bereits gematcht |
rejected | (grau) | manuell verworfen |
Anwendungsoberflaechen
| Page | Funktion |
|---|---|
| /transaction-cockpit | Tagesgeschaeft — pro Transaktion Vorschläge freigeben/ablehnen |
| /transaction-match-proposals | Globale Verwaltungssicht, Bulk-Approve, neuen Matching-Lauf starten |
Berechtigungen
| Action | Subject | Wirkung | Keycloak-Rolle |
|---|---|---|---|
view | TransactionMatchProposal | Vorschläge sichtbar | APP_SPEAMCORE_VIEW_TRANSACTION_MATCH_PROPOSAL |
update | TransactionMatchProposal | Freigeben / Ablehnen | APP_SPEAMCORE_UPDATE_TRANSACTION_MATCH_PROPOSAL |
do | RunTransactionMatching | Manueller Matching-Lauf | APP_SPEAMCORE_DO_RUN_TRANSACTION_MATCHING |
view/create | TransactionAllocation | Allokationen sehen / manuell anlegen | APP_SPEAMCORE_VIEW/CREATE_TRANSACTION_ALLOCATION |
Wiederverwendbare Konzepte
- Buchhaltungskonten — Account/TransactionAccount/BankAccount.
- Bankkonten und Zuweisungen
- Berechtigungen verstehen (CASL)
Verknuepfungen zu Modulen
- Transaktionen — Quelle.
- Match-Vorschlaege — Verwaltungssicht.
- Cockpit — Arbeits-Sicht.
- Customer-/Supplier-Open-Items — Match-Partner.
- Sales-/Purchase-Documents — Match-Partner.
Versionshinweise
- 2026-04-30: Initiale Veroeffentlichung als Querschnitts-Konzept.