{"name":"Umsatzsteuer-Voranmeldung API","apiVersion":1,"description":"Umsatzsteuer-Voranmeldung: nennt aus der Umsatzsteuer des Vorjahres und dem Jahr der Aufnahme der Tätigkeit den Voranmeldungszeitraum nach § 18 Abs. 2, 2a UStG (monatlich, vierteljährlich, Befreiung möglich) und alle Abgabetermine eines Kalenderjahres mit und ohne Dauerfristverlängerung, verschoben auf den nächsten Werktag nach § 108 Abs. 3 AO, dazu die Sondervorauszahlung nach § 47 UStDV.","privacy":"Die API speichert und protokolliert keine Eingaben; sie rechnet und vergisst.","units":"Beträge in Euro; Daten als JJJJ-MM-TT. Berücksichtigt sind Samstage, Sonntage und die neun bundesweiten Feiertage, keine regionalen.","founderRule":"Die Ausnahme für Neugründungen in § 18 Abs. 2 Satz 6 UStG gilt nach dem Gesetzestext nur für die Besteuerungszeiträume 2021 bis 2026 (Stand 17. November 2026). Der Gesetzgeber kann sie verlängern; es zählt der Text, der für den jeweiligen Besteuerungszeitraum gilt.","statuses":"Fehler: 400 mit einer Meldung je Feld, 413 über 10000 Bytes, 429 über 120 Aufrufen pro Minute.","checkedOn":"2026-11-17","openapi":"https://www.firma.de/api/ust-voranmeldung/openapi.json","page":"https://www.firma.de/umsatzsteuervoranmeldung/","fields":[{"name":"year","type":"integer","default":null,"description":"Das Kalenderjahr der Voranmeldungen: 2026, 2027. Standard: das laufende Jahr, sonst 2026.","example":"2026","aliases":["jahr","kalenderjahr"],"min":2026,"max":2027},{"name":"tax","type":"number | null","default":null,"description":"Umsatzsteuer des Vorjahres in Euro (die Zahllast des ganzen Jahres; ein Überschuss zu Gunsten des Unternehmers als negative Zahl). Bei startYear = year: die voraussichtliche Steuer des laufenden Jahres. Pflicht bei rhythm = auto, außer Satz 4 oder Satz 5 entscheidet.","example":"12000","aliases":["steuer","zahllast","umsatzsteuer","vorjahressteuer","ustvorjahr"],"min":-100000000,"max":100000000},{"name":"startYear","type":"integer | null","default":null,"description":"Jahr, in dem die Tätigkeit aufgenommen wurde. Weglassen, wenn das länger als ein Jahr vor year liegt. Im Jahr der Aufnahme und im Folgejahr gilt § 18 Abs. 2 Satz 4 UStG (monatlich), für die Besteuerungszeiträume 2021 bis 2026 stattdessen Satz 6.","example":"2026","aliases":["gruendungsjahr","startjahr","aufnahme","gruendung"],"min":1950,"max":2027},{"name":"monthsActive","type":"integer","default":12,"description":"Monate der Tätigkeit im Vorjahr, 1 bis 12. Nur von Belang, wenn startYear das Vorjahr ist: Dann wird die Steuer für 2021 bis 2026 auf zwölf Monate umgerechnet (§ 18 Abs. 2 Satz 6 UStG; gerechnet wird Steuer × 12 ÷ Monate, die Rechenweise nennt das Gesetz nicht) und ebenso die Summe der Vorauszahlungen für die Sondervorauszahlung, bei der angefangene Monate voll zählen (§ 47 Abs. 2 UStDV). Standard 12.","example":"6","aliases":["monate","monatetaetig"],"min":1,"max":12},{"name":"shell","type":"boolean","default":false,"description":"true: Vorratsgesellschaft oder Firmenmantel (§ 18 Abs. 2 Satz 5 UStG), mit startYear als Jahr des Beginns oder der Übernahme. Standard false.","example":"false","aliases":["vorratsgesellschaft","firmenmantel","mantel"]},{"name":"rhythm","type":"enum","default":"auto","description":"auto (Standard): der Zeitraum folgt aus tax und startYear. monat oder quartal: nur die Termine für diesen Zeitraum, ohne Prüfung, etwa wenn das Finanzamt ihn mitgeteilt hat.","example":"auto","aliases":["rhythmus","zeitraum","voranmeldungszeitraum"],"values":["auto","monat","quartal"]},{"name":"extension","type":"boolean","default":false,"description":"true: mit Dauerfristverlängerung, alle Termine einen Monat später (§ 46 UStDV). Standard false.","example":"true","aliases":["dauerfristverlaengerung","dfv","fristverlaengerung"]},{"name":"prepayments","type":"number | null","default":null,"description":"Summe der Vorauszahlungen des Vorjahres in Euro, nicht negativ; bei startYear = year die voraussichtlichen Vorauszahlungen des laufenden Jahres. Angegeben: Die Antwort nennt die Sondervorauszahlung (ein Elftel, § 47 UStDV).","example":"22000","aliases":["vorauszahlungen","summevorauszahlungen","sondervorauszahlung"],"min":0,"max":100000000}],"parameters":{"today":{"description":"Der Tag, ab dem next zählt, als JJJJ-MM-TT. Standard: heute in Deutschland.","example":"2026-11-17","type":"date"},"format":{"description":"json (Standard) oder md: die Antwort als Markdown mit Tabelle der Termine.","example":"md","type":"enum","values":["json","md"]}},"examples":{"monthly":{"description":"12.000 € Umsatzsteuer im Vorjahr, mit Dauerfristverlängerung und Sondervorauszahlung, als Markdown:","url":"https://www.firma.de/api/ust-voranmeldung/?extension=true&format=md&prepayments=12000&tax=12000&year=2026"},"quarterly":{"description":"Die Termine 2026 bei vierteljährlicher Abgabe, ohne Angabe der Steuer:","url":"https://www.firma.de/api/ust-voranmeldung/?rhythm=quartal&year=2026"},"founder":{"description":"Neugründung 2027: nach dem Gesetzestext monatlich.","url":"https://www.firma.de/api/ust-voranmeldung/?startYear=2027&year=2027"}},"post":{"contentType":"application/json","description":"Dieselben Felder als JSON. format geht auch hier, ebenso ?format=md in der Adresse.","example":{"extension":true,"prepayments":12000,"tax":12000,"year":2026}},"answer":{"rhythm":"Der Voranmeldungszeitraum nach § 18 Abs. 2, 2a UStG: monat oder quartal, mit Grund, Norm, der verglichenen Steuer, dem Ergebnis als Satz (sentence) und weiteren Hinweisen (notes).","extension":"true: die Termine in due sind die mit Dauerfristverlängerung (§ 46 UStDV).","next":"Die nächste Voranmeldung ab today, oder null, wenn alle Termine des Jahres vorbei sind.","dates":"Jede Voranmeldung des Jahres: Zeitraum, Fälligkeit ohne (regular) und mit Dauerfristverlängerung (extended), jeweils mit dem Tag laut Gesetz (nominal) und der Verschiebung nach § 108 Abs. 3 AO; due ist der Termin, der gilt.","specialPrepayment":"Die Sondervorauszahlung nach § 47 UStDV, wenn prepayments angegeben ist und monatlich abzugeben ist; sonst null.","founderRule":"Was § 18 Abs. 2 Satz 4 und Satz 6 UStG nach dem Gesetzestext für Neugründungen 2026 und 2027 vorsehen, mit Stand.","holidayNote":"Welche Feiertage berücksichtigt sind und welche nicht.","sources":"Die Normen als Links auf gesetze-im-internet.de."},"disclaimer":"Unverbindliche Berechnung nach UStG, UStDV und AO, Stand 17. November 2026. Keine Steuerberatung: Das Ergebnis nennt, was das Gesetz für die eingegebenen Zahlen vorsieht, und ersetzt nicht die Prüfung des Einzelfalls."}