---
title: "Contextual E-Commerce"
slug: "contextual-e-commerce-configuration"
updated: 2026-07-06T10:26:25Z
published: 2026-07-06T10:26:25Z
canonical: "learn.servitly.com/contextual-e-commerce-configuration"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://learn.servitly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contextual E-Commerce

Here you can find a step-by-step guide to set up the contextual e-commerce and start selling spare parts and consumables in the DPS.

The e-commerce allows the following products to be sold within the DPS:

- [Spare Parts](/docs/spare-parts) that can be replaced within a machine due to sudden breakage or because they are subject to wear and tear.
- [Consumables](/docs/consumable-definition) used by machines during processing phases, which require periodic refilling.

In the DPS, we can identify two main actors: [BUYERS](/docs/buyers-and-providers#buyers) (end-customer or partners purchasing products), [PROVIDERS](/docs/buyers-and-providers#providers) (OEM and Partners selling products).

The DPS entry points to the e-commerce are:

- General [Catalog](/docs/spare-parts-catalog), which allows back-office and service users to search for spare parts and consumables for their customers;
- contextual Catalog which allows customer users to search for spare parts and consumables compatible with their machines;
- [Store](/docs/store-page) page, which allows DPS users to manage their shopping cart, complete an order of spare parts or consumables, and manage their orders.

> [!WARNING]
> This feature is available for the following modules:
> 
> SMART SPARE PARTS & CONSUMABLES

## Configuring the Contextual E-Commerce

1. Upload the catalog of [Spare Parts](/docs/spare-parts).
2. Define [Product Models](/docs/product-model) to be assigned to the things registered in the DPS.
3. Define [Spare Part References](/docs/spare-part-reference) for each Product Model.
4. Enter the [Interfaces / Views](/docs/views) page.
5. Open the *Back-office* view used by the Organization.
6. In the *Pages* section, click on *Add Predefined Page* and select the *Store* page. This will add the [*Store*](/docs/store-page) page to the *Back-office* view. The page is predefined; if needed, you can configure certain aspects of the page, such as the label, ico,n and menu position. ![](https://cdn.document360.io/6759e9c9-3ce3-49df-965a-7231d2d9a10a/Images/Documentation/image(703).png)
7. Repeat step 3, but for the *Customer* view. In this case, in the configuration page of the *Store* page, you should deselect the *Show Catalog* option.
8. Go to the [Interfaces / Views](/docs/views) page, then *Thing Definitions*, and select the thing definition in which you want to enable the *Catalog* browsing.
9. Select the Customer view, and add a new tab named *Catalog.*
10. In the template of the newly created tab, place the [Catalog](/docs/catalog-widget) widget. In this way, customers will access the Catalog of spare parts and consumables directly from the machine view, without the need to select the right product model.
11. (OPTIONAL) Enter the [Properties / Location](/docs/location-properties) page, and verify that the following custom properties are defined: *city*, *zipCode*, *address*, *streetNumber*, and *phoneNumber*. In the DPS, when an [order](/docs/order-management) is created, the location detail automatically includes, other than the location *name* and *country*, all the above custom properties if defined.
12. For each User Type that will have access to the *Store* page, you must also configure [User Permissions](/docs/user-permissions) to enable the right functionalities according to what you want to sell and who can buy products.
13. Navigate the DPS by using the back-office view, and you will find the *Store* page in the menu as a first-level page.
14. Navigate the DPS by using the customer view, you will find the *Store* page in the menu as a first-level page, and the *Catalog* tab when entering the thing details view.

## User Permissions

Each user accessing the DPS is associated with a User Type (e.g., Back-office Admin), which has a set of [permissions](/docs/user-permissions) defining what the user can see and do in the DPS. To improve the security (principle of least privilege), the Store is also subject to permissions, and by entering the [User Types](/docs/user-types) page, you will find a group of permissions named *Store* that you can configure on each User Type. Note that some permissions could be available only to certain user type categories (e.g., only Organizations and Partners can modify an order).

Here are the permissions involved in the e-commerce and their effect on DPS data access and UI.

| PERMISSION | USER CATEGORY | DESCRIPTION |
| --- | --- | --- |
| *Read Spare Part* | *ANY* | Allows the user to view *Spare Parts* in the Catalog. The *Catalog* tab is visible on the *Store* page. |
| *Read Order* | *ANY* | BUYER: allows the user to view all created orders. PROVIDER: allows the user to view all received orders. The *Orders* tab is visible on the *Store* page. |
| *Place Order* | *ANY* | BUYER: allows the user to place an order. The checkout button is available in the *Cart* tab of the *Store* page. |
| *Write Order* | *ANY* | PROVIDER: allows the user to add notes to an order or change the order status. |