Anwendungsfall · Für HR-Software

Feiertage in der Schichtplanung je Standort berücksichtigen

Feiertage je Standort automatisch im Plan, regionale Feiertage eingeschlossen.

Für die Schichtplanung brauchst du die Feiertage des Bundeslands, in dem ein Standort liegt, nicht die des Firmensitzes. Bayern hat 2026 zum Beispiel 14 gesetzliche Feiertage einschließlich der regionalen, andere Länder weniger. Die API liefert sie je Land und Jahr mit Wochentag.

1

Jeden Standort seinem Bundesland zuordnen.

2

Feiertage für das Planungsjahr je Land abrufen und regionale Feiertage je Standort prüfen.

3

Freie Tage und Zuschläge im Plan setzen und Soll-Stunden neu berechnen.

Der Standort entscheidet

Maßgeblich ist das Feiertagsgesetz des Landes, in dem gearbeitet wird. Ein Unternehmen mit Sitz in Hamburg und einem Lager in Bayern hat an Heilige Drei Könige in Bayern frei, in Hamburg nicht.

Regionale Feiertage gelten nur in einem Teil eines Landes, etwa Fronleichnam in Teilen Sachsens und Thüringens oder das Augsburger Friedensfest. Die API kennzeichnet sie und nennt, wo sie gelten. Ob ein Standort betroffen ist, entscheidest du einmal bei der Zuordnung.

Was die Planung daraus macht

  • Freie Tage je Standort im Schichtplan sperren oder mit Zuschlag besetzen.
  • Soll-Stunden je Monat mit dem Arbeitstage-Rechner neu berechnen.
  • Heiligabend und Silvester gesondert behandeln: keine gesetzlichen Feiertage, für Zuschläge nach § 3b EStG ab 14 Uhr aber wie Feiertage.

Jahre im Voraus planen

Die Feiertage stehen von 2015 bis 2035 bereit, beweglich und fest, dazu einmalige Feiertage, sobald ein Land sie beschlossen hat. Die Tabellen für das laufende und das nächste Jahr stehen auf der Seite Gesetzliche Feiertage.

So sieht der Aufruf aus

Beispiel mit dem Datensatz Gesetzliche Feiertage. Die Antwort kommt aus demselben Code wie die API.

api.quellenkontor.dev/v1/hr/feiertage?land=BY
Zur API-Doku →
curl "https://api.quellenkontor.dev/v1/hr/feiertage?land=BY" \
  -H "Authorization: Bearer $QK_KEY"
