NonWorkTimeBlockingPeriod

Personal5 EndpunkteTimeTracking / NonWorkTimeBlockingPeriod

Diese Methode liefert alle NonWorkTimeBlockingPeriod-Objekte

GET/api/time/non_work_time_blocking_period

Query-Parameter

`id`integer
`deleted`boolean	Diese Eigenschaft markiert eine Entität als gelöscht / archiviert \| Benötigtes Zugriffsrecht: SCOPE \| Standardwert: false
`name`string
`mode`string
`scope`string
`maxDaysPerYear`string	Tage pro Kalenderjahr, die innerhalb dieses Zeitraums noch genommen werden dürfen, bevor er überhaupt etwas entscheidet. null hält den Zeitraum absolut - das bisherige und weiterhin voreingestellte Verhalten. Ein Wert macht den Zeitraum von einer Wand zu einem Kontingent: "höchstens sieben Tage außerhalb der Schulferien" ist ein Zeitraum über das ganze Jahr mit einer Quote von sieben, nicht sieben einzelne Regeln. \| Erfordert Zugriffs-Tag: SCOPE
`quotaScope`string	Welche Tage innerhalb des Zeitraums auf das Kontingent angerechnet werden. Nur zusammen mit maxDaysPerYear sinnvoll. \| Erforderliches Zugriffsrecht: SCOPE
`requiresConsultation`boolean	Tage, die dieser Zeitraum umfasst (z. B. außerhalb der Schulferien), dürfen nur nach einer Rücksprache mit der zuständigen Teamleitung beantragt werden; der Antrag muss sie nennen (U14). \| Erfordert Zugriffs-Tag: SCOPE
`cancellationQuotaDays`string	U21: wie viele bereits genehmigte Abwesenheitstage eine Person innerhalb dieses Zeitraums pro Jahr wieder zurückziehen darf (z. B. zwei Tage der Sommerschließung). null = keine Begrenzung. \| Benötigt Zugriffsrecht: SCOPE
`cancellationRequiresWrittenApproval`boolean	U21: das Zurückziehen genehmigter Tage innerhalb dieses Zeitraums erfordert die schriftliche Entscheidung des Schritts der Geschäftsführung (Kommentar Pflicht). \| Benötigt Zugriffsrecht: SCOPE
`start`string	Erster gesperrter Tag (einschließlich). \| Benötigt Zugriffsrecht: SCOPE
`end`string	Letzter gesperrter Tag (einschließlich) - eine eintägige Sperre hat Beginn = Ende. \| Benötigt Zugriffs-Tag: SCOPE
`employmentContractGroup`string
`employmentOrganization`string	Sind alle drei Referenzen leer, gilt der Zeitraum für alle.
`contract`string
`searchString`string	Text, nach dem in der Liste gesucht wird
`orderFieldName`string	Name des Bestellfelds
`orderFieldSort`string	SortiermodusErlaubt: `DESCASC`
`page`integer	Seite der Liste
`pageSize`integer	Anzahl der Einträge je Seite
`withMaxPageNumber`string	gibt die Anzahl verfügbarer Seiten als Header zurück, wenn dies gesetzt ist

Antworten

200Liefert eine Liste der NonWorkTimeBlockingPeriod-Objekte.array<NonWorkTimeBlockingPeriod>

Felder anzeigen (19)

levelinteger
Wie eng der Zeitraum ist. Die engste Ebene mit einem passenden Zeitraum entscheidet, sodass ein einzelner Vertrag eine Ausnahme tragen kann, ohne die Gruppen- oder Organisationsregel, unter der er steht, zu berühren.
idinteger
Primärschlüssel des Sperrzeitraums. Interne ID.
startstring (date-time)
Erster gesperrter Tag (einschließlich).
endstring (date-time)
Letzter gesperrter Tag (einschließlich) - eine eintägige Sperre hat Beginn = Ende.
modestring
Art der Sperrfrist, zum Beispiel block oder warn.
scopestring
Geltungsbereich der Sperrzeit, zum Beispiel Gruppe oder Vertrag.
max_days_per_yearinteger
Tage pro Kalenderjahr, die innerhalb dieses Zeitraums noch genommen werden dürfen, bevor er überhaupt etwas entscheidet. null hält den Zeitraum absolut - das bisherige und weiterhin voreingestellte Verhalten. Ein Wert macht den Zeitraum von einer Wand zu einem Kontingent: "höchstens sieben Tage außerhalb der Schulferien" ist ein Zeitraum über das ganze Jahr mit einer Quote von sieben, nicht sieben einzelne Regeln.
quota_scopestring
Welche Tage innerhalb des Zeitraums auf das Kontingent angerechnet werden. Nur zusammen mit maxDaysPerYear sinnvoll.
requires_consultationboolean
Tage, die dieser Zeitraum umfasst (z. B. außerhalb der Schulferien), dürfen nur nach einer Rücksprache mit der zuständigen Teamleitung beantragt werden; der Antrag muss sie nennen (U14).
cancellation_quota_daysinteger
U21: wie viele bereits genehmigte Abwesenheitstage eine Person innerhalb dieses Zeitraums pro Jahr wieder zurückziehen darf (z. B. zwei Tage der Sommerschließung). null = keine Begrenzung.
cancellation_requires_written_approvalboolean
U21: das Zurückziehen genehmigter Tage innerhalb dieses Zeitraums erfordert die schriftliche Entscheidung des Schritts der Geschäftsführung (Kommentar Pflicht).
employment_organizationEmploymentOrganization
Sind alle drei Referenzen leer, gilt der Zeitraum für alle.
Felder anzeigen (12)
- staged_absence_approvalboolean
  null übernimmt die Organisationsrichtlinie (Verträge); bestehende Installationen bleiben aus.
- idinteger
  Primärschlüssel der Beschäftigungsorganisation. Interne ID.
- allow_app_time_trackingboolean
  Ob die Zeiterfassung in der App erlaubt ist.
- school_holiday_regionSchoolHolidayRegion
  U09: der Schulkalender (Bundesland) dieser Organisation; Gruppen dürfen ihn überschreiben.
- organization_unitOrganizationUnit4
  L01: der Knoten des Organisationsbaums, an dem diese Organisation hängt (Einrichtung, Bereich, Geschäftsstelle ...). Leitende dieses Knotens und der darüberliegenden Knoten leiten auch diese Organisation.
- shift_booking_syncboolean
  L35: veröffentlichte Schichten der Personen dieser Organisation erscheinen als Verfügbarkeiten im Event-/Buchungsbereich, und eine Schicht kann in einen Termin umgewandelt werden. null = aus.
- allow_scanner_time_trackingboolean
  Ob die Zeiterfassung per Scanner erlaubt ist.
- allow_app_non_work_time_managementboolean
  Ob arbeitsfreie Zeit in der App verwaltet werden kann.
- include_in_auto_exportboolean
  Ob die Organisation in den automatischen Export einbezogen wird.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
employment_contract_groupEmploymentContractGroup
Vertragsgruppe, für die die Sperrzeit gilt.
Felder anzeigen (25)
- staged_absence_approvalboolean
  null übernimmt die Organisation; false deaktiviert die gestufte Freigabe ausdrücklich.
- shift_booking_syncboolean
  L35: Schichten als Verfügbarkeiten / Termine im Buchungsbereich; null übernimmt die Organisation, false schaltet es für diese Gruppe aus.
- idinteger
  Primärschlüssel der Vertragsgruppe. Interne ID.
- week_total_hoursnumber (float)
  Gesamte Arbeitsstunden pro Woche.
- week_total_daysnumber (float)
  Arbeitstage pro Woche.
- year_vacation_daysnumber (float)
  Urlaubstage pro Jahr.
- month_vacation_daysnumber (float)
  Urlaubstage pro Monat.
- year_vacation_weeksnumber (float)
  Urlaubswochen pro Jahr.
- monday_hoursnumber (float)
  Arbeitsstunden am Montag.
- tuesday_hoursnumber (float)
  Arbeitsstunden am Dienstag.
- wednesday_hoursnumber (float)
  Arbeitsstunden am Mittwoch.
- thursday_hoursnumber (float)
  Arbeitsstunden am Donnerstag.
- friday_hoursnumber (float)
  Arbeitsstunden am Freitag.
- saturday_hoursnumber (float)
  Arbeitsstunden am Samstag.
- sunday_hoursnumber (float)
  Arbeitsstunden am Sonntag.
- netto_hour_costnumber (float)
  Nettokosten je Stunde.
- brutto_hour_costnumber (float)
  Bruttokosten pro Stunde.
- allow_app_time_trackingboolean
  Ob die Zeiterfassung in der App erlaubt ist.
- allow_scanner_time_trackingboolean
  Ob die Zeiterfassung per Scanner erlaubt ist.
- allow_app_non_work_time_managementboolean
  Ob arbeitsfreie Zeit in der App verwaltet werden kann.
- request_lead_time_daysinteger
  Tage, die ein Abwesenheitsantrag dieser Gruppe vor seinem ersten Tag eingereicht werden muss. null greift auf die installationsweite Einstellung zurück – eine bestehende Gruppe verhält sich daher weiterhin genauso wie bisher.
- school_holiday_regionSchoolHolidayRegion
  U09: der Schulkalender dieser Gruppe, wenn er vom Kalender der Organisation abweicht (Auszubildende, die in einem anderen Bundesland zur Schule gehen). null = der der Organisation.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.
