Skip to content

This online publication is intellectual property of Apptus Technologies. Its contents can be duplicated in part or whole, provided that a copyright label is visibly located on each copy and the copy is used in conjunction with the product described within this document.

All information found in these documents has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither Apptus Technologies nor the authors shall be held liable for possible errors or the consequences thereof.

Software and hardware descriptions cited in these documents might be registered trademarks. All trade names are subject to copyright restrictions and may be registered trademarks. Apptus Technologies essentially adheres to the manufacturer’s spelling. Names of products and trademarks appearing in this document, with or without specific notation, are likewise subject to trademark and trade protection laws and may thus fall under copyright restrictions.


Getting Started

Get started with Apptus eSales Fashion by following a few easy steps. First, contact to get credentials to the Apptus Cloud environment. Using the credentials, a live demo can be viewed and custom data can be loaded. Finally some customisation can be performed.

Cloud credentials

The credentials for the Apptus Cloud environment consist of three parts:

  • webApiId - A public cluster Id pointing to the retailers eSales service. The Web API cluster Id is used for the site integration.
  • Api-Key - A private key. The private key is used when importing data and notifying orders to the eSales service.
  • Apptus eSales Apps invitation mail - Used to access the web based apps for reporting and merchandising.

Following is an example of what the webApiId and Api-Key can look like, and this will be used as such through out this page. For the actual integration, the keys received from Apptus must be used.

webApiId: w1A2B3C45
Api-Key (private): pkA123456789AB1BDA3E968F69A97B5508BF5B123456778912FFC99

Live demo

Once credentials has been received, a live demo of eSales Fashion with sample data can be viewed. Copy the URL below into a web browser and replace the webApiID with the one received and press Enter. The live demo uses UK as market.

<!--Change webApiID-->

Load custom data

The eSales Fashion service is preloaded with sample data. To view the demo with custom product data, a data file can be created according to the eSales Fashion data format specification. The product data is normally generated based on data available in a retailers' systems. The market value for the custom data must be UK when using the live demo.

Load the data into the eSales service using the standard HTTP POST protocol. If no errors are present in the import, the new product data will be visible on the live demo site.

The following example loads product data into eSales using the received credentials and the custom product data saved to the file my_data.xml.

curl -i -X POST -d @- \
-H "Content-Type: application/xml" \
-H "Api-Key: pkA123456789AB1BDA3E968F69A97B5508BF5B123456778912FFC99" \
"" < /my_data.xml

With the custom data loaded, the type of results that can be expected with eSales Fashion can be experienced to some extent.

The search results mainly rely on three parts: the quality of the data in the product feed, the quality of the cutout images specified in the product feed, and the user behaviour on the site.

At this stage eSales Fashion will not be able to showcase the effect of the behavioural data, but search, including colour search, can be tried out without it.

Colour search processing time

The colour search image processing usually takes about 5 minutes for 1 000 products. If the product data file is very large, it might take a little while before the colour search is working optimally.


Although eSales Fashion is designed and themed out of the box in a way that follows many best practices in e-commerce, the theme may require alterations to fit a retailer's visual identity.

Apptus eSales Fashion consists of several components such as the search assistant and the search results. To change the look and feel of these components, eSales Fashion allows for customisation to a certain degree.

For a live site, the theming is set with the initialisation of eSales. For the live demo site a customisation page is available that allows to theme the components and change the look and feel of eSales Fashion. The link to the customisation page is also available in the footer of the live demo.

Other available settings for eSales Fashion, including modification of some of the texts displayed in the components, can be done in the Experience app.

Last update: April 30, 2020