Antwort200 OK · JSON
{
  "datensatz": "feiertage",
  "jahr": 2026,
  "land": "BY",
  "land_name": "Bayern",
  "anzahl": 14,
  "anzahl_landesweit_montag_bis_freitag": 9,
  "feiertage": [
    {
      "datum": "2026-01-01",
      "id": "neujahr",
      "name": "Neujahr",
      "wochentag": "Donnerstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-01-06",
      "id": "heilige_drei_koenige",
      "name": "Heilige Drei Könige",
      "wochentag": "Dienstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-04-03",
      "id": "karfreitag",
      "name": "Karfreitag",
      "wochentag": "Freitag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-04-06",
      "id": "ostermontag",
      "name": "Ostermontag",
      "wochentag": "Montag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-05-01",
      "id": "tag_der_arbeit",
      "name": "Tag der Arbeit",
      "wochentag": "Freitag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-05-14",
      "id": "christi_himmelfahrt",
      "name": "Christi Himmelfahrt",
      "wochentag": "Donnerstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-05-25",
      "id": "pfingstmontag",
      "name": "Pfingstmontag",
      "wochentag": "Montag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-06-04",
      "id": "fronleichnam",
      "name": "Fronleichnam",
      "wochentag": "Donnerstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-08-08",
      "id": "augsburger_friedensfest",
      "name": "Augsburger Hohes Friedensfest",
      "wochentag": "Samstag",
      "regional": true,
      "regional_hinweis": "nur im Stadtgebiet Augsburg",
      "sonntag": false
    },
    {
      "datum": "2026-08-15",
      "id": "mariae_himmelfahrt",
      "name": "Mariä Himmelfahrt",
      "wochentag": "Samstag",
      "regional": true,
      "regional_hinweis": "nur in Gemeinden mit überwiegend katholischer Bevölkerung",
      "sonntag": false
    },
    {
      "datum": "2026-10-03",
      "id": "tag_der_deutschen_einheit",
      "name": "Tag der Deutschen Einheit",
      "wochentag": "Samstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-11-01",
      "id": "allerheiligen",
      "name": "Allerheiligen",
      "wochentag": "Sonntag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-12-25",
      "id": "erster_weihnachtstag",
      "name": "1. Weihnachtstag",
      "wochentag": "Freitag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-12-26",
      "id": "zweiter_weihnachtstag",
      "name": "2. Weihnachtstag",
      "wochentag": "Samstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    }
  ],
  "rechtsgrundlage": "Gesetz über den Schutz der Sonn- und Feiertage (Feiertagsgesetz, FTG)",
  "quelle": {
    "titel": "Gesetz über den Schutz der Sonn- und Feiertage (Feiertagsgesetz, FTG), Bayern",
    "url": "https://www.gesetze-bayern.de/Content/Document/BayFTG-1"
  },
  "quellen": [
    {
      "titel": "Gesetz über den Schutz der Sonn- und Feiertage (Feiertagsgesetz, FTG), Bayern",
      "url": "https://www.gesetze-bayern.de/Content/Document/BayFTG-1"
    }
  ],
  "hinweise": [
    "Regionale Feiertage gelten nur in Teilen des Landes und sind mit regional: true gekennzeichnet.",
    "sonntag: true steht für gesetzliche Feiertage, die immer auf einen Sonntag fallen. Das ist für Zuschläge nach § 3b EStG wichtig.",
    "Einmalige Feiertage sind enthalten, soweit sie bis zum Datenstand beschlossen sind. Neue Beschlüsse trägt der wöchentliche Prüflauf nach."
  ],
  "stand": "2026-09-23",
  "lizenz": "Berechnung nach den genannten Normen. Nutzung nach den Nutzungsbedingungen von Quellenkontor.",
  "zitat": "Gesetzliche Feiertage 2026 in Bayern: 14, davon 9 landesweit von Montag bis Freitag. Landesweit: Neujahr Do 01.01., Heilige Drei Könige Di 06.01., Karfreitag Fr 03.04., Ostermontag Mo 06.04., Tag der Arbeit Fr 01.05., Christi Himmelfahrt Do 14.05., Pfingstmontag Mo 25.05., Fronleichnam Do 04.06., Tag der Deutschen Einheit Sa 03.10., Allerheiligen So 01.11., 1. Weihnachtstag Fr 25.12., 2. Weihnachtstag Sa 26.12.. Regionale Feiertage stehen in der Antwort. Rechtsgrundlage: Gesetz über den Schutz der Sonn- und Feiertage (Feiertagsgesetz, FTG). Quelle: Gesetz über den Schutz der Sonn- und Feiertage (Feiertagsgesetz, FTG), Bayern, https://www.gesetze-bayern.de/Content/Document/BayFTG-1. Daten: Quellenkontor (quellenkontor.dev).",
  "datenstand": "2026-09-23.1"
}

Häufige Fragen

Welche Feiertage zählen für einen Standort?

Die des Bundeslands, in dem der Standort liegt. Regionale Feiertage zählen nur, wenn der Standort im betroffenen Gebiet liegt.

Sind Heiligabend und Silvester Feiertage?

Nein, beide sind keine gesetzlichen Feiertage. Ob frei ist, regeln Vertrag oder Tarif.

Wie weit im Voraus gibt es Feiertage?

Bis 2035. Neue einmalige Feiertage trägt der wöchentliche Prüflauf nach, sobald ein Land sie beschlossen hat.

Verwendete Datensätze

Verwandte Anwendungsfälle