contractEmploymentContract
Vertrag, für den die Sperrzeit gilt.
Felder anzeigen (43)
- staged_absence_approvalboolean
  null übernimmt zuerst die Gruppen- und dann die Organisationsrichtlinie; bestehende Installationen bleiben aus.
- idinteger
  Primärschlüssel des Arbeitsvertrags. Interne ID.
- tokenstring
  Öffentlicher Token des Vertrags. Anstelle der ID verwendet.
- userUser14
  Benutzer des Mitarbeiters.
- week_total_hoursnumber (float)
  Gesamte Arbeitsstunden pro Woche.
- week_total_daysnumber (float)
  Gesamte Arbeitstage pro Woche.
- reserved_hours_preparationnumber (float)
  L03: wöchentliche Stunden, die für Vorbereitung reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- reserved_hours_follow_upnumber (float)
  L03: wöchentliche Stunden, die für Nachbereitung reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- reserved_hours_travelnumber (float)
  L03: wöchentliche Stunden, die für Fahrt reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- reserved_hours_flexiblenumber (float)
  L03: wöchentliche Stunden, die für freie Einteilung reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- week_full_time_total_daysnumber (float)
  Gesamte Arbeitstage pro Woche bei einem Vollzeitvertrag.
- year_vacation_daysnumber (float)
  Urlaubstage pro Jahr.
- month_vacation_daysnumber (float)
  Urlaubstage pro Monat.
- year_vacation_weeksnumber (float)
  Urlaubswochen pro Jahr.
- monday_hoursnumber (float)
  Arbeitsstunden am Montag.
- tuesday_hoursnumber (float)
  Arbeitsstunden am Dienstag.
- wednesday_hoursnumber (float)
  Arbeitsstunden am Mittwoch.
- thursday_hoursnumber (float)
  Arbeitsstunden am Donnerstag.
- friday_hoursnumber (float)
  Arbeitsstunden am Freitag.
- saturday_hoursnumber (float)
  Arbeitsstunden am Samstag.
- sunday_hoursnumber (float)
  Arbeitsstunden am Sonntag.
- netto_hour_costnumber (float)
  Nettokosten je Stunde.
- brutto_hour_costnumber (float)
  Bruttokosten pro Stunde.
- startstring (date-time)
  Startdatum des Vertrags.
- endstring (date-time)
  Enddatum des Vertrags.
- fixed_term_statusstring
  Befristung: PERMANENT (unbefristet, Standard), FIXED_TERM oder EXTENDED (FIXED_TERM_STATUS_*).
- fixed_term_endstring (date-time)
  Befristet bis (erster Zeitraum).
- fixed_term_extension_endstring (date-time)
  Befristet bis nach Verlängerung.
- probation_endstring (date-time)
  Probezeit bis; wird aus den probationMonths der Vorlage gefüllt, wenn ein Vertrag ohne diese Angabe angelegt wird.
- numberstring
  Vertragsnummer.
- descriptionstring
  Beschreibung des Vertrags.
- archivedboolean
  Der Vertrag ist archiviert.
- allow_app_time_trackingboolean
  Der Mitarbeitende darf Zeiten in der App erfassen.
- allow_scanner_time_trackingboolean
  Der Mitarbeitende darf Zeiten mit dem Scanner erfassen.
- allow_app_non_work_time_managementboolean
  Der Mitarbeitende darf Abwesenheiten in der App verwalten.
- force_no_auto_breakboolean
  Für diesen Vertrag werden keine automatischen Pausen hinzugefügt.
- work_time_modestring
  Wie die Sollarbeitszeit definiert ist - null verhält sich wie WEEKDAY_HOURS, damit bestehende Verträge ihr bisheriges Verhalten unverändert beibehalten.
- holiday_credit_modestring
  Feiertagsguthaben für WEEK_TOTAL-Verträge - null verhält sich wie WEEKDAY_TARGET (bisheriges Verhalten, nur bei WEEKDAY_HOURS-Verträgen sinnvoll).
- holiday_credit_fixed_secondsinteger
  Fester Feiertagsguthaben in Sekunden.
- planning_weekdays_bitmaskinteger
  ISO-Wochentagsbitmaske (Mo=1 ... So=64) der Tage, an denen dieser WEEK_TOTAL-Vertrag eingeplant werden bzw. Urlaub nehmen kann - null verhält sich wie Mo-Fr.
- request_lead_time_daysinteger
  Tage, die ein Abwesenheitsantrag vor seinem ersten Tag eingereicht werden muss ("Bearbeitungs- frist"). null greift zunächst auf die Vertragsgruppe und von dort auf die Einstellung der Installation zurück, damit ein bestehender Vertrag genau wie bisher funktioniert.
- shift_booking_syncboolean
  L35: Schichten als Verfügbarkeiten / Termine im Buchungsbereich; null übernimmt die Gruppe (die wiederum die Organisation übernimmt).
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
deletedboolean
Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestring
Name der Einheit.
createdstring (date-time)
Zeitpunkt, zu dem der Datensatz angelegt wurde.
updatedstring (date-time)
Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage

curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period \
  --header 'x-iw-jwt-token: <TOKEN>'

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/non_work_time_blocking_period_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await NonWorkTimeBlockingPeriodController.getAll();
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

[
  {
    "id": 42,
    "name": "Beispiel",
    "level": 1,
    "start": "2026-10-15T09:30:00+02:00",
    "end": "2026-10-15T09:30:00+02:00",
    "mode": "string",
    "scope": "string",
    "max_days_per_year": 1,
    "quota_scope": "string",
    "requires_consultation": true
  }
]

NonWorkTimeBlockingPeriod neu anlegen

POST/api/time/non_work_time_blocking_period

Request-Body application/json

dataNonWorkTimeBlockingPeriod2
Felder anzeigen (11)
- startstring (date-time)
  Erster gesperrter Tag (einschließlich).
- endstring (date-time)
  Letzter gesperrter Tag (einschließlich) - eine eintägige Sperre hat Beginn = Ende.
- modestring
  Art der Sperrfrist, zum Beispiel block oder warn.
- scopestring
  Geltungsbereich der Sperrzeit, zum Beispiel Gruppe oder Vertrag.
- max_days_per_yearinteger
  Tage pro Kalenderjahr, die innerhalb dieses Zeitraums noch genommen werden dürfen, bevor er überhaupt etwas entscheidet. null hält den Zeitraum absolut - das bisherige und weiterhin voreingestellte Verhalten. Ein Wert macht den Zeitraum von einer Wand zu einem Kontingent: "höchstens sieben Tage außerhalb der Schulferien" ist ein Zeitraum über das ganze Jahr mit einer Quote von sieben, nicht sieben einzelne Regeln.
- quota_scopestring
  Welche Tage innerhalb des Zeitraums auf das Kontingent angerechnet werden. Nur zusammen mit maxDaysPerYear sinnvoll.
- requires_consultationboolean
  Tage, die dieser Zeitraum umfasst (z. B. außerhalb der Schulferien), dürfen nur nach einer Rücksprache mit der zuständigen Teamleitung beantragt werden; der Antrag muss sie nennen (U14).
- cancellation_quota_daysinteger
  U21: wie viele bereits genehmigte Abwesenheitstage eine Person innerhalb dieses Zeitraums pro Jahr wieder zurückziehen darf (z. B. zwei Tage der Sommerschließung). null = keine Begrenzung.
- cancellation_requires_written_approvalboolean
  U21: das Zurückziehen genehmigter Tage innerhalb dieses Zeitraums erfordert die schriftliche Entscheidung des Schritts der Geschäftsführung (Kommentar Pflicht).
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.

Antworten

200NonWorkTimeBlockingPeriod neu anlegenNonWorkTimeBlockingPeriod3

Felder anzeigen (19)

levelinteger
Wie eng der Zeitraum ist. Die engste Ebene mit einem passenden Zeitraum entscheidet, sodass ein einzelner Vertrag eine Ausnahme tragen kann, ohne die Gruppen- oder Organisationsregel, unter der er steht, zu berühren.
idinteger
Primärschlüssel des Sperrzeitraums. Interne ID.
startstring (date-time)
Erster gesperrter Tag (einschließlich).
endstring (date-time)
Letzter gesperrter Tag (einschließlich) - eine eintägige Sperre hat Beginn = Ende.
modestring
Art der Sperrfrist, zum Beispiel block oder warn.
scopestring
Geltungsbereich der Sperrzeit, zum Beispiel Gruppe oder Vertrag.
max_days_per_yearinteger
Tage pro Kalenderjahr, die innerhalb dieses Zeitraums noch genommen werden dürfen, bevor er überhaupt etwas entscheidet. null hält den Zeitraum absolut - das bisherige und weiterhin voreingestellte Verhalten. Ein Wert macht den Zeitraum von einer Wand zu einem Kontingent: "höchstens sieben Tage außerhalb der Schulferien" ist ein Zeitraum über das ganze Jahr mit einer Quote von sieben, nicht sieben einzelne Regeln.
quota_scopestring
Welche Tage innerhalb des Zeitraums auf das Kontingent angerechnet werden. Nur zusammen mit maxDaysPerYear sinnvoll.
requires_consultationboolean
Tage, die dieser Zeitraum umfasst (z. B. außerhalb der Schulferien), dürfen nur nach einer Rücksprache mit der zuständigen Teamleitung beantragt werden; der Antrag muss sie nennen (U14).
cancellation_quota_daysinteger
U21: wie viele bereits genehmigte Abwesenheitstage eine Person innerhalb dieses Zeitraums pro Jahr wieder zurückziehen darf (z. B. zwei Tage der Sommerschließung). null = keine Begrenzung.
cancellation_requires_written_approvalboolean
U21: das Zurückziehen genehmigter Tage innerhalb dieses Zeitraums erfordert die schriftliche Entscheidung des Schritts der Geschäftsführung (Kommentar Pflicht).
employment_organizationEmploymentOrganization2
Sind alle drei Referenzen leer, gilt der Zeitraum für alle.
Felder anzeigen (12)
- staged_absence_approvalboolean
  null übernimmt die Organisationsrichtlinie (Verträge); bestehende Installationen bleiben aus.
