Touren abrufen & Rückmeldungen

Dieses Kapitel beschreibt die wichtigsten Endpunkte, um Toureninformationen aus DeDeFleet auszulesen.
Je nach Anwendungsfall können dabei:

• Tourvorlagen

• konkrete Tourdetails

• Listen von Touren in einem Zeitraum

abgerufen werden.

Touren sind zentrale Planungseinheiten. Gerade nach Create, Assign, Optimize oder OptimizeMany ist es wichtig, die Tourdaten erneut zu konsumieren und im eigenen System zu verarbeiten – denn durch (Multi-)Optimierungen können sich nicht nur Zeiten und Zuordnungen ändern, sondern insbesondere auch die Reihenfolge der Aufträge innerhalb einer Tour.

👉 Wenn externe Systeme (ERP/TMS, Fahrer-App-Integrationen, Dispatching) die Reihenfolge oder ETA-/Zeitdaten verwenden, sollten nach jeder Optimierung die betroffenen Touren erneut abgerufen werden (z. B. über Tour/Get oder Tour/List) und die neue Reihenfolge/Planung übernommen werden.

Die zentrale Referenz für Touren ist die tourGuid.

1) Tourvorlagen abrufen (Tour/ListTemplates)

Endpoint

GET /tour/listtemplates

 

Zweck / Wann nutzen?

Liefert alle verfügbaren Tourvorlagen.

Tourvorlagen definieren einen festen Rahmen für Touren, z. B.:

• Start- und Endpunkt

• Fahrzeug- und Fahrerzuordnung

• zeitliche Rahmenbedingungen

• optionale Sichtbarkeits- und Abschlussregeln

Typische Anwendungsfälle:

• Auswahl einer Vorlage für Tour/CreateFromTemplate

• Synchronisation von Vorlagen in externe Systeme

• Anzeige verfügbarer Tourtypen

---

Response (Beispiel)

{
  "templates": [
    {
      "templateName": "Tagestour Northeim",
      "vehicleApiID": "VEH-42",
      "apiID": "TPL-1001",
      "driver": "DRV-1001",
      "departure": {
        "date": "2026-02-02",
        "time": "07:00",
        "location": {
          "type": 0,
          "id": "DEPOT-1",
          "name": "Zentrallager Northeim"
        }
      },
      "return": {
        "latestReturnTime": "17:00",
        "toDepot": true,
        "location": {
          "type": 0,
          "id": "DEPOT-1",
          "name": "Zentrallager Northeim"
        }
      },
      "notes": "Standard-Tagestour",
      "forceVisibilityTourStartOrder": true,
      "forceVisibilityTourEndOrder": true
    }
  ],
  "status": {
    "code": 100,
    "description": "OK"
  }
}

 

2) Einzelne Tour abrufen (Tour/Get)

Endpoint

POST /tour/get

Zweck / Wann nutzen?

Liefert alle Details einer konkreten Tour, inklusive:

• Start- und Endinformationen

• Fahrer- und Fahrzeugzuordnung

• enthaltener Aufträge

• berechneter Zeiten und Distanzen

• Metriken zur Auswertung

Typische Anwendungsfälle:

• Konsumieren des Ergebnisses nach Optimierung

• Anzeige der finalen Tourstruktur

• Synchronisation der Tour in externe Systeme

---

Request (Beispiel)

{
  "tourGuid": "7a3c1e9e-8d7a-4f21-b8c1-0f6c9e2a1111"
}

Response (Beispiel)

{
  "tour": {
    "tourGuid": "7a3c1e9e-8d7a-4f21-b8c1-0f6c9e2a1111",
    "tour": "Tour 02.02.2026",
    "vehicleApiID": "VEH-42",
    "driver": "DRV-1001",
    "driverName": "Max Mustermann",
    "departure": {
      "date": "2026-02-02",
      "time": "07:00",
      "location": {
        "type": 0,
        "id": "DEPOT-1",
        "name": "Zentrallager Northeim"
      }
    },
    "return": {
      "calculatedReturnTime": "16:30",
      "latestReturnTime": "17:00",
      "toDepot": true,
      "location": {
        "type": 0,
        "id": "DEPOT-1",
        "name": "Zentrallager Northeim"
      }
    },
    "orders": [
      {
        "orderGuid": "a1123f45-9c8e-4a77-bb21-11aa22bb3333",
        "order": "ORDER-10001",
        "delivery": "DEL-10001",
        "orderStatus": 1,
        "eta": "2026-02-02T09:10:00",
        "location": {
          "type": 2,
          "name": "Musterkunde GmbH",
          "city": "Northeim"
        }
      }
    ],
    "status": 1,
    "metrics": {
      "fuel": 18.5,
      "distancePlanned": 124.3,
      "distanceDriven": 0,
      "actualDuration": 0
    }
  },
  "status": {
    "code": 100,
    "description": "OK"
  }
}

 

3) Touren im Zeitraum abrufen (Tour/List)

Endpoint

POST /tour/list

Zweck / Wann nutzen?

Liefert alle Touren innerhalb eines definierten Zeitraums.

Typische Anwendungsfälle:

• Tages- oder Wochenübersichten

• Monitoring der Planung

• Auswertung nach Optimierung

• Historische Analyse

Request (Beispiel)

{
  "start": "2026-02-01T00:00:00",
  "end": "2026-02-02T23:59:59"
}

Response (Beispiel)

{
  "tours": [
    {
      "tourGuid": "7a3c1e9e-8d7a-4f21-b8c1-0f6c9e2a1111",
      "tour": "Tour 02.02.2026",
      "vehicleApiID": "VEH-42",
      "driver": "DRV-1001",
      "driverName": "Max Mustermann",
      "departure": {
        "date": "2026-02-02",
        "time": "07:00",
        "location": {
          "type": 0,
          "id": "DEPOT-1",
          "name": "Zentrallager Northeim"
        }
      },
      "status": 1,
      "metrics": {
        "distancePlanned": 124.3,
        "actualDuration": 285
      }
    }
  ],
  "status": {
    "code": 100,
    "description": "OK"
  }
}

 

Wichtiger Hinweis: Touren nach Optimierung konsumieren

Nach Optimize oder OptimizeMany sollten die betroffenen Touren immer erneut über Tour/Get oder Tour/List abgerufen werden, da sich u. a. geändert haben können:

• Auftragszuordnung

• Reihenfolge der Aufträge

• Zeiten, Distanzen und ETA-Werte

---

Zusammenfassung