Bestelldaten-Datentyp
Beschreibung:
TYRIOS speichert Aufträge in einem OrderData-Objekt. Es ist sicherlich eine der komplexesten Datenstrukturen in TYRIOS und 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 dies 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 OrderData-Objekt die folgende Datenstruktur:
{
"id": 697,
"UserData": 33, // UserData-Objekt oder UserData-ID, erforderlich zum Ändern des Status
"OrderAssistant": 22, // UserData-Objekt oder UserData-ID, optional, kann automatisch zugewiesen werden
"BillingAddress": 34, // UserAddressData-Objekt oder id - erforderlich
"ShippingAddress": 34, // UserAddressData-Objekt oder id - optional
"OrderDetailData": [], // Array der OrderDetailData der Bestellpositionen, erforderlich zum Ändern des Status
"orderTime": null, // Bestellzeitpunkt, null wenn im Entwurfsmodus
"lastChangeTime": 1631281823000, // unix timestamp
"OrderState": null, // OrderState Objekt, kann nicht manuell geändert werden
"contactPhone": null, // optionales Kontakttelefon
"taxCode": null, // optionaler taxCode
"ip": "192.168.1.35", // IP-Adresse der Bestellung
"provider": "provider name", // Name des Anbieters
"orderLang": "de", // Sprache der Bestellung
"shippingCosts": 2.11, // Lieferkosten der Bestellung
"DeliveryOptionData": null, // DeliveryOption-Datenobjekt, automatisch zugewiesen
"selectedDeliveryTime": null,
"deliveryOptionName": "Standardversand",
"PaymentOption": null, // Zahlungsoptionsdatenobjekt, automatisch zugewiesen
"PaymentObjectData": null, // Zahlungsdatenobjekt zum Speichern aller Zahlungsinformationen
"AffiliateData": null, // AffiliateDatenobjekt für Marketinganalysen
"lastOrderAction": null, // Bestellaktion, automatisch st
"CouponData": null, // verwendete Coupons
"ignoreCouponData4PriceCalculation": false,
"CouponOrderDetailData": null,
"agbAccepted": true, // Information, ob der Nutzer AGB akzeptiert hat
"revocationAccepted": true, // Information, ob der Nutzer den Widerruf akzeptiert hat
"paymentAccepted": false, // Information, ob der Nutzer die Zahlungsbedingungen akzeptiert hat
"total": 126.7, // Gesamtbetrag der Bestellung, automatisch berechnet
"grossRevenue": 102.68, // Gesamtbruttoumsatz, automatisch berechnet
"discount": null, // vorgesehener Rabatt
"taxMode": "B2C", // Steuermodus, mögliche Werte: B2C, B2B, B2B_EU, wird automatisch anhand der Lieferadresse berechnet
"VATVerificationResult": null,
"globalBillDataPreText": null,
"globalBillDataPostText": null,
"orderTags": [
"Online-Bestellung" // mögliche Tags zum Filtern
],
"ShoppingCardOfferRequest": null,
"acceptedProductSpecificAcceptanceText": null,
"OrderAcceptanceData": [], // optionales Array für Rechtstexte (z.B. AGB), die akzeptiert wurden
"editable": true, // gibt an, ob die Bestellung geändert werden kann
"dropShipping": false, // gibt an, ob die Bestellung eine Dropshipping-Bestellung ist
"ProductUserComment": null,
"OrderDataUserComment": null,
"orderDataUserCommentNotificationLevel1MailSent": false,
"orderDataUserCommentNotificationLevel2MailSent": false,
"orderDataUserCommentNotificationLevel1CouponSent": false,
"orderDataUserCommentNotificationLevel2CouponSent": false,
"productUserCommentNotificationLevel1MailSent": false,
"productUserCommentNotificationLevel2MailSent": false,
"productUserCommentNotificationLevel1CouponSent": false,
"productUserCommentNotificationLevel2CouponSent": false,
"enableUserCommentPrompt": false,
"userCall4CommentSent": false,
"digitalProductDataDownloadEnabled": false,
"digitalProductDataDownloadHash": "",
"BillData": null, // Verweis auf BillData (Rechnungen, Lieferscheine,...)
"paymentText": "Sie hatten als Bezahlform Paypal ausgewählt. Ihr Paypal-Konto läuft unter Testkäufer (paypal-buyer@thunder-2000.com). Die Zahlung in Höhe von 126,70 € wurde am Fr, 10. Sep 2021 um 15.50 Uhr durchgeführt." // optional payment inforamtion added to BillData
}