- idinteger
  Primärschlüssel der Beschäftigungsorganisation. Interne ID.
- allow_app_time_trackingboolean
  Ob die Zeiterfassung in der App erlaubt ist.
- school_holiday_regionSchoolHolidayRegion
  U09: der Schulkalender (Bundesland) dieser Organisation; Gruppen dürfen ihn überschreiben.
- organization_unitOrganizationUnit5
  L01: der Knoten des Organisationsbaums, an dem diese Organisation hängt (Einrichtung, Bereich, Geschäftsstelle ...). Leitende dieses Knotens und der darüberliegenden Knoten leiten auch diese Organisation.
- shift_booking_syncboolean
  L35: veröffentlichte Schichten der Personen dieser Organisation erscheinen als Verfügbarkeiten im Event-/Buchungsbereich, und eine Schicht kann in einen Termin umgewandelt werden. null = aus.
- allow_scanner_time_trackingboolean
  Ob die Zeiterfassung per Scanner erlaubt ist.
- allow_app_non_work_time_managementboolean
  Ob arbeitsfreie Zeit in der App verwaltet werden kann.
- include_in_auto_exportboolean
  Ob die Organisation in den automatischen Export einbezogen wird.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
employment_contract_groupEmploymentContractGroup
Vertragsgruppe, für die die Sperrzeit gilt.
Felder anzeigen (25)
- staged_absence_approvalboolean
  null übernimmt die Organisation; false deaktiviert die gestufte Freigabe ausdrücklich.
- shift_booking_syncboolean
  L35: Schichten als Verfügbarkeiten / Termine im Buchungsbereich; null übernimmt die Organisation, false schaltet es für diese Gruppe aus.
- idinteger
  Primärschlüssel der Vertragsgruppe. Interne ID.
- week_total_hoursnumber (float)
  Gesamte Arbeitsstunden pro Woche.
- week_total_daysnumber (float)
  Arbeitstage pro Woche.
- year_vacation_daysnumber (float)
  Urlaubstage pro Jahr.
- month_vacation_daysnumber (float)
  Urlaubstage pro Monat.
- year_vacation_weeksnumber (float)
  Urlaubswochen pro Jahr.
- monday_hoursnumber (float)
  Arbeitsstunden am Montag.
- tuesday_hoursnumber (float)
  Arbeitsstunden am Dienstag.
- wednesday_hoursnumber (float)
  Arbeitsstunden am Mittwoch.
- thursday_hoursnumber (float)
  Arbeitsstunden am Donnerstag.
- friday_hoursnumber (float)
  Arbeitsstunden am Freitag.
- saturday_hoursnumber (float)
  Arbeitsstunden am Samstag.
- sunday_hoursnumber (float)
  Arbeitsstunden am Sonntag.
- netto_hour_costnumber (float)
  Nettokosten je Stunde.
- brutto_hour_costnumber (float)
  Bruttokosten pro Stunde.
- allow_app_time_trackingboolean
  Ob die Zeiterfassung in der App erlaubt ist.
- allow_scanner_time_trackingboolean
  Ob die Zeiterfassung per Scanner erlaubt ist.
- allow_app_non_work_time_managementboolean
  Ob arbeitsfreie Zeit in der App verwaltet werden kann.
- request_lead_time_daysinteger
  Tage, die ein Abwesenheitsantrag dieser Gruppe vor seinem ersten Tag eingereicht werden muss. null greift auf die installationsweite Einstellung zurück – eine bestehende Gruppe verhält sich daher weiterhin genauso wie bisher.
- school_holiday_regionSchoolHolidayRegion
  U09: der Schulkalender dieser Gruppe, wenn er vom Kalender der Organisation abweicht (Auszubildende, die in einem anderen Bundesland zur Schule gehen). null = der der Organisation.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.
contractEmploymentContract2
Vertrag, für den die Sperrzeit gilt.
Felder anzeigen (43)
- staged_absence_approvalboolean
  null übernimmt zuerst die Gruppen- und dann die Organisationsrichtlinie; bestehende Installationen bleiben aus.
- idinteger
  Primärschlüssel des Arbeitsvertrags. Interne ID.
- tokenstring
  Öffentlicher Token des Vertrags. Anstelle der ID verwendet.
- userUser14
  Benutzer des Mitarbeiters.
- week_total_hoursnumber (float)
  Gesamte Arbeitsstunden pro Woche.
- week_total_daysnumber (float)
  Gesamte Arbeitstage pro Woche.
- reserved_hours_preparationnumber (float)
  L03: wöchentliche Stunden, die für Vorbereitung reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- reserved_hours_follow_upnumber (float)
  L03: wöchentliche Stunden, die für Nachbereitung reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- reserved_hours_travelnumber (float)
  L03: wöchentliche Stunden, die für Fahrt reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- reserved_hours_flexiblenumber (float)
  L03: wöchentliche Stunden, die für freie Einteilung reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- week_full_time_total_daysnumber (float)
  Gesamte Arbeitstage pro Woche bei einem Vollzeitvertrag.
- year_vacation_daysnumber (float)
  Urlaubstage pro Jahr.
- month_vacation_daysnumber (float)
  Urlaubstage pro Monat.
- year_vacation_weeksnumber (float)
  Urlaubswochen pro Jahr.
- monday_hoursnumber (float)
  Arbeitsstunden am Montag.
- tuesday_hoursnumber (float)
  Arbeitsstunden am Dienstag.
- wednesday_hoursnumber (float)
  Arbeitsstunden am Mittwoch.
- thursday_hoursnumber (float)
  Arbeitsstunden am Donnerstag.
- friday_hoursnumber (float)
  Arbeitsstunden am Freitag.
- saturday_hoursnumber (float)
  Arbeitsstunden am Samstag.
- sunday_hoursnumber (float)
  Arbeitsstunden am Sonntag.
- netto_hour_costnumber (float)
  Nettokosten je Stunde.
- brutto_hour_costnumber (float)
  Bruttokosten pro Stunde.
- startstring (date-time)
  Startdatum des Vertrags.
- endstring (date-time)
  Enddatum des Vertrags.
- fixed_term_statusstring
  Befristung: PERMANENT (unbefristet, Standard), FIXED_TERM oder EXTENDED (FIXED_TERM_STATUS_*).
- fixed_term_endstring (date-time)
  Befristet bis (erster Zeitraum).
- fixed_term_extension_endstring (date-time)
  Befristet bis nach Verlängerung.
- probation_endstring (date-time)
  Probezeit bis; wird aus den probationMonths der Vorlage gefüllt, wenn ein Vertrag ohne diese Angabe angelegt wird.
- numberstring
  Vertragsnummer.
- descriptionstring
  Beschreibung des Vertrags.
- archivedboolean
  Der Vertrag ist archiviert.
- allow_app_time_trackingboolean
  Der Mitarbeitende darf Zeiten in der App erfassen.
- allow_scanner_time_trackingboolean
  Der Mitarbeitende darf Zeiten mit dem Scanner erfassen.
- allow_app_non_work_time_managementboolean
  Der Mitarbeitende darf Abwesenheiten in der App verwalten.
- force_no_auto_breakboolean
  Für diesen Vertrag werden keine automatischen Pausen hinzugefügt.
- work_time_modestring
  Wie die Sollarbeitszeit definiert ist - null verhält sich wie WEEKDAY_HOURS, damit bestehende Verträge ihr bisheriges Verhalten unverändert beibehalten.
- holiday_credit_modestring
  Feiertagsguthaben für WEEK_TOTAL-Verträge - null verhält sich wie WEEKDAY_TARGET (bisheriges Verhalten, nur bei WEEKDAY_HOURS-Verträgen sinnvoll).
- holiday_credit_fixed_secondsinteger
  Fester Feiertagsguthaben in Sekunden.
- planning_weekdays_bitmaskinteger
  ISO-Wochentagsbitmaske (Mo=1 ... So=64) der Tage, an denen dieser WEEK_TOTAL-Vertrag eingeplant werden bzw. Urlaub nehmen kann - null verhält sich wie Mo-Fr.
- request_lead_time_daysinteger
  Tage, die ein Abwesenheitsantrag vor seinem ersten Tag eingereicht werden muss ("Bearbeitungs- frist"). null greift zunächst auf die Vertragsgruppe und von dort auf die Einstellung der Installation zurück, damit ein bestehender Vertrag genau wie bisher funktioniert.
- shift_booking_syncboolean
  L35: Schichten als Verfügbarkeiten / Termine im Buchungsbereich; null übernimmt die Gruppe (die wiederum die Organisation übernimmt).
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
deletedboolean
Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestring
Name der Einheit.
createdstring (date-time)
Zeitpunkt, zu dem der Datensatz angelegt wurde.
updatedstring (date-time)
Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage

curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "name": "Beispiel",
    "start": "2026-10-15T09:30:00+02:00",
    "end": "2026-10-15T09:30:00+02:00",
    "mode": "string",
    "scope": "string",
    "max_days_per_year": 1
  }
}
'

