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

POST /tour/create

Vollständige URL

https://ortung.dedefleet.de/data/api/2/tour/create

Beispiel: Tour neu anlegen (frei definierter Rahmen)

{
  "tour": "TOUR-2026-02-01-01",
  "vehicleApiID": "VEH-42",
  "trailer": "",
  "driver": "DRV-17",
  "departure": {
    "date": "2026-02-01",
    "time": "07:00",
    "location": {
      "type": 2,
      "name": "Zentrallager Northeim",
      "street": "Industriestraße 1",
      "postal": "37154",
      "city": "Northeim",
      "country": "DE"
    }
  },
  "return": {
    "latestReturnTime": "17:00",
    "toDepot": true,
    "location": {
      "type": 2,
      "name": "Zentrallager Northeim",
      "street": "Industriestraße 1",
      "postal": "37154",
      "city": "Northeim",
      "country": "DE"
    }
  },
  "notes": "Tagestour Region Südniedersachsen",
  "status": 0
}

Ergebnis im System

• ✔ Tour wird erstellt

• ❌✔ RahmenStart/Ende istsowie nichtZeiten automatischsind vorkonfiguriertdefiniert

• ✔ Fahrzeug/Fahrer sind als Stammdaten referenziert

• ❌ Keine Aufträge sind noch nicht zugewiesen

Variante B – Tour aus Vorlage anlegen

Endpoint

POST /tour/createfromtemplate

Vollständige URL

https://ortung.dedefleet.de/data/api/2/tour/createfromtemplate

Beispiel: Tour aus Vorlage erzeugen

{
  "templateName": "Standard-Tagestour-Lager-Nord",
  "tourName": "TOUR-2026-02-01-02",
  "date": "2026-02-01",
  "status": 0
}

Ergebnis im System

• Hinweis:✔ Start-/Endpunkt,Tour wird erstellt

• ✔ Vordefinierter Rahmen (Start/Ende, Zeiten, FahrzeugFahrzeug, undggf. FahrerFahrer) müssenwird übernommen

• ❌ Keine Aufträge zugewiesen

Vergleich der Varianten

benötigtweiterenVerlaufgesetztwerden(entweder oderPortal).

Aspekt	Variante A – fallsCreate	Variante B – imTemplate
Start-/Endpunkt	wird über zusätzlichePayload API-Aufrufegesetzt	aus imVorlage
Zeitrahmen	wird über Payload gesetzt	aus Vorlage
Fahrzeug	Referenz auf Stammdaten (vehicleApiID)	aus Vorlage
Fahrer	Referenz auf Stammdaten (driver, optional)	ggf. aus Vorlage
Flexibilität	hoch	standardisiert
Aufwand	höher	geringer

Zusammenfassung Step 2

• ✔ Tour wird per API erzeugt

✔ Zwei Varianten je nach Integrationsgrad:

• A: Tour frei definieren (/tour/create) mit Referenzen auf Stammdaten

• B: Tour aus vorkonfigurierter Vorlage (/tour/createfromtemplate)

❌ In beiden Fällen sind anschließend noch keine Aufträge Bestandteil der Tour