Fahrauftrag anlegen – TORD INBO · REAR

1. Überblick

Dieser Prozess beschreibt die Anlage eines neuen Transportauftrags (Fahrauftrags) in identpro WES über das WMS-REST-Interface. Ein Fahrauftrag weist einen Stapler an, eine Ladung von einer Quell-Location zu einer Ziel-Location zu befördern.

identpro WES unterstützt zwei Varianten zur Identifikation der zu transportierenden Ladung:

HU-basiert: Eine konkrete Ladung wird über ihre Ladungs-ID (lenum) adressiert.
Materialbasiert: Das LVS gibt Materialnummer (tamatnum), optionalen Batch und Menge vor. Der Fahrer sucht im Lager eine passende Ladung und nimmt diese physisch auf; WES erkennt die Aufnahme und prüft, ob die Ladung den Vorgaben entspricht. Bei Abweichung erhält der Fahrer eine Fehlermeldung und muss die Ladung wieder abstellen.

2. Unterstützte Transaktionstypen

INBO

Einlagerauftrag

Ladung wird vom Wareneingang (z. B. Förderband) in einen Lagerplatz eingelagert.

REAR

Umlagerauftrag

Ladung wird innerhalb des Lagers von einer Position zu einer anderen umgelagert.

OUTB

Auslagerauftrag

Ladung wird aus dem Lager zum Warenausgang oder einer Übergabestation ausgelagert.

Hinweis: Alle drei Transaktionstypen (INBO, REAR, OUTB) werden von identpro WES über denselben Verarbeitungspfad abgewickelt. Der Unterschied liegt in der konfigurierten Materialflussregel, die durch die Kombination aus frstyp, frpla, tostyp und topla bestimmt wird.

3. Prozessablauf

LVS / WMS

identpro WES

Stapler

1LVS entscheidet, dass eine Ladung transportiert werden soll, und erstellt den Fahrauftrag-Request.

2LVS sendet HTTP PUT an https://<HOST>:<PORT>/wms/idptords mit dem JSON-Array im Request-Body.

3identpro WES empfängt die Anfrage, prüft tanum auf Eindeutigkeit und validiert Pflichtfelder sowie Materialfluss-Konfiguration.

4aFehlerfall: Validierung schlägt fehl → WES gibt status: "FAIL" mit spezifischem stCode zurück. Prozess endet.

4bErfolgsfall: Transportauftrag wird in der Datenbank angelegt und dem passenden Materialfluss zugeordnet. Der Auftrag wird für Stapler sichtbar.

5identpro WES antwortet mit status: "OK", stCode: 0 und einem Bestätigungstext.

6LVS verarbeitet die Response und vermerkt den Auftrag als übergeben.

7Ein verfügbarer Stapler erhält den Fahrauftrag auf seinem Terminal und führt den Transport aus.

4. Variante A – HU-basierter Auftrag

Bei dieser Variante wird die zu transportierende Ladung explizit über ihre Ladungs-ID (lenum) angegeben. identpro WES erstellt den Transportauftrag für genau diese Ladung.

Anwendungsfall: Das LVS kennt die konkrete Ladungs-ID und möchte eine bestimmte HU von A nach B transportieren lassen – unabhängig von ihrem Material.

Endpunkt

Methode	`PUT`
`createLorryLoadMap`	Boolean	Optional	Wenn `true`: WES sendet nach Abschluss des Transports automatisch eine LorryLoadMap an das WMS (`POST /wms/idplorryloadmap`).
URL	`https://<HOST>:<PORT>/wms/idptords`
Content-Type	`application/json`
Accept	`application/json`

Request-Body (Beispiel – INBO)

[
  {
    "tatyp":  "INBO",
    "tanum":  "TA-1234",
    "lenum":  "614",
    "frstyp": "Conveyor",
    "frpla":  "FT-01",
    "tostyp": "Warenübergabe",
    "topla":  "Warenübergabe"
  }
]

Felder

