Mitarbeiter erstellen
Mit diesem Endpunkt können Sie einen neuen Mitarbeiter erstellen.
Request
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.