const options = {
  method: 'POST',
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: JSON.stringify({
    data: {
      name: 'Beispiel',
      start: '2026-10-15T09:30:00+02:00',
      end: '2026-10-15T09:30:00+02:00',
      mode: 'string',
      scope: 'string',
      max_days_per_year: 1
    }
  })
};

fetch('https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period"

payload = { "data": {
    "name": "Beispiel",
    "start": "2026-10-15T09:30:00+02:00",
    "end": "2026-10-15T09:30:00+02:00",
    "mode": "string",
    "scope": "string",
    "max_days_per_year": 1
  } }
headers = {
  "x-iw-jwt-token": "<TOKEN>",
  "content-type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period', [
  'body' => '{"data":{"name":"Beispiel","start":"2026-10-15T09:30:00+02:00","end":"2026-10-15T09:30:00+02:00","mode":"string","scope":"string","max_days_per_year":1}}',
  'headers' => [
    'content-type' => 'application/json',
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
  Content = new StringContent("{\"data\":{\"name\":\"Beispiel\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"mode\":\"string\",\"scope\":\"string\",\"max_days_per_year\":1}}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"data\":{\"name\":\"Beispiel\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"mode\":\"string\",\"scope\":\"string\",\"max_days_per_year\":1}}");
Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period")
  .post(body)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period"

	payload := strings.NewReader("{\"data\":{\"name\":\"Beispiel\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"mode\":\"string\",\"scope\":\"string\",\"max_days_per_year\":1}}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")
	req.Header.Add("content-type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/non_work_time_blocking_period_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';
import 'package:iw_erp_api/model/non_work_time_blocking_period.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await NonWorkTimeBlockingPeriodController.post(NonWorkTimeBlockingPeriod.fromJson({
  "name": "Beispiel",
  "start": "2026-10-15T09:30:00+02:00",
  "end": "2026-10-15T09:30:00+02:00",
  "mode": "string",
  "scope": "string",
  "max_days_per_year": 1
}));
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "id": 42,
  "name": "Beispiel",
  "level": 1,
  "start": "2026-10-15T09:30:00+02:00",
  "end": "2026-10-15T09:30:00+02:00",
  "mode": "string",
  "scope": "string",
  "max_days_per_year": 1,
  "quota_scope": "string",
  "requires_consultation": true
}

Diese Methode liefert einen einzelnen NonWorkTimeBlockingPeriod mit der angegebenen ID

GET/api/time/non_work_time_blocking_period/{id}

Pfad-Parameter

idPflichtstring

Antworten

200Liefert ein einzelnes NonWorkTimeBlockingPeriod-Objekt.NonWorkTimeBlockingPeriod3

Felder anzeigen (19)

levelinteger
Wie eng der Zeitraum ist. Die engste Ebene mit einem passenden Zeitraum entscheidet, sodass ein einzelner Vertrag eine Ausnahme tragen kann, ohne die Gruppen- oder Organisationsregel, unter der er steht, zu berühren.
idinteger
Primärschlüssel des Sperrzeitraums. Interne ID.
startstring (date-time)
Erster gesperrter Tag (einschließlich).
endstring (date-time)
Letzter gesperrter Tag (einschließlich) - eine eintägige Sperre hat Beginn = Ende.
modestring
Art der Sperrfrist, zum Beispiel block oder warn.
scopestring
Geltungsbereich der Sperrzeit, zum Beispiel Gruppe oder Vertrag.
max_days_per_yearinteger
Tage pro Kalenderjahr, die innerhalb dieses Zeitraums noch genommen werden dürfen, bevor er überhaupt etwas entscheidet. null hält den Zeitraum absolut - das bisherige und weiterhin voreingestellte Verhalten. Ein Wert macht den Zeitraum von einer Wand zu einem Kontingent: "höchstens sieben Tage außerhalb der Schulferien" ist ein Zeitraum über das ganze Jahr mit einer Quote von sieben, nicht sieben einzelne Regeln.
quota_scopestring
Welche Tage innerhalb des Zeitraums auf das Kontingent angerechnet werden. Nur zusammen mit maxDaysPerYear sinnvoll.
requires_consultationboolean
Tage, die dieser Zeitraum umfasst (z. B. außerhalb der Schulferien), dürfen nur nach einer Rücksprache mit der zuständigen Teamleitung beantragt werden; der Antrag muss sie nennen (U14).
cancellation_quota_daysinteger
U21: wie viele bereits genehmigte Abwesenheitstage eine Person innerhalb dieses Zeitraums pro Jahr wieder zurückziehen darf (z. B. zwei Tage der Sommerschließung). null = keine Begrenzung.
cancellation_requires_written_approvalboolean
U21: das Zurückziehen genehmigter Tage innerhalb dieses Zeitraums erfordert die schriftliche Entscheidung des Schritts der Geschäftsführung (Kommentar Pflicht).
employment_organizationEmploymentOrganization2
Sind alle drei Referenzen leer, gilt der Zeitraum für alle.
Felder anzeigen (12)
- staged_absence_approvalboolean
  null übernimmt die Organisationsrichtlinie (Verträge); bestehende Installationen bleiben aus.
- idinteger
  Primärschlüssel der Beschäftigungsorganisation. Interne ID.
- allow_app_time_trackingboolean
  Ob die Zeiterfassung in der App erlaubt ist.
- school_holiday_regionSchoolHolidayRegion
  U09: der Schulkalender (Bundesland) dieser Organisation; Gruppen dürfen ihn überschreiben.
- organization_unitOrganizationUnit5
  L01: der Knoten des Organisationsbaums, an dem diese Organisation hängt (Einrichtung, Bereich, Geschäftsstelle ...). Leitende dieses Knotens und der darüberliegenden Knoten leiten auch diese Organisation.
- shift_booking_syncboolean
  L35: veröffentlichte Schichten der Personen dieser Organisation erscheinen als Verfügbarkeiten im Event-/Buchungsbereich, und eine Schicht kann in einen Termin umgewandelt werden. null = aus.
- allow_scanner_time_trackingboolean
  Ob die Zeiterfassung per Scanner erlaubt ist.
- allow_app_non_work_time_managementboolean
  Ob arbeitsfreie Zeit in der App verwaltet werden kann.
- include_in_auto_exportboolean
  Ob die Organisation in den automatischen Export einbezogen wird.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
employment_contract_groupEmploymentContractGroup
Vertragsgruppe, für die die Sperrzeit gilt.
Felder anzeigen (25)
- staged_absence_approvalboolean
  null übernimmt die Organisation; false deaktiviert die gestufte Freigabe ausdrücklich.
- shift_booking_syncboolean
  L35: Schichten als Verfügbarkeiten / Termine im Buchungsbereich; null übernimmt die Organisation, false schaltet es für diese Gruppe aus.
- idinteger
  Primärschlüssel der Vertragsgruppe. Interne ID.
- week_total_hoursnumber (float)
  Gesamte Arbeitsstunden pro Woche.
- week_total_daysnumber (float)
  Arbeitstage pro Woche.
- year_vacation_daysnumber (float)
  Urlaubstage pro Jahr.
- month_vacation_daysnumber (float)
  Urlaubstage pro Monat.
- year_vacation_weeksnumber (float)
  Urlaubswochen pro Jahr.
- monday_hoursnumber (float)
  Arbeitsstunden am Montag.
- tuesday_hoursnumber (float)
  Arbeitsstunden am Dienstag.
- wednesday_hoursnumber (float)
  Arbeitsstunden am Mittwoch.
- thursday_hoursnumber (float)
  Arbeitsstunden am Donnerstag.
- friday_hoursnumber (float)
  Arbeitsstunden am Freitag.
- saturday_hoursnumber (float)
  Arbeitsstunden am Samstag.
- sunday_hoursnumber (float)
  Arbeitsstunden am Sonntag.
- netto_hour_costnumber (float)
  Nettokosten je Stunde.
- brutto_hour_costnumber (float)
  Bruttokosten pro Stunde.
- allow_app_time_trackingboolean
  Ob die Zeiterfassung in der App erlaubt ist.
- allow_scanner_time_trackingboolean
  Ob die Zeiterfassung per Scanner erlaubt ist.
- allow_app_non_work_time_managementboolean
  Ob arbeitsfreie Zeit in der App verwaltet werden kann.
- request_lead_time_daysinteger
  Tage, die ein Abwesenheitsantrag dieser Gruppe vor seinem ersten Tag eingereicht werden muss. null greift auf die installationsweite Einstellung zurück – eine bestehende Gruppe verhält sich daher weiterhin genauso wie bisher.
- school_holiday_regionSchoolHolidayRegion
  U09: der Schulkalender dieser Gruppe, wenn er vom Kalender der Organisation abweicht (Auszubildende, die in einem anderen Bundesland zur Schule gehen). null = der der Organisation.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.
contractEmploymentContract2
Vertrag, für den die Sperrzeit gilt.
Felder anzeigen (43)
- staged_absence_approvalboolean
  null übernimmt zuerst die Gruppen- und dann die Organisationsrichtlinie; bestehende Installationen bleiben aus.
- idinteger
  Primärschlüssel des Arbeitsvertrags. Interne ID.
- tokenstring
  Öffentlicher Token des Vertrags. Anstelle der ID verwendet.
- userUser14
  Benutzer des Mitarbeiters.
- week_total_hoursnumber (float)
  Gesamte Arbeitsstunden pro Woche.
- week_total_daysnumber (float)
  Gesamte Arbeitstage pro Woche.
