Zweck
Steuersätze (TaxRate) sind die zentralen Steuer-Stammdaten — Voller Steuersatz, Ermaessigter Satz, Steuerfrei, Gastronomie etc. Pro Steuersatz pflegen Sie ein Output-Steuer-Konto (Umsatzsteuer-Schuldkonto) und ein Input-Steuer-Konto (Vorsteuer-Konto). Auf dem Tab Gültigkeit legen Sie die historischen Werte fest — z. B. „19 % bis 30.06.2020, 16 % bis 31.12.2020, dann wieder 19 %".
Voraussetzungen
- Buchhaltungskonten (`TransactionAccount`) angelegt — typischerweise über den Setup-Wizard Schritt 4.
- Berechtigung `create:TaxRate`.
Berechtigungen (CASL)
| Action | Subject | Wirkung | Keycloak-Rolle |
|---|
view | FE_TaxRate, TaxRate | Liste/Details aufrufbar | — |
create/update/delete | TaxRate | Pflegen | APP_SPEAMCORE_CREATE/UPDATE/DELETE_TAX_RATE |
view | TaxRateValidity | Tab Gültigkeit sichtbar | APP_SPEAMCORE_VIEW_TAX_RATE_VALIDITY |
view | Account | Konto-Auswahl in den Selects | APP_SPEAMCORE_VIEW_ACCOUNT |
Schritt-für-Schritt-Anleitung
Steuersatz anlegen
- Steuersätze (
/tax-rates) → + Neu.
- Name (z. B. „19 % USt").
- Output-Konto und Input-Konto wählen.
- Im Tab Gültigkeit historische Werte ergaenzen (Prozent + Datum-von/bis).
Schlanke Toolbar oben rechts:
| Icon | Aktion (aria-label) | CASL | Wirkung |
|---|
| ← | Zurückgehen | — | Zurück zur Liste. |
| 🏠 | Zur Startseite gehen | — | Springt auf das Dashboard / /. |
| ⏮/◀/▶/⏭ | Pagination | — | Navigation durch die gefilterte Liste — Massen-Bearbeitung ohne Liste-Sprung. |
Globale Floating-Drawer (links)
Wie auf jeder Detail-Seite verfuegbar — siehe Floating-Quickbar:
- KAL. (Mini-Kalender)
- ZEIT (Persoenliche Wochen-Arbeitszeit)
- ARBEIT (Eigene bevorstehende Aufträge)
Felder und Eingaben
| Feldname | Pflicht | Datentyp | Beschreibung | Wirkung beim Ausfuellen | Voraussetzung |
|---|
name | ja | String | Bezeichnung des Steuersatzes. | Erscheint in Beleg-Positionen, Buchhaltungs-Reports und Steuersatz-Auswahl. | — |
taxLiabilityAccountId | nein | UUID (Account-Select) | Output-Steuer-Konto (Umsatzsteuer-Schuldkonto). | Wird beim Buchen von Verkaufs-Belegen als Kreditseite verwendet. | view:Account. Konto muss ein Steuer-Konto sein. |
inputTaxAccountId | nein | UUID (Account-Select) | Input-Steuer-Konto (Vorsteuer-Konto). | Wird beim Buchen von Bestell-Belegen als Debetseite verwendet. | view:Account. |
Sub-Felder pro TaxRateValidity (Tab Gültigkeit)
| Feldname | Datentyp | Wirkung |
|---|
validFrom | DATE | Steuersatz gilt ab diesem Datum. |
validTo | DATE | Steuersatz gilt bis zu diesem Datum. |
percentage | Float | Steuersatz in %. |
Wiederverwendbare Konzepte
Verknuepfungen zu anderen Modulen
- Verkaufsbelege — Positionen referenzieren Steuersätze für USt-Berechnung.
- Bestellbelege — analog Vorsteuer.
- Setup-Wizard Schritt 4 — Standardsteuersaetze (Voller Steuersatz, Ermaessigt, Steuerfrei, Gastronomie) inklusive historischer Gültigkeiten werden dort geladen.
API/Schnittstellen
| Methode | Endpoint | Zweck | CASL |
|---|
GET | /api/tax-rates | Liste | view TaxRate |
GET | /api/tax-rates/:id | Detail | view TaxRate |
POST | /api/tax-rates | Anlegen | create TaxRate |
PATCH | /api/tax-rates/:id | Ändern | update TaxRate |
DELETE | /api/tax-rates/:id | Soft-Delete | delete TaxRate |
GET | /api/tax-rates/:id/validities | Gueltigkeits-Sub-Liste | view TaxRateValidity |
Versionshinweise
- 2026-04-29: Initiale Veroeffentlichung mit FE-Tiefen-Standard.