Zum Inhalt springen

App-Dokumentation · DE

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), eine kind (full|reduced|zero|reverse_charge), optional revenue_account und vat_account, ein active-Flag sowie ein Gültigkeitsfenster valid_from / optional valid_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

  1. Den Standardsatz DE/AT/CH einspielen oder Schlüssel manuell anlegen.
  2. Nach Land oder „Nur aktive“ filtern, um einen Schlüssel zu finden.
  3. Satz, Art, Konten oder Gültigkeit eines Schlüssels bearbeiten; nicht mehr benötigte Schlüssel besser deaktivieren statt löschen.