Step 2 – Touren anlegen (Create Tour)

Grundidee dieses Schrittes

Eine Tour ist der organisatorische Rahmen für eine geplante Fahrt.
In einer Tour werden Aufträge zusammengeführt, in eine Reihenfolge gebracht und (optional) Ressourcen wie Fahrzeug oder Fahrer zugeordnet.

In diesem Schritt wird die Tour selbst erzeugt.
Die Zuweisung von Aufträgen zur Tour erfolgt im nächsten Schritt.

Entscheidungslogik

Variante A – Tour neu anlegen (/tour/create)

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

➡️ Verwenden Sie diese Variante, wenn Sie den Rahmen der Tour selbst definieren möchten, insbesondere:

Start- und Endpunkt der Tour
Startdatum und -zeit
Zuweisung bestehender Fahrzeuge aus den Stammdaten
Zuweisung bestehender Mitarbeiter/Fahrer aus den Stammdaten (optional)

Variante B – Tour aus Vorlage anlegen (/tour/createfromtemplate)

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

➡️ Verwenden Sie diese Variante, wenn ein vordefinierter Rahmen genutzt werden soll, in dem typischerweise bereits festgelegt sind:

Start- und Endpunkt
Start- und Endzeit
Fahrzeugzuordnung
ggf. Fahrer

👉 In Variante B erzeugen Sie eine Tour, die von Anfang an „vorkonfiguriert“ ist.
In Variante A müssen diese Angaben (falls benötigt) nachträglich gesetzt werden.

Technische Umsetzung (API)

API-Basis-URL

Authentifizierung

Für alle API-Aufrufe ist ein gültiger Bearer Token erforderlich.

Variante 1 (empfohlen): Bearer Token im HTTP-Header

Variante 2: Bearer Token als URL-Parameter

Variante A – Tour neu anlegen

Endpoint

Vollständige URL

Ergebnis im System

✔ Tour wird erstellt
❌ Rahmen ist nicht automatisch vorkonfiguriert
❌ Aufträge sind noch nicht zugewiesen

Hinweis: Start-/Endpunkt, Zeiten, Fahrzeug und Fahrer müssen – falls benötigt – im weiteren Verlauf gesetzt werden (entweder über zusätzliche API-Aufrufe oder im Portal).