Lagerort-Status · idplocationstatus

1. Übersicht

identpro WES stellt Fahrern am Terminal drei Driver Actions zur Verfügung, mit denen sie den Status eines Lagerortes aktiv an das LVS melden können. Alle drei Aktionen nutzen denselben LVS-seitigen Endpunkt PUT /wms/idplocationstatus. Der Endpunkt ist konfigurierbar; der Standardpfad lautet idplocationstatus.

► WES → LVS

ZERO CROSSING

Bestandsprüfung

Der Fahrer gibt die tatsächliche Anzahl an Ladungen in einem Lagerort an. WES meldet die Zahl als Bestand (INVENTORY) an das LVS.

Das LVS entscheidet, welche Folgeaktionen nötig sind.

FROM PLACE EMPTY

Quellort leer

Der Fahrer fährt seinen Quellort an und stellt fest, dass er bereits leer ist — eine Aufnahme ist nicht möglich. Er meldet dies vor der Aufnahme als SOURCE_EMPTY ans LVS, damit der Auftrag neu geplant werden kann.

TO PLACE FULL

Zielort voll

Der Fahrer meldet, dass ein Zielort belegt ist und keine weitere Einlagerung möglich ist (DESTINATION_FULL). Das LVS kann daraufhin alternative Lagerorte zuweisen.

2. Endpunkt (LVS-seitig)

Methode	`PUT`
Pfad (Standard)	`/wms/idplocationstatus`
Pfad (konfigurierbar)	Systemproperty `RESTLocationStatusPath`
Content-Type	`application/json`

3. Felder der Nachricht

Feld	Typ	Pflicht	Beschreibung
`status`	Enum	Pflicht	Art des Lagerort-Status (s. u.)
`location`	String	Pflicht	Name des betroffenen Lagerortes
`truck`	String	Pflicht	Name des meldenden Staplers
`loadNumber`	Integer	Optional	Anzahl der Ladungen am Lagerort. Nur bei `status: "INVENTORY"` gesetzt.

Werte für status

Wert	Driver Action	Bedeutung
`"INVENTORY"`	ZERO CROSSING	Fahrer gibt die tatsächliche Anzahl an Ladungen am Lagerort an. Feld `loadNumber` enthält den gemeldeten Wert.
`"SOURCE_EMPTY"`	FROM PLACE EMPTY	Fahrer meldet, dass der Quellort leer ist. `loadNumber` wird nicht gesetzt.
`"DESTINATION_FULL"`	TO PLACE FULL	Fahrer meldet, dass der Zielort voll ist. `loadNumber` wird nicht gesetzt.

Hinweis: WES trifft auf Basis des gemeldeten Status keine automatischen Folgeaktionen im eigenen System. Es liegt in der Verantwortung des LVS, auf Basis des empfangenen Status geeignete Maßnahmen einzuleiten (z. B. Stornierung von Aufträgen, Neuplanung, Bestandskorrektur).

4. Zero Crossing – Bestandsprüfung (INVENTORY)

Die Aktion Zero Crossing ermöglicht es dem Fahrer, die tatsächliche Anzahl an Ladungen in einem Lagerort zu erfassen und an das LVS zu melden. Typischer Anwendungsfall: Der Fahrer stellt bei einer Inventur fest, dass der im LVS geführte Bestand nicht mit dem tatsächlichen Bestand übereinstimmt.

Voraussetzung

Die Aktion ist nur verfügbar, wenn der Fahrer mindestens eine Ladung aufgenommen hat (Status "In Transfer"). Gibt es keine solche Ladung, wird dem Fahrer eine Fehlermeldung angezeigt.

Prozessablauf

1Fahrer öffnet die Driver Action Zero Crossing am Terminal.

2 WES ermittelt automatisch den Lagerort aus der zuletzt geänderten Ladung, die sich aktuell im Transfer des Staplers befindet. Der Lagerort wird dem Fahrer als vorausgefülltes Feld angezeigt.
Der Fahrer wählt den Lagerort nicht manuell — WES bestimmt ihn aus dem aktuellen Fahrzeugkontext.

3 Fahrer gibt die tatsächliche Anzahl der Ladungen am angezeigten Lagerort ein (ganzzahlig, ≥ 0). Auch 0 ist ein gültiger Wert.

4 WES sendet PUT /idplocationstatus an das LVS mit status: "INVENTORY" und dem eingegebenen Wert in loadNumber.

✓ LVS antwortet erfolgreich (HTTP 2xx): Dem Fahrer wird eine Erfolgsmeldung angezeigt. WES führt keine weiteren automatischen Aktionen aus.

✗ LVS antwortet mit Fehler: Dem Fahrer wird eine Fehlermeldung angezeigt. Der gemeldete Fehlertext des LVS wird ausgegeben.

Wichtig – Folgeaktionen liegen beim LVS:
WES sendet den Bestandswert unabhängig davon, ob er 0 oder größer ist. WES storniert keine Ladungen und sendet kein CATO. Soll das LVS bei einem Bestand von loadNumber: 0 Aufträge stornieren oder andere Maßnahmen einleiten, muss dies vollständig LVS-seitig implementiert werden.

Beispiel-Request (Bestand = 0)

{
  "status":     "INVENTORY",
  "location":   "Regal-A-01",
  "truck":      "Truck 1",
  "loadNumber": 0
}