- reserved_hours_preparationnumber (float)
  L03: wöchentliche Stunden, die für Vorbereitung reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- reserved_hours_follow_upnumber (float)
  L03: wöchentliche Stunden, die für Nachbereitung reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- reserved_hours_travelnumber (float)
  L03: wöchentliche Stunden, die für Fahrt reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- reserved_hours_flexiblenumber (float)
  L03: wöchentliche Stunden, die für freie Einteilung reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- week_full_time_total_daysnumber (float)
  Gesamte Arbeitstage pro Woche bei einem Vollzeitvertrag.
- year_vacation_daysnumber (float)
  Urlaubstage pro Jahr.
- month_vacation_daysnumber (float)
  Urlaubstage pro Monat.
- year_vacation_weeksnumber (float)
  Urlaubswochen pro Jahr.
- monday_hoursnumber (float)
  Arbeitsstunden am Montag.
- tuesday_hoursnumber (float)
  Arbeitsstunden am Dienstag.
- wednesday_hoursnumber (float)
  Arbeitsstunden am Mittwoch.
- thursday_hoursnumber (float)
  Arbeitsstunden am Donnerstag.
- friday_hoursnumber (float)
  Arbeitsstunden am Freitag.
- saturday_hoursnumber (float)
  Arbeitsstunden am Samstag.
- sunday_hoursnumber (float)
  Arbeitsstunden am Sonntag.
- netto_hour_costnumber (float)
  Nettokosten je Stunde.
- brutto_hour_costnumber (float)
  Bruttokosten pro Stunde.
- startstring (date-time)
  Startdatum des Vertrags.
- endstring (date-time)
  Enddatum des Vertrags.
- fixed_term_statusstring
  Befristung: PERMANENT (unbefristet, Standard), FIXED_TERM oder EXTENDED (FIXED_TERM_STATUS_*).
- fixed_term_endstring (date-time)
  Befristet bis (erster Zeitraum).
- fixed_term_extension_endstring (date-time)
  Befristet bis nach Verlängerung.
- probation_endstring (date-time)
  Probezeit bis; wird aus den probationMonths der Vorlage gefüllt, wenn ein Vertrag ohne diese Angabe angelegt wird.
- numberstring
  Vertragsnummer.
- descriptionstring
  Beschreibung des Vertrags.
- archivedboolean
  Der Vertrag ist archiviert.
- allow_app_time_trackingboolean
  Der Mitarbeitende darf Zeiten in der App erfassen.
- allow_scanner_time_trackingboolean
  Der Mitarbeitende darf Zeiten mit dem Scanner erfassen.
- allow_app_non_work_time_managementboolean
  Der Mitarbeitende darf Abwesenheiten in der App verwalten.
- force_no_auto_breakboolean
  Für diesen Vertrag werden keine automatischen Pausen hinzugefügt.
- work_time_modestring
  Wie die Sollarbeitszeit definiert ist - null verhält sich wie WEEKDAY_HOURS, damit bestehende Verträge ihr bisheriges Verhalten unverändert beibehalten.
- holiday_credit_modestring
  Feiertagsguthaben für WEEK_TOTAL-Verträge - null verhält sich wie WEEKDAY_TARGET (bisheriges Verhalten, nur bei WEEKDAY_HOURS-Verträgen sinnvoll).
- holiday_credit_fixed_secondsinteger
  Fester Feiertagsguthaben in Sekunden.
- planning_weekdays_bitmaskinteger
  ISO-Wochentagsbitmaske (Mo=1 ... So=64) der Tage, an denen dieser WEEK_TOTAL-Vertrag eingeplant werden bzw. Urlaub nehmen kann - null verhält sich wie Mo-Fr.
- request_lead_time_daysinteger
  Tage, die ein Abwesenheitsantrag vor seinem ersten Tag eingereicht werden muss ("Bearbeitungs- frist"). null greift zunächst auf die Vertragsgruppe und von dort auf die Einstellung der Installation zurück, damit ein bestehender Vertrag genau wie bisher funktioniert.
- shift_booking_syncboolean
  L35: Schichten als Verfügbarkeiten / Termine im Buchungsbereich; null übernimmt die Gruppe (die wiederum die Organisation übernimmt).
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
deletedboolean
Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestring
Name der Einheit.
createdstring (date-time)
Zeitpunkt, zu dem der Datensatz angelegt wurde.
updatedstring (date-time)
Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage

curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42 \
  --header 'x-iw-jwt-token: <TOKEN>'

const options = {method: 'GET', headers: {'x-iw-jwt-token': '<TOKEN>'}};

