Ladung editieren

1. Überblick

Dieser Prozess beschreibt die Änderung von Eigenschaften einer bestehenden Ladung in identpro WES über das WMS-REST-Interface. Die Transaktion wird als EDIT (Transaktionstyp tatyp = "EDIT") bezeichnet.

Im Gegensatz zur AVIS-Transaktion wird bei EDIT keine neue Ladung angelegt, sondern eine bereits vorhandene Ladung anhand ihrer Ladungs-ID (lenum) gesucht und ihre Attribute selektiv aktualisiert. Nur die im Request enthaltenen Felder werden geändert – nicht übergebene Felder bleiben unverändert. Dimensionsfelder mit dem Wert -1 werden ebenfalls nicht verändert.

2. Beteiligte Systeme

3. Voraussetzungen

• Das LVS hat eine Netzwerkverbindung zum identpro WES-Server.
• Die Ladung mit der angegebenen lenum existiert bereits in identpro WES.
• Ein neu gesetzter Ladungstyp (letyp), sofern übergeben, ist in identpro WES konfiguriert.
• Neue Dimensionswerte (length, width, height) sind größer als 0, sofern übergeben.
• Materialien aus der packageList sind in WES bekannt oder die automatische Materialanlage ist aktiviert.

4. Prozessablauf

5. API-Aufruf

Endpunkt

Methode	PUT
URL	https://<HOST>:<PORT>/wms/idptords
Content-Type	application/json
Accept	application/json

Request-Body (Beispiel)

[
  {
    "tatyp":    "EDIT",
    "lenum":    "Ladung 1234",
    "letyp":    "Europalette",
    "length":   1200,
    "width":    800,
    "height":   1000,
    "weight":   1120,
    "lckstate": "NOT_LOCKED",
    "params": {
      "Name":     "Andreas",
      "Kollegen": "Kai und Rene"
    },
    "packageList": [
      {
        "matnum": "10070/20",
        "mattxt": "Material 1",
        "qunit":  "ST",
        "quant":  500.5,
        "weight": 999.12,
        "batch":  "Batch 1"
      }
    ]
  }
]

6. Editierbare Felder

Bei EDIT werden ausschließlich die im Request übermittelten Felder aktualisiert. Felder, die nicht gesendet werden (bzw. null oder -1 bei numerischen Feldern), bleiben unverändert.

Feld	Typ	Beschreibung & Verhalten
lenum	String	Pflichtfeld. Identifiziert die zu ändernde Ladung. Wird nicht selbst geändert.
letyp	String	Neuer Ladungstyp. Wird nur aktualisiert, wenn nicht leer. Muss in WES konfiguriert sein.
desc	String	Neue Freitextbeschreibung der Ladung. Wird aktualisiert, wenn nicht null.
weight	Integer	Neues Gewicht in kg. Wird aktualisiert, wenn Wert > -1.
length	Integer	Neue Länge in mm. Wird aktualisiert, wenn Wert ≠ -1. Muss > 0 sein.
width	Integer	Neue Breite in mm. Wird aktualisiert, wenn Wert ≠ -1. Muss > 0 sein.
height	Integer	Neue Höhe in mm. Wird aktualisiert, wenn Wert ≠ -1. Muss > 0 sein.
lckstate	Enum	Neuer Sperrstatus. Gültige Werte: NOT_LOCKED, QA_LOCK, LOCKED, OTHERS. Wird aktualisiert, wenn nicht null.
packageList	Array	Bestehende Pakete werden ergänzt oder angepasst. Nur im Request enthaltene Keys werden überschrieben; übrige Pakete bleiben erhalten.
params	Map	Ladungseigenschaften (Key-Value-Paare). Nur übergebene Keys werden überschrieben; nicht enthaltene Keys bleiben erhalten.

Nicht unterstützt bei EDIT:
Die Felder topla (Ziel-Location) und shipment werden bei EDIT nicht ausgewertet und haben keinen Effekt. Eine Änderung der Location einer bestehenden Ladung ist über den EDIT-Prozess nicht möglich.

7. Response

Jede Antwort von identpro WES enthält die folgenden drei Felder:

Feld	Typ	Beschreibung
status	String	"OK" – Anfrage erfolgreich verarbeitet "FAIL" – Anfrage fehlgeschlagen
stCode	Integer	Spezifischer Statuscode (s. Abschnitt 8)
sftxt	String	Klartext-Beschreibung des Ergebnisses oder der Fehlerursache

Beispiel – Erfolgsfall

✓ Response OK

{
  "status": "OK",
  "stCode": 0,
  "sftxt":  "[tatyp:EDIT, deliv: null]: Load with lenum Ladung 1234 was edited successfully."
}

Beispiel – Fehlerfall (Ladung nicht gefunden)

✗ Response FAIL

{
  "status": "FAIL",
  "stCode": 102,
  "sftxt":  "Load with name 'Ladung 1234' not found!"
}

8. Statuscodes

stCode	Bedeutung	Ursache / Beschreibung
0	Erfolg	Ladung wurde erfolgreich aktualisiert.
100	Allgemeiner Fehler	Business-Logik-Fehler, z. B. ungültige Systemkonfiguration oder EntityUpdateException bei Picklist-Update.
101	Unvollständige Daten	Pflichtvalidierung fehlgeschlagen, z. B. fehlende Pflichtfelder im Request.
102	Ungültige / unbekannte Daten	Ladung mit angegebener lenum existiert nicht in WES. Oder: letyp ist unbekannt. Oder: Dimensionswert (length, width, height) ist ≤ 0.
104	Datensatz existiert bereits	Namenskonflikt durch DuplicateNameException beim Speichern.
107	Material unbekannt	Ein Material aus der packageList ist nicht in WES hinterlegt und die automatische Materialanlage ist deaktiviert.

9. Hinweise

Selektive Aktualisierung:
Es müssen nur die Felder übertragen werden, die tatsächlich geändert werden sollen. Numerische Felder (length, width, height) mit Wert -1 sowie null-Felder werden von identpro WES ignoriert. Dies erlaubt es, z. B. nur den Sperrstatus zu ändern, ohne alle anderen Felder zu senden.

Verhalten bei params (Ladungseigenschaften):
Bestehende Properties der Ladung werden nicht gelöscht. Nur die im Request enthaltenen Keys werden überschrieben bzw. neu angelegt. Sollen Properties entfernt werden, muss dies separat über die WES-Oberfläche erfolgen.

Verhalten bei packageList:
Bestehende Pakete werden anhand ihrer Identifikatoren (packid / suppid) abgeglichen. Bekannte Pakete werden aktualisiert, neue werden hinzugefügt. Die gesamte Paketliste der Ladung wird durch die gesendete Liste ersetzt, wenn packageList nicht leer ist.

Mehrere Ladungen in einem Request:
Der Endpoint /wms/idptords akzeptiert ein JSON-Array mit mehreren TORD-Objekten. Jedes Objekt wird einzeln verarbeitet. Tritt bei einem Objekt ein Fehler auf, schlägt der gesamte Request fehl.

identpro.de← Dokumentationsübersicht