1. Übersicht
Mit der Driver Action Load Damage kann ein Fahrer am Terminal melden,
dass eine Ladung beschädigt ist und nicht mehr regulär ausgeliefert werden darf.
WES markiert die Ladung sofort als entfernt und informiert das LVS über den Schaden.
Das LVS entscheidet anschließend, welche Maßnahmen für die beschädigte Ladung
eingeleitet werden sollen.
Typische Situation:
Der Fahrer hat eine Ladung aufgenommen und stellt dabei fest, dass sie beschädigt ist
und nicht ausgeliefert werden darf. Er nutzt die Aktion, um die Ladung aus dem
regulären Prozess auszuschleusen und das LVS zu informieren.
2. Was passiert nach der Meldung?
Da WES die Ladung sofort auf REMOVED setzt, ist sie aus dem regulären
Prozess ausgeschleust. WES löst keine automatischen Folgeaufträge aus.
Der Fahrer bringt die beschädigte Ladung typischerweise per Arbeitsanweisung
zum Klärplatz — ohne einen weiteren aktiven Auftrag in identpro WES.
Offener Fahrauftrag bleibt bestehen:
Ist zum Zeitpunkt der Schadensmeldung noch ein aktiver Fahrauftrag (Picklist) für die
Ladung in WES vorhanden, wird dieser nicht automatisch storniert.
WES setzt lediglich den Ladungsstatus auf REMOVED.
Möchte das LVS den zugehörigen WMS-Auftrag in WES schließen, muss es einen
CATO an identpro WES senden. Erst dadurch wird der Auftrag in WES
abgeschlossen. Ohne CATO verbleibt der Fahrauftrag in seinem aktuellen Status.
3. Prozessablauf
1
Fahrer hat eine Ladung aufgenommen und stellt fest, dass sie beschädigt ist. Er öffnet die Driver Action Load Damage am Terminal.
2
WES fordert den Fahrer auf, die Ladungs-ID (lenum) der beschädigten Ladung einzugeben.
✗
Ladung nicht gefunden: Ist die eingegebene Ladungs-ID in WES nicht bekannt, wird dem Fahrer eine Fehlermeldung angezeigt. Die Eingabe kann korrigiert werden.
✓
Ladung gefunden: WES führt sofort zwei Aktionen durch:
• Ladungsstatus wird auf REMOVED gesetzt (Ladung aus dem regulären Prozess ausgeschleust)
• Ein interner LoadConflict-Eintrag (Typ: MANUAL_CORRECTION) wird angelegt
3
WES sendet POST /idploaddamaged mit Ladungs-ID und Stapler-Name an das LVS.
✗
LVS antwortet mit Fehler: Dem Fahrer wird der Fehlertext des LVS angezeigt. Die Ladung bleibt in WES auf REMOVED.
✓
LVS antwortet erfolgreich: Fahrer erhält eine Bestätigung und wird gefragt,
ob er eine weitere beschädigte Ladung melden möchte.
• Weitere Ladung melden → zurück zu Schritt 2
• Beenden → Aktion wird abgeschlossen
4. API – idploaddamaged
► WES → LVS
Endpunkt (LVS-seitig)
| Methode | POST |
| Pfad (Standard) | /wms/idploaddamaged |
| Pfad (konfigurierbar) | Systemproperty RESTLoadDamagedPath |
| Content-Type | application/json |
Felder
| Feld | Typ | Pflicht | Beschreibung |
|---|
lenum | String | Pflicht | ID der beschädigten Ladung (vom Fahrer eingegeben) |
truck | String | Pflicht | Name des meldenden Staplers |
Beispiel-Request
{
"lenum": "LE-4711",
"truck": "Truck 1"
}
5. Response – Antwort des LVS
| HTTP-Status | Verhalten in WES |
|---|
2xx (z. B. 200 OK) |
Dem Fahrer wird eine Bestätigung angezeigt. Er kann wählen, ob er eine weitere Ladung melden oder die Aktion beenden möchte. |
4xx / 5xx |
Dem Fahrer wird eine Fehlermeldung mit dem Fehlertext des LVS angezeigt. Die Ladung bleibt in WES auf REMOVED. |
Hinweis: WES setzt den Ladungsstatus auf REMOVED bereits
vor dem LVS-Request — unabhängig von der Antwort des LVS.
Im Fehlerfall ist die Ladung in WES also bereits ausgeschleust, auch wenn das LVS
die Meldung nicht verarbeiten konnte.
6. Verhalten in WES nach der Meldung
| Aktion in WES | Zeitpunkt |
|---|
Ladungsstatus → REMOVED |
Sofort bei Eingabe der Ladungs-ID, vor dem LVS-Request |
LoadConflict-Eintrag anlegen (MANUAL_CORRECTION) |
Sofort bei Eingabe der Ladungs-ID, vor dem LVS-Request |
POST an /idploaddamaged |
Nach der lokalen Statusänderung |
| Kein automatischer Folgeauftrag in WES |
Fahrer handelt per Arbeitsanweisung (Klärplatz) |
| Offener Fahrauftrag bleibt bestehen |
LVS muss CATO senden, um den WMS-Auftrag in WES zu schließen |
7. Konfiguration
| Systemproperty | Standard | Beschreibung |
|---|
RESTLoadDamagedPath |
idploaddamaged |
Relativer Pfad des LVS-Endpunkts (wird an die REST-Basis-URL angehängt) |
Die Driver Action LOAD_DAMAGE kann projektspezifisch in identpro WES
aktiviert oder deaktiviert und nach Fahrzeuggruppe (Resource Group) eingeschränkt werden.
