REST DokumentationMitarbeiterPATCH Mitarbeiter aktualisieren

Mitarbeiter aktualisieren

Aktualisiert die angegebenen Felder eines bestehenden Mitarbeiters. Nur die übermittelten Felder werden geändert, alle anderen behalten ihren aktuellen Wert.

Verfügbarkeit: Vollversion und ZEP Clock

PUT wird für diese Operation als Alias von PATCH akzeptiert.

Request

PATCH /api/v1/employees/{username}
curl --request PATCH \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/employees/{username}' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
       "username": "max.mustermann",
       "firstname": "Max",
       "lastname": "Mustermann",
       "email": "erika.mustermann@acme-corp.de",
       "personal_number": "1",
       "birthdate": "1985-08-17T00:00:00.000000Z",
       "phone": "+49 30 12345678",
       "department_id": 1,
       "rights": 0,
       "employment": 0,
       "price_group": "Junior-Entwickler",
       "oauth_username": "string",
       "salutation": "Herr",
       "street": "Musterstraße 30",
       "zip": "71254",
       "city": "Berlin",
       "country": "Deutschland",
       "abbreviation": "MM",
       "title": "Dr.",
       "mobile": "+49 170 1234567",
       "fax": "+1-555-0124",
       "private_phone": "07156 33958",
       "iban": "DE89370400440532013000",
       "bic": "COBADEFFXXX",
       "account_no": "string",
       "bank_name": "string",
       "bank_code": "string",
       "currency": "EUR",
       "approval_date": "2026-01-31T09:00:00.000000Z",
       "vat": 1.5,
       "personio_id": "string",
       "connector_external_ids": [
         "string"
       ],
       "cost_bearer": "string",
       "tax_id": "string",
       "creditor_number": "80033",
       "cost_accounting_ads": true,
       "categories": [
         {
           "name": "string"
         }
       ],
       "dynamicAttributes": [
         [
           "string"
         ]
       ]
     }'

Pfad-Parameter

  • Name
    username
    Type
    string
    Description

    Der Benutzername des Mitarbeiters

