Umsatzsteuervoranmeldung per KI-Agent vorbereiten und in der App übermitteln

Der Ablauf von der Vorschau bis zur Freigabe

Jeder Aufruf hat einen klaren Zweck. In keinem davon wird etwas an das Finanzamt gesendet.

• get_vat_return (GET /v1/vat-returns?period=…): Kennzahlen, Zahllast und die Buchungen hinter jeder Kennzahl – nur lesend.
• get_vat_supplementary (GET /v1/vat-returns/supplementary): die bedingten Angaben des amtlichen Vordrucks mit amtlichem Wortlaut und ob sie für den Zeitraum bestätigt sind.
• confirm_vat_supplementary (POST /v1/vat-returns/supplementary): bestätigt „keiner der Sonderfälle liegt vor“ – erst nach Ihrer ausdrücklichen Antwort.
• check_tax_filing mit art=ustva: amtliche Prüfung durch ERiC, ohne Versand.
• prepare_tax_filing mit art=ustva: Kennzahlen, Zahllast und Prüfwert werden 30 Minuten eingefroren, Hindernisse aufgelistet.
• request_tax_filing_approval: der Freigabe-Link in die App, sieben Tage gültig.
• get_tax_operation: der Stand nach Ihrer Übermittlung, mit Transferticket.

Zeitraum und Kennzahlen: was der Agent zuerst liest

Der Zeitraum ist immer ein Kalendermonat (JJJJ-MM) oder ein Kalenderquartal (JJJJ-Qn). Die API ordnet ihn dem passenden Geschäftsjahr zu, auch bei abweichendem Wirtschaftsjahr. Gibt es dafür nicht genau ein Geschäftsjahr, antwortet sie mit 409 fiscal_year_ambiguous statt mit geschätzten Werten.

get_vat_return liefert die Kennzahlen des Zeitraums – etwa Kennzahl 81 und 86 für steuerpflichtige Umsätze zu 19 und 7 %, 66 für die Vorsteuer aus Rechnungen und 83 für die verbleibende Vorauszahlung oder den Überschuss –, dazu die Zahllast und die Buchungen je Kennzahl. Was diese Abfrage im Einzelnen zurückgibt, beschreibt die Seite „Umsatzsteuer-Zahlen per KI-Agent abfragen“. Die Antwort nennt auch die Herkunft der Werte: aus der Buchhaltung oder in der App von Hand erfasst. Mit einem Schlüssel aus dem Buchhaltungs- oder EÜR-Abo liest der Agent mit get_entity_settings außerdem Voranmeldungszeitraum, Soll- oder Ist-Versteuerung und Dauerfristverlängerung; geändert werden diese Einstellungen nur in der App.

Die Fragen des Vordrucks: „keine Sonderfälle“ per API, alles andere in der App

Der amtliche Vordruck enthält bedingte Angaben, die nur in bestimmten Fällen auszufüllen sind – etwa zu Dreiecksgeschäften, zu unrichtig oder unberechtigt ausgewiesener Steuer (§ 14c UStG) oder zur Berichtigung des Vorsteuerabzugs (§ 15a UStG). get_vat_supplementary gibt diese Fragen mit amtlichem Wortlaut zurück. Der Agent stellt sie Ihnen; beantworten tun Sie sie.

Verneinen Sie alle, ruft er confirm_vat_supplementary mit keine_sonderfaelle=true und confirm=true auf. Liegt einer der Fälle vor, erfassen Sie ihn in der App – über die API lässt sich nur „keiner liegt vor“ bestätigen. Sind für den Zeitraum schon Sonderfälle erfasst, überschreibt die API nichts und antwortet mit 409 zusatzangaben_in_app. Solange die Fragen offen sind, steht bei der Vorbereitung das Hindernis zusatzangaben_offen.

Prüfen und vorbereiten: so sieht der Aufruf aus

Die Vorbereitung für September 2026 als MCP-Aufruf – über REST ist es POST /v1/tax/operations mit demselben Körper:

{
  "name": "prepare_tax_filing",
  "arguments": {
    "art": "ustva",
    "period": "2026-09"
  }
}

Die Antwort enthält die vorgang_id, die eingefrorenen Werte im manifest (Kennzahlen, Zahllast, Herkunft und Hinweise), den Prüfwert manifest_sha256, das ERiC-Ergebnis, die Liste hindernisse und das Feld sendebereit. Der Prüfwert ist ein SHA-256-Wert über die Kennzahlen; die Freigabe-Seite der App rechnet ihn aus dem aktuellen Stand neu und vergleicht.

Typische Hindernisse sind zusatzangaben_offen (Fragen des Vordrucks offen), eric_fehler (ERiC beanstandet Felder, Einzelheiten in eric.field_errors), versand_gesperrt (etwa wegen des Jahrgangs oder einer umsatzsteuerlichen Organschaft), unklarer_versand (ein früherer Versand dieses Zeitraums ist ungeklärt) und zertifikat_fehlt (die Gesellschaft hat kein eigenes ELSTER-Zertifikat hinterlegt). Ein guter Agent nennt sie Ihnen, statt sie zu übergehen.

Die Freigabe: Ihr Klick in der App

request_tax_filing_approval gibt eine Adresse der Form https://jahresabschluss.io/api-freigabe/… zurück, gültig sieben Tage. Sie öffnen sie angemeldet. Die Seite zeigt Zeitraum, Werte und den Anfang des Prüfwerts und vergleicht mit dem aktuellen Stand: „unverändert seit der Vorbereitung“ oder ein Hinweis, dass sich seither etwas geändert hat. Übermittelt werden immer die Werte, die die Versandseite in diesem Moment zeigt.

