Merchandising

How it works

To generate a product lister page, execute a Navigation request and follow these steps:

• Use the facets from the response to display Facets.
• Use the items from the response to display products.
• Use the configuration to display paging & sorting options.

💡

If you're using group codes, use the Navigation (grouped) endpoint and learn more about Grouped Items.

Structure

After successfully executing the search request, the reponse XML or JSON response will contain everything you need to generate a search results page. The XML response will have this structure:

• facets: see Facets.
• items: see Items.
• properties: see Properties.

<navigation xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <facets>
    <facet>
      <!-- omitted for brevity -->
    </facet>
  </facets>
  <items>
    <item>
      <!-- omitted for brevity -->
    </item>
	</items>
	<properties>
    <nrofitems>4480</nrofitems>
    <pagesize>12</pagesize>
    <nrofpages>374</nrofpages>
    <currentpage>1</currentpage>
    <selectedcategory>100022</selectedcategory>
    <isrootcategory>false</isrootcategory>
    <pageurl>?tn_cid=100022&tn_sort=Aanbevolen</pageurl>
    <reseturl>?tn_cid=100022</reseturl>
    <sortfields>
      <!-- omitted for brevity -->
    </sortfields>
  </properties>
</navigation>

Facets

To implement facets, read our guide on Facets.

Items

To implement items, go to Items.

Properties

• nrofitems, pagesize, nrofpages and currentpage: see Paging.
• selectedcategory: the currently selected category. This is the value of the tn_cid parameter. In case of a category path it's the last one in the list (e.g. for tn_cid=100022-100021968 the value is 100021968 ).
• isrootcategory: indicates if the current category is the root category.
• pageurl: current request url without paging properties.
• reseturl: a predefined request url to easily reset all selected facets, sorting and paging.

Sorting

To support different ways of sorting (or ordering) of items, go to Sorting, ordering and paging.

Paging

To implement paging, dive into Sorting, ordering and paging.

Language

To specify what language should be used, go to Language Support.

Overrides

To override default values or specific app configuration, go to Override App Configuration.

💡

Need even more control?

In general, the response times of our endpoints are so fast we can provide both facets and products in a single response. This makes a traditional implementation of search and/or merchandising easy.

If you want even more control or want to squeeze the last piece of performance, take a look at the Facets and Products endpoints.