Ladebild – LorryLoadMap

1. Übersicht

Das Ladebild (LorryLoadMap) erfasst die genaue Position jedes Ladungsträgers auf dem Fahrzeug. Dadurch kann ein LKW an einem Zielstandort automatisiert mit Systemunterstützung entladen werden, ohne dass die Ladungen erneut eingescannt oder bekanntgemacht werden müssen.

Die Schnittstelle wird in zwei Richtungen genutzt:

Richtung	Methode	Auslöser
WMS → WES	`PUT /wms/idplorryloadmap`	WMS übermittelt das geplante Ladebild vor oder während des Transports an WES
WES → WMS	`POST /wms/idplorryloadmap`	WES sendet das tatsächliche Ladebild nach Transportsabschluss zurück (wenn `createLorryLoadMap=true` im TORD gesetzt)

Der automatische Rückversand (WES → WMS) muss pro Ladeliste aktiviert werden, indem im TORD-Objekt das Feld createLorryLoadMap auf true gesetzt wird.

2. Datenmodell – LorryLoadMapDto

Feld	Typ	Pflicht	Beschreibung
`shipment`	String	Pflicht	Name/ID des Transports (Shipment).
`index`	Integer	Optional	Index zur Unterscheidung mehrerer Koordinatensysteme pro Transport (z.B. bei mehrteiliger Beladung).
`loads`	Array<LoadPositionDto>	Pflicht	Liste der Ladungsträger mit ihren Positionen im Fahrzeug.

2.1 LoadPositionDto – Position eines Ladungsträgers

Feld	Typ	Pflicht	Beschreibung
`name`	String	Pflicht	Name/ID des Ladungsträgers.
`x`	Integer	Pflicht	X-Koordinate der Position im Fahrzeug.
`y`	Integer	Pflicht	Y-Koordinate der Position im Fahrzeug.
`z`	Integer	Pflicht	Z-Koordinate (Höhe) der Position im Fahrzeug.
`o`	Integer	Pflicht	Orientierung des Ladungsträgers (Winkel in Grad).

3. Beispiel – WMS sendet Ladebild an WES

WMS → WES PUT /wms/idplorryloadmap

{
  "shipment": "SHIP001",
  "index": 1,
  "loads": [
    { "name": "LOAD-001", "x": 100, "y": 50,  "z": 0, "o": 0   },
    { "name": "LOAD-002", "x": 100, "y": 150, "z": 0, "o": 90  },
    { "name": "LOAD-003", "x": 200, "y": 50,  "z": 0, "o": 180 }
  ]
}

4. Beispiel – WES sendet Ladebild an WMS

WES → WMS POST /wms/idplorryloadmap

{
  "shipment": "SHIP001",
  "index": 1,
  "loads": [
    { "name": "LOAD-001", "x": 100, "y": 50,  "z": 0, "o": 0  },
    { "name": "LOAD-002", "x": 100, "y": 150, "z": 0, "o": 90 }
  ]
}

5. Response

200 OK

{ "status": "OK", "stCode": 0, "sftxt": "" }

200 OK (Fehlerfall)

{ "status": "FAIL", "stCode": 1, "sftxt": "Unknown shipment: SHIP001" }