Datentyp: Unterposition einer Bestellposition
Beschreibung:
TYRIOS speichert Auftragspositionen in einem OrderDetailData-Objekt. Dieses Objekt unterstützt Unterpositionen für abhängige Positionen. Es ist sehr wahrscheinlich, dass die Datenstruktur aufgrund der verschiedenen unterstützten Systeme (z.B. konfigurierbare Aufträge, POS-basierte Aufträge, Produktionsaufträge, wiederkehrende Aufträge, ...) von deiner konkreten Installation abhängt. Für die Erstellung von Aufträgen über die API ist das nicht relevant, da nur die Daten wichtig sind, die du verwendest. Wenn du jedoch eine Bestellung aktualisieren willst, musst du darauf achten, dass du keine bestehenden Daten überschreibst.
Achtung
Bitte beachte: TYRIOS ist ein aspektorientiertes System und die konkrete Datenstruktur hängt von deiner Systemkonfiguration ab. Vor allem, wenn du bestehende Daten aktualisieren willst, solltest du alle verfügbaren Felder berücksichtigen oder einen aktualisierungsspezifischen API-Endpunkt verwenden, um Datenverluste zu vermeiden.
Allgemeine Datenstruktur
Im Allgemeinen hat ein OrderDetailDataSubPosition-Objekt die folgende Datenstruktur:
{
"id": 41, // id, automatisch erstellt
"OrderDetailData": 1349, // Referenz auf die OrderDetailData, gesetzt durch API
"ProductData": null, // ProductData Objekt oder id
"position": "1.1", // Positionstext
"materialNumber": "A22", // Materialnummer
"name": "sub position name", // Name der Unterposition, max. 255 Zeichen
"description": null, // Beschreibung
"alternativeFakturaDescription": null,
"amount": 1,
"Einheit": "Stk",
"Marke": null,
"Farbe": [], // Array von Strings
"gender": null,
"ageGroup": null,
"material": [], // Array von Strings
"pattern": null,
"size": null,
"productTags": [], // Array von Strings
"stockState": "1",
"ProductGroupData": 1, // ProductGroupData Objekt oder ID
"customsTariffNumber": null,
"countryOfOrigin": null,
"detailType": "default"
}
Beziehung zu ProductData
Eine OrderDetailDataSubPosition ist sehr häufig mit einem ProductData-Objekt verknüpft (z.B. in einem klassischen Online-Shop). TYRIOS ist jedoch nicht auf dieses Szenario beschränkt. Du kannst auch ganz individuelle OrderDetailDataSubPositions-Objekte erstellen, ohne dass ein Bezug zum PIM-System besteht. Dadurch ist es möglich, das System auch für servicebezogene Bestellungen zu nutzen. Wenn du eine Verknüpfung zu einem ProductData herstellst, musst du trotzdem die restlichen Daten ausfüllen, da sie nicht automatisch umgewandelt werden. Bitte sieh dir die API an, denn dort wird dies ausführlich beschrieben.
Speicherung von Analysedaten
Eine OrderDetailDataSubPosition speichert in der Regel alle erforderlichen statistischen Daten auf sich selbst. Es ist nicht sicher, dass die ProductData zum Zeitpunkt der Analyse noch vorhanden sind. Wir empfehlen daher dringend, auch alle statistischen Daten wie Gewicht, Farbe usw. bereitzustellen.