3. Leergut / Items

Grundidee

Über das Feld items können einem Auftrag zusätzliche positionsbezogene Informationen mitgegeben werden.

Ein Item kann dabei z. B. sein:

• eine Lieferposition

• ein Einzel-Leergut

• ein gruppiertes Leergut (z. B. mehrere gleiche Paletten)

Damit lassen sich Aufträge nicht nur planerisch, sondern auch fachlich mengenbezogen beschreiben.

Items sind besonders relevant, wenn:

• gelieferte Mengen dokumentiert werden sollen

• Rücknahmemengen erfasst werden müssen

• Leergut oder Mehrwegbehälter Teil des Prozesses sind

• Positionen im Auftrag strukturiert abgebildet werden sollen

---

Aufbau von items

"items": [
{
"item": "string",
"description": "string",
"type": 0,
"status": 0,
"quantity": 0,
"group": "string"
}
]

Jeder Eintrag beschreibt eine Position innerhalb des Auftrags.

---

Bedeutung der Felder

item

Bezeichner bzw. Nummer des Items.

---

description

Optionale Beschreibung des Items.

---

type

Steuert die Art des Items.

Folgende Werte sind gültig:

---

Bedeutung der Typen

0 = NoReturnable

Normale Auftragsposition ohne Leergutbezug.

Typische Verwendung:

• normale Warenposition

• reine Liefermenge

• keine Rücknahme

Beispiel

{
"item": "ART-1001",
"description": "Menü 3",
"type": 0,
"quantity": 1
}

 

---

1 = UniqueReturnables

Einzelnes Leergut mit eindeutiger Nummer.

Typische Verwendung:

• Behälter oder Geräte mit eigener Kennung

• rückzugebende Einzeleinheiten

• serialisierte Mehrwegobjekte

Wichtig:
👉 Für diesen Typ ist nur quantity = 1 zulässig.

Beispiel

{
"item": "BOX-4711",
"description": "Thermobox",
"type": 1,
"quantity": 1
}

 

---

2 = GroupedReturnables

Gruppiertes Leergut, bei dem mehrere gleiche Einheiten zusammengefasst werden.

Typische Verwendung:

• Paletten

• Getränkekisten

• Mehrwegbehälter ohne individuelle Einzelnummer

Wichtig:
👉 Nur bei diesem Typ darf quantity > 1 verwendet werden.

Beispiel

{
"item": "EURO-PALLET",
"description": "Europalette",
"type": 2,
"quantity": 6
}

 

---

quantity

Menge des Items.

Wichtige Regel:

• Bei type = 2 sind Werte größer als 1 zulässig

• Bei type = 0 und type = 1 ist nur der Wert 1 zulässig

Diese Regel ist wichtig für die korrekte Modellierung der Positionen.

---

group

Optionale Gruppierung von Items.

Damit können mehrere Positionen logisch zusammengefasst werden, z. B.:

• gleiche Artikelgruppe

• gleiche Leergutklasse

• gleiche fachliche Kategorie

Beispiel

---

Beispiel: Auftrag mit verschiedenen Item-Typen

{
"items": [
{
"item": "ART-1001",
"description": "Menü 3",
"type": 0,
"quantity": 1,
"group": "WARE"
},
{
"item": "BOX-4711",
"description": "Thermobox",
"type": 1,
"quantity": 1,
"group": "LEERGUT"
},
{
"item": "EURO-PALLET",
"description": "Europalette",
"type": 2,
"quantity": 6,
"group": "LEERGUT"
}
]
}

 

---

Bedeutung für Integrationen

Items sind besonders hilfreich, wenn:

• Liefer- und Rücknahmepositionen sauber getrennt werden sollen

• Leergut strukturiert abgebildet werden muss

• Mengen an ERP oder Abrechnungssysteme zurückgespielt werden

• Auftrag und Ausführung fachlich detaillierter beschrieben werden sollen

---

Praktische Einordnung

• Normale Ware → NoReturnable

• Einzelnes rückzugebendes Objekt → UniqueReturnables

• Mehrere gleiche Leerguteinheiten → GroupedReturnables

👉 In der Praxis ist GroupedReturnables besonders relevant für klassisches Leergut wie Paletten oder Kisten.