Skip to content

Additional Features

Apptus eSales 4 includes several additional features that work across different parts of the system.

Store specific stock numbers

Apptus eSales supports supplying store specific stock numbers for variants. This enables visitors to get an experience that is tailored towards their preferred physical stores. The out of stock settings in the eSales Apps will take a visitors' selected stores into account when presenting products and variants, provided that the query parameter channels is not just ONLINE. The online stock is always returned in the result, along with the stock of all the selected stores present on the variants. On the product page the stock is returned for online and all stores present on the variants.

How to use

Stores and channels should be provided as query parameters. Each store value must match a provided store key in the data feed. The set of valid stores is assumed to be stored externally. For more information and examples, see Stores and channels.

Custom prices

Supplying custom prices for variants enables displaying visitor specific prices, or showing prices within the same market in different currencies.

Custom local prices

It can for example easily be integrated with external currency providers and is suitable for retailers supporting shipping to multiple locations, but not fully supporting different markets. Custom prices are fully compatible with price filtering and sorting, and prices will automatically be updated and rendered in both product listings and in price filters.

If a product lacks price information for a given price id, that product will be omitted from all results where that price id is specified in a request. For example, if searching for jackets with EUR as the price presentation, jackets without a custom price provided in EUR will be omitted from the search result.

For more information about custom prices in the data feed, see the Format Specification.

How to use

The applicable price identifier should be provided as a query parameter. This must match a provided price id in the data feed.

Keeping the state of which price identifiers that are applicable to different clients, such as selected currencies, is assumed to be stored externally.


Supplying ratings as the standard rating attribute for products in the data feed enables the feature of displaying rating stars in product cards in all product listings.

A product rating is supplied as a value from 0.0 to 5.0. Rating of actual products and score aggregation is assumed to be handled elsewhere, e.g the value to import is the current rating to display.

How to use

Ratings are automatically included in a response to a query if they are present in the data feed.

For more information about ratings in the data feed, see the Format Specification.


A personal input signal supported by eSales 4 is a visitor's favorite products. Visitors can select and have their favorite products notified to eSales via the API.

Introducing favorites

How to use

When a visitor select a product as a favorite, send the Add favorite notification. When a visitor removes a favorite, send the Remove favorite notification.


Content is a flexible and generic type of data, that can be searched for and ranked according to interest or newness. Typical entities that would be suitable to supply as content are for examples FAQs, magazine entries and inspirational articles.

Introducing content

Apptus eSales 4 uses both user interactions and the provided content data, to determine how to rank content. Furthermore, multiple types of content can be added and used for separate purposes. For example, FAQs could be added as content to search in, while also adding the latest and greatest inspirational articles for presentation on the start page.

How to use

Supply the content items in the data feed.

To create a new separate endpoint for search, e.g. a standalone FAQ search, use the Content Search Page query. Content entities may also be included on the Search Page.

To retrieve content information, or list content according to newness or relevance, use either the Content Information query or the Landing Page query. Some requests require that the content lists to include are specified in the request body through a Page configuration.

Last update: March 25, 2022
Back to top

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.