Referenz: SV-Fälligkeit
Beitragsnachweis und Zahltag der Sozialversicherung je Monat, berechnet für den Sitz deiner Einzugsstelle.
Berechnet für jeden Monat den drittletzten Bankarbeitstag, an dem die Gesamtsozialversicherungsbeiträge fällig sind, und den Termin für den Beitragsnachweis. Samstage, Sonntage, gesetzliche Feiertage am Sitz der Einzugsstelle sowie der 24. und 31. Dezember zählen nicht als Bankarbeitstag. Ohne Land zeigt der Rechner, in welchen Monaten die Termine je nach Land abweichen.
Endpunkte und Aufrufe
#| Zugang | Aufruf |
|---|---|
| REST-API | GET /hr/sv-faelligkeit |
| SDK JavaScript | qk.hr.svFaelligkeit(…) |
| SDK Python | qk.hr.sv_faelligkeit(…) |
| CLI | qk sv-faelligkeit --jahr 2027 --land HH |
| MCP-Werkzeug | hr_sv_faelligkeit |
Parameter
#| Name | Typ | Pflicht | Standard | Erlaubt | Beschreibung |
|---|---|---|---|---|---|
jahr | Jahr | nein | laufendes Jahr | 2015 bis 2035 | Kalenderjahr 2015 bis 2035, liefert alle zwölf Monate. Ohne Angabe gilt das laufende Jahr. |
datum | Datum (JJJJ-MM-TT) | nein | Alternativ zu jahr: Stichtag im Format JJJJ-MM-TT, liefert nur den Monat des Stichtags. | ||
land | Text | nein | BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH | Land am Sitz der Einzugsstelle (Krankenkasse), zum Beispiel HH. Ohne Angabe: gemeinsame Termine und je Monat die Abweichungen nach Ländern |
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 |
jahr | Ganzzahl | Kalenderjahr |
land | Text oder null | Kürzel des Bundeslands |
land_name | Text | Name des Bundeslands |
termine | Liste | Je Monat faelligkeit, nachweis_vorliegen, nachweis_uebermitteln_bis und die übersprungenen Tage |
rechtsgrundlage | Text | Gesetz oder Verordnung |
quelle | Objekt | Titel und URL der Quelle, auf der der Wert beruht |
quellen | Liste | Alle Normen, auf denen die Antwort beruht, mit Titel und URL |
hinweise | Liste | Grenzen der Werte oder der Berechnung, in Sätzen |
stand | Datum | Tag der letzten Prüfung gegen die Quelle |
lizenz | Text | Nutzungsbedingungen der Werte |
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 |
abweichungen | Liste | Ohne land: Termine je Ländergruppe, wenn sie abweichen |
einheitlich | Wahrheitswert | Ohne land: true, wenn alle Länder dieselben Termine haben |
Beispiel
#Aufruf mit jahr = 2027, land = HH. Die Antwort erzeugt derselbe Code, der auch die API beantwortet.
Fehlerfälle
#| Status | Code | Wann |
|---|---|---|
| 400 | ungueltiger_parameter | falsches Format oder Wert außerhalb von: jahr (2015 bis 2035); land (BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH) |
| 400 | unbekannter_parameter | Parameter, den es für diesen Datensatz nicht gibt |
| 404 | kein_wert | außerhalb der Abdeckung (2015 bis 2035) 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_sv_faelligkeit:
Quelle und Stand
#| Angabe | Inhalt |
|---|---|
| Quelle | § 23 Abs. 1 und § 28f Abs. 3 SGB IV, Gemeinsame Grundsätze Beitragsnachweis |
| Lizenz | Berechnung nach den genannten Normen. Nutzung nach den Nutzungsbedingungen von Quellenkontor. |
| Aktualisierung | folgt dem Kalender |
| Abdeckung | Deutschland, 2015 bis 2035 |
| Zuletzt geprüft | 26.09.2026 |
| Nächste erwartete Änderung | jährlicher Abgleich mit den Terminlisten der Einzugsstellen im Dezember |
Fehlt etwas oder ist etwas unklar? Schreib uns, wir ergänzen die Doku.