Zum Hauptinhalt springen

Buchungs-Schlüssel (Posting Keys)

**Aktueller Code-Stand:** FE-Route `/posting-keys` existiert in `routes.tsx`, die Page-Komponente `PostingKeyListPage` ist jedoch **ein Stub** (`return null`). Der zugehörige Backend-Router fehlt — kein dedizierter `posting-key.router.ts` in `api.speamcore.com/src/routers/`. Das Modell `PostingKey` existiert (mit Versions-Tracking), wird aber **nicht über die REST-API exponiert**.

Diese Seite ist als Konzept-Doku zu verstehen. Vor produktiver Nutzung muss das Feature im FE und BE implementiert werden.

Zweck​

Buchungs-Schlüssel (Posting Keys) sind DATEV-kompatible Klassifikations-Codes, die festlegen, welche Steuer-Behandlung und welche Konten-Logik auf eine Buchung angewendet werden. Sie sind ein Stammdaten-Bereich der Buchhaltung — typische Beispiele: Inland 19% USt, Innergemeinschaftlich, Reverse-Charge, Steuerfrei.

Pro Mandant wird eine Liste konfiguriert, die anschließend in Belege (Sales/Purchase Documents) und automatischen Buchungs-Vorlagen verwendet wird.

Voraussetzungen​

- Mandant hat Buchhaltung aktiviert. - Berechtigungen `view:FE_PostingKey` + `view:PostingKey`. - Anlegen/Ändern typischerweise nur durch Buchhaltungs-Leitung oder externen Steuerberater.

Berechtigungen (CASL)​

Frontend-Page-Guard (requiredAbility):

ActionSubjectWirkung
viewFE_PostingKeySeite sichtbar im Menü
viewPostingKeyListe lesbar

API-CASL (BE):

ActionSubject
viewPostingKey
createPostingKey
updatePostingKey
deletePostingKey

Beziehung zu anderen Modulen​

  • Belege (Sales/Purchase Documents): jede Belegposition kann einen Posting-Key tragen, der die Steuer-Behandlung bestimmt.
  • Buchhaltung: bei Übergabe an DATEV/SKR03/SKR04 liefert der Posting-Key die DATEV-Schlüssel-Spalte.
  • Auto-Allocation: Posting-Keys können Teil von Match-Regeln sein, sind aber nicht zwingend.

Verwandte Doku​