Datentyp: Bestellpositions-Daten
Beschreibung:
TYRIOS speichert Bestellpositionen in einem OrderDetailData-Objekt. 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. Insbesondere 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 OrderDetailData-Objekt die folgende Datenstruktur:
{
"id": 1349, // id der OrderDetailData, automatisch zugewiesen
"OrderData": 697, // id der OrderData, erforderlich, automatisch durch den API-Aufruf zugewiesen
"ShopCategoryData": 3, // ID der ShopCategoryData, die zum Hinzufügen dieser OrderDetailData verwendet wurde, optional
"ProductData": null, // ProductData-Objekt oder ProductData-ID, optional
"shippingTime": null, // gibt die Lieferzeit für diese Position an
"varyingPrice": null, // gibt einen variierenden Preis für diese Position an
"productImage": null, // MediahelperFile Objekt oder id, optional
"position": null, // Position der Bestellung, optional
"materialNumber": "1234", // Materialnummer des verwendeten Produkts, optional
"name": "product name", // Name der Position, erforderlich, max 255 Zeichen
"description": null, // Beschreibung der Position, optional
"amount": 1, // Betrag der Position
"singlePrice": 102.67960594958, // einzelner Nettopreis, erforderlich
"singleBasePrice": 0, // einzelner Basis-Nettopreis, erforderlich für die Umsatzberechnung. wenn nicht angegeben, 0
"singleUVP": null, // einzelner Listen-Nettopreis, o
Beziehung zu ProductData
Ein OrderDetailData wird 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 OrderDetailData-Objekte erstellen, ohne auf das PIM-System Bezug zu nehmen. 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 die restlichen Daten trotzdem ausfüllen, da sie nicht automatisch umgewandelt werden. Bitte sieh dir die API an, da dies dort ausführlich beschrieben ist.
Speicherung von Analysedaten
Ein OrderDetailData speichert in der Regel alle erforderlichen statistischen Daten in sich selbst. Es ist nicht sicher, dass die ProductData zum Zeitpunkt der Analyse noch vorhanden sind. Wir empfehlen daher dringend, alle statistischen Daten wie Gewicht, Farbe usw. ebenfalls zu speichern.