So verwerfen Sie tasks

Eine task zu verwerfen bedeutet, ihre Ausführung abzubrechen und sie als nicht mehr aktiv für die Lieferung oder Abholung zu markieren. Wenn eine task verworfen wird:

• Der task-Status ändert sich zu „DISCARDED";

• Sie wird aus einem zugewiesenen round entfernt (falls zutreffend);

• Sie ist nicht mehr für die Optimierung und Lieferung verfügbar;

• Externe Spediteure erhalten Stornierungsbenachrichtigungen, wenn die task mit ihnen verknüpft war;

• Die task erscheint im Abschnitt „Discarded" der Plattform

Methoden zum Verwerfen

API-Methoden:

• Einzelne task verwerfen per interner ID

Parameter:
id: Datenbank-ID der task
removeFromRound (optional): Auf true setzen, um die task vor dem Verwerfen aus dem round zu entfernen

• Einzelne task verwerfen per TaskId

Parameter:
taskId: Die externe task-ID
removeFromRound (optional): Auf true setzen, um die task vor dem Verwerfen aus dem round zu entfernen

• Mehrere tasks gleichzeitig verwerfen

Body:
taskId: Die externe task-ID

Web-Plattform:

• Einzelne task verwerfen

Navigieren Sie zu den task-Details -> Verwenden Sie die Löschoption in der task-Oberfläche:

• Mehrere tasks gleichzeitig verwerfen

1. Gehen Sie zum Tab „Tasks";

2. Wählen Sie „Bulk Update";

3. Wählen Sie tasks aus: Alle vorhandenen tasks auswählen oder bestimmte tasks anhand ihrer IDs festlegen;

4. Aktion auswählen: „Discard a task";

5. Wichtig: Aktivieren Sie den Schalter „Remove task from the round" zur Sicherheit;

6. Klicken Sie auf „Proceed", um alle ausgewählten tasks zu verwerfen.

• Verwerfen durch Löschen von Ankündigungen

Löschen Sie die gesamte Ankündigung, die die tasks enthält.

ℹ️ Hinweis ℹ️

Wenn Sie eine Ankündigung löschen, bevor die tasks optimiert wurden, erhalten alle tasks den Status DISCARDED.

Dies ist ein unwiderruflicher Vorgang – sobald eine Ankündigung gelöscht wurde, werden alle zugehörigen tasks als DISCARDED markiert und können weder optimiert noch weiterverarbeitet werden.

Wenn Sie eine Ankündigung nach der Optimierung löschen, können die folgenden tasks verworfen werden oder nicht:

• KÖNNEN verworfen werden: Ankündigungen mit tasks im Status ASSIGNED, PREPARED, GEOCODED

• KÖNNEN NICHT verworfen werden: Ankündigungen mit tasks im Status ONGOING, COMPLETED oder IN_PROGRESS

Das System schützt vor dem Löschen von Ankündigungen mit tasks, die aktiv ausgeführt werden oder bereits abgeschlossen wurden, um die Datenintegrität zu gewährleisten und laufende Vorgänge nicht zu unterbrechen.

Wichtige Hinweise

Tasks in Rounds

• Standardverhalten: Die API lehnt Anfragen zum Verwerfen von tasks ab, die rounds zugewiesen sind

• Lösung: Verwenden Sie den Parameter removeFromRound=true, um die task vor dem Verwerfen aus dem round zu entfernen

• Race Conditions: Das gleichzeitige Verwerfen mehrerer tasks aus demselben round kann zu Problemen führen

Ratenlimits und Performance

• Sammeloperationen werden gegenüber mehreren einzelnen API-Aufrufen empfohlen

• Das gleichzeitige Verwerfen von Hunderten von tasks kann zu Latenz führen

Protokollierung und Nachverfolgung

• Verworfene tasks erscheinen in den Systemprotokollen

• API-Verwerfungen werden in den Protokollen als „discard by SYSTEM" angezeigt

• Der task-Verlauf erfasst die Verwerfungsaktion und wer sie durchgeführt hat

Integration externer Spediteure

• Wenn tasks, die mit externen Spediteuren verknüpft sind, verworfen werden, werden automatisch Stornierungsanfragen an diese Spediteure gesendet

• Dies gilt für Verwerfungen über die API, manuelle Aktionen in der Web-App oder das Löschen von Ankündigungen