Transport quittieren

1. Übersicht

Wenn ein Transport (Shipment) im WES-System vollständig abgeschlossen ist, sendet WES automatisch eine SHIPCO-Nachricht (ShipmentConfirmation) an das WMS. Die Nachricht enthält die Transport-ID sowie alle zugehörigen Ladelisten mit ihren Positionen, Pre-/Postcheck-Daten und Liefereigenschaften.

WES → WMS PUT /wms/idpshipco

Die SHIPCO-Nachricht wird nach dem Abschluss aller Ladelisten eines Transports gesendet. Sie ist die übergeordnete Zusammenfassung – für den Abschluss einzelner Ladelisten wird separat DELCO gesendet.

2. Objekthierarchie

Ebene	Objekt	Beschreibung
1	Shipco	Wurzelelement. Enthält die Transport-ID und die Liste aller Ladelisten-Abschlüsse.
2	ShipcoPos	Eine Position je Ladeliste. Enthält Ladelisten-ID, Liefereigenschaften sowie Pre-/Postcheck-Daten.
3	DelivPos	Positionen der Ladeliste mit Material und Fahrauftragseinzelpositionen.
4	TaPos	Einzelposition eines Fahrauftrags (Teillieferung).

3. Datenmodell – Shipco

Feld	Typ	Pflicht	Beschreibung
`shipment`	String	Pflicht	Bezeichner des Transports. Beispiel: `SHIP001`
`shipcoPos`	Array<ShipcoPos>	Pflicht	Liste der Ladelisten-Abschlüsse des Transports.

3.1 ShipcoPos – Ladelistenposition

Feld	Typ	Pflicht	Beschreibung
`deliv`	String	Optional	Bezeichner der Ladeliste. Beispiel: `picklist 001`
`delivProperties`	Object	Optional	Liefereigenschaften als Key-Value-Map (String → String).
`precheck`	Object	Optional	Ausgefüllte Pre-Check-Daten der Ladeliste, wenn konfiguriert.
`postcheck`	Object	Optional	Ausgefüllte Post-Check-Daten der Ladeliste, wenn konfiguriert.
`delivPos`	Array<DelivPos>	Optional	Liste der Ladelistenpositionen mit Materialangaben und Fahrauftragseinzelpositionen.

3.2 DelivPos – Ladelisteneinzelposition

Feld	Typ	Pflicht	Beschreibung
`delivMaterial`	String	Optional	Material-Bezeichner der Ladelistenposition. Beispiel: `mat 001`
`orderPos`	Array<TaPos>	Optional	Liste der Fahrauftragseinzelpositionen (Teillieferungen).

4. Beispiel-Request

WES → WMS PUT /wms/idpshipco

{
  "shipment": "SHIP001",
  "shipcoPos": [
    {
      "deliv": "picklist 001",
      "delivProperties": {
        "warehouse": "WH01"
      },
      "precheck": {
        "check_brake": "OK",
        "check_load_secured": "OK"
      },
      "postcheck": {
        "check_damage": "NONE"
      },
      "delivPos": [
        {
          "delivMaterial": "mat 001",
          "orderPos": [
            { "tanum": "order 001", "lenum": "load 001" }
          ]
        }
      ]
    },
    {
      "deliv": "picklist 002",
      "delivPos": [
        {
          "delivMaterial": "mat 002",
          "orderPos": [
            { "tanum": "order 003", "lenum": "load 003" }
          ]
        }
      ]
    }
  ]
}

5. Response

200 OK

{ "result": "OK" }

200 OK (Fehlerfall)

{ "result": "ERROR", "message": "Unknown shipment: SHIP001" }

6. Zusammenhang DELCO / SHIPCO

Beim Abschluss eines Transports sendet WES zwei Arten von Callbacks:

Nachricht	Auslöser	Granularität	Endpoint
DELCO	Jede einzelne Ladeliste wird abgeschlossen	Pro Ladeliste	`PUT /wms/idpdelco`
SHIPCO	Alle Ladelisten des Transports sind abgeschlossen	Gesamter Transport	`PUT /wms/idpshipco`

Transport quittierenSHIPCO – ShipmentConfirmation