Auf der Versandseite übermitteln Sie wie gewohnt mit Zwei-Faktor-Bestätigung und Ihrer ELSTER-PIN. Der Agent erfährt die PIN nicht. Fragt er danach get_tax_operation ab, steht dort der Übermittlungsstand der Voranmeldung samt Transferticket.

Beispiel: die Voranmeldung für das dritte Quartal

Ihr Auftrag im Chat: „Umsatzsteuer-Voranmeldung Q3 2026 vorbereiten, vor jeder Bestätigung bei mir nachfragen.“ Ein möglicher Verlauf:

• get_vat_return mit period=2026-Q3: Der Agent nennt die Zahllast und die größten Posten. Fällt ihm eine Buchung mit ungewöhnlichem Steuersatz auf, fragt er nach.
• Ist die Buchung falsch und hat der Schlüssel Schreibrecht in der Buchhaltung, korrigiert er sie nach Ihrer Bestätigung per Storno und Neubuchung (storno_journal_entry, create_journal_entry) und liest die Vorschau neu.
• get_vat_supplementary: Er stellt Ihnen die Fragen des Vordrucks; Sie verneinen, er ruft confirm_vat_supplementary auf.
• check_tax_filing: ERiC nimmt den Datensatz an (valid=true).
• prepare_tax_filing und request_tax_filing_approval: Er zeigt Kennzahlen, Zahllast und Prüfwert und gibt Ihnen den Link.
• Nach Ihrer Übermittlung: get_tax_operation nennt das Transferticket, list_tax_deadlines führt die Frist als erledigt.

Fristen und Recht

Die Voranmeldung ist bis zum zehnten Tag nach Ablauf des Voranmeldungszeitraums nach amtlich vorgeschriebenem Datensatz über die amtlich bestimmte Schnittstelle zu übermitteln; am selben Tag ist die Vorauszahlung fällig (§ 18 Abs. 1 UStG). Voranmeldungszeitraum ist das Kalendervierteljahr, bei mehr als 9.000 € Steuer im Vorjahr der Kalendermonat (§ 18 Abs. 2 UStG). Mit Dauerfristverlängerung verlängern sich beide Fristen um einen Monat (§ 46 UStDV). Fällt das Fristende auf einen Sonnabend, Sonntag oder gesetzlichen Feiertag, endet die Frist mit dem nächsten Werktag (§ 108 Abs. 3 AO).

Die Voranmeldung ist eine Steueranmeldung (§ 150 Abs. 1 Satz 3 AO) und steht einer Steuerfestsetzung unter Vorbehalt der Nachprüfung gleich (§ 168 Satz 1 AO). Wer abgibt, macht seine Angaben nach bestem Wissen und Gewissen (§ 150 Abs. 2 AO). Eine spätere Korrektur ist eine berichtigte Voranmeldung – und die übermitteln Sie in der App.

Was in der App bleibt

• Berichtigte Voranmeldungen (Kennzahl 10) und Voranmeldungen, deren Vorgänger außerhalb der Software abgegeben wurde.
• Jeder Sonderfall des Vordrucks und jede Änderung an bereits erfassten Zusatzangaben.
• Gesperrte Zeiträume, etwa bei umsatzsteuerlicher Organschaft: Für die Organgesellschaft gibt der Organträger ab.
• Einstellungen wie Voranmeldungszeitraum, Versteuerungsart und Dauerfristverlängerung.
• Die Übermittlung selbst – mit Zwei-Faktor-Bestätigung und PIN.

Häufige Fragen

Kann ein KI-Agent die Umsatzsteuervoranmeldung abgeben?

Er bereitet sie vollständig vor: Zahlen lesen, Fragen des Vordrucks klären, amtlich prüfen, Werte einfrieren. Die Übermittlung starten Sie über den Freigabe-Link in der App mit Ihrer PIN. Ein Recht, mit dem ein Agent über die API sendet, wird derzeit nicht vergeben.

Was ist der Unterschied zu „Umsatzsteuer-Zahlen per KI-Agent abfragen“?

Dort geht es nur um get_vat_return, also das Lesen von Kennzahlen, Zahllast und Buchungen. Diese Seite beschreibt den ganzen Weg bis zur Übermittlung: Zusatzangaben, amtliche Prüfung, Vorbereitung und Freigabe-Link.

Welche Rechte braucht der API-Schlüssel?

„Lesen“ genügt für get_vat_return, get_vat_supplementary und get_tax_operation. Für confirm_vat_supplementary, check_tax_filing, prepare_tax_filing und request_tax_filing_approval braucht er „Schreiben“.

Wie lange gilt eine Vorbereitung?

Der eingefrorene Vorgang gilt 30 Minuten, der Freigabe-Link sieben Tage. Ist der Link abgelaufen, übermitteln Sie trotzdem auf der Versandseite der App; dort sehen Sie die aktuellen Werte.

Was passiert, wenn ERiC Fehler meldet?

check_tax_filing liefert valid=false und je Beanstandung Feld, Text, Regel-Kennung und Schwere. Der Agent erklärt die Fehler und schlägt Korrekturen vor; danach prüft er erneut. Bei der Vorbereitung steht dann das Hindernis eric_fehler.

Geht das auch vierteljährlich und bei abweichendem Wirtschaftsjahr?

Ja. Der Zeitraum ist ein Kalendermonat oder Kalenderquartal; die API ordnet ihn dem passenden Geschäftsjahr zu. Ist das nicht eindeutig, antwortet sie mit 409 fiscal_year_ambiguous.