Umsatzsteuer-Voranmeldung: Zahlen per KI-Agent abfragen

Was get_vat_return zurückgibt

Das Werkzeug ist rein lesend. Es liefert die Vorschau eines Voranmeldungszeitraums so, wie die App sie berechnet — ohne Versand.

• Kennzahlen: die Werte des Datensatzes für den Zeitraum, etwa Kennzahl 81 (steuerpflichtige Umsätze zu 19 %), 86 (zu 7 %), 66 (Vorsteuer) und 83 (verbleibende Vorauszahlung oder Überschuss).
• Zahllast: einmal so, wie sie gemeldet würde, und einmal so, wie sie gebucht ist. Weichen beide ab, kann das zum Beispiel an der Rundung der Bemessungsgrundlagen auf volle Euro liegen.
• Belege je Kennzahl: zu jeder Kennzahl die Buchungen mit Betrag und Buchungs-ID, bei Zahlungen auch Rechnungsnummer, Kunde und Datum. Daran sieht der Agent, woraus sich ein Wert zusammensetzt.
• Dauerfristverlängerung und Sondervorauszahlung: ob die Dauerfrist aktiv ist und welchen Stand die Sondervorauszahlung des Jahres hat.
• Hinweise: etwa zum Jahrgang oder zu einer umsatzsteuerlichen Organschaft, dazu ein Kennzeichen, ob eine Übermittlung derzeit gesperrt wäre, und ein Vermerk, wenn eine frühere Übermittlung für den Zeitraum ohne klare Rückmeldung geblieben ist.
• Zusatzangaben der Voranmeldung, ob sie bestätigt sind, und gefundene Unstimmigkeiten darin.
• Herkunft: ob die Werte aus der Buchhaltung stammen oder in der App von Hand erfasst wurden — und der ausdrückliche Vermerk, dass die Übermittlung in der App bleibt.

So fragt der Agent einen Zeitraum ab

Ein Parameter genügt: der Zeitraum als Kalendermonat (JJJJ-MM) oder Kalenderquartal (JJJJ-Qn).

Der Zeitraum muss in genau einem Geschäftsjahr liegen; bei abweichendem Wirtschaftsjahr ordnet die Buchhaltung den Kalendermonat oder das Kalenderquartal selbst dem richtigen Geschäftsjahr zu. Gibt es kein passendes Geschäftsjahr, kommt eine klare Fehlermeldung statt geschätzter Zahlen.

Welchen Voranmeldungszeitraum Ihre Gesellschaft hat, ob Sie nach vereinbarten oder vereinnahmten Entgelten versteuern und ob eine Dauerfristverlängerung besteht, liest der Agent vorher mit get_entity_settings. Geändert werden diese Einstellungen nur in der App.

{
  "name": "get_vat_return",
  "arguments": {
    "period": "2026-Q3"
  }
}

Beispiel: die Zahllast prüfen, bevor Sie abgeben

• get_entity_settings: Der Agent sieht, dass Ihre Gesellschaft monatlich anmeldet und wie sie versteuert.
• get_vat_return mit period 2026-09 und 2026-08: Er stellt die Kennzahlen beider Monate nebeneinander, etwa die Umsätze zu 19 % und die Vorsteuer.
• Aus den Belegen je Kennzahl liest er, welche Buchungen den Unterschied ausmachen; mit get_journal_entry öffnet er einzelne Buchungen.
• list_incoming_invoices: Er liest die Eingangsrechnungen des Geschäftsjahres, gleicht sie mit den Vorsteuer-Belegen ab und nennt Ihnen Rechnungen, die im September fehlen oder noch nicht bezahlt sind.
• Er fasst zusammen und erinnert daran, dass die Abgabe im Steuer-Modul der App erfolgt — der Agent startet sie nicht.

