EmploymentContractTemplate
Diese Methode liefert alle EmploymentContractTemplate-Objekte
GET/api/time/employment/contract_template
Query-Parameter
idinteger | |
deletedboolean | Diese Eigenschaft markiert eine Entität als gelöscht / archiviert | Benötigtes Zugriffsrecht: SCOPE | Standardwert: false |
namestring | |
templateTypestring | |
workTimeModestring | |
employmentContractGroupstring | |
searchStringstring | Text, nach dem in der Liste gesucht wird |
orderFieldNamestring | Name des Bestellfelds |
orderFieldSortstring | SortiermodusErlaubt: DESCASC |
pageinteger | Seite der Liste |
pageSizeinteger | Anzahl der Einträge je Seite |
withMaxPageNumberstring | gibt die Anzahl verfügbarer Seiten als Header zurück, wenn dies gesetzt ist |
Antworten
200Liefert eine Liste der EmploymentContractTemplate-Objekte.array<EmploymentContractTemplate>
Felder anzeigen (40)
idintegerPrimärschlüssel der Vertragsvorlage. Interne ID.
template_typestringArt der Vorlage, zum Beispiel Vollzeit oder Teilzeit.
work_time_modestringArbeitszeitmodus der Vorlage.
vacation_days_modestringU01: wie yearVacationDays der Vorlage gemeint ist. MANUAL übernimmt den Wert unverändert; PROPORTIONAL behandelt ihn als Anspruch für die Arbeitstage pro Woche der Vorlage und skaliert ihn auf die Arbeitstage des neuen Vertrags (30 Tage bei 5 Tagen/Woche → 18 bei 3).
leadership_may_change_weekdaysbooleanL13/U22: Leitende von Verträgen dieses Typs dürfen eine datierte Neuverteilung der wöchentlichen Arbeitstage als Änderungsantrag einreichen.
week_total_hoursnumber (float)Gesamte Arbeitsstunden 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.
flexible_vacation_daysnumber (float)U02/U18: wie viele der jährlichen Urlaubstage dieser Kategorie für Ergänzungsanträge statt für den Jahresplan zurückgehalten werden. null = der Installationsstandard (Einstellung non_work_time_flexible_vacation_days).
supplement_processing_deadline_daysintegerU20: Bearbeitungsfrist eines Ergänzungsantrags dieser Kategorie in Tagen nach Eingang (Teamer: 14). null = die allgemeine Frist der Installation.
week_total_daysnumber (float)Gesamte Arbeitstage pro Woche.
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.
year_vacation_daysnumber (float)Urlaubstage pro Jahr.
holiday_credit_modestringWie das Feiertagsguthaben berechnet wird, zum Beispiel fest oder nach Stunden.
holiday_credit_fixed_secondsintegerFester Feiertagsguthaben in Sekunden.
planning_weekdays_bitmaskintegerBitmaske der in der Vorlage geplanten Wochentage.
netto_hour_costnumber (float)Nettokosten je Stunde.
brutto_hour_costnumber (float)Bruttokosten pro Stunde.
probation_monthsintegerProbezeit in Monaten, rein informativ
default_contract_duration_monthsintegerStandard-Festlaufzeit in Monaten (null = unbegrenzt), nur zur Information
monthly_earnings_limitnumber (float)Warngrenze, z. B. die Minijob-Verdienstgrenze – als Daten gepflegt, nie fest codiert
max_week_hours_limitnumber (float)Warngrenze, z. B. 20h für Werkstudenten
allow_app_time_trackingbooleanMitarbeitende dürfen Zeiten in der App erfassen.
allow_scanner_time_trackingbooleanMitarbeitende dürfen Zeiten mit dem Scanner erfassen.
allow_app_non_work_time_managementbooleanMitarbeitende dürfen Abwesenheiten in der App verwalten.
employment_contract_groupEmploymentContractGroupVertragsgruppe, zu der die Vorlage gehört.
Felder anzeigen (25)
staged_absence_approvalbooleannull übernimmt die Organisation; false deaktiviert die gestufte Freigabe ausdrücklich.
shift_booking_syncbooleanL35: Schichten als Verfügbarkeiten / Termine im Buchungsbereich; null übernimmt die Organisation, false schaltet es für diese Gruppe aus.
idintegerPrimä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_trackingbooleanOb die Zeiterfassung in der App erlaubt ist.
allow_scanner_time_trackingbooleanOb die Zeiterfassung per Scanner erlaubt ist.
allow_app_non_work_time_managementbooleanOb arbeitsfreie Zeit in der App verwaltet werden kann.
request_lead_time_daysintegerTage, 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_regionSchoolHolidayRegionU09: 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_stringstringText, unter dem die Entität gesucht werden kann.
deletedbooleanDiese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestringName der Einheit.
sort_orderintegerSortierreihenfolge der Vorlage in Listen.
search_stringstringText, unter dem die Entität gesucht werden kann.
deletedbooleanDiese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestringName der Einheit.
createdstring (date-time)Zeitpunkt, zu dem der Datensatz angelegt wurde.
updatedstring (date-time)Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
curl --request GET \
--url https://eure-instanz.iw-erp.de/api/time/employment/contract_template \
--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/employment/contract_template', 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/employment/contract_template"
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/employment/contract_template', [
'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/employment/contract_template"),
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/employment/contract_template")
.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/employment/contract_template"
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/employment_contract_template_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 EmploymentContractTemplateController.getAll();
if (result.success) {
print(result.data);
}[
{
"id": 42,
"name": "Beispiel",
"template_type": "string",
"work_time_mode": "string",
"vacation_days_mode": "string",
"leadership_may_change_weekdays": true,
"week_total_hours": 1.5,
"reserved_hours_preparation": 1.5,
"reserved_hours_follow_up": 1.5,
"reserved_hours_travel": 1.5
}
]EmploymentContractTemplate neu anlegen
POST/api/time/employment/contract_template
Request-Body application/json
dataEmploymentContractTemplate2Felder anzeigen (35)
template_typestringArt der Vorlage, zum Beispiel Vollzeit oder Teilzeit.
work_time_modestringArbeitszeitmodus der Vorlage.
vacation_days_modestringU01: wie yearVacationDays der Vorlage gemeint ist. MANUAL übernimmt den Wert unverändert; PROPORTIONAL behandelt ihn als Anspruch für die Arbeitstage pro Woche der Vorlage und skaliert ihn auf die Arbeitstage des neuen Vertrags (30 Tage bei 5 Tagen/Woche → 18 bei 3).
leadership_may_change_weekdaysbooleanL13/U22: Leitende von Verträgen dieses Typs dürfen eine datierte Neuverteilung der wöchentlichen Arbeitstage als Änderungsantrag einreichen.
week_total_hoursnumber (float)Gesamte Arbeitsstunden 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.
flexible_vacation_daysnumber (float)U02/U18: wie viele der jährlichen Urlaubstage dieser Kategorie für Ergänzungsanträge statt für den Jahresplan zurückgehalten werden. null = der Installationsstandard (Einstellung non_work_time_flexible_vacation_days).
supplement_processing_deadline_daysintegerU20: Bearbeitungsfrist eines Ergänzungsantrags dieser Kategorie in Tagen nach Eingang (Teamer: 14). null = die allgemeine Frist der Installation.
week_total_daysnumber (float)Gesamte Arbeitstage pro Woche.
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.
year_vacation_daysnumber (float)Urlaubstage pro Jahr.
holiday_credit_modestringWie das Feiertagsguthaben berechnet wird, zum Beispiel fest oder nach Stunden.
holiday_credit_fixed_secondsintegerFester Feiertagsguthaben in Sekunden.
planning_weekdays_bitmaskintegerBitmaske der in der Vorlage geplanten Wochentage.
netto_hour_costnumber (float)Nettokosten je Stunde.
brutto_hour_costnumber (float)Bruttokosten pro Stunde.
probation_monthsintegerProbezeit in Monaten, rein informativ
default_contract_duration_monthsintegerStandard-Festlaufzeit in Monaten (null = unbegrenzt), nur zur Information
monthly_earnings_limitnumber (float)Warngrenze, z. B. die Minijob-Verdienstgrenze – als Daten gepflegt, nie fest codiert
max_week_hours_limitnumber (float)Warngrenze, z. B. 20h für Werkstudenten
allow_app_time_trackingbooleanMitarbeitende dürfen Zeiten in der App erfassen.
allow_scanner_time_trackingbooleanMitarbeitende dürfen Zeiten mit dem Scanner erfassen.
allow_app_non_work_time_managementbooleanMitarbeitende dürfen Abwesenheiten in der App verwalten.
sort_orderintegerSortierreihenfolge der Vorlage in Listen.
deletedbooleanDiese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestringName der Einheit.
Antworten
200EmploymentContractTemplate neu anlegenEmploymentContractTemplate
Felder anzeigen (40)
idintegerPrimärschlüssel der Vertragsvorlage. Interne ID.
template_typestringArt der Vorlage, zum Beispiel Vollzeit oder Teilzeit.
work_time_modestringArbeitszeitmodus der Vorlage.
vacation_days_modestringU01: wie yearVacationDays der Vorlage gemeint ist. MANUAL übernimmt den Wert unverändert; PROPORTIONAL behandelt ihn als Anspruch für die Arbeitstage pro Woche der Vorlage und skaliert ihn auf die Arbeitstage des neuen Vertrags (30 Tage bei 5 Tagen/Woche → 18 bei 3).
leadership_may_change_weekdaysbooleanL13/U22: Leitende von Verträgen dieses Typs dürfen eine datierte Neuverteilung der wöchentlichen Arbeitstage als Änderungsantrag einreichen.
week_total_hoursnumber (float)Gesamte Arbeitsstunden 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.
flexible_vacation_daysnumber (float)U02/U18: wie viele der jährlichen Urlaubstage dieser Kategorie für Ergänzungsanträge statt für den Jahresplan zurückgehalten werden. null = der Installationsstandard (Einstellung non_work_time_flexible_vacation_days).
supplement_processing_deadline_daysintegerU20: Bearbeitungsfrist eines Ergänzungsantrags dieser Kategorie in Tagen nach Eingang (Teamer: 14). null = die allgemeine Frist der Installation.
week_total_daysnumber (float)Gesamte Arbeitstage pro Woche.
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.
year_vacation_daysnumber (float)Urlaubstage pro Jahr.
holiday_credit_modestringWie das Feiertagsguthaben berechnet wird, zum Beispiel fest oder nach Stunden.
holiday_credit_fixed_secondsintegerFester Feiertagsguthaben in Sekunden.
planning_weekdays_bitmaskintegerBitmaske der in der Vorlage geplanten Wochentage.
netto_hour_costnumber (float)Nettokosten je Stunde.
brutto_hour_costnumber (float)Bruttokosten pro Stunde.
probation_monthsintegerProbezeit in Monaten, rein informativ
default_contract_duration_monthsintegerStandard-Festlaufzeit in Monaten (null = unbegrenzt), nur zur Information
monthly_earnings_limitnumber (float)Warngrenze, z. B. die Minijob-Verdienstgrenze – als Daten gepflegt, nie fest codiert
max_week_hours_limitnumber (float)Warngrenze, z. B. 20h für Werkstudenten
allow_app_time_trackingbooleanMitarbeitende dürfen Zeiten in der App erfassen.
allow_scanner_time_trackingbooleanMitarbeitende dürfen Zeiten mit dem Scanner erfassen.
allow_app_non_work_time_managementbooleanMitarbeitende dürfen Abwesenheiten in der App verwalten.
employment_contract_groupEmploymentContractGroupVertragsgruppe, zu der die Vorlage gehört.
Felder anzeigen (25)
staged_absence_approvalbooleannull übernimmt die Organisation; false deaktiviert die gestufte Freigabe ausdrücklich.
shift_booking_syncbooleanL35: Schichten als Verfügbarkeiten / Termine im Buchungsbereich; null übernimmt die Organisation, false schaltet es für diese Gruppe aus.
idintegerPrimä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_trackingbooleanOb die Zeiterfassung in der App erlaubt ist.
allow_scanner_time_trackingbooleanOb die Zeiterfassung per Scanner erlaubt ist.
allow_app_non_work_time_managementbooleanOb arbeitsfreie Zeit in der App verwaltet werden kann.
request_lead_time_daysintegerTage, 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_regionSchoolHolidayRegionU09: 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_stringstringText, unter dem die Entität gesucht werden kann.
deletedbooleanDiese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestringName der Einheit.
sort_orderintegerSortierreihenfolge der Vorlage in Listen.
search_stringstringText, unter dem die Entität gesucht werden kann.
deletedbooleanDiese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestringName der Einheit.
createdstring (date-time)Zeitpunkt, zu dem der Datensatz angelegt wurde.
updatedstring (date-time)Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
curl --request POST \
--url https://eure-instanz.iw-erp.de/api/time/employment/contract_template \
--header 'content-type: application/json' \
--header 'x-iw-jwt-token: <TOKEN>' \
--data '
{
"data": {
"name": "Beispiel",
"template_type": "string",
"work_time_mode": "string",
"vacation_days_mode": "string",
"leadership_may_change_weekdays": true,
"week_total_hours": 1.5
}
}
'const options = {
method: 'POST',
headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
body: JSON.stringify({
data: {
name: 'Beispiel',
template_type: 'string',
work_time_mode: 'string',
vacation_days_mode: 'string',
leadership_may_change_weekdays: true,
week_total_hours: 1.5
}
})
};
fetch('https://eure-instanz.iw-erp.de/api/time/employment/contract_template', 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/employment/contract_template"
payload = { "data": {
"name": "Beispiel",
"template_type": "string",
"work_time_mode": "string",
"vacation_days_mode": "string",
"leadership_may_change_weekdays": True,
"week_total_hours": 1.5
} }
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/employment/contract_template', [
'body' => '{"data":{"name":"Beispiel","template_type":"string","work_time_mode":"string","vacation_days_mode":"string","leadership_may_change_weekdays":true,"week_total_hours":1.5}}',
'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/employment/contract_template"),
Headers =
{
{ "x-iw-jwt-token", "<TOKEN>" },
},
Content = new StringContent("{\"data\":{\"name\":\"Beispiel\",\"template_type\":\"string\",\"work_time_mode\":\"string\",\"vacation_days_mode\":\"string\",\"leadership_may_change_weekdays\":true,\"week_total_hours\":1.5}}")
{
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\",\"template_type\":\"string\",\"work_time_mode\":\"string\",\"vacation_days_mode\":\"string\",\"leadership_may_change_weekdays\":true,\"week_total_hours\":1.5}}");
Request request = new Request.Builder()
.url("https://eure-instanz.iw-erp.de/api/time/employment/contract_template")
.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/employment/contract_template"
payload := strings.NewReader("{\"data\":{\"name\":\"Beispiel\",\"template_type\":\"string\",\"work_time_mode\":\"string\",\"vacation_days_mode\":\"string\",\"leadership_may_change_weekdays\":true,\"week_total_hours\":1.5}}")
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/employment_contract_template_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';
import 'package:iw_erp_api/model/employment_contract_template.dart';
IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';
final result = await EmploymentContractTemplateController.post(EmploymentContractTemplate.fromJson({
"name": "Beispiel",
"template_type": "string",
"work_time_mode": "string",
"vacation_days_mode": "string",
"leadership_may_change_weekdays": true,
"week_total_hours": 1.5
}));
if (result.success) {
print(result.data);
}{
"id": 42,
"name": "Beispiel",
"template_type": "string",
"work_time_mode": "string",
"vacation_days_mode": "string",
"leadership_may_change_weekdays": true,
"week_total_hours": 1.5,
"reserved_hours_preparation": 1.5,
"reserved_hours_follow_up": 1.5,
"reserved_hours_travel": 1.5
}Diese Methode liefert eine einzelne EmploymentContractTemplate mit der angegebenen ID
GET/api/time/employment/contract_template/{id}
Pfad-Parameter
idPflichtstring |
Antworten
200Liefert ein einzelnes EmploymentContractTemplate-Objekt.EmploymentContractTemplate
Felder anzeigen (40)
idintegerPrimärschlüssel der Vertragsvorlage. Interne ID.
template_typestringArt der Vorlage, zum Beispiel Vollzeit oder Teilzeit.
work_time_modestringArbeitszeitmodus der Vorlage.
vacation_days_modestringU01: wie yearVacationDays der Vorlage gemeint ist. MANUAL übernimmt den Wert unverändert; PROPORTIONAL behandelt ihn als Anspruch für die Arbeitstage pro Woche der Vorlage und skaliert ihn auf die Arbeitstage des neuen Vertrags (30 Tage bei 5 Tagen/Woche → 18 bei 3).
leadership_may_change_weekdaysbooleanL13/U22: Leitende von Verträgen dieses Typs dürfen eine datierte Neuverteilung der wöchentlichen Arbeitstage als Änderungsantrag einreichen.
week_total_hoursnumber (float)Gesamte Arbeitsstunden 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.
flexible_vacation_daysnumber (float)U02/U18: wie viele der jährlichen Urlaubstage dieser Kategorie für Ergänzungsanträge statt für den Jahresplan zurückgehalten werden. null = der Installationsstandard (Einstellung non_work_time_flexible_vacation_days).
supplement_processing_deadline_daysintegerU20: Bearbeitungsfrist eines Ergänzungsantrags dieser Kategorie in Tagen nach Eingang (Teamer: 14). null = die allgemeine Frist der Installation.
week_total_daysnumber (float)Gesamte Arbeitstage pro Woche.
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.
year_vacation_daysnumber (float)Urlaubstage pro Jahr.
holiday_credit_modestringWie das Feiertagsguthaben berechnet wird, zum Beispiel fest oder nach Stunden.
holiday_credit_fixed_secondsintegerFester Feiertagsguthaben in Sekunden.
planning_weekdays_bitmaskintegerBitmaske der in der Vorlage geplanten Wochentage.
netto_hour_costnumber (float)Nettokosten je Stunde.
brutto_hour_costnumber (float)Bruttokosten pro Stunde.
probation_monthsintegerProbezeit in Monaten, rein informativ
default_contract_duration_monthsintegerStandard-Festlaufzeit in Monaten (null = unbegrenzt), nur zur Information
monthly_earnings_limitnumber (float)Warngrenze, z. B. die Minijob-Verdienstgrenze – als Daten gepflegt, nie fest codiert
max_week_hours_limitnumber (float)Warngrenze, z. B. 20h für Werkstudenten
allow_app_time_trackingbooleanMitarbeitende dürfen Zeiten in der App erfassen.
allow_scanner_time_trackingbooleanMitarbeitende dürfen Zeiten mit dem Scanner erfassen.
allow_app_non_work_time_managementbooleanMitarbeitende dürfen Abwesenheiten in der App verwalten.
employment_contract_groupEmploymentContractGroupVertragsgruppe, zu der die Vorlage gehört.
Felder anzeigen (25)
staged_absence_approvalbooleannull übernimmt die Organisation; false deaktiviert die gestufte Freigabe ausdrücklich.
shift_booking_syncbooleanL35: Schichten als Verfügbarkeiten / Termine im Buchungsbereich; null übernimmt die Organisation, false schaltet es für diese Gruppe aus.
idintegerPrimä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_trackingbooleanOb die Zeiterfassung in der App erlaubt ist.
allow_scanner_time_trackingbooleanOb die Zeiterfassung per Scanner erlaubt ist.
allow_app_non_work_time_managementbooleanOb arbeitsfreie Zeit in der App verwaltet werden kann.
request_lead_time_daysintegerTage, 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_regionSchoolHolidayRegionU09: 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_stringstringText, unter dem die Entität gesucht werden kann.
deletedbooleanDiese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestringName der Einheit.
sort_orderintegerSortierreihenfolge der Vorlage in Listen.
search_stringstringText, unter dem die Entität gesucht werden kann.
deletedbooleanDiese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestringName der Einheit.
createdstring (date-time)Zeitpunkt, zu dem der Datensatz angelegt wurde.
updatedstring (date-time)Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
curl --request GET \
--url https://eure-instanz.iw-erp.de/api/time/employment/contract_template/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/employment/contract_template/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/employment/contract_template/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/employment/contract_template/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/employment/contract_template/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/employment/contract_template/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/employment/contract_template/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/employment_contract_template_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 EmploymentContractTemplateController.get('42');
if (result.success) {
print(result.data);
}{
"id": 42,
"name": "Beispiel",
"template_type": "string",
"work_time_mode": "string",
"vacation_days_mode": "string",
"leadership_may_change_weekdays": true,
"week_total_hours": 1.5,
"reserved_hours_preparation": 1.5,
"reserved_hours_follow_up": 1.5,
"reserved_hours_travel": 1.5
}EmploymentContractTemplate aktualisieren
PUT/api/time/employment/contract_template/{id}
Pfad-Parameter
idPflichtstring |
Request-Body application/json
dataEmploymentContractTemplate2Felder anzeigen (35)
template_typestringArt der Vorlage, zum Beispiel Vollzeit oder Teilzeit.
work_time_modestringArbeitszeitmodus der Vorlage.
vacation_days_modestringU01: wie yearVacationDays der Vorlage gemeint ist. MANUAL übernimmt den Wert unverändert; PROPORTIONAL behandelt ihn als Anspruch für die Arbeitstage pro Woche der Vorlage und skaliert ihn auf die Arbeitstage des neuen Vertrags (30 Tage bei 5 Tagen/Woche → 18 bei 3).
leadership_may_change_weekdaysbooleanL13/U22: Leitende von Verträgen dieses Typs dürfen eine datierte Neuverteilung der wöchentlichen Arbeitstage als Änderungsantrag einreichen.
week_total_hoursnumber (float)Gesamte Arbeitsstunden 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.
flexible_vacation_daysnumber (float)U02/U18: wie viele der jährlichen Urlaubstage dieser Kategorie für Ergänzungsanträge statt für den Jahresplan zurückgehalten werden. null = der Installationsstandard (Einstellung non_work_time_flexible_vacation_days).
supplement_processing_deadline_daysintegerU20: Bearbeitungsfrist eines Ergänzungsantrags dieser Kategorie in Tagen nach Eingang (Teamer: 14). null = die allgemeine Frist der Installation.
week_total_daysnumber (float)Gesamte Arbeitstage pro Woche.
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.
year_vacation_daysnumber (float)Urlaubstage pro Jahr.
holiday_credit_modestringWie das Feiertagsguthaben berechnet wird, zum Beispiel fest oder nach Stunden.
holiday_credit_fixed_secondsintegerFester Feiertagsguthaben in Sekunden.
planning_weekdays_bitmaskintegerBitmaske der in der Vorlage geplanten Wochentage.
netto_hour_costnumber (float)Nettokosten je Stunde.
brutto_hour_costnumber (float)Bruttokosten pro Stunde.
probation_monthsintegerProbezeit in Monaten, rein informativ
default_contract_duration_monthsintegerStandard-Festlaufzeit in Monaten (null = unbegrenzt), nur zur Information
monthly_earnings_limitnumber (float)Warngrenze, z. B. die Minijob-Verdienstgrenze – als Daten gepflegt, nie fest codiert
max_week_hours_limitnumber (float)Warngrenze, z. B. 20h für Werkstudenten
allow_app_time_trackingbooleanMitarbeitende dürfen Zeiten in der App erfassen.
allow_scanner_time_trackingbooleanMitarbeitende dürfen Zeiten mit dem Scanner erfassen.
allow_app_non_work_time_managementbooleanMitarbeitende dürfen Abwesenheiten in der App verwalten.
sort_orderintegerSortierreihenfolge der Vorlage in Listen.
deletedbooleanDiese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestringName der Einheit.
Antworten
200EmploymentContractTemplate aktualisierenEmploymentContractTemplate
Felder anzeigen (40)
idintegerPrimärschlüssel der Vertragsvorlage. Interne ID.
template_typestringArt der Vorlage, zum Beispiel Vollzeit oder Teilzeit.
work_time_modestringArbeitszeitmodus der Vorlage.
vacation_days_modestringU01: wie yearVacationDays der Vorlage gemeint ist. MANUAL übernimmt den Wert unverändert; PROPORTIONAL behandelt ihn als Anspruch für die Arbeitstage pro Woche der Vorlage und skaliert ihn auf die Arbeitstage des neuen Vertrags (30 Tage bei 5 Tagen/Woche → 18 bei 3).
leadership_may_change_weekdaysbooleanL13/U22: Leitende von Verträgen dieses Typs dürfen eine datierte Neuverteilung der wöchentlichen Arbeitstage als Änderungsantrag einreichen.
week_total_hoursnumber (float)Gesamte Arbeitsstunden 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.
flexible_vacation_daysnumber (float)U02/U18: wie viele der jährlichen Urlaubstage dieser Kategorie für Ergänzungsanträge statt für den Jahresplan zurückgehalten werden. null = der Installationsstandard (Einstellung non_work_time_flexible_vacation_days).
supplement_processing_deadline_daysintegerU20: Bearbeitungsfrist eines Ergänzungsantrags dieser Kategorie in Tagen nach Eingang (Teamer: 14). null = die allgemeine Frist der Installation.
week_total_daysnumber (float)Gesamte Arbeitstage pro Woche.
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.
year_vacation_daysnumber (float)Urlaubstage pro Jahr.
holiday_credit_modestringWie das Feiertagsguthaben berechnet wird, zum Beispiel fest oder nach Stunden.
holiday_credit_fixed_secondsintegerFester Feiertagsguthaben in Sekunden.
planning_weekdays_bitmaskintegerBitmaske der in der Vorlage geplanten Wochentage.
netto_hour_costnumber (float)Nettokosten je Stunde.
brutto_hour_costnumber (float)Bruttokosten pro Stunde.
probation_monthsintegerProbezeit in Monaten, rein informativ
default_contract_duration_monthsintegerStandard-Festlaufzeit in Monaten (null = unbegrenzt), nur zur Information
monthly_earnings_limitnumber (float)Warngrenze, z. B. die Minijob-Verdienstgrenze – als Daten gepflegt, nie fest codiert
max_week_hours_limitnumber (float)Warngrenze, z. B. 20h für Werkstudenten
allow_app_time_trackingbooleanMitarbeitende dürfen Zeiten in der App erfassen.
allow_scanner_time_trackingbooleanMitarbeitende dürfen Zeiten mit dem Scanner erfassen.
allow_app_non_work_time_managementbooleanMitarbeitende dürfen Abwesenheiten in der App verwalten.
employment_contract_groupEmploymentContractGroupVertragsgruppe, zu der die Vorlage gehört.
Felder anzeigen (25)
staged_absence_approvalbooleannull übernimmt die Organisation; false deaktiviert die gestufte Freigabe ausdrücklich.
shift_booking_syncbooleanL35: Schichten als Verfügbarkeiten / Termine im Buchungsbereich; null übernimmt die Organisation, false schaltet es für diese Gruppe aus.
idintegerPrimä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_trackingbooleanOb die Zeiterfassung in der App erlaubt ist.
allow_scanner_time_trackingbooleanOb die Zeiterfassung per Scanner erlaubt ist.
allow_app_non_work_time_managementbooleanOb arbeitsfreie Zeit in der App verwaltet werden kann.
request_lead_time_daysintegerTage, 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_regionSchoolHolidayRegionU09: 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_stringstringText, unter dem die Entität gesucht werden kann.
deletedbooleanDiese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestringName der Einheit.
sort_orderintegerSortierreihenfolge der Vorlage in Listen.
search_stringstringText, unter dem die Entität gesucht werden kann.
deletedbooleanDiese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestringName der Einheit.
createdstring (date-time)Zeitpunkt, zu dem der Datensatz angelegt wurde.
updatedstring (date-time)Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
curl --request PUT \
--url https://eure-instanz.iw-erp.de/api/time/employment/contract_template/42 \
--header 'content-type: application/json' \
--header 'x-iw-jwt-token: <TOKEN>' \
--data '
{
"data": {
"name": "Beispiel",
"template_type": "string",
"work_time_mode": "string",
"vacation_days_mode": "string",
"leadership_may_change_weekdays": true,
"week_total_hours": 1.5
}
}
'const options = {
method: 'PUT',
headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
body: JSON.stringify({
data: {
name: 'Beispiel',
template_type: 'string',
work_time_mode: 'string',
vacation_days_mode: 'string',
leadership_may_change_weekdays: true,
week_total_hours: 1.5
}
})
};
fetch('https://eure-instanz.iw-erp.de/api/time/employment/contract_template/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/employment/contract_template/42"
payload = { "data": {
"name": "Beispiel",
"template_type": "string",
"work_time_mode": "string",
"vacation_days_mode": "string",
"leadership_may_change_weekdays": True,
"week_total_hours": 1.5
} }
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/employment/contract_template/42', [
'body' => '{"data":{"name":"Beispiel","template_type":"string","work_time_mode":"string","vacation_days_mode":"string","leadership_may_change_weekdays":true,"week_total_hours":1.5}}',
'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/employment/contract_template/42"),
Headers =
{
{ "x-iw-jwt-token", "<TOKEN>" },
},
Content = new StringContent("{\"data\":{\"name\":\"Beispiel\",\"template_type\":\"string\",\"work_time_mode\":\"string\",\"vacation_days_mode\":\"string\",\"leadership_may_change_weekdays\":true,\"week_total_hours\":1.5}}")
{
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\",\"template_type\":\"string\",\"work_time_mode\":\"string\",\"vacation_days_mode\":\"string\",\"leadership_may_change_weekdays\":true,\"week_total_hours\":1.5}}");
Request request = new Request.Builder()
.url("https://eure-instanz.iw-erp.de/api/time/employment/contract_template/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/employment/contract_template/42"
payload := strings.NewReader("{\"data\":{\"name\":\"Beispiel\",\"template_type\":\"string\",\"work_time_mode\":\"string\",\"vacation_days_mode\":\"string\",\"leadership_may_change_weekdays\":true,\"week_total_hours\":1.5}}")
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/employment_contract_template_controller.dart';
import 'package:iw_erp_api/logic/iw_api_state.dart';
import 'package:iw_erp_api/model/employment_contract_template.dart';
IwApiState().host = 'eure-instanz.iw-erp.de';
IwApiState().currentJwtApiToken = '<TOKEN>';
final result = await EmploymentContractTemplateController.put(EmploymentContractTemplate.fromJson({
"name": "Beispiel",
"template_type": "string",
"work_time_mode": "string",
"vacation_days_mode": "string",
"leadership_may_change_weekdays": true,
"week_total_hours": 1.5
}));
if (result.success) {
print(result.data);
}{
"id": 42,
"name": "Beispiel",
"template_type": "string",
"work_time_mode": "string",
"vacation_days_mode": "string",
"leadership_may_change_weekdays": true,
"week_total_hours": 1.5,
"reserved_hours_preparation": 1.5,
"reserved_hours_follow_up": 1.5,
"reserved_hours_travel": 1.5
}EmploymentContractTemplate aktualisieren
PATCH/api/time/employment/contract_template/{id}
Pfad-Parameter
idPflichtstring |
Request-Body application/json
dataEmploymentContractTemplate2Felder anzeigen (35)
template_typestringArt der Vorlage, zum Beispiel Vollzeit oder Teilzeit.
work_time_modestringArbeitszeitmodus der Vorlage.
vacation_days_modestringU01: wie yearVacationDays der Vorlage gemeint ist. MANUAL übernimmt den Wert unverändert; PROPORTIONAL behandelt ihn als Anspruch für die Arbeitstage pro Woche der Vorlage und skaliert ihn auf die Arbeitstage des neuen Vertrags (30 Tage bei 5 Tagen/Woche → 18 bei 3).
leadership_may_change_weekdaysbooleanL13/U22: Leitende von Verträgen dieses Typs dürfen eine datierte Neuverteilung der wöchentlichen Arbeitstage als Änderungsantrag einreichen.
week_total_hoursnumber (float)Gesamte Arbeitsstunden 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.
flexible_vacation_daysnumber (float)U02/U18: wie viele der jährlichen Urlaubstage dieser Kategorie für Ergänzungsanträge statt für den Jahresplan zurückgehalten werden. null = der Installationsstandard (Einstellung non_work_time_flexible_vacation_days).
supplement_processing_deadline_daysintegerU20: Bearbeitungsfrist eines Ergänzungsantrags dieser Kategorie in Tagen nach Eingang (Teamer: 14). null = die allgemeine Frist der Installation.
week_total_daysnumber (float)Gesamte Arbeitstage pro Woche.
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.
year_vacation_daysnumber (float)Urlaubstage pro Jahr.
holiday_credit_modestringWie das Feiertagsguthaben berechnet wird, zum Beispiel fest oder nach Stunden.
holiday_credit_fixed_secondsintegerFester Feiertagsguthaben in Sekunden.
planning_weekdays_bitmaskintegerBitmaske der in der Vorlage geplanten Wochentage.
netto_hour_costnumber (float)Nettokosten je Stunde.
brutto_hour_costnumber (float)Bruttokosten pro Stunde.
probation_monthsintegerProbezeit in Monaten, rein informativ
default_contract_duration_monthsintegerStandard-Festlaufzeit in Monaten (null = unbegrenzt), nur zur Information
monthly_earnings_limitnumber (float)Warngrenze, z. B. die Minijob-Verdienstgrenze – als Daten gepflegt, nie fest codiert
max_week_hours_limitnumber (float)Warngrenze, z. B. 20h für Werkstudenten
allow_app_time_trackingbooleanMitarbeitende dürfen Zeiten in der App erfassen.
allow_scanner_time_trackingbooleanMitarbeitende dürfen Zeiten mit dem Scanner erfassen.
allow_app_non_work_time_managementbooleanMitarbeitende dürfen Abwesenheiten in der App verwalten.
sort_orderintegerSortierreihenfolge der Vorlage in Listen.
deletedbooleanDiese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestringName der Einheit.
Antworten
200EmploymentContractTemplate aktualisierenEmploymentContractTemplate
Felder anzeigen (40)
idintegerPrimärschlüssel der Vertragsvorlage. Interne ID.
template_typestringArt der Vorlage, zum Beispiel Vollzeit oder Teilzeit.
work_time_modestringArbeitszeitmodus der Vorlage.
vacation_days_modestringU01: wie yearVacationDays der Vorlage gemeint ist. MANUAL übernimmt den Wert unverändert; PROPORTIONAL behandelt ihn als Anspruch für die Arbeitstage pro Woche der Vorlage und skaliert ihn auf die Arbeitstage des neuen Vertrags (30 Tage bei 5 Tagen/Woche → 18 bei 3).
leadership_may_change_weekdaysbooleanL13/U22: Leitende von Verträgen dieses Typs dürfen eine datierte Neuverteilung der wöchentlichen Arbeitstage als Änderungsantrag einreichen.
week_total_hoursnumber (float)Gesamte Arbeitsstunden 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.
flexible_vacation_daysnumber (float)U02/U18: wie viele der jährlichen Urlaubstage dieser Kategorie für Ergänzungsanträge statt für den Jahresplan zurückgehalten werden. null = der Installationsstandard (Einstellung non_work_time_flexible_vacation_days).
supplement_processing_deadline_daysintegerU20: Bearbeitungsfrist eines Ergänzungsantrags dieser Kategorie in Tagen nach Eingang (Teamer: 14). null = die allgemeine Frist der Installation.
week_total_daysnumber (float)Gesamte Arbeitstage pro Woche.
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.
year_vacation_daysnumber (float)Urlaubstage pro Jahr.
holiday_credit_modestringWie das Feiertagsguthaben berechnet wird, zum Beispiel fest oder nach Stunden.
holiday_credit_fixed_secondsintegerFester Feiertagsguthaben in Sekunden.
planning_weekdays_bitmaskintegerBitmaske der in der Vorlage geplanten Wochentage.
netto_hour_costnumber (float)Nettokosten je Stunde.
brutto_hour_costnumber (float)Bruttokosten pro Stunde.
probation_monthsintegerProbezeit in Monaten, rein informativ
default_contract_duration_monthsintegerStandard-Festlaufzeit in Monaten (null = unbegrenzt), nur zur Information
monthly_earnings_limitnumber (float)Warngrenze, z. B. die Minijob-Verdienstgrenze – als Daten gepflegt, nie fest codiert
max_week_hours_limitnumber (float)Warngrenze, z. B. 20h für Werkstudenten
allow_app_time_trackingbooleanMitarbeitende dürfen Zeiten in der App erfassen.
allow_scanner_time_trackingbooleanMitarbeitende dürfen Zeiten mit dem Scanner erfassen.
allow_app_non_work_time_managementbooleanMitarbeitende dürfen Abwesenheiten in der App verwalten.
employment_contract_groupEmploymentContractGroupVertragsgruppe, zu der die Vorlage gehört.
Felder anzeigen (25)
staged_absence_approvalbooleannull übernimmt die Organisation; false deaktiviert die gestufte Freigabe ausdrücklich.
shift_booking_syncbooleanL35: Schichten als Verfügbarkeiten / Termine im Buchungsbereich; null übernimmt die Organisation, false schaltet es für diese Gruppe aus.
idintegerPrimä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_trackingbooleanOb die Zeiterfassung in der App erlaubt ist.
allow_scanner_time_trackingbooleanOb die Zeiterfassung per Scanner erlaubt ist.
allow_app_non_work_time_managementbooleanOb arbeitsfreie Zeit in der App verwaltet werden kann.
request_lead_time_daysintegerTage, 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_regionSchoolHolidayRegionU09: 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_stringstringText, unter dem die Entität gesucht werden kann.
deletedbooleanDiese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestringName der Einheit.
sort_orderintegerSortierreihenfolge der Vorlage in Listen.
search_stringstringText, unter dem die Entität gesucht werden kann.
deletedbooleanDiese Eigenschaft markiert eine Entität als gelöscht / archiviert
namestringName der Einheit.
createdstring (date-time)Zeitpunkt, zu dem der Datensatz angelegt wurde.
updatedstring (date-time)Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.
curl --request PATCH \
--url https://eure-instanz.iw-erp.de/api/time/employment/contract_template/42 \
--header 'content-type: application/json' \
--header 'x-iw-jwt-token: <TOKEN>' \
--data '
{
"data": {
"name": "Beispiel",
"template_type": "string",
"work_time_mode": "string",
"vacation_days_mode": "string",
"leadership_may_change_weekdays": true,
"week_total_hours": 1.5
}
}
'const options = {
method: 'PATCH',
headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
body: JSON.stringify({
data: {
name: 'Beispiel',
template_type: 'string',
work_time_mode: 'string',
vacation_days_mode: 'string',
leadership_may_change_weekdays: true,
week_total_hours: 1.5
}
})
};
fetch('https://eure-instanz.iw-erp.de/api/time/employment/contract_template/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/employment/contract_template/42"
payload = { "data": {
"name": "Beispiel",
"template_type": "string",
"work_time_mode": "string",
"vacation_days_mode": "string",
"leadership_may_change_weekdays": True,
"week_total_hours": 1.5
} }
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/employment/contract_template/42', [
'body' => '{"data":{"name":"Beispiel","template_type":"string","work_time_mode":"string","vacation_days_mode":"string","leadership_may_change_weekdays":true,"week_total_hours":1.5}}',
'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/employment/contract_template/42"),
Headers =
{
{ "x-iw-jwt-token", "<TOKEN>" },
},
Content = new StringContent("{\"data\":{\"name\":\"Beispiel\",\"template_type\":\"string\",\"work_time_mode\":\"string\",\"vacation_days_mode\":\"string\",\"leadership_may_change_weekdays\":true,\"week_total_hours\":1.5}}")
{
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\",\"template_type\":\"string\",\"work_time_mode\":\"string\",\"vacation_days_mode\":\"string\",\"leadership_may_change_weekdays\":true,\"week_total_hours\":1.5}}");
Request request = new Request.Builder()
.url("https://eure-instanz.iw-erp.de/api/time/employment/contract_template/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/employment/contract_template/42"
payload := strings.NewReader("{\"data\":{\"name\":\"Beispiel\",\"template_type\":\"string\",\"work_time_mode\":\"string\",\"vacation_days_mode\":\"string\",\"leadership_may_change_weekdays\":true,\"week_total_hours\":1.5}}")
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/employment/contract_template/42'),
headers: {'x-iw-jwt-token': '<TOKEN>', 'content-type': 'application/json'},
body: jsonEncode({
"data": {
"name": "Beispiel",
"template_type": "string",
"work_time_mode": "string",
"vacation_days_mode": "string",
"leadership_may_change_weekdays": true,
"week_total_hours": 1.5
}
}),
);
print(response.body);{
"id": 42,
"name": "Beispiel",
"template_type": "string",
"work_time_mode": "string",
"vacation_days_mode": "string",
"leadership_may_change_weekdays": true,
"week_total_hours": 1.5,
"reserved_hours_preparation": 1.5,
"reserved_hours_follow_up": 1.5,
"reserved_hours_travel": 1.5
}