DATEV-Steuerschlüssel (TaxKey)

Zweck

Ein DATEV-Steuerschlüssel (BU-Schlüssel) bündelt die steuerliche Behandlung einer Buchung: welcher Steuersatz, welche Vorsteuer-/Umsatzsteuerkonten, ob Reverse-Charge (§13b) und auf welche UStVA-Kennzahlen der Betrag fällt. SpeamCore nutzt die Steuerschlüssel sowohl beim Verbuchen (DATEV-konformer Buchungsschlüssel) als auch für die Umsatzsteuer-Voranmeldung.

Voraussetzungen

- Berechtigung `view:FE_TaxKey` + `view:TaxKey`; zum Pflegen `create`/`update`/`delete:TaxKey`. - Eingerichtete [Steuersätze](/tax-rates) und [Konten](/accounts).

Berechtigungen (CASL)

Frontend-Page-Guard:

Action	Subject	Wirkung
view	FE_TaxKey	Seite /tax-keys und /vat-advance-return aufrufbar
view	TaxKey	Steuerschlüssel sichtbar

API-Datenzugriff:

Action	Subject	Endpoint(s)
view	TaxKey	GET /tax-keys, GET /tax-keys/:id
create	TaxKey	POST /tax-keys
update	TaxKey	PATCH /tax-keys/:id
delete	TaxKey	DELETE /tax-keys/:id

Felder und Eingaben

Feldname	Pflicht	Datentyp	Beschreibung	Wirkung beim Ausfüllen
datevKey	ja	String	DATEV-Steuerschlüssel (BU-Schlüssel)	identifiziert den Schlüssel DATEV-konform
datevBuLegacy	nein	String, nullable	alter/abweichender BU-Schlüssel	für Altdaten-Kompatibilität
name	ja	String	Bezeichnung	Anzeige in Auswahllisten
description	nein	Text	Erläuterung	—
function	ja	String	Funktion/Typ des Schlüssels (z. B. Standard, Reverse-Charge, EU)	steuert die Buchungslogik
taxRateId	nein	UUID	verknüpfter Steuersatz	bestimmt den Prozentsatz
ratePercent	nein	Decimal, nullable	Steuersatz in % (falls direkt am Schlüssel)	—
reverseChargeType	nein	String, nullable	Reverse-Charge-Typ (§13b), z. B. foreign_service	aktiviert §13b-Buchung, siehe Konten
euType	nein	String	EU-Behandlung (z. B. innergemeinschaftlich)	—
inputTaxAccountNo	nein	String, nullable	Vorsteuerkonto	Zielkonto der Vorsteuer
outputTaxAccountNo	nein	String, nullable	Umsatzsteuerkonto	Zielkonto der USt
standardAccountNo	nein	String, nullable	Standard-Buchungskonto	—
active	ja	Boolean	Schlüssel aktiv?	nur aktive werden angeboten
validFrom / validTo	nein	Date, nullable	Gültigkeitszeitraum	zeitliche Begrenzung

UStVA-Kennzahlen (TaxKeyKennzahl)

Je Steuerschlüssel sind UStVA-Kennzahlen hinterlegt (TaxKeyKennzahl) mit einer Art (kind):

• base — Bemessungsgrundlage (Netto-Umsatz)
• tax — Umsatzsteuer-Betrag
• input_vat — abziehbare Vorsteuer

Daraus aggregiert SpeamCore die Umsatzsteuer-Voranmeldung — jede Buchung fällt über ihren Steuerschlüssel auf die richtige(n) Kennzahl(en).

Verknüpfungen zu anderen Modulen

• Umsatzsteuer-Voranmeldung (UStVA) — wird aus den Kennzahlen der Steuerschlüssel berechnet.
• Steuersätze — der Prozentsatz hinter dem Schlüssel.
• Konten — Vorsteuer-/Umsatzsteuer-/Standardkonten; §13b-Reverse-Charge.
• Konten-Buchungen — die TaxKeys steuern die DATEV-Buchungsschlüssel.

Wiederverwendbare Konzepte

• Buchhaltungskonten
• Berechtigungen verstehen (CASL)

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/tax-keys	Liste	view TaxKey
POST	/api/tax-keys	Anlegen	create TaxKey
GET	/api/tax-keys/:id	Detail	view TaxKey
PATCH	/api/tax-keys/:id	Ändern	update TaxKey
DELETE	/api/tax-keys/:id	Löschen	delete TaxKey

Versionshinweise

• 2026-06-12: Initiale Veröffentlichung — DATEV-Steuerschlüssel (BU) mit Steuersatz-/Konten-/Kennzahl-Verknüpfung, §13b-Bezug und UStVA-Kennzahlen. Verifiziert an taxKey.model.ts, taxKey.router.ts, vatAdvanceReturn.service.ts.