Referenz: Lohnsteuer-Anmeldung
Grenzen für monatliche, vierteljährliche und jährliche Lohnsteuer-Anmeldung, Abgabetag und Zahlungsschonfrist seit 2015.
Ob du die Lohnsteuer monatlich, vierteljährlich oder einmal im Jahr anmeldest, hängt von der abzuführenden Lohnsteuer des Vorjahres ab (§ 41a Abs. 2 EStG). Der Datensatz liefert beide Grenzen, den Abgabetag am zehnten Tag nach Ablauf des Zeitraums und die Schonfrist von drei Tagen beim Säumniszuschlag, dazu die Regeln zum Verspätungszuschlag.
Endpunkte und Aufrufe
#| Zugang | Aufruf |
|---|---|
| REST-API | GET /hr/lohnsteuer-anmeldung |
| Verlauf | GET /hr/lohnsteuer-anmeldung/verlauf |
| SDK JavaScript | qk.hr.lohnsteuerAnmeldung(…) |
| SDK Python | qk.hr.lohnsteuer_anmeldung(…) |
| CLI | qk lohnsteuer-anmeldung --datum 2026-10-01 |
| MCP-Werkzeug | hr_lohnsteuer_anmeldung |
Parameter
#| Name | Typ | Pflicht | Standard | Erlaubt | Beschreibung |
|---|---|---|---|---|---|
datum | Datum (JJJJ-MM-TT) | nein | heute | Stichtag im Format JJJJ-MM-TT. Ohne Angabe gilt der heutige Tag. | |
bestandteil | Text | nein | grenze_jahresanmeldung, grenze_quartalsanmeldung, abgabefrist_tage, schonfrist_saeumniszuschlag_tage | Nur diesen Bestandteil liefern und zitieren, etwa für eine einzelne Frage (optional). Erlaubt sind die ids der Bestandteile. |
Unbekannte Parameter lehnt die API mit unbekannter_parameter ab. Dazu kommen format und trennzeichen, siehe CSV.
Antwortfelder
#| Feld | Typ | Bedeutung |
|---|---|---|
datensatz | Text | Kennung des Datensatzes |
datum | Datum | Abgefragter Stichtag |
vorlaeufig | Boolesch | true, wenn für den Stichtag noch nicht alle Werte festgelegt sind; ausstehende Werte stehen dann auf null |
werte | Objekt | Kurzform: Bestandteil und Wert |
bestandteile | Liste | Je Bestandteil Wert, Einheit, Gültigkeit, Rechtsgrundlage und Quelle |
regeln | Liste | Regeln aus dem Gesetz, je mit Norm |
hinweise | Liste | Grenzen der Werte oder der Berechnung, in Sätzen |
lizenz | Text | Nutzungsbedingungen der Werte |
stand | Datum | Tag der letzten Prüfung gegen die Quelle |
zitat | Text | Fertiger Satz mit Wert, Gültigkeit, Rechtsgrundlage und Quelle zum Zitieren |
datenstand | Text | Kennung des Datenstands: Datum und laufende Nummer der letzten Änderung im Änderungsprotokoll (/v1/aenderungen), die diesen Datensatz betrifft. Gleicher Datenstand heißt unveränderter Inhalt, praktisch für Prüfer und zum Vergleich zweier Abfragen |
Bestandteile
#Die Antwort enthält je Stichtag die gültigen Bestandteile, jeweils mit id, name, gruppe, einheit, wert, gueltig_ab, rechtsgrundlage, quelle, hinweis und naechster_wert. Im Objekt werte steht dieselbe Liste als Kurzform. Ein Bestandteil fehlt, wenn er am Stichtag noch nicht oder nicht mehr gilt.
| id | Bestandteil | Einheit | Erste Stufe | Aktueller Wert | Ende |
|---|---|---|---|---|---|
grenze_jahresanmeldung | Grenze für die jährliche Lohnsteuer-Anmeldung: abzuführende Lohnsteuer des Vorjahres höchstens | Euro | 01.01.2015 | 1.080 € | offen |
grenze_quartalsanmeldung | Grenze für die vierteljährliche Lohnsteuer-Anmeldung: abzuführende Lohnsteuer des Vorjahres höchstens | Euro | 01.01.2015 | 5.000 € | offen |
abgabefrist_tage | Abgabe- und Zahlungsfrist: Tage nach Ablauf des Anmeldungszeitraums | Tage | 01.01.2015 | 10 Tage | offen |
schonfrist_saeumniszuschlag_tage | Zahlungsschonfrist: Tage ohne Säumniszuschlag | Tage | 01.01.2015 | 3 Tage | offen |
Beispiel
#Aufruf mit datum = 2026-10-01. Die Antwort erzeugt derselbe Code, der auch die API beantwortet.
Verlauf
#Alle Stufen seit 2015 mit einem Aufruf, als JSON oder mit format=csv als CSV. Die letzten beiden Stufen:
Fehlerfälle
#| Status | Code | Wann |
|---|---|---|
| 400 | ungueltiger_parameter | falsches Format oder Wert außerhalb von: bestandteil (grenze_jahresanmeldung, grenze_quartalsanmeldung, abgabefrist_tage, schonfrist_saeumniszuschlag_tage) |
| 400 | unbekannter_parameter | Parameter, den es für diesen Datensatz nicht gibt |
| 404 | kein_wert | außerhalb der Abdeckung (ab 01.01.2015) oder Wert für diesen Zeitraum noch nicht verkündet |
| 401, 429 | siehe Fehler | alle Fehlercodes |
Schema für MCP
#So beschreibt der MCP-Server die Argumente des Werkzeugs hr_lohnsteuer_anmeldung:
Quelle und Stand
#| Angabe | Inhalt |
|---|---|
| Quelle | § 41a EStG, §§ 152, 240 AO |
| Lizenz | Werte aus amtlichen Werken (§ 5 UrhG). Nutzung der Zusammenstellung nach den Nutzungsbedingungen von Quellenkontor. |
| Aktualisierung | bei Gesetzesänderung |
| Abdeckung | Deutschland, ab 01.01.2015 |
| Zuletzt geprüft | 26.09.2026 |
| Nächste erwartete Änderung | nur bei Gesetzesänderung |
Fehlt etwas oder ist etwas unklar? Schreib uns, wir ergänzen die Doku.