Request-Body

  • Name
    username
    Type
    string, erforderlich
    Description

    Eindeutiger Login-Name des Mitarbeiters. Nicht tatsächlich änderbar — muss mit dem aktuellen Benutzernamen des Mitarbeiters übereinstimmen.

  • Name
    firstname
    Type
    string
    Description

    Vorname des Mitarbeiters.

  • Name
    lastname
    Type
    string
    Description

    Nachname des Mitarbeiters.

  • Name
    email
    Type
    string (email)
    Description

    Geschäftliche E-Mail-Adresse des Mitarbeiters.

  • Name
    personal_number
    Type
    string, nullable
    Description

    Personalnummer des Mitarbeiters, wie auf der Gehaltsabrechnung angegeben.

  • Name
    birthdate
    Type
    string (date-time), nullable
    Description

    Geburtsdatum des Mitarbeiters.

  • Name
    phone
    Type
    string, nullable
    Description

    Geschäftliche Festnetznummer.

  • Name
    department_id
    Type
    integer, nullable
    Description

    Kennung der Abteilung, der der Mitarbeiter zugeordnet ist.

  • Name
    rights
    Type
    integer, nullable
    Description

    Rechtestufe, die dem Mitarbeiter in der Anwendung gewährt wird.

    Einer der Werte: 0, 1, 2, 3, 4, 5, 11

  • Name
    employment
    Type
    integer, nullable
    Description

    Art der Beschäftigung (festangestellt, freiberuflich, …).

    Einer der Werte: 0, 1, 2

  • Name
    price_group
    Type
    string
    Description

    Preisgruppe, aus der die Abrechnungssätze des Mitarbeiters abgeleitet werden.

  • Name
    oauth_username
    Type
    string, nullable
    Description

    Benutzername, mit dem der Mitarbeiter einer externen OAuth-Identität zugeordnet wird.

  • Name
    salutation
    Type
    string, nullable
    Description

    Anrede (Herr, Frau, …), die bei der Ansprache des Mitarbeiters verwendet wird.

    Einer der Werte: "Herr", "Frau", "Divers"

  • Name
    street
    Type
    string, nullable
    Description

    Straße und Hausnummer der Adresse des Mitarbeiters.

  • Name
    zip
    Type
    string, nullable
    Description

    Postleitzahl der Adresse des Mitarbeiters.

  • Name
    city
    Type
    string, nullable
    Description

    Ort der Adresse des Mitarbeiters.

  • Name
    country
    Type
    string, nullable
    Description

    Land der Adresse des Mitarbeiters.

  • Name
    abbreviation
    Type
    string, nullable
    Description

    Kurzzeichen zur Identifikation des Mitarbeiters in kompakten Ansichten und Berichten.

  • Name
    title
    Type
    string, nullable
    Description

    Akademischer oder beruflicher Titel, sofern vorhanden.

  • Name
    mobile
    Type
    string, nullable
    Description

    Geschäftliche Mobilnummer.

  • Name
    fax
    Type
    string, nullable
    Description

    Geschäftliche Faxnummer.

  • Name
    private_phone
    Type
    string, nullable
    Description

    Private Telefonnummer, getrennt von der geschäftlichen Telefonnummer geführt.

  • Name
    iban
    Type
    string, nullable
    Description

    IBAN (International Bank Account Number) für Erstattungen und Gehaltszahlungen.

  • Name
    bic
    Type
    string, nullable
    Description

    BIC (Bank Identifier Code) der Bank des Mitarbeiters.

  • Name
    account_no
    Type
    string, nullable
    Description

    Kontonummer, wird verwendet, wenn keine IBAN verfügbar ist.

  • Name
    bank_name
    Type
    string, nullable
    Description

    Name der Bank des Mitarbeiters.

  • Name
    bank_code
    Type
    string, nullable
    Description

    Bankleitzahl der Bank des Mitarbeiters.

  • Name
    currency
    Type
    string, nullable
    Description

    Währung, in der die Stundensätze und Erstattungen des Mitarbeiters angegeben sind.

  • Name
    approval_date
    Type
    string (date-time), nullable
    Description

    Datum, an dem die Daten/der Vertrag des Mitarbeiters genehmigt wurden.

  • Name
    vat
    Type
    number, nullable
    Description

    Umsatzsteuersatz, der auf die abgerechneten Stundensätze des Mitarbeiters angewendet wird.

  • Name
    personio_id
    Type
    string, nullable
    Description

    Kennung des Mitarbeiters im angebundenen Personio-HR-System, sofern verknüpft.

  • Name
    connector_external_ids
    Type
    Liste von string, nullable
    Description

    Externe Kennungen, mit denen dieser Mitarbeiter je Connector zugeordnet wird.

  • Name
    cost_bearer
    Type
    string, nullable
    Description

    Kostenstelle, auf die Zeiten und Auslagen des Mitarbeiters gebucht werden.

  • Name
    tax_id
    Type
    string, nullable
    Description

    Steueridentifikationsnummer des Mitarbeiters.

  • Name
    creditor_number
    Type
    string, nullable
    Description

    Kreditorennummer, die bei der Erstattung an den Mitarbeiter über die Buchhaltung verwendet wird.

  • Name
    cost_accounting_ads
    Type
    boolean, nullable
    Description

    Ob die Kostenrechnung des Mitarbeiters über ADS übermittelt wird.

  • Name
    categories
    Type
    Liste von object, nullable
    Description

    Namen der Mitarbeiter-Kategorien, denen der Mitarbeiter angehört. Die Liste ersetzt die bisherige Zuordnung vollständig; eine leere Liste entfernt alle Kategorien, ein fehlendes oder leeres (null) Feld lässt sie unverändert.

  • Name
    categories.name
    Type
    string, erforderlich
    Description

    Name einer vorhandenen Mitarbeiter-Kategorie; ein unbekannter Name oder eine reine Projekt-Kategorie wird abgelehnt.

  • Name
    dynamicAttributes
    Type
    Liste von array, nullable
    Description

    Benutzerdefinierte dynamische Attribute, die für den Mitarbeiter gesetzt werden sollen.

Response

