Nutzen Sie gerne unsere aktualisierte API-Dokumentation.
| Parameter | Typ | Beschreibung |
|---|---|---|
| id | integer |
Die ID des Mitarbeiters
|
| name | string |
Der Name des Mitarbeiter
|
| number | string|null |
Personalnummer
|
| string |
Die E-Mail-Adresse des Mitarbeiters
| |
| role | string |
Die Rolle des Mitarbeiters
|
| active | boolean |
Ist der Mitarbeiter aktiviert?
|
| timeformat_12h | boolean |
Nutzt der Mitarbeiter das 12h-Zeitformat?
|
| weekstart_monday | boolean |
Ist der Wochenanfang für den Mitarbeiter Montag?
Falls nicht, beginnt die Woche am Sonntag
|
| weekend_friday | boolean |
Ist das Wochenende für den Mitarbeiter Freitag und Samstag?
Falls nicht, ist das Wochenende Samstag und Sonntag
|
| language | string |
Sprache
Erlaubte Werte: 'de', 'en', 'fr'
|
| timezone | string |
Zeitzone des Mitarbeiters
z.B. 'Europe/Berlin'
|
| wage_type | integer|null |
Lohnart (nur relevant für DATEV-Export)
Erlaubte Werte: 1 (Gehalt), 2 (Stundenlohn)
|
| can_generally_see_absences | boolean |
Darf der Mitarbeiter Abwesenheiten anderer Mitarbeiter sehen?
Nur änderbar für Mitarbeiter mit der Rolle 'worker'
|
| can_generally_manage_absences | boolean |
Darf der Mitarbeiter Abwesenheiten anderer Mitarbeiter bearbeiten?
Nur änderbar für Mitarbeiter mit der Rolle 'manager'
|
| can_add_customers | boolean |
Darf der Mitarbeiter Kunden anlegen?
Nur änderbar für Mitarbeiter mit der Rolle 'worker'
|
| edit_lock | string|null |
Festgelegte Bearbeitungssperre für den Mitarbeiter
null (Keine Bearbeitungssperre) YYYY-MM-DD (Nicht bearbeitbar bis) |
| edit_lock_dyn | integer|null |
Dynamische Bearbeitungssperre für den Mitarbeiter
null (Keine Bearbeitungssperre) 1 (Heute bearbeitbar) 2 (Heute und Gestern bearbeitbar) 3 (Heute und 2 Tage rückwirkend bearbeitbar) 5 (Heute und 4 Tage rückwirkend bearbeitbar) 8 (Heute und eine Woche rückwirkend bearbeitbar) 15 (Heute und 2 Wochen rückwirkend bearbeitbar) 31 (Heute und 30 Tage rückwirkend bearbeitbar) 46 (Heute und 45 Tage rückwirkend bearbeitbar) 91 (Heute und 90 Tage rückwirkend bearbeitbar) |
| edit_lock_sync | boolean|null |
Kann die für den Mitarbeiter geltende Bearbeitungssperre durch eine Änderung der firmenweiten Bearbeitungssperre überschrieben werden?
|
| worktime_regulation_id | integer|null |
Für den Mitarbeiter geltende Arbeitszeitvorschrift
"0" wenn keine Arbeitszeitvorschrift gilt "null" wenn der Firmenstandard gilt |
| teams_id | integer|null |
Die ID des Teams, dem der Mitarbeiter zugeordnet ist
|
| initials | string|null |
Die Initialen des Mitarbeiters
|
| nonbusinessgroups_id | integer|null |
Die ID der für den Mitarbeiter gültigen Feiertagsgruppe
deprecated; verwenden Sie stattdessen v2/usersNonbusinessGroups
|
| boss | integer|null |
Die ID des Vorgesetzten des Mitarbeiters
|
| absence_managers_id | integer[] |
IDs der Mitarbeiter, die für diesen Mitarbeiter Abwesenheitsmanager sind
|
GET /api/v2/users
{
"users":
{
[object of type user],
[object of type user], ...
}
}GET /api/v2/users/[ID]
{
"user": [object of type user]
}POST /api/v2/users
| Notwendige Parameter | name, email, role |
|---|
| Optionale Parameter | mail_to_user, number, timeformat_12h, weekstart_monday, weekend_friday, language, timezone, wage_type, can_generally_see_absences, can_generally_manage_absences, can_add_customers, edit_lock_sync, teams_id, nonbusinessgroups_id, worktime_regulation_id, boss |
|---|
Der Parameter mail_to_user bestimmt, ob eine E-Mail an den neuen Mitarbeiter versendet wird (Default: false).
{
"user": [object of type user]
}PUT /api/v2/users/[ID]
| Notwendige Parameter | keine |
|---|
| Optionale Parameter | name, number, active, role, timeformat_12h, weekstart_monday, weekend_friday, language, timezone, wage_type, can_generally_see_absences, can_generally_manage_absences, can_add_customers, edit_lock, edit_lock_dyn, edit_lock_sync, teams_id, nonbusinessgroups_id, worktime_regulation_id, boss |
|---|
Die Zeitzone (timezone) kann nur für den Benutzer, der den Firmenaccount erstellt hat, und nur während der Testphase verändert werden.
{
"user": [object of type user]
}DELETE /api/v2/users/[ID]
{
"success": true
}
Unser Customer-Success-Team steht Ihnen für Fragen zur Verfügung!
Bechtle
Peerigon GmbH
Phoenix Logistik
Fidea