Feld	Typ	Pflicht	Beschreibung
`tatyp`	String	Pflicht	`"INBO"`, `"REAR"` oder `"OUTB"`
`tanum`	String	Pflicht*	Eindeutige Transportauftragsnummer. Muss systemweit eindeutig sein. *Pflicht, wenn kein `deliv` gesetzt ist.
`lenum`	String	Optional	Ladungs-ID der zu transportierenden Ladung. Muss in WES bekannt sein. Alternativ: `lenums` (Liste) für mehrere erlaubte Ladungen.
`frstyp`	String	Optional	Quell-Lagertyp zur Bestimmung des Materialflusses in WES.
`frpla`	String	Optional	Quell-Location (Abholort der Ladung).
`tostyp`	String	Optional	Ziel-Lagertyp zur Bestimmung des Materialflusses in WES.
`topla`	String	Optional	Ziel-Location (Abladeort der Ladung).
`deliv`	String	Optional	Picklisten-ID. Wenn gesetzt, wird der Auftrag einer Pickliste zugeordnet.
`trackingType`	Integer	Optional	Tracking-Modus der Ladung: `0` = HU-basiert (Standard), `1` = Mengenbasiert.

frstyp / tostyp vs. frpla / topla:
Die Felder frstyp und tostyp definieren den Typ des Lagerbereichs und werden zur Auswahl der passenden Materialflussregel in WES verwendet. Die Felder frpla und topla benennen die konkrete Location. Welche Felder benötigt werden, hängt von der Materialfluss-Konfiguration im System ab.

5. Variante B – Materialbasierter Auftrag

Bei dieser Variante wird kein konkretes lenum übergeben. Das LVS gibt stattdessen das gewünschte Material (tamatnum) sowie optional Charge und Menge vor. Der Fahrer sucht im Lager eine passende Ladung und nimmt diese mit dem Stapler auf. identpro WES erkennt die Aufnahme automatisch und prüft, ob die aufgenommene Ladung den vorgegebenen Parametern (Material, Charge, Menge, Aufnahmeort) entspricht. Stimmt sie überein, wird die Ladung dem Fahrauftrag zugeordnet. Stimmt sie nicht überein, erscheint die Meldung „Falsche Ladung, bitte wieder abstellen" und der Fahrer muss die Ladung zurücksetzen.

Anwendungsfall: Das LVS kennt das benötigte Material, aber nicht die konkrete Ladungs-ID. Der Fahrer sucht im Lager selbst eine passende HU und nimmt sie physisch auf; WES stellt sicher, dass die aufgenommene Ladung die vom LVS definierten Kriterien erfüllt.

Request-Body (Beispiel – REAR)

[
  {
    "tatyp":    "REAR",
    "tanum":    "TA-5678",
    "tamatnum": "9301_005",
    "tabatch":  "",
    "taquant":  "1",
    "frstyp":   "Blocklager 2",
    "frpla":    "BL2-04",
    "tostyp":   "Warenausgang",
    "topla":    "BLWA-Halle2"
  }
]

Materialspezifische Felder

Feld	Typ	Pflicht	Beschreibung
`tatyp`	String	Pflicht	`"INBO"`, `"REAR"` oder `"OUTB"`
`tanum`	String	Pflicht*	Eindeutige Transportauftragsnummer. *Pflicht, wenn kein `deliv` gesetzt ist.
`tamatnum`	String	Pflicht	Materialnummer des gewünschten Materials. WES sucht eine passende Ladung im Bestand.
`tabatch`	String	Optional	Charge des Materials. Wenn gesetzt, wird nur Material dieser Charge berücksichtigt.
`taquant`	String	Optional	Gewünschte Menge des Materials für den Transport.
`tamatnumalt`	Array	Optional	Liste alternativer Materialnummern, die ebenfalls akzeptiert werden.
`tamatquant`	Double	Optional	Mindestmenge des Materials, die sich auf der Ladung befinden muss.
`frstyp`	String	Optional	Quell-Lagertyp zur Bestimmung des Materialflusses.
`frpla`	String	Optional	Quell-Location (Suchbereich für die Ladungsauswahl).
`tostyp`	String	Optional	Ziel-Lagertyp.
`topla`	String	Optional	Ziel-Location.
`createLorryLoadMap`	Boolean	Optional	Wenn `true`: WES sendet nach Abschluss des Transports automatisch eine LorryLoadMap an das WMS (`POST /wms/idplorryloadmap`).

