Mitarbeiter erstellen

Mit diesem Endpunkt können Sie einen neuen Mitarbeiter erstellen.

Request

POST /api/v1/employees

curl --request POST \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/employees' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
         "username": "max.mustermann",
         "firstname": "Max",
         "lastname": "Mustermann",
         "email": "max.mustermann@beispiel.de",
         "password": "SicheresPasswort123!",
         "price_group": "Standard",
         "department_id": 42,
         "phone": "+49 30 123456",
         "rights": "0",
         "employment": "0",
         "birthdate": "1990-01-15",
         "street": "Hauptstraße 123",
         "zip": "10115",
         "city": "Berlin",
         "country": "Deutschland"
     }'

Response

{
    "data": {
        "id": 12345,
        "username": "max.mustermann",
        "firstname": "Max",
        "lastname": "Mustermann",
        "email": "max.mustermann@beispiel.de",
        "price_group": "Standard",
        "department_id": 42,
        "phone": "+49 30 123456",
        "rights": "0",
        "employment": "0",
        "birthdate": "1990-01-15",
        "street": "Hauptstraße 123",
        "zip": "10115",
        "city": "Berlin",
        "country": "Deutschland",
        "created": "2024-09-17T10:15:47.000000Z",
        "modified": "2024-09-17T10:15:47.000000Z"
    }
}

Erforderliche Parameter

Name
username
Type
string
Description
Eindeutiger Benutzername (5–255 Zeichen).
Name
firstname
Type
string
Description
Vorname des Mitarbeiters.
Name
lastname
Type
string
Description
Nachname des Mitarbeiters.
Name
email
Type
string
Description
Eindeutige E-Mail-Adresse.
Name
password
Type
string
Description
Passwort (min. 8 Zeichen, max. 48).
Name
price_group
Type
string
Description
Name der Preisgruppe.

Optionale Parameter

Name
personal_number
Type
string
Description
Personalnummer (muss eindeutig sein, falls angegeben).
Name
birthdate
Type
date | Y-m-d
Description
Geburtsdatum des Mitarbeiters.
Name
phone
Type
string
Description
Geschäftliche Telefonnummer.
Name
department_id
Type
integer
Description
ID der Abteilung.
Name
rights
Type
string | enum
Description
Zugriffsrechte: 0 (Benutzer), 1 (Admin), 2 (Controller), 3 (Benutzer mit erweiterten Rechten), 4 (Projekt-Controller).
Name
employment
Type
string | enum
Description
Beschäftigungsart: 0 (Mitarbeiter), 1 (Freelancer), 2 (Freelancer mit Gutschrift).
Name
oauthUsername
Type
string
Description
OAuth-Benutzername (muss eindeutig sein, falls angegeben).

Adressinformationen

Name
street
Type
string
Description
Straße und Hausnummer.
Name
zip
Type
string
Description
Postleitzahl.
Name
city
Type
string
Description
Stadt.
Name
country
Type
string
Description
Land.

Persönliche Informationen

Name
abbreviation
Type
string
Description
Mitarbeiterkürzel.
Name
salutation
Type
string
Description
Anrede.
Name
title
Type
string
Description
Titel (z.B. Dr., Prof.).
Name
mobile
Type
string
Description
Mobiltelefonnummer.
Name
fax
Type
string
Description
Faxnummer.
Name
private_phone
Type
string
Description
Private Telefonnummer.

Bankinformationen

Name
iban
Type
string
Description
IBAN.
Name
bic
Type
string
Description
BIC/SWIFT-Code.
Name
account_no
Type
string
Description
Kontonummer.
Name
bank_name
Type
string
Description
Bankname.
Name
bank_code
Type
string
Description
Bankleitzahl.
Name
currency
Type
string
Description
Währungscode.

Zusätzliche Informationen

Name
approval_date
Type
date | Y-m-d
Description
Genehmigungsdatum.
Name
vat
Type
string
Description
Umsatzsteuer-ID.
Name
personio_id
Type
string
Description
Personio-ID.
Name
cost_bearer
Type
string
Description
Kostenträger.
Name
tax_id
Type
string
Description
Steuer-ID.
Name
creditor_number
Type
string
Description
Kreditorennummer.
Name
categories
Type
array
Description
Liste von Kategorie-Strings.
Name
dynamicAttributes
Type
array
Description
Liste von dynamischen Attribut-Objekten.

GET Alle Mitarbeiter GET Mitarbeiter