Referenz: SFN-Zuschläge
Steuerfreie Zuschlagssätze nach § 3b EStG und die Grundlohngrenzen für Steuer und Sozialversicherung.
Die Höchstsätze, bis zu denen Zuschläge für Nacht-, Sonntags- und Feiertagsarbeit steuerfrei bleiben, mit den Sonderfällen 0 bis 4 Uhr, Heiligabend und Silvester ab 14 Uhr, Weihnachten und 1. Mai. Dazu die Grundlohngrenzen von 50 Euro je Stunde für die Steuer und 25 Euro für die Sozialversicherung. Mit einem Grundlohn rechnet die API die steuer- und beitragsfreien Beträge je Stunde aus.
Endpunkte und Aufrufe
#| Zugang | Aufruf |
|---|---|
| REST-API | GET /hr/sfn-zuschlaege |
| Verlauf | GET /hr/sfn-zuschlaege/verlauf |
| SDK JavaScript | qk.hr.sfnZuschlaege(…) |
| SDK Python | qk.hr.sfn_zuschlaege(…) |
| CLI | qk sfn-zuschlaege --datum 2026-12-24 --grundlohn-stunde 22.5 |
| MCP-Werkzeug | hr_sfn_zuschlaege |
Parameter
#| Name | Typ | Pflicht | Standard | Erlaubt | Beschreibung |
|---|---|---|---|---|---|
datum | Datum (JJJJ-MM-TT) | nein | heute | Tag der Arbeit oder Stichtag der Sätze im Format JJJJ-MM-TT. Ohne Angabe gilt der heutige Tag. Fällt er auf den 24.12., 25.12., 26.12., 31.12. oder 1.5., nennt die Antwort den Satz dieses Tages im Feld sondertag. Ob ein anderer Tag ein Feiertag ist, liefert hr_feiertage. | |
grundlohn_stunde | Zahl | nein | 0 bis 1000 | Grundlohn je Stunde in Euro nach § 3b Abs. 2 EStG (optional): laufender Arbeitslohn für die regelmäßige Arbeitszeit einschließlich laufender Zulagen, ohne SFN-Zuschläge und Mehrarbeitsvergütung; bei Monatslohn geteilt durch das 4,35-Fache der Wochenstunden (R 3b Abs. 2 LStR). Dann kommen die steuer- und beitragsfreien Beträge je Stunde dazu. | |
bestandteil | Text | nein | nachtarbeit, nachtarbeit_0_bis_4_uhr, sonntagsarbeit, feiertagsarbeit, weihnachten_und_1_mai, grundlohn_hoechstbetrag_steuer, grundlohn_hoechstbetrag_sv | 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 |
werte | Objekt | Zuschlagssätze in Prozent und Grundlohngrenzen |
bestandteile | Liste | Je Bestandteil Wert oder Satz, Gültigkeit, Rechtsgrundlage und Quelle |
regeln | Liste | Regeln aus § 3b EStG, R 3b LStR und SvEV |
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 |
sondertag | Objekt oder null | Satz des Tages, wenn datum auf 24.12., 25.12., 26.12., 31.12. oder 1.5. fällt |
grundlohn_stunde | Dezimal oder null | Übergebener Grundlohn je Stunde |
betraege_stunde | Objekt oder null | Je Zuschlag steuerfreier und beitragsfreier Betrag je Stunde |
kombinationen | Objekt | Nachtarbeit an Sonn- und Feiertagen: addierter Satz und, mit Grundlohn, Beträge je Stunde |
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 |
|---|---|---|---|---|---|
nachtarbeit | Nachtarbeit von 20 bis 6 Uhr | Prozent | 01.01.2015 | 25 % | offen |
nachtarbeit_0_bis_4_uhr | Nachtarbeit von 0 bis 4 Uhr, wenn die Arbeit vor 0 Uhr aufgenommen wurde | Prozent | 01.01.2015 | 40 % | offen |
sonntagsarbeit | Sonntagsarbeit | Prozent | 01.01.2015 | 50 % | offen |
feiertagsarbeit | Arbeit an gesetzlichen Feiertagen und am 31. Dezember ab 14 Uhr | Prozent | 01.01.2015 | 125 % | offen |
weihnachten_und_1_mai | Arbeit am 24. Dezember ab 14 Uhr, am 25. und 26. Dezember und am 1. Mai | Prozent | 01.01.2015 | 150 % | offen |
grundlohn_hoechstbetrag_steuer | Höchster Grundlohn je Stunde für die Steuerfreiheit | Euro je Stunde | 01.01.2015 | 50 € je Stunde | offen |
grundlohn_hoechstbetrag_sv | Höchster Grundlohn je Stunde für die Beitragsfreiheit in der Sozialversicherung | Euro je Stunde | 01.01.2015 | 25 € je Stunde | offen |
Beispiel
#Aufruf mit datum = 2026-12-24, grundlohn_stunde = 22.5. 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: grundlohn_stunde (0 bis 1000); bestandteil (nachtarbeit, nachtarbeit_0_bis_4_uhr, sonntagsarbeit, feiertagsarbeit, weihnachten_und_1_mai, grundlohn_hoechstbetrag_steuer, grundlohn_hoechstbetrag_sv) |
| 400 | unbekannter_parameter | Parameter, den es für diesen Datensatz nicht gibt |
| 404 | kein_wert | außerhalb der Abdeckung (ab 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_sfn_zuschlaege:
Quelle und Stand
#| Angabe | Inhalt |
|---|---|
| Quelle | § 3b EStG, R 3b LStR, § 1 Abs. 1 Satz 1 Nr. 1 SvEV |
| Lizenz | Werte aus amtlichen Werken (§ 5 UrhG). Nutzung der Zusammenstellung nach den Nutzungsbedingungen von Quellenkontor. |
| Aktualisierung | bei Gesetzesänderung |
| Abdeckung | Deutschland, ab 2015 |
| Zuletzt geprüft | 24.09.2026 |
| Nächste erwartete Änderung | nur bei Gesetzesänderung |
Fehlt etwas oder ist etwas unklar? Schreib uns, wir ergänzen die Doku.