fetch('https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42"

headers = {"x-iw-jwt-token": "<TOKEN>"}

response = requests.get(url, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42', [
  'headers' => [
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42")
  .get()
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/non_work_time_blocking_period_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await NonWorkTimeBlockingPeriodController.get('42');
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "id": 42,
  "name": "Beispiel",
  "level": 1,
  "start": "2026-10-15T09:30:00+02:00",
  "end": "2026-10-15T09:30:00+02:00",
  "mode": "string",
  "scope": "string",
  "max_days_per_year": 1,
  "quota_scope": "string",
  "requires_consultation": true
}

NonWorkTimeBlockingPeriod aktualisieren

PUT/api/time/non_work_time_blocking_period/{id}

Pfad-Parameter

idPflichtstring

Request-Body application/json

dataNonWorkTimeBlockingPeriod2
Felder anzeigen (11)
- startstring (date-time)
  Erster gesperrter Tag (einschließlich).
- endstring (date-time)
  Letzter gesperrter Tag (einschließlich) - eine eintägige Sperre hat Beginn = Ende.
- modestring
  Art der Sperrfrist, zum Beispiel block oder warn.
- scopestring
  Geltungsbereich der Sperrzeit, zum Beispiel Gruppe oder Vertrag.
- max_days_per_yearinteger
  Tage pro Kalenderjahr, die innerhalb dieses Zeitraums noch genommen werden dürfen, bevor er überhaupt etwas entscheidet. null hält den Zeitraum absolut - das bisherige und weiterhin voreingestellte Verhalten. Ein Wert macht den Zeitraum von einer Wand zu einem Kontingent: "höchstens sieben Tage außerhalb der Schulferien" ist ein Zeitraum über das ganze Jahr mit einer Quote von sieben, nicht sieben einzelne Regeln.
- quota_scopestring
  Welche Tage innerhalb des Zeitraums auf das Kontingent angerechnet werden. Nur zusammen mit maxDaysPerYear sinnvoll.
- requires_consultationboolean
  Tage, die dieser Zeitraum umfasst (z. B. außerhalb der Schulferien), dürfen nur nach einer Rücksprache mit der zuständigen Teamleitung beantragt werden; der Antrag muss sie nennen (U14).
- cancellation_quota_daysinteger
  U21: wie viele bereits genehmigte Abwesenheitstage eine Person innerhalb dieses Zeitraums pro Jahr wieder zurückziehen darf (z. B. zwei Tage der Sommerschließung). null = keine Begrenzung.
- cancellation_requires_written_approvalboolean
  U21: das Zurückziehen genehmigter Tage innerhalb dieses Zeitraums erfordert die schriftliche Entscheidung des Schritts der Geschäftsführung (Kommentar Pflicht).
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.

Antworten

200NonWorkTimeBlockingPeriod aktualisierenNonWorkTimeBlockingPeriod3

Felder anzeigen (19)

levelinteger
Wie eng der Zeitraum ist. Die engste Ebene mit einem passenden Zeitraum entscheidet, sodass ein einzelner Vertrag eine Ausnahme tragen kann, ohne die Gruppen- oder Organisationsregel, unter der er steht, zu berühren.
idinteger
Primärschlüssel des Sperrzeitraums. Interne ID.
startstring (date-time)
Erster gesperrter Tag (einschließlich).
endstring (date-time)
Letzter gesperrter Tag (einschließlich) - eine eintägige Sperre hat Beginn = Ende.
modestring
Art der Sperrfrist, zum Beispiel block oder warn.
scopestring
Geltungsbereich der Sperrzeit, zum Beispiel Gruppe oder Vertrag.
max_days_per_yearinteger
Tage pro Kalenderjahr, die innerhalb dieses Zeitraums noch genommen werden dürfen, bevor er überhaupt etwas entscheidet. null hält den Zeitraum absolut - das bisherige und weiterhin voreingestellte Verhalten. Ein Wert macht den Zeitraum von einer Wand zu einem Kontingent: "höchstens sieben Tage außerhalb der Schulferien" ist ein Zeitraum über das ganze Jahr mit einer Quote von sieben, nicht sieben einzelne Regeln.
quota_scopestring
Welche Tage innerhalb des Zeitraums auf das Kontingent angerechnet werden. Nur zusammen mit maxDaysPerYear sinnvoll.
requires_consultationboolean
Tage, die dieser Zeitraum umfasst (z. B. außerhalb der Schulferien), dürfen nur nach einer Rücksprache mit der zuständigen Teamleitung beantragt werden; der Antrag muss sie nennen (U14).
cancellation_quota_daysinteger
U21: wie viele bereits genehmigte Abwesenheitstage eine Person innerhalb dieses Zeitraums pro Jahr wieder zurückziehen darf (z. B. zwei Tage der Sommerschließung). null = keine Begrenzung.
cancellation_requires_written_approvalboolean
U21: das Zurückziehen genehmigter Tage innerhalb dieses Zeitraums erfordert die schriftliche Entscheidung des Schritts der Geschäftsführung (Kommentar Pflicht).
employment_organizationEmploymentOrganization2
Sind alle drei Referenzen leer, gilt der Zeitraum für alle.
Felder anzeigen (12)
- staged_absence_approvalboolean
  null übernimmt die Organisationsrichtlinie (Verträge); bestehende Installationen bleiben aus.
- idinteger
  Primärschlüssel der Beschäftigungsorganisation. Interne ID.
- allow_app_time_trackingboolean
  Ob die Zeiterfassung in der App erlaubt ist.
- school_holiday_regionSchoolHolidayRegion
  U09: der Schulkalender (Bundesland) dieser Organisation; Gruppen dürfen ihn überschreiben.
- organization_unitOrganizationUnit5
  L01: der Knoten des Organisationsbaums, an dem diese Organisation hängt (Einrichtung, Bereich, Geschäftsstelle ...). Leitende dieses Knotens und der darüberliegenden Knoten leiten auch diese Organisation.
- shift_booking_syncboolean
  L35: veröffentlichte Schichten der Personen dieser Organisation erscheinen als Verfügbarkeiten im Event-/Buchungsbereich, und eine Schicht kann in einen Termin umgewandelt werden. null = aus.
- allow_scanner_time_trackingboolean
  Ob die Zeiterfassung per Scanner erlaubt ist.
- allow_app_non_work_time_managementboolean
  Ob arbeitsfreie Zeit in der App verwaltet werden kann.
- include_in_auto_exportboolean
  Ob die Organisation in den automatischen Export einbezogen wird.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
employment_contract_groupEmploymentContractGroup
Vertragsgruppe, für die die Sperrzeit gilt.
Felder anzeigen (25)
- staged_absence_approvalboolean
  null übernimmt die Organisation; false deaktiviert die gestufte Freigabe ausdrücklich.
- shift_booking_syncboolean
  L35: Schichten als Verfügbarkeiten / Termine im Buchungsbereich; null übernimmt die Organisation, false schaltet es für diese Gruppe aus.
- idinteger
  Primärschlüssel der Vertragsgruppe. Interne ID.
- week_total_hoursnumber (float)
  Gesamte Arbeitsstunden pro Woche.
- week_total_daysnumber (float)
  Arbeitstage pro Woche.
- year_vacation_daysnumber (float)
  Urlaubstage pro Jahr.
- month_vacation_daysnumber (float)
  Urlaubstage pro Monat.
- year_vacation_weeksnumber (float)
  Urlaubswochen pro Jahr.
- monday_hoursnumber (float)
  Arbeitsstunden am Montag.
- tuesday_hoursnumber (float)
  Arbeitsstunden am Dienstag.
- wednesday_hoursnumber (float)
  Arbeitsstunden am Mittwoch.
- thursday_hoursnumber (float)
  Arbeitsstunden am Donnerstag.
- friday_hoursnumber (float)
  Arbeitsstunden am Freitag.
- saturday_hoursnumber (float)
  Arbeitsstunden am Samstag.
- sunday_hoursnumber (float)
  Arbeitsstunden am Sonntag.
- netto_hour_costnumber (float)
  Nettokosten je Stunde.
- brutto_hour_costnumber (float)
  Bruttokosten pro Stunde.
- allow_app_time_trackingboolean
  Ob die Zeiterfassung in der App erlaubt ist.
- allow_scanner_time_trackingboolean
  Ob die Zeiterfassung per Scanner erlaubt ist.
- allow_app_non_work_time_managementboolean
  Ob arbeitsfreie Zeit in der App verwaltet werden kann.
- request_lead_time_daysinteger
  Tage, die ein Abwesenheitsantrag dieser Gruppe vor seinem ersten Tag eingereicht werden muss. null greift auf die installationsweite Einstellung zurück – eine bestehende Gruppe verhält sich daher weiterhin genauso wie bisher.
- school_holiday_regionSchoolHolidayRegion
  U09: der Schulkalender dieser Gruppe, wenn er vom Kalender der Organisation abweicht (Auszubildende, die in einem anderen Bundesland zur Schule gehen). null = der der Organisation.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.
contractEmploymentContract2
Vertrag, für den die Sperrzeit gilt.
Felder anzeigen (43)
- staged_absence_approvalboolean
  null übernimmt zuerst die Gruppen- und dann die Organisationsrichtlinie; bestehende Installationen bleiben aus.
- idinteger
  Primärschlüssel des Arbeitsvertrags. Interne ID.
- tokenstring
  Öffentlicher Token des Vertrags. Anstelle der ID verwendet.
- userUser14
  Benutzer des Mitarbeiters.
- week_total_hoursnumber (float)
  Gesamte Arbeitsstunden pro Woche.
- week_total_daysnumber (float)
  Gesamte Arbeitstage pro Woche.
- reserved_hours_preparationnumber (float)
  L03: wöchentliche Stunden, die für Vorbereitung reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- reserved_hours_follow_upnumber (float)
  L03: wöchentliche Stunden, die für Nachbereitung reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- reserved_hours_travelnumber (float)
  L03: wöchentliche Stunden, die für Fahrt reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- reserved_hours_flexiblenumber (float)
  L03: wöchentliche Stunden, die für freie Einteilung reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- week_full_time_total_daysnumber (float)
  Gesamte Arbeitstage pro Woche bei einem Vollzeitvertrag.
- year_vacation_daysnumber (float)
  Urlaubstage pro Jahr.
- month_vacation_daysnumber (float)
  Urlaubstage pro Monat.
- year_vacation_weeksnumber (float)
  Urlaubswochen pro Jahr.
- monday_hoursnumber (float)
  Arbeitsstunden am Montag.
- tuesday_hoursnumber (float)
  Arbeitsstunden am Dienstag.
- wednesday_hoursnumber (float)
  Arbeitsstunden am Mittwoch.
- thursday_hoursnumber (float)
  Arbeitsstunden am Donnerstag.
- friday_hoursnumber (float)
  Arbeitsstunden am Freitag.
- saturday_hoursnumber (float)
  Arbeitsstunden am Samstag.
- sunday_hoursnumber (float)
  Arbeitsstunden am Sonntag.
- netto_hour_costnumber (float)
  Nettokosten je Stunde.
- brutto_hour_costnumber (float)
  Bruttokosten pro Stunde.
- startstring (date-time)
  Startdatum des Vertrags.
- endstring (date-time)
  Enddatum des Vertrags.
- fixed_term_statusstring
  Befristung: PERMANENT (unbefristet, Standard), FIXED_TERM oder EXTENDED (FIXED_TERM_STATUS_*).
- fixed_term_endstring (date-time)
  Befristet bis (erster Zeitraum).
- fixed_term_extension_endstring (date-time)
  Befristet bis nach Verlängerung.
- probation_endstring (date-time)
  Probezeit bis; wird aus den probationMonths der Vorlage gefüllt, wenn ein Vertrag ohne diese Angabe angelegt wird.
- numberstring
  Vertragsnummer.
- descriptionstring
  Beschreibung des Vertrags.
- archivedboolean
  Der Vertrag ist archiviert.
- allow_app_time_trackingboolean
  Der Mitarbeitende darf Zeiten in der App erfassen.
- allow_scanner_time_trackingboolean
  Der Mitarbeitende darf Zeiten mit dem Scanner erfassen.
- allow_app_non_work_time_managementboolean
  Der Mitarbeitende darf Abwesenheiten in der App verwalten.
- force_no_auto_breakboolean
  Für diesen Vertrag werden keine automatischen Pausen hinzugefügt.
- work_time_modestring
  Wie die Sollarbeitszeit definiert ist - null verhält sich wie WEEKDAY_HOURS, damit bestehende Verträge ihr bisheriges Verhalten unverändert beibehalten.
- holiday_credit_modestring
  Feiertagsguthaben für WEEK_TOTAL-Verträge - null verhält sich wie WEEKDAY_TARGET (bisheriges Verhalten, nur bei WEEKDAY_HOURS-Verträgen sinnvoll).
- holiday_credit_fixed_secondsinteger
  Fester Feiertagsguthaben in Sekunden.
- planning_weekdays_bitmaskinteger
  ISO-Wochentagsbitmaske (Mo=1 ... So=64) der Tage, an denen dieser WEEK_TOTAL-Vertrag eingeplant werden bzw. Urlaub nehmen kann - null verhält sich wie Mo-Fr.
- request_lead_time_daysinteger
  Tage, die ein Abwesenheitsantrag vor seinem ersten Tag eingereicht werden muss ("Bearbeitungs- frist"). null greift zunächst auf die Vertragsgruppe und von dort auf die Einstellung der Installation zurück, damit ein bestehender Vertrag genau wie bisher funktioniert.
- shift_booking_syncboolean
  L35: Schichten als Verfügbarkeiten / Termine im Buchungsbereich; null übernimmt die Gruppe (die wiederum die Organisation übernimmt).
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
deletedboolean
Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestring
Name der Einheit.
createdstring (date-time)
Zeitpunkt, zu dem der Datensatz angelegt wurde.
updatedstring (date-time)
Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage

curl --request PUT \
  --url https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42 \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "name": "Beispiel",
    "start": "2026-10-15T09:30:00+02:00",
    "end": "2026-10-15T09:30:00+02:00",
    "mode": "string",
    "scope": "string",
    "max_days_per_year": 1
  }
}
'

const options = {
  method: 'PUT',
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: JSON.stringify({
    data: {
      name: 'Beispiel',
      start: '2026-10-15T09:30:00+02:00',
      end: '2026-10-15T09:30:00+02:00',
      mode: 'string',
      scope: 'string',
      max_days_per_year: 1
    }
  })
};