{
  "data": {
    "username": "max.mustermann",
    "firstname": "Max",
    "lastname": "Mustermann",
    "personal_number": "1",
    "street": "Musterstraße 30",
    "zip": "71254",
    "city": "Berlin",
    "country": "Deutschland",
    "abbreviation": "MM",
    "salutation": {
      "id": "string",
      "name": "string"
    },
    "title": "Dr.",
    "email": "erika.mustermann@acme-corp.de",
    "phone": "+49 30 12345678",
    "mobile": "+49 170 1234567",
    "fax": "+1-555-0124",
    "private_phone": "07156 33958",
    "birthdate": "1985-08-17T00:00:00.000000Z",
    "iban": "DE89370400440532013000",
    "bic": "COBADEFFXXX",
    "account_no": "string",
    "bank_name": "string",
    "bank_code": "string",
    "currency": "EUR",
    "approval_date": "2026-01-31T09:00:00.000000Z",
    "vat": 1.5,
    "price_group": "Junior-Entwickler",
    "employment": {
      "id": "string",
      "name": "Mitarbeiter/in"
    },
    "rights": {
      "id": "string",
      "name": "User"
    },
    "department_id": 1,
    "language": {
      "locale": "string",
      "isoCode": "de",
      "name": "deutsch",
      "dateFormat": "d.m.Y",
      "dateTimeFormat": "d.m.Y H:i",
      "numberFormat": {
        "decimalSeparator": "string",
        "thousandsSeparator": "string"
      }
    },
    "personio_id": "string",
    "cost_bearer": "string",
    "cost_center": "4711",
    "note": "Familienurlaub",
    "overtime_ads": true,
    "tax_id": "string",
    "created": "2024-07-20T11:30:00.000000Z",
    "modified": "2024-07-20T12:30:00.000000Z",
    "creditor_number": "80033",
    "categories": [
      {
        "name": "EU",
        "description": {
          "de": "string",
          "en": "string",
          "fr": "string",
          "es": "string",
          "pl": "string"
        },
        "type": {
          "id": "string",
          "name": "Mitarbeiter/in"
        }
      }
    ],
    "dynamicAttributes": [
      {
        "name": "EU",
        "value": "Max Mustermann (Bruder)",
        "type": "Text",
        "description": {
          "de": "string",
          "en": "string",
          "fr": "string",
          "es": "string",
          "pl": "string"
        }
      }
    ],
    "employment_periods": [
      {
        "id": 1,
        "employee_id": "max.mustermann",
        "start_date": "2024-01-01",
        "end_date": null
      }
    ],
    "regular_working_times": [
      {
        "id": 1,
        "employee_id": "max.mustermann",
        "start_date": "2024-01-01",
        "monday": 8
      }
    ],
    "internal_rates": [
      {
        "id": 1,
        "employee_id": "max.mustermann",
        "start_date": "2024-01-01",
        "internal_rate": 85.5
      }
    ],
    "absences_count": 1,
    "regularWorkingTimes_count": 1,
    "employmentPeriods_count": 1,
    "internalRates_count": 1
  }
}

