Steuerschlüssel
Mit Steuerschlüssel pflegen Sie den Steuerschlüssel-Katalog auf Basis des verifizierten ERP-TaxKeys-Backends: Schlüssel nach Land und Aktiv-Flag filtern, anlegen, bearbeiten und löschen sowie den Standardsatz für DE/AT/CH per Klick einspielen.
Bereiche
- Steuerschlüssel: ein Land-/Aktiv-Filter, die Schaltfläche „Standard DE/AT/CH einspielen“, die Schlüsseltabelle und darunter ein Anlege-/ Bearbeiten-Formular.
- Hilfe: In-App-Hinweise.
Felder und Begriffe
- Steuerschlüssel:
code,country(ISO-3166-1 alpha-2),rate_pct(Prozent), einekind(full|reduced|zero|reverse_charge), optionalrevenue_accountundvat_account, einactive-Flag sowie ein Gültigkeitsfenstervalid_from/ optionalvalid_until. - Satz: wird in Prozent erfasst und als Basispunkte (
rate_bps, z. B. 19 % → 1900) gespeichert, um Rundungsfehler zu vermeiden. - Einspielen: legt die vordefinierten Schlüssel für DE (19/7/0/RC), AT
(20/13/10/0/RC) und CH (7,7/3,7/2,5/0/RC) an. Idempotent — vorhandene
(code, valid_from)-Zeilen werden übersprungen.
Backend-Vertrag
Alle Routen liegen unter /api/erp/tax-keys, mandantenbezogen, mit dem
{success, data}-Envelope.
GET /tax-keys(?country=&active=1) — auflisten.POST /tax-keys— anlegen. Body:{code, country, rate_bps, kind, revenue_account?, vat_account?, description?, active?, valid_from?, valid_until?}.POST /tax-keys/seed— Standard DE/AT/CH einspielen. Body:{valid_from?}.GET /tax-keys/{id}— einzeln lesen.PUT /tax-keys/{id}— teilweise aktualisieren.DELETE /tax-keys/{id}— löschen.
Schreibende Verben erfordern eine Finanzrolle (finance / tax / admin). Die
Authentifizierung erfolgt über httpOnly-Cookie + CSRF via @it-tremmel.de/platform-http
authedFetch (credentials: 'include'); es werden keine Tokens aus
localStorage gelesen.
Typischer Ablauf
- Den Standardsatz DE/AT/CH einspielen oder Schlüssel manuell anlegen.
- Nach Land oder „Nur aktive“ filtern, um einen Schlüssel zu finden.
- Satz, Art, Konten oder Gültigkeit eines Schlüssels bearbeiten; nicht mehr benötigte Schlüssel besser deaktivieren statt löschen.