fetch('https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42"

payload = { "data": {
    "name": "Beispiel",
    "start": "2026-10-15T09:30:00+02:00",
    "end": "2026-10-15T09:30:00+02:00",
    "mode": "string",
    "scope": "string",
    "max_days_per_year": 1
  } }
headers = {
  "x-iw-jwt-token": "<TOKEN>",
  "content-type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('PUT', 'https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42', [
  'body' => '{"data":{"name":"Beispiel","start":"2026-10-15T09:30:00+02:00","end":"2026-10-15T09:30:00+02:00","mode":"string","scope":"string","max_days_per_year":1}}',
  'headers' => [
    'content-type' => 'application/json',
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Put,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
  Content = new StringContent("{\"data\":{\"name\":\"Beispiel\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"mode\":\"string\",\"scope\":\"string\",\"max_days_per_year\":1}}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"data\":{\"name\":\"Beispiel\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"mode\":\"string\",\"scope\":\"string\",\"max_days_per_year\":1}}");
Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42")
  .put(body)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42"

	payload := strings.NewReader("{\"data\":{\"name\":\"Beispiel\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"mode\":\"string\",\"scope\":\"string\",\"max_days_per_year\":1}}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")
	req.Header.Add("content-type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit dem Package iw_erp_api

import 'package:iw_erp_api/clients/non_work_time_blocking_period_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';
import 'package:iw_erp_api/model/non_work_time_blocking_period.dart';

IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';

final result = await NonWorkTimeBlockingPeriodController.put(NonWorkTimeBlockingPeriod.fromJson({
  "name": "Beispiel",
  "start": "2026-10-15T09:30:00+02:00",
  "end": "2026-10-15T09:30:00+02:00",
  "mode": "string",
  "scope": "string",
  "max_days_per_year": 1
}));
if (result.success) {
  print(result.data);
}

Antwort 200 application/json

{
  "id": 42,
  "name": "Beispiel",
  "level": 1,
  "start": "2026-10-15T09:30:00+02:00",
  "end": "2026-10-15T09:30:00+02:00",
  "mode": "string",
  "scope": "string",
  "max_days_per_year": 1,
  "quota_scope": "string",
  "requires_consultation": true
}

NonWorkTimeBlockingPeriod aktualisieren

PATCH/api/time/non_work_time_blocking_period/{id}

Pfad-Parameter

idPflichtstring

Request-Body application/json

dataNonWorkTimeBlockingPeriod2
Felder anzeigen (11)
- startstring (date-time)
  Erster gesperrter Tag (einschließlich).
- endstring (date-time)
  Letzter gesperrter Tag (einschließlich) - eine eintägige Sperre hat Beginn = Ende.
- modestring
  Art der Sperrfrist, zum Beispiel block oder warn.
- scopestring
  Geltungsbereich der Sperrzeit, zum Beispiel Gruppe oder Vertrag.
- max_days_per_yearinteger
  Tage pro Kalenderjahr, die innerhalb dieses Zeitraums noch genommen werden dürfen, bevor er überhaupt etwas entscheidet. null hält den Zeitraum absolut - das bisherige und weiterhin voreingestellte Verhalten. Ein Wert macht den Zeitraum von einer Wand zu einem Kontingent: "höchstens sieben Tage außerhalb der Schulferien" ist ein Zeitraum über das ganze Jahr mit einer Quote von sieben, nicht sieben einzelne Regeln.
- quota_scopestring
  Welche Tage innerhalb des Zeitraums auf das Kontingent angerechnet werden. Nur zusammen mit maxDaysPerYear sinnvoll.
- requires_consultationboolean
  Tage, die dieser Zeitraum umfasst (z. B. außerhalb der Schulferien), dürfen nur nach einer Rücksprache mit der zuständigen Teamleitung beantragt werden; der Antrag muss sie nennen (U14).
- cancellation_quota_daysinteger
  U21: wie viele bereits genehmigte Abwesenheitstage eine Person innerhalb dieses Zeitraums pro Jahr wieder zurückziehen darf (z. B. zwei Tage der Sommerschließung). null = keine Begrenzung.
- cancellation_requires_written_approvalboolean
  U21: das Zurückziehen genehmigter Tage innerhalb dieses Zeitraums erfordert die schriftliche Entscheidung des Schritts der Geschäftsführung (Kommentar Pflicht).
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.

Antworten

200NonWorkTimeBlockingPeriod aktualisierenNonWorkTimeBlockingPeriod3

Felder anzeigen (19)

levelinteger
Wie eng der Zeitraum ist. Die engste Ebene mit einem passenden Zeitraum entscheidet, sodass ein einzelner Vertrag eine Ausnahme tragen kann, ohne die Gruppen- oder Organisationsregel, unter der er steht, zu berühren.
idinteger
Primärschlüssel des Sperrzeitraums. Interne ID.
startstring (date-time)
Erster gesperrter Tag (einschließlich).
endstring (date-time)
Letzter gesperrter Tag (einschließlich) - eine eintägige Sperre hat Beginn = Ende.
modestring
Art der Sperrfrist, zum Beispiel block oder warn.
scopestring
Geltungsbereich der Sperrzeit, zum Beispiel Gruppe oder Vertrag.
max_days_per_yearinteger
Tage pro Kalenderjahr, die innerhalb dieses Zeitraums noch genommen werden dürfen, bevor er überhaupt etwas entscheidet. null hält den Zeitraum absolut - das bisherige und weiterhin voreingestellte Verhalten. Ein Wert macht den Zeitraum von einer Wand zu einem Kontingent: "höchstens sieben Tage außerhalb der Schulferien" ist ein Zeitraum über das ganze Jahr mit einer Quote von sieben, nicht sieben einzelne Regeln.
quota_scopestring
Welche Tage innerhalb des Zeitraums auf das Kontingent angerechnet werden. Nur zusammen mit maxDaysPerYear sinnvoll.
requires_consultationboolean
Tage, die dieser Zeitraum umfasst (z. B. außerhalb der Schulferien), dürfen nur nach einer Rücksprache mit der zuständigen Teamleitung beantragt werden; der Antrag muss sie nennen (U14).
cancellation_quota_daysinteger
U21: wie viele bereits genehmigte Abwesenheitstage eine Person innerhalb dieses Zeitraums pro Jahr wieder zurückziehen darf (z. B. zwei Tage der Sommerschließung). null = keine Begrenzung.
cancellation_requires_written_approvalboolean
U21: das Zurückziehen genehmigter Tage innerhalb dieses Zeitraums erfordert die schriftliche Entscheidung des Schritts der Geschäftsführung (Kommentar Pflicht).
employment_organizationEmploymentOrganization2
Sind alle drei Referenzen leer, gilt der Zeitraum für alle.
Felder anzeigen (12)
- staged_absence_approvalboolean
  null übernimmt die Organisationsrichtlinie (Verträge); bestehende Installationen bleiben aus.
- idinteger
  Primärschlüssel der Beschäftigungsorganisation. Interne ID.
- allow_app_time_trackingboolean
  Ob die Zeiterfassung in der App erlaubt ist.
- school_holiday_regionSchoolHolidayRegion
  U09: der Schulkalender (Bundesland) dieser Organisation; Gruppen dürfen ihn überschreiben.
- organization_unitOrganizationUnit5
  L01: der Knoten des Organisationsbaums, an dem diese Organisation hängt (Einrichtung, Bereich, Geschäftsstelle ...). Leitende dieses Knotens und der darüberliegenden Knoten leiten auch diese Organisation.
- shift_booking_syncboolean
  L35: veröffentlichte Schichten der Personen dieser Organisation erscheinen als Verfügbarkeiten im Event-/Buchungsbereich, und eine Schicht kann in einen Termin umgewandelt werden. null = aus.
- allow_scanner_time_trackingboolean
  Ob die Zeiterfassung per Scanner erlaubt ist.
- allow_app_non_work_time_managementboolean
  Ob arbeitsfreie Zeit in der App verwaltet werden kann.
- include_in_auto_exportboolean
  Ob die Organisation in den automatischen Export einbezogen wird.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- namestring
  Name der Einheit.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
employment_contract_groupEmploymentContractGroup
Vertragsgruppe, für die die Sperrzeit gilt.
Felder anzeigen (25)
- staged_absence_approvalboolean
  null übernimmt die Organisation; false deaktiviert die gestufte Freigabe ausdrücklich.
- shift_booking_syncboolean
  L35: Schichten als Verfügbarkeiten / Termine im Buchungsbereich; null übernimmt die Organisation, false schaltet es für diese Gruppe aus.
- idinteger
  Primärschlüssel der Vertragsgruppe. Interne ID.
- week_total_hoursnumber (float)
  Gesamte Arbeitsstunden pro Woche.
- week_total_daysnumber (float)
  Arbeitstage pro Woche.
- year_vacation_daysnumber (float)
  Urlaubstage pro Jahr.
- month_vacation_daysnumber (float)
  Urlaubstage pro Monat.
- year_vacation_weeksnumber (float)
  Urlaubswochen pro Jahr.
- monday_hoursnumber (float)
  Arbeitsstunden am Montag.
- tuesday_hoursnumber (float)
  Arbeitsstunden am Dienstag.
- wednesday_hoursnumber (float)
  Arbeitsstunden am Mittwoch.
- thursday_hoursnumber (float)
  Arbeitsstunden am Donnerstag.
- friday_hoursnumber (float)
  Arbeitsstunden am Freitag.
- saturday_hoursnumber (float)
  Arbeitsstunden am Samstag.
- sunday_hoursnumber (float)
  Arbeitsstunden am Sonntag.
- netto_hour_costnumber (float)
  Nettokosten je Stunde.
- brutto_hour_costnumber (float)
  Bruttokosten pro Stunde.
- allow_app_time_trackingboolean
  Ob die Zeiterfassung in der App erlaubt ist.
- allow_scanner_time_trackingboolean
  Ob die Zeiterfassung per Scanner erlaubt ist.
- allow_app_non_work_time_managementboolean
  Ob arbeitsfreie Zeit in der App verwaltet werden kann.
- request_lead_time_daysinteger
  Tage, die ein Abwesenheitsantrag dieser Gruppe vor seinem ersten Tag eingereicht werden muss. null greift auf die installationsweite Einstellung zurück – eine bestehende Gruppe verhält sich daher weiterhin genauso wie bisher.
- school_holiday_regionSchoolHolidayRegion
  U09: der Schulkalender dieser Gruppe, wenn er vom Kalender der Organisation abweicht (Auszubildende, die in einem anderen Bundesland zur Schule gehen). null = der der Organisation.
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
- deletedboolean
  Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
- namestring
  Name der Einheit.
contractEmploymentContract2
Vertrag, für den die Sperrzeit gilt.
Felder anzeigen (43)
- staged_absence_approvalboolean
  null übernimmt zuerst die Gruppen- und dann die Organisationsrichtlinie; bestehende Installationen bleiben aus.
- idinteger
  Primärschlüssel des Arbeitsvertrags. Interne ID.
- tokenstring
  Öffentlicher Token des Vertrags. Anstelle der ID verwendet.
- userUser14
  Benutzer des Mitarbeiters.
- week_total_hoursnumber (float)
  Gesamte Arbeitsstunden pro Woche.
- week_total_daysnumber (float)
  Gesamte Arbeitstage pro Woche.
- reserved_hours_preparationnumber (float)
  L03: wöchentliche Stunden, die für Vorbereitung reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- reserved_hours_follow_upnumber (float)
  L03: wöchentliche Stunden, die für Nachbereitung reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- reserved_hours_travelnumber (float)
  L03: wöchentliche Stunden, die für Fahrt reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- reserved_hours_flexiblenumber (float)
  L03: wöchentliche Stunden, die für freie Einteilung reserviert sind - Teil der Vertragsstunden, aber nicht planbar im Schichtplan. null = keine.
- week_full_time_total_daysnumber (float)
  Gesamte Arbeitstage pro Woche bei einem Vollzeitvertrag.
- year_vacation_daysnumber (float)
  Urlaubstage pro Jahr.
- month_vacation_daysnumber (float)
  Urlaubstage pro Monat.
- year_vacation_weeksnumber (float)
  Urlaubswochen pro Jahr.
- monday_hoursnumber (float)
  Arbeitsstunden am Montag.
- tuesday_hoursnumber (float)
  Arbeitsstunden am Dienstag.
- wednesday_hoursnumber (float)
  Arbeitsstunden am Mittwoch.
- thursday_hoursnumber (float)
  Arbeitsstunden am Donnerstag.
- friday_hoursnumber (float)
  Arbeitsstunden am Freitag.
- saturday_hoursnumber (float)
  Arbeitsstunden am Samstag.
- sunday_hoursnumber (float)
  Arbeitsstunden am Sonntag.
- netto_hour_costnumber (float)
  Nettokosten je Stunde.
- brutto_hour_costnumber (float)
  Bruttokosten pro Stunde.
- startstring (date-time)
  Startdatum des Vertrags.
- endstring (date-time)
  Enddatum des Vertrags.
- fixed_term_statusstring
  Befristung: PERMANENT (unbefristet, Standard), FIXED_TERM oder EXTENDED (FIXED_TERM_STATUS_*).
- fixed_term_endstring (date-time)
  Befristet bis (erster Zeitraum).
- fixed_term_extension_endstring (date-time)
  Befristet bis nach Verlängerung.
- probation_endstring (date-time)
  Probezeit bis; wird aus den probationMonths der Vorlage gefüllt, wenn ein Vertrag ohne diese Angabe angelegt wird.
- numberstring
  Vertragsnummer.
- descriptionstring
  Beschreibung des Vertrags.
- archivedboolean
  Der Vertrag ist archiviert.
- allow_app_time_trackingboolean
  Der Mitarbeitende darf Zeiten in der App erfassen.
- allow_scanner_time_trackingboolean
  Der Mitarbeitende darf Zeiten mit dem Scanner erfassen.
- allow_app_non_work_time_managementboolean
  Der Mitarbeitende darf Abwesenheiten in der App verwalten.
- force_no_auto_breakboolean
  Für diesen Vertrag werden keine automatischen Pausen hinzugefügt.
- work_time_modestring
  Wie die Sollarbeitszeit definiert ist - null verhält sich wie WEEKDAY_HOURS, damit bestehende Verträge ihr bisheriges Verhalten unverändert beibehalten.
- holiday_credit_modestring
  Feiertagsguthaben für WEEK_TOTAL-Verträge - null verhält sich wie WEEKDAY_TARGET (bisheriges Verhalten, nur bei WEEKDAY_HOURS-Verträgen sinnvoll).
- holiday_credit_fixed_secondsinteger
  Fester Feiertagsguthaben in Sekunden.
- planning_weekdays_bitmaskinteger
  ISO-Wochentagsbitmaske (Mo=1 ... So=64) der Tage, an denen dieser WEEK_TOTAL-Vertrag eingeplant werden bzw. Urlaub nehmen kann - null verhält sich wie Mo-Fr.
- request_lead_time_daysinteger
  Tage, die ein Abwesenheitsantrag vor seinem ersten Tag eingereicht werden muss ("Bearbeitungs- frist"). null greift zunächst auf die Vertragsgruppe und von dort auf die Einstellung der Installation zurück, damit ein bestehender Vertrag genau wie bisher funktioniert.
- shift_booking_syncboolean
  L35: Schichten als Verfügbarkeiten / Termine im Buchungsbereich; null übernimmt die Gruppe (die wiederum die Organisation übernimmt).
- search_stringstring
  Text, unter dem die Entität gesucht werden kann.
search_stringstring
Text, unter dem die Entität gesucht werden kann.
deletedboolean
Diese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestring
Name der Einheit.
createdstring (date-time)
Zeitpunkt, zu dem der Datensatz angelegt wurde.
updatedstring (date-time)
Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage

curl --request PATCH \
  --url https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42 \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '
{
  "data": {
    "name": "Beispiel",
    "start": "2026-10-15T09:30:00+02:00",
    "end": "2026-10-15T09:30:00+02:00",
    "mode": "string",
    "scope": "string",
    "max_days_per_year": 1
  }
}
'

const options = {
  method: 'PATCH',
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: JSON.stringify({
    data: {
      name: 'Beispiel',
      start: '2026-10-15T09:30:00+02:00',
      end: '2026-10-15T09:30:00+02:00',
      mode: 'string',
      scope: 'string',
      max_days_per_year: 1
    }
  })
};

fetch('https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42"

payload = { "data": {
    "name": "Beispiel",
    "start": "2026-10-15T09:30:00+02:00",
    "end": "2026-10-15T09:30:00+02:00",
    "mode": "string",
    "scope": "string",
    "max_days_per_year": 1
  } }
headers = {
  "x-iw-jwt-token": "<TOKEN>",
  "content-type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('PATCH', 'https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42', [
  'body' => '{"data":{"name":"Beispiel","start":"2026-10-15T09:30:00+02:00","end":"2026-10-15T09:30:00+02:00","mode":"string","scope":"string","max_days_per_year":1}}',
  'headers' => [
    'content-type' => 'application/json',
    'x-iw-jwt-token' => '<TOKEN>',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Patch,
  RequestUri = new Uri("https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42"),
  Headers =
  {
    { "x-iw-jwt-token", "<TOKEN>" },
  },
  Content = new StringContent("{\"data\":{\"name\":\"Beispiel\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"mode\":\"string\",\"scope\":\"string\",\"max_days_per_year\":1}}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"data\":{\"name\":\"Beispiel\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"mode\":\"string\",\"scope\":\"string\",\"max_days_per_year\":1}}");
Request request = new Request.Builder()
  .url("https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42")
  .patch(body)
  .addHeader("x-iw-jwt-token", "<TOKEN>")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42"

	payload := strings.NewReader("{\"data\":{\"name\":\"Beispiel\",\"start\":\"2026-10-15T09:30:00+02:00\",\"end\":\"2026-10-15T09:30:00+02:00\",\"mode\":\"string\",\"scope\":\"string\",\"max_days_per_year\":1}}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-iw-jwt-token", "<TOKEN>")
	req.Header.Add("content-type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart mit package:http (kein Controller im Package iw_erp_api)

import 'dart:convert';
import 'package:http/http.dart' as http;

final response = await http.patch(
  Uri.parse('https://eure-instanz.iw-erp.de/api/time/non_work_time_blocking_period/42'),
  headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
  body: jsonEncode({
    "data": {
      "name": "Beispiel",
      "start": "2026-10-15T09:30:00+02:00",
      "end": "2026-10-15T09:30:00+02:00",
      "mode": "string",
      "scope": "string",
      "max_days_per_year": 1
    }
  }),
);
print(response.body);

Antwort 200 application/json

{
  "id": 42,
  "name": "Beispiel",
  "level": 1,
  "start": "2026-10-15T09:30:00+02:00",
  "end": "2026-10-15T09:30:00+02:00",
  "mode": "string",
  "scope": "string",
  "max_days_per_year": 1,
  "quota_scope": "string",
  "requires_consultation": true
}