We use cookies in order to give you the optimal experience of our website. Some of them are required for the operation of this site (e.g. in order to use the shopping cart). Others allow us to enhance our online offers and to display them efficiently. You can use the settings to determine which cookies you will permit. Further details can be found in our privacy policy.
Settings
  • Required
    These cookies are required for the functionality of this site, e.g. by making it possible to add products to the shopping cart. Furthermore, this type of cookie guarantees that you can log into your account and that you can stay logged in, in order to maintain access to your order details. Required cookies are exclusively used on this Website. No data is transferred to third parties.
  • Comfort
    These cookies allow the custom tailoring of certain features in order to enhance the user experience and simplify the use of our site.For instance, they make it easier to search for and find suitable products. Cookies used to enhance the user experience are exclusively used on this site and no data is passed on to third parties.
  • External Media
    We provide you additional media, e.g. videos or maps. This media is provided by third parties, who are using cookies.Cookies for external media is used by third parties or publishers. We do not have any control about this cookie usage.
  • Statistics
    In order to further improve our Website, we collect anonymous data for statistics and analysis. These cookies enable us to keep track of traffic which helps us improve the site systematically. For these purposes, only anonymous data is passed on to third parties.
  • Marketing
    Marketing cookies help us to inform you about interesting offers on other websites. Marketing cookies are used by third parties or publishers in order to present personalized adds.

Data type OrderDetailData

Description:

TYRIOS saves order positions in an OrderDetailData object. It is extremely likely that the data structure depends on your concrete installation due to the different supported systems (e.g. configurable orders, POS based orders, production orders, recurring orders,...) . For creating orders using the API, this is not relevant, as only the data is important you are using. However, if you want to update an order, you really need to be careful to not overwrite existing data.

Attention

Please be aware: TYRIOS is an aspect-oriented system and the concrete data structure depends on your system configuration. Especially in case you want to update existing data, please be aware to take all available fields into account or use an update specific API endpoint to avoid data loss.

General data structure

In general, an OrderDetailData object has the following data structure:

{
    "id": 1349, // id of the OrderDetailData, automatically assigned
    "OrderData": 697, // id of the OrderData, required, automatically assigned by the API call
    "ShopCategoryData": 3, // ID of the ShopCategoryData which was used to add this OrderDetailData, option
    "ProductData": null, // ProductData object or ProductData id, optional
    "shippingTime": null, // specifies the delivery time for this position
    "varyingPrice": null, // specifies a varying price for this position
    "productImage": null, // MediahelperFile object or id, optional
    "position": null,     // position of the order, optional
    "materialNumber": "1234", // material number of the used product, optional
    "name": "product name", // name of the position, required, max 255 characters
    "description": null, // description of the position, optional
    "amount": 1, // amount of the position
    "singlePrice": 102.67960594958, // single net price, required
    "singleBasePrice": 0, // single base net price, required for revenue calculation. if not given, 0
    "singleUVP": null, // single list net price, optional
    "singleOriginalPrice": null, // single original net price, used to identify marketing actions
    "discount": null, // potential discount in percent, max 1
    "carry": false, // specifies that this position is not delivered
    "freeDelivery": false, // specifies if this position is delivered for free
    "tax": 19, // tax
    "unit": "Stk", // unit
    "productVersion": 9, // specifies the version of the product which was ordered
    "productType": "2", // specifies the product data type
    "isShoppingCardOfferRequestElement": false,
    "weight": null,
    "limitPaymentOption": false, // specifies if the payment options are limited
    "PaymentOption": null, // array of potential payment options
    "limitDeliveryOptionData": false, // specifies if the delivery options are limited
    "DeliveryOptionData": null, // array of potential delivery options
    "alternativeFakturaDescription": null,
    "MediahelperFile": null, // array of MediahelperFile
    "OrderDetailDataCommentData": null,
    "hasSubPositions": false,
    "OrderDetailDataSubPosition": null, // array to potential sub positions
    "brand": null,
    "color": [], // array of string
    "gender": null,
    "ageGroup": null,
    "material": [], // array of string
    "pattern": null,
    "size": null,
    "productTags": [],
    "stockState": "2",
    "ProductGroupData": null, // ProductGroupData id or object
    "rejectRevocationSupport": false,
    "reason4rejectRevocationSupport": null, // string
    "OrderDetailDataState": null, // OrderDetailData state for internal workflow management
    "customsTariffNumber": null,
    "countryOfOrigin": null,
    "detailType": "default",
    "FreeOrderDetailDeliveryOptionTerm": null,
    "OrderDetailVariantData": null,
    "ProductDataVariantData": null,
}

Relation with ProductData

An OrderDetailData is very frequently linked to a ProductData object (e.g. in a classical online shop). TYRIOS is however not limited to this scenario. You can also create complete individual OrderDetailData objects without any refernce to the PIM system. This makes it possible to use the system also for service related orders. When you link to a ProductData, you nevertheless need to fill the rest of the data as it is not automatically converted. Please have a look to the API because this is described in detail there.

Storage of analysis data

An OrderDetailData typically saves all required statistical data on itself. It does not rely that the ProductData will still be there in time of analysis. Thus we highly recommend to also provide all statistica data like weight, color, etc.

Solution:

Tips und Tricks:

Subscribe to our newsletter

Stay informed at all times. We will gladly inform you about product news and offers.