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

Variante B – Auftrag direkt bei der Erstellung einer Tour zuweisen

Prinzip

Wenn die Ziel-Tour bereits bekannt ist, kann der Auftrag direkt beim Anlegen einer Tour zugewiesen werden.

Dies erfolgt über das Feld:

tourGuid

im Create-Order-Request (siehe Step 1).

Beispiel (Auszug aus Create Order)

{
  "type": 0,
  "order": "ORDER-10003",
  "location": {
    "type": 2,
    "street": "Hauptstraße 12",
    "postal": "37154",
    "city": "Northeim",
    "country": "DE"
  },
  "plannedDeliveryDate": "2026-02-01",
  "tourGuid": "00000000-0000-0000-0000-000000000000"
}

Ergebnis im System

• ✔ Auftrag wird erstellt

• ✔ Auftrag wird sofort der angegebenen Tour zugewiesen

• ❌ Auftrag ist nicht unverplant

Vergleich der Varianten

Aspekt	Variante A – Assign	Variante B – Direkt
Zeitpunkt der Zuweisung	nachträglich	beim Create
Zwischenzustand „unverplant“	ja	nein
Flexibilität	hoch	geringer
API-Aufrufe	2	1
Typischer Einsatz	Disposition / Planung	Direkte Integration

Typische Hinweise & Stolperfallen

• Auftrag und Tour müssen existieren

• GUIDs müssen gültig sein

• Ein Auftrag kann nur einer Tour gleichzeitig zugeordnet sein

• Reihenfolge innerhalb der Tour wird ggf. automatisch gesetzt oder in späteren Schritten angepasst

Zusammenfassung Step 3

• ✔ Aufträge werden einer Tour zugewiesen

• ✔ Zwei gleichwertige Varianten je nach Integrationslogik

• ✔ Grundlage für Reihenfolge, Optimierung und Ausführung