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.

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

• ✔ Start/Ende sowie Zeiten sind definiert

• ✔ Fahrzeug/Fahrer sind als Stammdaten referenziert

• ❌ Keine Aufträge 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

• ✔ Tour wird erstellt

• ✔ Vordefinierter Rahmen (Start/Ende, Zeiten, Fahrzeug, ggf. Fahrer) wird übernommen

• ❌ Keine Aufträge zugewiesen

Vergleich der Varianten

Aspekt	Variante A – Create	Variante B – Template
Start-/Endpunkt	wird über Payload gesetzt	aus Vorlage
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