Skip to main content

2. Employee (Mitarbeiter / Fahrer)

Grundidee

Mitarbeiter (Employees) repräsentieren in DeDeFleet Personen, die in Touren eingesetzt werden können – typischerweise Fahrer, aber auch andere mobile Mitarbeiter.

Employees werden unter anderem verwendet für:

  • Fahrerzuweisung in Touren (Step 2)

  • Anzeige der Touren in der Fahrer-App

  • Zeitliche Planung (Arbeitszeiten, Arbeitstage)

  • optionale Fahrzeugzuordnung

👉 Employees sind Stammdaten und werden in der Regel vor der eigentlichen Tourenplanung angelegt.

2.1 Employee/Create – Mitarbeiter anlegen

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Employee/Employee_Create

Zweck

Legt einen einzelnen Mitarbeiter in DeDeFleet an.
Der Mitarbeiter kann anschließend:

  • Touren zugewiesen bekommen

  • in der Fahrer-App arbeiten (bei entsprechender Lizenz)

  • in der Planung berücksichtigt werden (Arbeitszeiten, Arbeitstage)

Endpoint

POST /employee/create

Request Body (Beispiel, 1 Mitarbeiter)

{
  "employeeNumber": "DRV-1001",
  "firstName": "Max",
  "lastName": "Mustermann",
  "password": "InitialPass123",
  "email": "max.mustermann@unternehmen.de",
  "phoneNumber": "+49 170 1234567",
  "location": {
    "type": 2,
    "street": "Industriestraße 1",
    "postal": "37154",
    "city": "Northeim",
    "country": "DE"
  },
  "workTimeStart": "07:00",
  "workTimeEnd": "16:00",
  "workingDays": [1, 2, 3, 4, 5],
  "vehicleApiID": "VEH-42",
  "hasTourPlanningLicense": true
}

Wichtige Felder & Bedeutung

Feld Beschreibung
employeeNumber Eindeutige Mitarbeiternummer (führende externe Referenz)
firstName, lastName Name des Mitarbeiters
password Passwort für die Fahrer-App
location Heimatstandort des Mitarbeiters (Location-Typen wie bei Aufträgen)
workTimeStart / workTimeEnd Reguläre Arbeitszeit
workingDays Arbeitstage (z. B. 1 = Montag, 5 = Freitag)
vehicleApiID Optional: Referenz auf ein vorhandenes Fahrzeug
hasTourPlanningLicense Steuert, ob der Mitarbeiter in Tourenplanung nutzen darf

Hinweise zur Anlage

  • Die employeeNumber wird später z. B.:

    • in Touren referenziert (driver)

  • Das Feld (hasTourPlanningLicense) ist Voraussetzung für die Nutzung der Fahrers in der Tourenplanung

Wirkung im System

  • ✔ Mitarbeiter ist als Stammdatensatz vorhanden

  • ✔ Mitarbeiter kann Touren zugewiesen werden

  • ✔ Mitarbeiter kann in der Fahrer-App eingesetzt werden (bei Lizenz)

Best Practices

  • Mitarbeiter vor der Tourenplanung anlegen

  • Arbeitszeiten und Arbeitstage pflegen, um realistische Planung zu ermöglichen

  • Fahrzeugzuordnung nur setzen, wenn ein fester Bezug besteht

Back to top