Skip to main content

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 eineden Rahmen der Tour vollständig selbst aufbauendefinieren möchten, z. B. weil Sie:insbesondere:

  • Start-/ und Endpunkt selbstder setzenTour

  • FahrzeugStartdatum und Fahrer selbst zuordnen-zeit

  • Start-/EndzeitZuweisung selbstbestehender definierenFahrzeuge aus den Stammdaten

  • dieZuweisung Tourstrukturbestehender komplettMitarbeiter/Fahrer aus demden externenStammdaten System steuern(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 Sie einenein bereits definiertenvordefinierter Rahmen nutzengenutzt möchten,werden soll, in dem typischerweise bereits festgelegt sind:

  • Start- und Endpunkt

  • FahrzeugzuordnungStart- und Endzeit

  • Start- und EndzeitFahrzeugzuordnung

  • 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).

Back to top