Response-Felder

  • Name
    username
    Type
    string
    Description

    Eindeutiger Anmeldename des Mitarbeiters, wird auch als seine Kennung in der API verwendet.

  • Name
    firstname
    Type
    string
    Description

    Vorname des Mitarbeiters.

  • Name
    lastname
    Type
    string
    Description

    Nachname des Mitarbeiters.

  • Name
    personal_number
    Type
    string, nullable
    Description

    Personalnummer des Mitarbeiters, wie auf der Gehaltsabrechnung angegeben.

  • Name
    street
    Type
    string, nullable
    Description

    Straße und Hausnummer der Adresse des Mitarbeiters.

  • Name
    zip
    Type
    string, nullable
    Description

    Postleitzahl der Adresse des Mitarbeiters.

  • Name
    city
    Type
    string, nullable
    Description

    Ort der Adresse des Mitarbeiters.

  • Name
    country
    Type
    string, nullable
    Description

    Land der Adresse des Mitarbeiters.

  • Name
    abbreviation
    Type
    string, nullable
    Description

    Kurzzeichen zur Identifikation des Mitarbeiters in kompakten Ansichten und Berichten.

  • Name
    salutation
    Type
    object, nullable
    Description

    Anrede (Herr, Frau, …), die bei der Ansprache des Mitarbeiters verwendet wird.

  • Name
    salutation.id
    Type
    string
    Description

    Der gespeicherte Wert. Vergleichen Sie gegen diesen, nicht gegen name.

  • Name
    salutation.name
    Type
    string
    Description

    Die lesbare Bezeichnung in der Sprache des Mandanten. Nicht parsen.

  • Name
    title
    Type
    string, nullable
    Description

    Akademischer oder beruflicher Titel, sofern vorhanden.

  • Name
    email
    Type
    string, nullable
    Description

    Geschäftliche E-Mail-Adresse, unter der der Mitarbeiter erreichbar ist und eingeladen wird.

  • Name
    phone
    Type
    string, nullable
    Description

    Geschäftliche Festnetznummer.

  • Name
    mobile
    Type
    string, nullable
    Description

    Geschäftliche Mobilnummer.

  • Name
    fax
    Type
    string, nullable
    Description

    Geschäftliche Faxnummer.

  • Name
    private_phone
    Type
    string, nullable
    Description

    Private Telefonnummer, getrennt von der geschäftlichen Telefonnummer geführt.

  • Name
    birthdate
    Type
    string (date-time), nullable
    Description

    Geburtsdatum des Mitarbeiters.

  • Name
    iban
    Type
    string, nullable
    Description

    IBAN (International Bank Account Number) für Erstattungen und Gehaltszahlungen.

  • Name
    bic
    Type
    string, nullable
    Description

    BIC (Bank Identifier Code) der Bank des Mitarbeiters.

  • Name
    account_no
    Type
    string, nullable
    Description

    Kontonummer, wird verwendet, wenn keine IBAN verfügbar ist.

  • Name
    bank_name
    Type
    string, nullable
    Description

    Name der Bank des Mitarbeiters.

  • Name
    bank_code
    Type
    string, nullable
    Description

    Bankleitzahl der Bank des Mitarbeiters.

  • Name
    currency
    Type
    string, nullable
    Description

    Währung, in der die Stundensätze und Erstattungen des Mitarbeiters angegeben sind.

  • Name
    approval_date
    Type
    string (date-time), nullable
    Description

    Datum, an dem die Daten/der Vertrag des Mitarbeiters genehmigt wurden.

  • Name
    vat
    Type
    number, nullable
    Description

    Umsatzsteuersatz, der auf die abgerechneten Stundensätze des Mitarbeiters angewendet wird.

  • Name
    price_group
    Type
    string
    Description

    Preisgruppe, aus der die Abrechnungssätze des Mitarbeiters abgeleitet werden.

  • Name
    employment
    Type
    object, nullable
    Description

    Art der Beschäftigung (festangestellt, freiberuflich, …).

  • Name
    employment.id
    Type
    string
    Description

    Der gespeicherte Wert. Vergleichen Sie gegen diesen, nicht gegen name.

  • Name
    employment.name
    Type
    string
    Description

    Die lesbare Bezeichnung in der Sprache des Mandanten. Nicht parsen.

    Einer der Werte: "Mitarbeiter/in", "Freier Mitarbeiter", "Freier Mitarbeiter mit Gutschrift"

  • Name
    rights
    Type
    object
    Description

    Rechtestufe, die dem Mitarbeiter in der Anwendung gewährt wird.

  • Name
    rights.id
    Type
    string
    Description

    Der gespeicherte Wert. Vergleichen Sie gegen diesen, nicht gegen name.

  • Name
    rights.name
    Type
    string
    Description

    Die lesbare Bezeichnung in der Sprache des Mandanten. Nicht parsen.

    Einer der Werte: "User", "Administrator", "Controller", "User with additional authorizations", "Projektcontroller", "Kundenansprechpartner", "System-Administrator"

  • Name
    department_id
    Type
    integer
    Description

    Kennung der Abteilung, der der Mitarbeiter derzeit angehört.

  • Name
    language
    Type
    object, nullable
    Description

    Sprache, in der Oberfläche und Kommunikation für den Mitarbeiter angezeigt werden.

  • Name
    language.locale
    Type
    string
    Description
  • Name
    language.isoCode
    Type
    string
    Description

    Einer der Werte: "de", "en", "fr", "es", "pl", "sk", "tr"

  • Name
    language.name
    Type
    string
    Description

    Einer der Werte: "deutsch", "German (Austria)", "German (Switzerland)", "englisch", "English (German Format)", "English (Europe)", "English (Great Britain)", "English (USA)", "französisch", "French (Switzerland)", "French (German Format)", "Spanisch", "Polnisch", "Slovak", "Turkish"

  • Name
    language.dateFormat
    Type
    string
    Description

    Einer der Werte: "d.m.Y", "d/m/Y", "m/d/Y"

  • Name
    language.dateTimeFormat
    Type
    string
    Description

    Einer der Werte: "d.m.Y H:i", "d/m/Y H:i", "m/d/Y H:i"

  • Name
    language.numberFormat
    Type
    object
    Description
  • Name
    personio_id
    Type
    string, nullable
    Description

    Kennung des Mitarbeiters im angebundenen Personio-HR-System, sofern verknüpft.

  • Name
    cost_bearer
    Type
    string, nullable
    Description

    Kostenträger, auf den Zeiten und Auslagen des Mitarbeiters gebucht werden.

  • Name
    cost_center
    Type
    string, nullable
    Description

    Kostenstelle, der der Mitarbeiter angehört; nicht identisch mit dem Kostenträger.

  • Name
    note
    Type
    string, nullable
    Description

    Freitext-Notiz zum Mitarbeiter.

  • Name
    overtime_ads
    Type
    boolean, nullable
    Description

    Ob die Überstunden des Mitarbeiters angezeigt werden; null, wenn nie gesetzt.

  • Name
    tax_id
    Type
    string, nullable
    Description

    Steueridentifikationsnummer des Mitarbeiters.

  • Name
    created
    Type
    string (date-time), nullable
    Description

    Zeitstempel der Erstellung des Mitarbeiterdatensatzes.

  • Name
    modified
    Type
    string (date-time), nullable
    Description

    Zeitstempel der letzten Änderung des Mitarbeiterdatensatzes.

  • Name
    creditor_number
    Type
    string, nullable
    Description

    Kreditorennummer, die bei der Erstattung an den Mitarbeiter über die Buchhaltung verwendet wird.

  • Name
    categories
    Type
    Liste von Category
    Description

    Kategorien, denen der Mitarbeiter zugeordnet ist.

  • Name
    categories.name
    Type
    string
    Description

    Name der Kategorie, wird überall angezeigt, wo eine Entität damit gekennzeichnet ist.

  • Name
    categories.description
    Type
    object
    Description

    Ausführlichere Erläuterung, wofür diese Kategorie verwendet werden soll.

  • Name
    categories.type
    Type
    object
    Description

    Art der Entität, der diese Kategorie zugeordnet werden kann, z. B. Mitarbeiter, Projekt oder Kunde.

  • Name
    dynamicAttributes
    Type
    Liste von DynamicAttribute
    Description

    Für diesen Mandanten konfigurierte dynamische Attribute, die bei diesem Mitarbeiter gesetzt sind.

  • Name
    dynamicAttributes.name
    Type
    string
    Description

    Name der Definition des dynamischen Attributs, für die dieser Wert eingegeben wurde.

  • Name
    dynamicAttributes.value
    Type
    any
    Description

    Der gespeicherte Wert; seine Form hängt vom benachbarten Feld type ab (eine Zeichenkette, eine Zahl, ein Boolean, ein Datum, eine Mitarbeiterreferenz oder eine Liste von Optionswerten).

  • Name
    dynamicAttributes.type
    Type
    string
    Description

    Datentyp dieses Attributs, z. B. Text, Zahl, Datum oder Optionen; bestimmt, wie value zu interpretieren ist.

    Einer der Werte: "Text", "Integer", "Float", "URL", "E-Mail", "Datum", "Uhrzeit", "Datetime", "Boolean", "Betrag", "Optionen", "Prozent", "Time period", "Textarea", "Users", "Upload"

  • Name
    dynamicAttributes.description
    Type
    object, nullable
    Description

    Erläuterung, was dieses Attribut erfasst, wie in seiner Definition konfiguriert.

  • Name
    employment_periods
    Type
    Liste von EmploymentPeriod
    Description

    Beschäftigungszeiträume des Mitarbeiters, im selben Format wie am Endpunkt für Beschäftigungszeiträume. Nur mit include=employment_periods vorhanden; die Liste ist vollständig, nicht paginiert.

  • Name
    employment_periods.id
    Type
    integer
    Description

    Eindeutige Kennung des Beschäftigungszeitraums.

  • Name
    employment_periods.employee_id
    Type
    string
    Description

    Benutzername des Mitarbeiters, zu dem dieser Beschäftigungszeitraum gehört.

  • Name
    employment_periods.start_date
    Type
    string (date-time), nullable
    Description

    Erster Kalendertag, an dem der Mitarbeiter in diesem Zeitraum beschäftigt war.

  • Name
    employment_periods.end_date
    Type
    string (date-time), nullable
    Description

    Letzter Kalendertag, an dem der Mitarbeiter in diesem Zeitraum beschäftigt war, sofern beendet.

  • Name
    employment_periods.note
    Type
    string, nullable
    Description

    Freitextnotiz zum Beschäftigungszeitraum.

  • Name
    employment_periods.beginning_of_year
    Type
    string (date-time), nullable
    Description

    Kalendertag, an dem das Urlaubsjahr für diesen Beschäftigungszeitraum beginnt.

  • Name
    employment_periods.annual_leave_entitlement
    Type
    number, nullable
    Description

    Anzahl der Urlaubstage, auf die der Mitarbeiter pro vollem Urlaubsjahr Anspruch hat.

  • Name
    employment_periods.period_holiday_entitlement
    Type
    number, nullable
    Description

    Anzahl der Urlaubstage, auf die der Mitarbeiter Anspruch hat, anteilig für diesen Zeitraum.

  • Name
    employment_periods.is_holiday_per_year
    Type
    boolean, nullable
    Description

    Ob der Urlaubsanspruch pro Kalenderjahr und nicht pro Beschäftigungszeitraum angegeben ist.

  • Name
    employment_periods.day_absent_in_hours
    Type
    number, nullable
    Description

    Anzahl der Stunden, mit denen ein ganzer Fehltag für diesen Beschäftigungszeitraum gebucht wird.

  • Name
    employment_periods.created
    Type
    string (date-time), nullable
    Description

    Zeitstempel der Erstellung des Beschäftigungszeitraums.

  • Name
    employment_periods.modified
    Type
    string (date-time), nullable
    Description

    Zeitstempel der letzten Änderung des Beschäftigungszeitraums.

  • Name
    regular_working_times
    Type
    Liste von RegularWorkingTime
    Description

    Regelarbeitszeiten des Mitarbeiters, im selben Format wie am Endpunkt für Regelarbeitszeiten. Nur mit include=regular_working_times vorhanden; die Liste ist vollständig, nicht paginiert.

  • Name
    regular_working_times.id
    Type
    integer
    Description

    Eindeutige Kennung der Regelarbeitszeit.

  • Name
    regular_working_times.employee_id
    Type
    string
    Description

    Benutzername des Mitarbeiters, für den diese Regelarbeitszeit gilt.

  • Name
    regular_working_times.start_date
    Type
    string (date-time), nullable
    Description

    Kalendertag, ab dem diese Regelarbeitszeit gilt.

  • Name
    regular_working_times.monday
    Type
    number, nullable
    Description

    Geplante Arbeitsstunden am Montag.

  • Name
    regular_working_times.monday_workday
    Type
    boolean, nullable
    Description

    Ob Montag in dieser Regelarbeitszeit als Arbeitstag zählt.

  • Name
    regular_working_times.tuesday
    Type
    number, nullable
    Description

    Geplante Arbeitsstunden am Dienstag.

  • Name
    regular_working_times.tuesday_workday
    Type
    boolean, nullable
    Description

    Ob Dienstag in dieser Regelarbeitszeit als Arbeitstag zählt.

  • Name
    regular_working_times.wednesday
    Type
    number, nullable
    Description

    Geplante Arbeitsstunden am Mittwoch.

  • Name
    regular_working_times.wednesday_workday
    Type
    boolean, nullable
    Description

    Ob Mittwoch in dieser Regelarbeitszeit als Arbeitstag zählt.

  • Name
    regular_working_times.thursday
    Type
    number, nullable
    Description

    Geplante Arbeitsstunden am Donnerstag.

  • Name
    regular_working_times.thursday_workday
    Type
    boolean, nullable
    Description

    Ob Donnerstag in dieser Regelarbeitszeit als Arbeitstag zählt.

  • Name
    regular_working_times.friday
    Type
    number, nullable
    Description

    Geplante Arbeitsstunden am Freitag.

  • Name
    regular_working_times.friday_workday
    Type
    boolean, nullable
    Description

    Ob Freitag in dieser Regelarbeitszeit als Arbeitstag zählt.

  • Name
    regular_working_times.saturday
    Type
    number, nullable
    Description

    Geplante Arbeitsstunden am Samstag.

  • Name
    regular_working_times.saturday_workday
    Type
    boolean, nullable
    Description

    Ob Samstag in dieser Regelarbeitszeit als Arbeitstag zählt.

  • Name
    regular_working_times.sunday
    Type
    number, nullable
    Description

    Geplante Arbeitsstunden am Sonntag.

  • Name
    regular_working_times.sunday_workday
    Type
    boolean, nullable
    Description

    Ob Sonntag in dieser Regelarbeitszeit als Arbeitstag zählt.

  • Name
    regular_working_times.is_monthly
    Type
    boolean, nullable
    Description

    Ob die Regelarbeitszeit als Monatssumme statt pro Wochentag definiert ist.

  • Name
    regular_working_times.monthly_hours
    Type
    number, nullable
    Description

    Geplante Arbeitsstunden pro Monat, nur gesetzt, wenn die Regelarbeitszeit monatlich definiert ist.

  • Name
    regular_working_times.max_hours_in_month
    Type
    number, nullable
    Description

    Maximal zulässige Arbeitsstunden pro Monat gemäß dieser Regelarbeitszeit.

  • Name
    regular_working_times.max_hours_in_week
    Type
    number, nullable
    Description

    Maximal zulässige Arbeitsstunden pro Woche gemäß dieser Regelarbeitszeit.

  • Name
    regular_working_times.holidayCalendar
    Type
    object (HolidayCalendar)
    Description

    Feiertagskalender, aus dem die gesetzlichen Feiertage dieser Regelarbeitszeit stammen.

  • Name
    regular_working_times.breakRegulationType
    Type
    object (BreakRegulationType)
    Description

    Pausenregelung, die bei der Berechnung der Pausen für diese Regelarbeitszeit angewendet wird.

  • Name
    internal_rates
    Type
    Liste von InternalRate
    Description

    Interne Stundensätze des Mitarbeiters, im selben Format wie am Endpunkt für interne Stundensätze. Nur mit include=internal_rates vorhanden; die Liste ist vollständig, nicht paginiert.

  • Name
    internal_rates.id
    Type
    integer
    Description

    Eindeutige Kennung des internen Stundensatzes.

  • Name
    internal_rates.employee_id
    Type
    string
    Description

    Benutzername des Mitarbeiters, für den dieser interne Stundensatz gilt.

  • Name
    internal_rates.start_date
    Type
    string (date-time)
    Description

    Kalendertag, ab dem dieser interne Stundensatz gilt.

  • Name
    internal_rates.internal_rate
    Type
    number, nullable
    Description

    Interner (Kosten-)Satz, der für die Zeit des Mitarbeiters angesetzt wird.

  • Name
    internal_rates.note
    Type
    string, nullable
    Description

    Freitextnotiz zum internen Stundensatz.

  • Name
    internal_rates.monthly_rate
    Type
    number, nullable
    Description

    Fester Monatssatz, der anstelle des Stundensatzes verwendet wird, sofern zutreffend.

  • Name
    internal_rates.internal_rate_resets
    Type
    number, nullable
    Description

    Intervall, in dem der interne Stundensatz zurückgesetzt wird (z. B. monatlich, jährlich).

  • Name
    internal_rates.rate_type
    Type
    object, nullable
    Description

    Ob der Satz stündlich oder als fester Monatsbetrag angesetzt wird.

  • Name
    internal_rates.created
    Type
    string (date-time), nullable
    Description

    Zeitstempel der Erstellung des internen Stundensatzes.

  • Name
    internal_rates.modified
    Type
    string (date-time), nullable
    Description

    Zeitstempel der letzten Änderung des internen Stundensatzes.

  • Name
    absences_count
    Type
    integer
    Description

    Anzahl der für diesen Mitarbeiter erfassten Fehlzeiten.

  • Name
    regularWorkingTimes_count
    Type
    integer
    Description

    Anzahl der für diesen Mitarbeiter erfassten Regelarbeitszeiten.

  • Name
    employmentPeriods_count
    Type
    integer
    Description

    Anzahl der für diesen Mitarbeiter erfassten Beschäftigungszeiträume.

  • Name
    internalRates_count
    Type
    integer
    Description

    Anzahl der für diesen Mitarbeiter erfassten internen Stundensätze.

Aus der OpenAPI-Spezifikation erzeugt — Änderungen gehören in den Quellcode, nicht auf diese Seite.