Step 3 – Aufträge einer Tour zuweisen (Assign Orders)

Grundidee dieses Schrittes

In Step 1 wurden Aufträge angelegt (unverplant).
In Step 2 wurde eine Tour erstellt (leer oder vorkonfiguriert).

In Step 3 werden Aufträge konkret einer bestehenden Tour zugewiesen.
Erst dadurch werden Aufträge Teil einer geplanten Fahrt.

👉 Nach diesem Schritt:

• ist der Auftrag verplant

• gehört der Auftrag zur Tour

• kann die Tour weiter kalkuliert oder auch optimiert

Voraussetzungen

• Auftrag existiert und GUID ist bekannt (aus Step 1)

• Tour existiert und GUID ist bekannt (aus Step 2)

• Authentifizierung ist eingerichtet (Step 0)

Entscheidungslogik

Es gibt zwei gleichwertige Varianten, um einen Auftrag einer Tour zuzuweisen.

Variante A – Nachträgliches Zuordnen (separater Assign-Endpunkt)

➡️ Verwenden Sie diese Variante, wenn:

• Aufträge zuerst unverplant angelegt werden

• Touren später erstellt oder festgelegt werden

• Disposition oder Planung zeitlich getrennt erfolgt

---

Variante B – Direkte Zuordnung beim Anlegen des Auftrags

➡️ Verwenden Sie diese Variante, wenn:

• die Tour bereits bekannt ist

• der Auftrag sofort einer Tour zugeordnet werden soll

• kein unverplanter Zwischenzustand benötigt wird

Variante A – Auftrag nachträglich einer Tour zuweisen

Endpoint

POST /order/assign

Vollständige URL

https://ortung.dedefleet.de/data/api/2/order/assign

Request Body

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

Bedeutung der Felder

Feld	Beschreibung
tourGuid	GUID der Ziel-Tour
orderGuid	GUID des zuzuweisenden Auftrags

Ergebnis im System

• ✔ Auftrag wird der Tour zugewiesen

• ✔ Auftrag ist nicht mehr unverplant

• ✔ Auftrag ist Bestandteil der Tour