Aufträge abrufen & Rückmeldungen

Dieses Kapitel beschreibt die wichtigsten Endpunkte, um Auftragsdaten aus DeDeFleet auszulesen – entweder als:

• vollständige Detaildaten,

• Status- und Fortschrittsinformationen,

• oder Listen für Planung und Monitoring.

Die zentrale Referenz für alle Abfragen ist die beim Anlegen erzeugte orderGuid.

---

1) Auftrag abrufen (Order/Get)

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Order/Order_Get

Endpoint

POST /order/get

Zweck / Wann nutzen?

Mit Order/Get wird ein Auftrag vollständig aus dem System gelesen.

Typische Anwendungsfälle:

• Prüfung nach Order/Create oder Order/Update

• Synchronisation von Auftragsdetails in externe Systeme

• Auslesen von Planungsinformationen (z. B. tourGuid, Fahrer, Fahrzeug)

• Zugriff auf Dokumente, Skills, Kapazitäten und Formulardaten

Request

{
  "orderGuid": "a1123f45-9c8e-4a77-bb21-11aa22bb3333"
}

Response (Beispiel)

{
  "type": 0,
  "order": "ORDER-10001",
  "delivery": "DEL-10001",
  "location": {
    "type": 2,
    "name": "Musterkunde GmbH",
    "street": "Hauptstraße 12",
    "postal": "37154",
    "city": "Northeim",
    "country": "DE",
    "latitude": 51.7065,
    "longitude": 10.0034
  },
  "plannedDeliveryDate": "2026-02-02",
  "workTime": 20,
  "weight": 150,
  "driverMessage": "Bitte Rampe 2 nutzen",
  "appTitle": "Lieferung Musterkunde",
  "priority": 2,
  "notes": "Kunde bevorzugt Vormittag",
  "skills": ["Kühlfahrzeug"],
  "capacities": [
    { "key": "EURO_PALLET", "value": 4 }
  ],
  "documents": [
    { "name": "Anlieferhinweise.pdf", "data": "<BASE64>" }
  ],
  "visitTimeWindows": [
    { "day": 1, "startTime": "08:00", "endTime": "12:00" }
  ],
  "tourGuid": "7a3c1e9e-8d7a-4f21-b8c1-0f6c9e2a1111",
  "startDateTime": "2026-02-02T08:30:00",
  "vehicleApiId": "VEH-42",
  "firstDriverNumber": "DRV-1001",
  "secondDriverNumber": "",
  "contact": "Max Müller",
  "phone": "+49 5551 12345",
  "status": {
    "code": 100,
    "description": "OK"
  }
}

 

2) Auftragsstatus abrufen (Order/GetStatus)

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Order/Order_GetStatus

Endpoint

POST /order/getstatus

Zweck / Wann nutzen?

Liefert den aktuellen Status eines einzelnen Auftrags.

Typische Anwendungsfälle:

• Live-Statusanzeige in externen Systemen

• ETA- und Ankunftsinformationen

• Rückmeldungen aus der Fahrer-App (Formulardaten, Unterschrift etc.)

• Prüfung der Tourzugehörigkeit eines Auftrags

---

Request (Beispiel)

{
  "orderGuid": "a1123f45-9c8e-4a77-bb21-11aa22bb3333"
}

Response (Beispiel)

{
  "orderStatus": {
    "tourGuid": "7a3c1e9e-8d7a-4f21-b8c1-0f6c9e2a1111",
    "orderGuid": "a1123f45-9c8e-4a77-bb21-11aa22bb3333",
    "orderState": 2,
    "tourArrival": "2026-02-02T09:05:00",
    "eta": "2026-02-02T09:10:00",
    "formdata": [
      {
        "id": "SIGNATURE",
        "field": "Unterschrift",
        "value": "OK",
        "file_Name": "signature.png",
        "file_Data": "<BASE64>"
      }
    ],
    "guid": "c3345d67-2e3f-4d99-dd43-33cc44dd5555"
  },
  "status": {
    "code": 100,
    "description": "OK"
  }
}

Hinweis: Die Bedeutung der einzelnen orderState-Werte wird in einem separaten Abschnitt zu Statuswerten beschrieben.

---

3) Auftragsstatus im Zeitraum abrufen (Order/ListStatus)

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Order/Order_ListStatus

Endpoint

POST /order/liststatus

Zweck / Wann nutzen?

Liefert Statusinformationen für mehrere Aufträge innerhalb eines definierten Zeitraums.

Typische Anwendungsfälle:

• Sammelabfrage für ERP-/BI-Systeme

• Monitoring von Aufträgen über einen Zeitraum

• Historische Auswertungen (ETA, Ankunft, Rückmeldungen)

• Effiziente Alternative zu vielen Einzel-GetStatus-Aufrufen

Request (Beispiel)

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

Response (Beispiel)

{
  "statusList": [
    {
      "tourGuid": "7a3c1e9e-8d7a-4f21-b8c1-0f6c9e2a1111",
      "orderGuid": "a1123f45-9c8e-4a77-bb21-11aa22bb3333",
      "orderState": 2,
      "tourArrival": "2026-02-02T09:05:00",
      "eta": "2026-02-02T09:10:00",
      "formdata": [
        {
          "id": "SIGNATURE",
          "field": "Unterschrift",
          "value": "OK",
          "file_Name": "signature.png",
          "file_Data": "<BASE64>"
        }
      ],
      "guid": "c3345d67-2e3f-4d99-dd43-33cc44dd5555"
    }
  ],
  "status": {
    "code": 100,
    "description": "OK"
  }
}

 

4) Unverplante Aufträge auflisten (Order/ListUnassigned)

API-Referenz (Swagger)

https://ortung.dedefleet.de/swagger/?url=https://ortung.dedefleet.de/swagger/data/api/2#/Order/Order_ListUnassigned

Endpoint

GET /order/listunassigned

Zweck / Wann nutzen?

Liefert alle Aufträge, die aktuell keiner Tour zugewiesen sind.

Typische Anwendungsfälle:

• Planungspool für die Disposition

• Vorbereitung von Touren

• Kontrolle, ob Aufträge unbeabsichtigt unverplant sind

---

Response (Beispiel)

{
  "guids": [
    "a1123f45-9c8e-4a77-bb21-11aa22bb3333",
    "b2234c56-1d2e-4c88-cc32-22bb33cc4444",
    "d4456e78-3f40-4ea0-ee54-44dd55ee6666"
  ],
  "status": {
    "code": 100,
    "description": "OK"
  }
}

Tipp: Um Details zu einem Auftrag aus dieser Liste zu erhalten, wird anschließend Order/Get verwendet.

---

Zusammenfassung