Skip to main content

Step 5 – Aufträge im Planungsprozess ändern

Grundidee dieses Schrittes

Im laufenden Planungsprozess kann es erforderlich sein, bereits angelegte Aufträge zu ändern, aus einer Tour zu entfernen oder vollständig zu löschen.

Alle Aktionen in diesem Schritt arbeiten mit der GUID des Auftrags, die beim Anlegen des Auftrags zurückgegeben wurde (siehe Einschub „Arbeiten mit GUIDs“).

5.1 Auftrag aktualisieren (Order/Update)

API-Referenz (Swagger)

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

Zweck

Mit Order/Update können bestehende Aufträge gezielt angepasst werden.
Dabei gilt:

👉 Es werden ausschließlich die im Request übergebenen Felder geändert.
Nicht übergebene Felder bleiben unverändert.

Typische Anwendungsfälle

  • Änderung von Lieferdatum oder Arbeitszeit

  • Anpassung der Adresse oder Location

  • Aktualisierung von Fahrerhinweisen

  • Ergänzen oder Ändern von Items, Skills oder Kapazitäten

Endpoint

POST /order/update

Request Body (Minimalbeispiel)

{
  "orderGuid": "00000000-0000-0000-0000-000000000000",
  "plannedDeliveryDate": "2026-02-02",
  "driverMessage": "Anlieferung erst ab 10 Uhr möglich",
  "priority": 2
}

Wirkung im System

  • ✔ Auftrag wird aktualisiert

  • ✔ Nur die übergebenen Felder werden geändert

  • ⚠️ Bei bereits verplanten Aufträgen kann eine Neuberechnung der Tour erforderlich sein

5.2 Auftrag aus einer Tour entfernen (Order/Unassign)

API-Referenz (Swagger)

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

Zweck

Mit Order/Unassign wird ein Auftrag aus einer Tour entfernt, ohne ihn zu löschen.

Der Auftrag wird danach wieder als unverplant geführt.

Typische Anwendungsfälle

  • Auftrag soll auf eine andere Tour verschoben werden

  • kurzfristige Umplanung

  • manuelle Dispositionsanpassung

Endpoint

POST /order/unassign

Request Body

{
  "orderGuid": "00000000-0000-0000-0000-000000000000"
}

Wirkung im System

  • ✔ Auftrag wird aus der Tour entfernt

  • ✔ Auftrag ist wieder unverplant

  • ✔ Tour bleibt bestehen

  • ⚠️ Tour sollte anschließend ggf. neu berechnet werden

5.3 Auftrag löschen (Order/Delete)

API-Referenz (Swagger)

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

Zweck

Mit Order/Delete wird ein Auftrag vollständig aus dem System entfernt.

Typische Anwendungsfälle

  • Auftrag wurde fälschlich angelegt

  • Auftrag wurde extern storniert

  • Testdaten sollen bereinigt werden

Endpoint

POST /order/delete

Request Body

{
  "orderGuid": "00000000-0000-0000-0000-000000000000"
}

Wirkung im System

  • ✔ Auftrag wird gelöscht

  • ❌ Auftrag steht nicht mehr zur Verfügung

  • ⚠️ Abhängig vom Status kann es Einschränkungen geben (z. B. bereits abgeschlossene Touren)

Hinweise & Best Practices

  • Änderungen an verplanten Aufträgen können Auswirkungen auf:

    • Zeiten

    • Reihenfolge

    • Optimierung
      haben
      → Calculate / Optimize ggf. erneut ausführen (Step 4)

  • Die GUID des Auftrags sollte im Quellsystem dauerhaft gespeichert werden

Zusammenfassung Step 5

  • ✔ Aufträge können aktualisiert, aus Touren entfernt oder gelöscht werden

  • ✔ Alle Aktionen erfolgen über die orderGuid

  • ✔ Änderungen sind Teil des laufenden Planungsprozesses

No comments to display

Back to top