Step 4 – Tour bearbeiten & freigeben

Grundidee dieses Schrittes

Nachdem in den vorherigen Schritten:

• Aufträge angelegt wurden (Step 1)

• eine Tour erstellt wurde (Step 2)

• Aufträge der Tour zugewiesen wurden (Step 3)

wird die Tour in Step 4 inhaltlich bearbeitet und finalisiert.

Dieser Schritt umfasst alle Aktionen, mit denen eine Tour:

• berechnet

• optimiert

• sortiert

• und letztlich für die Fahrer-App freigegeben wird

👉 Step 4 ist damit der Übergang von der Planung zur Ausführung.

Überblick: Verfügbare Tour-Aktionen

In DeDeFleet stehen für eine bestehende Tour folgende Aktionen zur Verfügung:

1. ChangeStatus – Status der Tour ändern (wichtig)

2. Calculate – Zeiten & Distanzen berechnen

3. Optimize – Tour automatisch optimieren

4. Reorder – Reihenfolge der Aufträge manuell festlegen

Alle Aktionen arbeiten mit der GUID der Tour, die im Request Body übergeben wird.

1. Tourstatus ändern (ChangeStatus)

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Tour/Tour_ChangeStatus

Zweck

Der Tourstatus steuert, in welcher Phase sich die Tour befindet und ob sie für die Fahrer-App sichtbar ist.

Gültige Statuswerte

Typischer Ablauf

• Tour wird erstellt → Planning

• Tour wird berechnet / optimiert

• Tour wird freigegeben → Released

• Tour wird gefahren und abgeschlossen → Completed

Request (Beispiel)

{
  "tourGuid": "00000000-0000-0000-0000-000000000000",
  "status": 1
}

Wirkung im System

• Wechsel auf Released:

  • Tour ist in der Fahrer-App sichtbar

  • Tour kann gestartet werden

• Wechsel auf Planning:

  • Tour ist nicht für die App sichtbar

⚠️ Hinweis:
Änderungen an Aufträgen oder Reihenfolge sollten vor der Freigabe erfolgen.

2. Tour berechnen (Calculate)

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Tour/Tour_Calculate

Zweck

Die Aktion Calculate berechnet für die Tour:

• Fahrzeiten zwischen den Aufträgen

• Distanzen

• zeitliche Abfolge der Stopps

Die Berechnung basiert auf:

• Reihenfolge der Aufträge

• Locations

• hinterlegten Routingdaten

---

Request

{
  "tourGuid": "00000000-0000-0000-0000-000000000000"
}

Typischer Einsatz

• nach dem Zuweisen von Aufträgen

• nach manueller Umordnung

• vor der Freigabe der Tour

---

3. Tour optimieren (Optimize)

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Tour/Tour_Optimize

Zweck

Die Aktion Optimize optimiert automatisch:

• die Reihenfolge der Aufträge

• Fahrzeit und Strecke

• ggf. zeitliche Restriktionen (z. B. Zeitfenster)

👉 Ziel ist eine effiziente Tour mit möglichst kurzer Fahrzeit bzw. Strecke.

Request

{
  "tourGuid": "00000000-0000-0000-0000-000000000000"
}

Wann sinnvoll?

• bei vielen Aufträgen

• bei unbekannter optimaler Reihenfolge

• zur automatischen Disposition

Wirkung

• Reihenfolge der Aufträge kann sich ändern

• ggf. Statusabruf der Tour ins führende System erforderlich, damit die geänderte Reihenfolge weiter berücksichtigt werden kann. Siehe "xxx"

---

4. Reihenfolge manuell festlegen (Reorder)

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Tour/Tour_Reorder

Zweck

Mit Reorder wird die Reihenfolge der Aufträge explizit vorgegeben.

Diese Aktion ist sinnvoll, wenn:

• eine bestimmte Abfolge eingehalten werden muss

• externe Planungssysteme die Reihenfolge bestimmen

• Optimierung nicht gewünscht ist

---

Request

{
  "tourGuid": "string",
  "orderGuids": [
    "string",
    "string",
    "string"
  ]
}

Bedeutung

• Die Reihenfolge der orderGuids entspricht exakt der gewünschten Abfolge in der Tour

• Alle angegebenen Aufträge müssen bereits der Tour zugewiesen sein

---

Empfohlener Ablauf (Best Practice)

Ein typischer API-Workflow sieht wie folgt aus:

1. Tour erstellen (Step 2)

2. Aufträge zuweisen (Step 3)

3. Optimize (optional)

4. Calculate

5. ChangeStatus → Released

---

Zusammenfassung Step 4

• ✔ Tour kann berechnet, optimiert und sortiert werden

• ✔ Status steuert die Sichtbarkeit in der Fahrer-App

• ✔ Freigabe erfolgt explizit über ChangeStatus

• ✔ Schritt vor der eigentlichen Ausführung