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.

TYRIOS order API

Description:

TYRIOS makes it possible to manage orders directly from API. Here are general rules for using the order API:

  • TYRIOS depends on different module configurations. It depends on your configuration if an endpoint is available.
  • It depends on your rights if you can call a specific endpoint.
  • TYRIOS is an aspect oriented system. It depends on the concrete configuration, which fields are available and processes. In this document we will discuss the typical structure.

Authentication

The API endpoints of TYRIOS are only available for authorized users. Therefore, the user must be authenticated. There are two different authentication types:

  • Authentication by BASIC authentication. The user account must have an activated REST API token. You need to send an appropriate BASIC authentication header.
  • Authentication by mobile app registration. You need to send an appropriate app registration token.

Data structure

TYRIOS makes the underlying data structure directly available using REST API.

  • OrderData: saves the order itself (data type OrderData)
  • UserData: saves the user information - potentially linked with customer information (data type UserData)
  • BillingAddress and ShippingAddress: saves addresses (data type UserAddressData)
  • OrderDetailData: saves different order positions (data type OrderDetailData)
  • OrderDetailDataSubPosition: saves sub positions (data type OrderDetailDataSubPosition)
  • ProductData: saves product information, typically linked to the PIM system (data type ProductData)

API endpoints

Get orders

To get all available orders, you need to make a GET request to the following URL:

https://[tyrios-instance.de]/service/OrderManagement/OrderData/

The service provides a paginated result. You can control the pagination with offset and length parameter. In addition, the service supports sorting and filtering. As filter, a JSON struct is required. All order fields are supported.

Sorting supports sorting for multiple fields and need to be provided as JSON struct.

Get a specific order data

To get one specific order data, you need to create a GET request to following URL.

https://[tyrios-instance.de]/service/OrderManagement/OrderData/[orderID]

Please keep in mind that the concrete data structure depends on your installation.

Save / create order

To create or save an order, you need to create a POST request to following URL.

https://[tyrios-instance.de]/service/OrderManagement/OrderData/

You can create an empty order by passing an empty JSON object. By doing this, the system automatically creates an order ID for which you can add / update order details in an iterative process.

You can also assign data directly to the order - including creating the complete order data object. This data must be provided as payload to the POST request.

{ 
UserData: null, // UserData object or userID 
BillingAddress: null,  //UserAddressData object or addressID 
ShippingAddress: null, // UserAddressData object or addressID 
...
}

Please have a look to the detailed OrderData data structure to see the possible fields. 

Note

The API depends on your specific user rights. This not only applies to the API endpoints itself but also to the underlying functionality. If you don't have the right to change an order state, the order state will be for example not processed with this API call. Your provided field data will be ignored in that case.

Add / update an order detail data

if you want to add an order detail data to an order, you need to create a POST request to following URL:

https://[tyrios-instance.de]/service/OrderManagement/OrderData/[orderID]/OrderDetailData

If you want to assign a product, you need to specify in the payload a ProductData object or the corresponding product ID. TYRIOS will automatically load the corresponding ProductData from the pim system and create the corresponding OrderDetailData. You can however also overwrite this data. The payload will look like:

{
  ProductData: null // ProductData object / productID
  amount: 23, //required, automatically set to 1 if ProductData is given
  title: "title", //required, automatically set if ProductData is given
  "materialNumber": "materialNumber", // automatically set if ProductData is given
  "price": 14.33 //required, automatically set if ProductData is given
  "tax": 19, // required, automatically set if ProductData is given
  description: //optional, automatically set if ProductData is given
}

Please keep in mind that the concrete data structure depends on your installation. If OrderDetailData->id is null, ProductData is automatically converted to OrderDetailData. Only this data is overwritten, which is specified.

Delete an order detail data

To delete an OrderDetailData, you need to send a DELETE request to the URL:

https://[tyrios-instance.de]/service/OrderManagement/OrderData/[orderID]/OrderDetailData/["OrderDetailDataID"]

Release an order data

By default, an OrderData is created with primary state "Draft". An order in draft state can be changed by the user and is not released so far. Typically, a user has the right to release an OrderData in an online shop. This is also possible to be done by API. Therefore a POST request must be sent to this endpoint:

https://[tyrios-instance.de]/service/OrderManagement/OrderData/[orderID]/release

No payload is required.

The API is only available, ...

  • if the currently logged-in user is the user of the OrderData itself or
  • if your authorized user has the right to change order states or
  • if the Cookie OrderCode is available and it is identical to cookieID field of OrderData
  • if an HTTP header Order-Code is available and it is identical to cookieID field of OrderData

Solution:

Tips und Tricks:

Subscribe to our newsletter

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