Ihr Auftrag im Chat: „Wie hoch ist die Umsatzsteuer-Zahllast für September 2026, und warum ist sie höher als im August? Bitte auch prüfen, ob alle Eingangsrechnungen mit Vorsteuer enthalten sind.“

Warum der Agent nur liest

Die Voranmeldung ist eine Steueranmeldung gegenüber dem Finanzamt. Deshalb trägt schon die Antwort des Werkzeugs den Vermerk, dass die Übermittlung an ELSTER in der App bleibt. Weder der MCP-Server noch die REST-Schnittstelle der Buchhaltung kennen einen Versandweg; ein Agent kann also auch versehentlich nichts abgeben.

In der App sehen Sie vor der Übermittlung dieselben Kennzahlen, ergänzen bei Bedarf Zusatzangaben und geben frei. Hat der Agent vorher einen Fehler gefunden — etwa eine falsch kontierte Rechnung —, korrigiert er die Buchung mit Schreibrecht per Storno und Neubuchung, und die Vorschau zeigt beim nächsten Abruf die neuen Werte.

Fragen, die der Agent damit beantwortet

Zusammenspiel mit Ihrem Steuerberater

Prüft oder übermittelt Ihr Steuerberater die Voranmeldung, ändert der Agent daran nichts — er macht die Vorbereitung schneller. Er stellt die Kennzahlen eines Zeitraums samt Belegen zusammen, bereitet Rückfragen vor und listet offene Eingangsrechnungen auf, bevor die Kanzlei draufschaut. Bucht der Agent Korrekturen, stehen sie als Storno und Neubuchung im Journal und bleiben für die Kanzlei nachvollziehbar.

Für das reine Lesen genügt ein Schlüssel mit Leserecht. Wer dem Agenten nur Auswertungen erlauben möchte, vergibt kein Schreibrecht — dann kann er Zahlen abfragen, aber nichts buchen.

Häufige Fragen

Kann ein KI-Agent die Umsatzsteuer-Voranmeldung abgeben?

Nein. get_vat_return liest nur. Die Übermittlung an das Finanzamt starten Sie im Steuer-Modul der App; dafür gibt es weder im MCP-Server noch in der REST-Schnittstelle einen Weg.

Welche Kennzahlen zeigt die Antwort?

Die Kennzahlen des Datensatzes für den Zeitraum, für die es Werte gibt — etwa 81 und 86 für steuerpflichtige Umsätze zu 19 und 7 %, 66 für die Vorsteuer und 83 für die verbleibende Vorauszahlung oder den Überschuss. Zu jeder Kennzahl kommen die Buchungen, aus denen sie sich ergibt.

Sind das dieselben Zahlen wie in der App?

Ja. Die Vorschau rechnet mit denselben Bausteinen wie die App, nur ohne Versand. Ändert sich eine Buchung, zeigt der nächste Abruf den neuen Stand.

Geht das auch quartalsweise?

Ja. Der Zeitraum ist ein Kalendermonat (JJJJ-MM) oder ein Kalenderquartal (JJJJ-Qn). Die Buchhaltung ordnet ihn dem passenden Geschäftsjahr zu, auch bei abweichendem Wirtschaftsjahr.

Was bedeutet es, wenn die Übermittlung als gesperrt gemeldet wird?

Die Antwort enthält ein Kennzeichen, ob eine Übermittlung für diesen Zeitraum derzeit gesperrt wäre, und den Grund in den Hinweisen — etwa bei einer umsatzsteuerlichen Organschaft oder einem Hinweis zum Jahrgang. Die Zahlen liest der Agent trotzdem; was zu tun ist, klären Sie in der App oder mit Ihrem Steuerberater.

Welche Rechte braucht der Schlüssel?

Nur das Leserecht, das in jedem Schlüssel enthalten ist. Der Schlüssel gilt für genau eine Gesellschaft und wird in der App unter Buchhaltung → Einstellungen → „KI-Agent & API“ angelegt; gespeichert wird nur ein Hash.