Zum Hauptinhalt springen

Steuer-Sätze (Taxation Types)

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

Eine alternative existierende Tax-Stamm-Tabelle ist Tax-Rates (mit Validity-Sub-Route) — diese ist real implementiert und sollte für aktuelle Produktiv-Nutzung verwendet werden. TaxationType scheint eine geplante Erweiterung zu sein, aktuell nicht aktiv.

Zweck​

Steuer-Sätze (Taxation Types) sind die zentrale Stammdaten-Tabelle für Umsatzsteuer-/Vorsteuer-Klassifikationen, die in Belegen, Belegpositionen und Buchungen verwendet werden. Beispiele:

  • Inland 19 % USt
  • Inland 7 % USt (ermäßigt)
  • Innergemeinschaftliche Lieferung 0 %
  • Reverse-Charge (Bauleistung §13b)
  • Drittland (Export) 0 %
  • Steuerfrei nach §4 UStG

Pro Mandant ist die Liste konfiguriert (oft nach Land/Region) und wird in Sales-/Purchase-Documents als Default oder pro Position überschrieben.

Voraussetzungen​

- Mandant hat Buchhaltung aktiviert. - Berechtigungen `view:FE_TaxationType` + `view:TaxationType`. - Änderungen typischerweise nur durch Buchhaltungs-Leitung oder Steuerberater.

Berechtigungen (CASL)​

Frontend-Page-Guard (requiredAbility):

ActionSubjectWirkung
viewFE_TaxationTypeSeite sichtbar im Menü
viewTaxationTypeListe lesbar

API-CASL (BE):

ActionSubject
viewTaxationType
createTaxationType
updateTaxationType
deleteTaxationType

Beziehung zu anderen Modulen​

  • Sales-/Purchase-Documents: jede Belegposition referenziert einen TaxationType — bestimmt MwSt-Berechnung in Beleg-Footer.
  • Posting-Keys: häufig kombiniert mit Posting-Key, der die DATEV-Klassifikation liefert (siehe Posting Keys).
  • Buchhaltung-Export: ZUGFeRD/XRechnung-Export nutzt TaxationType für BG-23 (Tax-Categories).

Verwandte Doku​