Umsatzsteuer-Jahreserklärung per KI-Agent prüfen und vorbereiten

Warum der Entwurf in der App entsteht

• Übernahme der Jahreswerte: aus den Voranmeldungen des Jahres bzw. aus den Umsatzsteuer-Konten — Umsatzsteuer, Vorsteuer, Bemessungsgrundlagen und ein Vorschlag für das Vorauszahlungssoll.
• Vorauszahlungssoll: Sie bestätigen das amtliche Soll einschließlich Sondervorauszahlung, Berichtigungen und Festsetzungen außerhalb der Software.
• Besteuerungsart und Erklärungsprofil: Sie bestätigen sie vor dem Versand.
• Hinweis „Die Buchhaltung hat sich seit der Übernahme geändert“: Dann übernehmen Sie neu, bevor Sie prüfen lassen.

create_tax_draft legt Entwürfe der Zusammenfassenden Meldung und der Dauerfristverlängerung aus den Büchern an — die Jahreserklärung bewusst nicht. Ruft ein Agent create_tax_draft mit art ustje auf, antwortet die Schnittstelle mit 422 api_ustje_entwurf_in_app und nennt die Seite in der App. Der Grund: Die amtlichen Felder der Jahreserklärung entstehen erst mit mehreren menschlichen Bestätigungen.

Rechtlicher Rahmen

• § 18 Abs. 3 Satz 1 UStG: Für das Kalenderjahr ist eine Steuererklärung nach amtlich vorgeschriebenem Datensatz über die amtlich bestimmte Schnittstelle zu übermitteln, in der der Unternehmer die Steuer bzw. den Überschuss selbst berechnet (Steueranmeldung).
• § 18 Abs. 4 Satz 1 UStG: Weicht die Jahreserklärung von der Summe der Vorauszahlungen ab, ist der Unterschiedsbetrag einen Monat nach Eingang der Steueranmeldung fällig.
• § 168 Satz 1 AO: Eine Steueranmeldung steht einer Steuerfestsetzung unter Vorbehalt der Nachprüfung gleich.
• § 149 Abs. 2 AO: In der Grundregel ist die Erklärung sieben Monate nach Ablauf des Kalenderjahres abzugeben; mit Steuerberatung gilt § 149 Abs. 3 AO. Die Fristen Ihrer Gesellschaft liest der Agent mit list_tax_deadlines.
• § 153 AO: Wer nachträglich erkennt, dass eine Erklärung unrichtig oder unvollständig ist, muss das unverzüglich anzeigen und richtigstellen — eine Berichtigung, die Sie in der App übermitteln.

Der Abgleich: Voranmeldungen gegen das Jahr

Hier liegt der eigentliche Nutzen des Agenten. Er stellt drei Quellen nebeneinander, bevor Sie die Jahreserklärung freigeben.

Typische Funde: ein Zeitraum ohne Übermittlung, eine Voranmeldung mit unklarem Versandstatus, eine Testübermittlung, die nie echt abgegeben wurde, oder eine nachträgliche Buchung, die nur in der Jahreserklärung auftaucht. Ob daraus eine Berichtigung einer Voranmeldung folgt oder die Jahreserklärung den Unterschied aufnimmt, entscheiden Sie — gegebenenfalls mit Ihrer Kanzlei.

Der Ablauf mit dem Agenten

• list_tax_deadlines: Fälligkeit der Jahreserklärung und offene Voranmeldungen des Jahres.
• list_tax_filings mit art ustva und art ustje: Stand der Voranmeldungen und des Entwurfs; die id des Entwurfs ist die source_id.
• get_vat_return für die Zeiträume, die auffallen.
• check_tax_filing mit art ustje und source_id: amtliche ELSTER-Prüfung mit Testmerker; die Prüfung nimmt auch einen Entwurf an.
• prepare_tax_filing: Vorgang mit den amtlichen Feldern und dem Prüfwert der gespeicherten Meldung. Steht der Entwurf noch nicht auf freigegeben, trägt der Vorgang das Hindernis freigabe_in_app.
• request_tax_filing_approval: Der Link führt auf die Jahreserklärung in der App. Dort geben Sie frei und übermitteln mit Ihrer PIN.
• get_tax_operation: Stand und Transferticket nach der Übermittlung.

Beispiel: der Entwurf 2025 auf dem Prüfstand

Ihr Auftrag: „Umsatzsteuer-Jahreserklärung 2025 gegen alle Voranmeldungen 2025 abgleichen und den Entwurf amtlich prüfen.“ Die Prüfung über REST:

curl -s -X POST \
  -H "Authorization: Bearer $JAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"art":"ustje","source_id":"<id aus list_tax_filings>"}' \
  https://api.jahresabschluss.io/functions/v1/bookkeeping-api/v1/tax/check

# Antwort (gekürzt)
{
  "art": "ustje",
  "zeitraum": "2025",
  "valid": true,
  "eric": { "valid": true, "field_errors": [], "hinweise": [] },
  "hindernisse": [ { "code": "freigabe_in_app", "text": "…" } ],
  "manifest": { "art": "ustje", "jahr": 2025, "besteuerungsart": "…", "elster_felder": { "…": "…" } },
  "manifest_sha256": "…"
}

Der Agent berichtet dann etwa: welche Voranmeldungen übermittelt sind, wo die heutige Vorschau vom gemeldeten Wert abweicht, ob die amtliche Prüfung Feldfehler meldet und dass vor dem Versand noch die Freigabe in der App fehlt. Erst wenn Sie das bestätigt haben, bereitet er vor und schickt den Freigabe-Link.

Berichtigungen bleiben in der App

Ist eine Jahreserklärung als Berichtigung angelegt, lehnt die Schnittstelle Prüfen und Vorbereiten mit 422 api_berichtigung_nur_in_app ab und nennt die Seite in der App. Dasselbe gilt für Berichtigungen der Zusammenfassenden Meldung, der Dauerfristverlängerung und der Sondervorauszahlung. Bei einer Berichtigung der Jahreserklärung gilt als Vorauszahlungssoll die bisher festgesetzte Umsatzsteuer — auch das bestätigen Sie in der App.

Grenzen und Kosten

• Anlegen des Entwurfs, Übernahme der Werte, Bestätigung von Vorauszahlungssoll und Besteuerungsart sowie die Freigabe: in der App.
• Die Übermittlung mit Ihrer PIN; ein Recht, mit dem ein Schlüssel ohne die App an ELSTER übermittelt, wird derzeit nicht vergeben.
• Prüfen, Vorbereiten und Entwürfe teilen sich eine Grenze von 30 Aufrufen je Stunde und Schlüssel.
• Erstellen und amtliche Prüfung kosten nichts. Die Übermittlung der Jahreserklärung wird je Veranlagungszeitraum berechnet, sofern Ihr Abo sie nicht enthält; Preise und enthaltene Leistungen stehen unter /preise.

Die Software ersetzt keine Steuerberatung. Der Abgleich des Agenten ist eine Kontrolle, die Ihnen Arbeit abnimmt — die Entscheidung über die erklärten Werte bleibt bei Ihnen.

Häufige Fragen

Kann ein KI-Agent die Umsatzsteuer-Jahreserklärung anlegen?

Nein, bewusst nicht. create_tax_draft mit art ustje antwortet mit 422 api_ustje_entwurf_in_app. Den Entwurf legen Sie in der App an; danach prüft und bereitet der Agent ihn vor.

Was gleicht der Agent ab?

Die übermittelten Voranmeldungen des Jahres (list_tax_filings), die heutigen Werte je Zeitraum (get_vat_return) und die amtlichen Felder des Entwurfs. So fallen fehlende Zeiträume, unklare Übermittlungen und spätere Buchungen auf.

Warum meldet prepare_tax_filing das Hindernis freigabe_in_app?

Der Entwurf ist noch nicht freigegeben. Amtlich prüfen lässt er sich trotzdem; übermittelt wird erst nach der Freigabe in der App, die Sie über den Freigabe-Link erreichen.

Übermittelt der Agent die Jahreserklärung?

Nein. Er bereitet vor und schickt den Freigabe-Link; Sie übermitteln in der App mit Ihrer PIN. Ein Recht zum Übermitteln ohne die App wird derzeit nicht vergeben.

Was ist mit einer Berichtigung?

Berichtigungen bearbeiten und übermitteln Sie in der App. Die Schnittstelle lehnt sie mit 422 api_berichtigung_nur_in_app ab.

Wann ist der Unterschiedsbetrag fällig?

Nach § 18 Abs. 4 Satz 1 UStG einen Monat nach Eingang der Steueranmeldung, wenn die Jahreserklärung von der Summe der Vorauszahlungen abweicht. Die Steuerfristen Ihrer Gesellschaft liest der Agent mit list_tax_deadlines.