Ladungsaufnahme durch den Fahrer:
Bei materialbasierter Beauftragung sucht der Fahrer im Lager selbst eine passende Ladung und nimmt diese mit dem Stapler auf. identpro WES erkennt die Aufnahme und prüft, ob die aufgenommene HU den Vorgaben des LVS entspricht (Materialnummer, Charge, Menge, Aufnahmeort). Stimmt die Ladung überein, wird sie dem Fahrauftrag zugeordnet. Stimmt sie nicht überein, erscheint die Meldung „Falsche Ladung, bitte wieder abstellen" und der Fahrer muss die Ladung zurücksetzen.

6. Response

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

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

Beispiel – Erfolgsfall (HU-basiert, INBO)

✓ Response OK

{
  "status": "OK",
  "stCode": 0,
  "sftxt":  "[tatyp:INBO, deliv: null]: Transport order with tanum TA-1234 accepted."
}

Beispiel – Erfolgsfall (Materialbasiert, REAR)

✓ Response OK

{
  "status": "OK",
  "stCode": 0,
  "sftxt":  "[tatyp:REAR, deliv: null]: Transport order with tanum TA-5678 accepted."
}

Beispiel – Fehlerfall (tanum bereits vorhanden)

✗ Response FAIL

{
  "status": "FAIL",
  "stCode": 104,
  "sftxt":  "Transport order with tanum 'TA-1234' already exists!"
}

7. Statuscodes

stCode	Bedeutung	Ursache / Beschreibung
0	Erfolg	Transportauftrag wurde erfolgreich angelegt.
100	Allgemeiner Fehler	Business-Logik-Fehler, z. B. kein passender Materialfluss konfiguriert, oder eine bereits aktive Pickliste kann nicht ersetzt werden (`EntityUpdateException`).
101	Unvollständige Daten	`tanum` und `deliv` sind beide leer/nicht gesetzt. Mindestens eines der beiden Felder ist erforderlich.
102	Ungültige / unbekannte Daten	Validierungsfehler, z. B. Deliv-Restriktionen ohne `deliv` gesetzt, oder Sequenznummer ohne Shipment angegeben.
104	Datensatz existiert bereits	Die angegebene `tanum` existiert bereits im System. Transportauftragsnummern müssen eindeutig sein.
107	Material unbekannt	Das in `tamatnum` angegebene Material ist nicht in WES hinterlegt und die automatische Materialanlage ist deaktiviert.

8. Hinweise

tanum – Eindeutigkeit:
Die Transportauftragsnummer (tanum) muss systemweit eindeutig sein. Wird eine bereits verwendete tanum gesendet, antwortet WES mit stCode 104. Das LVS ist für die Vergabe eindeutiger Nummern verantwortlich.

tanum oder deliv:
Mindestens eines der beiden Felder tanum oder deliv muss gesetzt sein. Sind beide leer, wird stCode 101 zurückgegeben. Wird deliv gesetzt, wird der Auftrag einer Pickliste zugeordnet; tanum kann dann optional bleiben.

Materialfluss-Konfiguration:
Die Felder frstyp, frpla, tostyp und topla müssen zur konfigurierten Materialflussregel in identpro WES passen. Welche Felder konkret benötigt werden, ist projektspezifisch konfiguriert. Bei Fragen zur Konfiguration wenden Sie sich an Ihren identpro-Ansprechpartner.

Mehrere Aufträge in einem Request:
Der Endpoint /wms/idptords akzeptiert ein JSON-Array mit mehreren TORD-Objekten. Alle Objekte werden gemeinsam verarbeitet. Tritt bei einem Objekt ein Fehler auf, schlägt der gesamte Request fehl.

Fahrauftraganlegen