Beispiel-Request (Bestand = 3)

{
  "status":     "INVENTORY",
  "location":   "Regal-A-01",
  "truck":      "Truck 1",
  "loadNumber": 3
}

5. From Place Empty – Quellort leer (SOURCE_EMPTY)

Der Fahrer hat einen Fahrauftrag, eine Ladung von einem bestimmten Lagerort zu holen. Er fährt dorthin und stellt fest, dass der Lagerort bereits leer ist — eine Aufnahme ist nicht möglich. Mit dieser Aktion meldet er den leeren Lagerort an das LVS, bevor eine Aufnahme stattfindet. Das LVS kann den Auftrag daraufhin stornieren oder einen neuen Quellort vergeben.

1Fahrer hat einen aktiven Fahrauftrag mit einem vorgegebenen Quellort. Er fährt den Lagerort an und stellt fest, dass er leer ist.

2Fahrer öffnet die Driver Action From Place Empty. Eine Aufnahme hat noch nicht stattgefunden.

3WES ermittelt den Quellort aus dem aktuellen Fahrzeugkontext. Der Lagerort wird dem Fahrer zur Bestätigung angezeigt.

4WES sendet PUT /idplocationstatus mit status: "SOURCE_EMPTY" an das LVS. Feld loadNumber wird nicht gesetzt.

✓LVS antwortet erfolgreich → Fahrer erhält Bestätigung. Das LVS entscheidet über die Folgeaktion (z. B. Auftragsstornierung oder neuer Quellort).

✗LVS antwortet mit Fehler → Fehlermeldung wird dem Fahrer angezeigt.

Beispiel-Request

{
  "status":   "SOURCE_EMPTY",
  "location": "Regal-B-05",
  "truck":    "Truck 2"
}

6. To Place Full – Zielort voll (DESTINATION_FULL)

Der Fahrer kann melden, dass ein Zielort für eine weitere Einlagerung nicht verfügbar ist. Das LVS kann daraufhin einen alternativen Ablageort für laufende oder kommende Aufträge planen.

1Fahrer öffnet die Driver Action To Place Full.

2WES ermittelt den Zielort aus dem aktuellen Fahrzeugkontext. Der Lagerort wird dem Fahrer zur Bestätigung angezeigt.

3WES sendet PUT /idplocationstatus mit status: "DESTINATION_FULL" an das LVS. Feld loadNumber wird nicht gesetzt.

✓LVS antwortet erfolgreich → Fahrer erhält Bestätigung.

✗LVS antwortet mit Fehler → Fehlermeldung wird dem Fahrer angezeigt.

Beispiel-Request

{
  "status":   "DESTINATION_FULL",
  "location": "Regal-C-12",
  "truck":    "Truck 3"
}

7. Response – Antwort des LVS

Das LVS antwortet auf jeden Request mit einem HTTP-Statuscode und einem JSON-Body. WES wertet den HTTP-Statuscode aus und zeigt dem Fahrer das Ergebnis:

HTTP-Status	Verhalten in WES
`2xx` (z. B. 200 OK)	Dem Fahrer wird eine Erfolgsmeldung angezeigt. Die Aktion ist abgeschlossen.
`4xx` / `5xx`	Dem Fahrer wird eine Fehlermeldung mit dem Fehlertext des LVS angezeigt. Die Aktion wird nicht wiederholt.

Hinweis zum Response-Body:
WES liest im Fehlerfall den Response-Body als Fehlertext aus und zeigt ihn dem Fahrer. Das LVS sollte im Fehlerfall einen verständlichen Hinweis als Plain-Text oder JSON-String zurückgeben.

8. Konfiguration

Systemproperty	Standard	Beschreibung
`RESTLocationStatusPath`	`idplocationstatus`	Relativer Pfad des LVS-Endpunkts (wird an die REST-Basis-URL angehängt)

Welche Driver Actions dem Fahrer angeboten werden, wird projektspezifisch über die Driver Action Konfiguration in identpro WES gesteuert. Jede Aktion (ZERO_CROSSING, FROM_PLACE_EMPTY, TO_PLACE_FULL) kann einzeln aktiviert oder deaktiviert und nach Fahrzeuggruppe (Resource Group) eingeschränkt werden.

9. Vollständige Übersicht der Status-Werte

status	loadNumber	Driver Action	Typischer Auslöser
`"INVENTORY"`	Ja (≥ 0)	ZERO CROSSING	Fahrer zählt Ladungen an einem Lagerort und gibt die Zahl ein (auch 0 möglich)
`"SOURCE_EMPTY"`	Nicht gesetzt	FROM PLACE EMPTY	Fahrer fährt seinen Quellort an, kann aber nicht aufnehmen, weil der Lagerort bereits leer ist (Meldung vor der Aufnahme)
`"DESTINATION_FULL"`	Nicht gesetzt	TO PLACE FULL	Fahrer meldet, dass kein weiterer Platz am Zielort vorhanden ist

Verantwortung für Folgeaktionen beim LVS:
identpro WES sendet ausschließlich die Statusmeldung. Alle daraus resultierenden Folgeaktionen – wie Bestandskorrekturen, Auftragsstornierungen, CATO-Nachrichten oder Neuplanungen – sind vollständig LVS-seitig zu implementieren und zu steuern.