Umsatzsteuer-Voranmeldung (UStVA-Vorschau)

Zweck

Die Seite /vat-advance-return erstellt eine UStVA-Vorschau für einen frei wählbaren Zeitraum: SpeamCore aggregiert die Buchungen des Zeitraums über ihre DATEV-Steuerschlüssel auf die Umsatzsteuer-Kennzahlen (Bemessungsgrundlagen, Umsatzsteuer, Vorsteuer) — als Kontrolle vor der eigentlichen Voranmeldung. Es ist eine Auswertung, keine Übermittlung ans Finanzamt.

Voraussetzungen

- Berechtigung `view:FE_TaxKey` + `view:TaxKey`. - Gepflegte [DATEV-Steuerschlüssel](/tax-keys) mit hinterlegten UStVA-Kennzahlen. - Verbuchte [Konten-Buchungen](/account-entries) im gewählten Zeitraum.

Berechtigungen (CASL)

Action	Subject	Wirkung
view	FE_TaxKey, TaxKey	UStVA-Vorschau aufrufbar

Funktionsweise

1. Zeitraum wählen (from / to, Format YYYY-MM-DD).
2. SpeamCore lädt die Buchungen des Zeitraums und gruppiert sie nach Steuerschlüssel.
3. Je Steuerschlüssel werden dessen Kennzahlen (base, tax, input_vat) auf die UStVA-Kennzahlen summiert.
4. Das Ergebnis listet je Kennzahl den Betrag — mit Drill-down auf die zugrunde liegenden Buchungen.

So lässt sich vor der Abgabe prüfen, welche Beträge auf welche UStVA-Kennzahl fallen und ob alles korrekt verschlüsselt wurde.

Verknüpfungen zu anderen Modulen

• DATEV-Steuerschlüssel — liefern die Kennzahl-Zuordnung je Buchung.
• Konten-Buchungen — Datengrundlage der Aggregation.
• Konten — Vorsteuer-/Umsatzsteuerkonten.

Wiederverwendbare Konzepte

• Buchhaltungskonten
• Berechtigungen verstehen (CASL)

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/vat-advance-return?from=…&to=…	UStVA-Kennzahlen für den Zeitraum (inkl. Drill-down)	view TaxKey

Versionshinweise

• 2026-06-12: Initiale Veröffentlichung — UStVA-Vorschau aus den TaxKey-Kennzahlen (base/tax/input_vat) je Zeitraum, mit Buchungs-Drill-down. Verifiziert an vatAdvanceReturn.service.ts (computeVatAdvanceReturn) und vatAdvanceReturn.router.ts.