Skip to main content

Order referrer

Omni-channel sale with plentymarkets means that you can use many different channels to offer your items to customers and, therefore, generate orders from many different sources. Some referrers in the system are set up by default and are fixed entries that cannot be changed. Other referrers are automatically added e.g. when you integrate a plugin or plentyPOS. Referrers from plugins cannot be deleted. You can also add referrers manually.

Each referrer has a unique ID. Some referrers have sub-referrers. The ID for a sub-referrer is composed of the ID of the main referrer followed by two decimal numbers. Amazon, eBay and plentyPOS are examples for main referrers that have sub-referrers. Each country platform of eBay and Amazon has a sub-referrer just like every till registered with plentyPOS will have a sub-referrer.

Regardless of their referrer, all orders are listed and can be edited in the Orders » Edit orders menu. There, the referrer is displayed on every order. The ID of a referrer is displayed in line with further order details. If you point the cursor to the ID, a tooltip with the referrer’s name is shown. Additionally, the referrer is displayed in the Settings tab of an order. The referrer can be changed but only if it is a manually created referrer and only as long as no invoice was created yet.

1. Activating an order referrer

Default referrers and referrers that were automatically added by plugins only need to be activated. To do so, proceed as follows.

Activating an order referrer:

  1. Go to Setup » Orders » Order referrer.

  2. Select a referrer.

  3. Activate the referrer by placing a check mark.
    → Note also the information given in Table 1.

  4. Save () the settings.

2. Manually creating an order referrer

As already mentioned in the introduction to this chapter, you can manually add order referrers to the system. Proceed as described below to manually create an order referrer.

Creating an order referrer:

  1. Go to Setup » Orders » Order referrer.

  2. Click on New ().
    → A new line is added to the referrer list with the cursor of your mouse is directly placed in the name column of that line.

  3. Enter a name for the referrer.

  4. Carry out the settings according to Table 1.

  5. Save () the settings.

Table 1. Settings for order referrers
Setting Explanation


Each referrer is given a unique ID. It is automatically assigned by the system and cannot be changed. The IDs 9-100 are available for manually created order referrers. The IDs 1-8 as well as from 101 and higher are reserved for predefined order referrers in the system. Sub-referrers are represented by a decimal ID, for example 2.08 for eBay Germany.
Note: When all available IDs are assigned to manually created order referrers, the butten New () is no longer displayed because no new order referrers can be added.


The name entered here is displayed in the system, for example in the order search. The name can be changed at any time.

Internal name

The internal name cannot be changed and is not displayed in the system. Only predefined order referrers are given an internal name, manually created order referrers not.


Select which person should automatically be entered as owner of orders with this referrer. You can choose from all users who were given these rights in the Setup » Settings » User » Accounts menu.

Activation column

Activate the referrer by placing a check mark. If activated, the referrer is displayed in other menus, for example in the Settings tab of an order.
If you deactivate the referrer, it is no longer displayed in the system.
You can activate or deactivate all referrers at once by clicking on Select all on the table header.

Copy online store URL

Copies the referrer’s URL to the clipboard.
The URL is required for affiliate services, for example. It contains the corresponding ID as the so-called Referrer ID.

Open in the store ()

A click on the preview () opens the online shop with the referrer ID added to it. All prices displayed are for the corresponding order referrer.
The preview can only function correctly if you have set up sales prices and activated the sales price for the referrer you wish to see a preview for. In addition, the sales price also has to be added to a variation and a value for the price must have been saved.


Click on the delete to delete an order referrer. You can only delete manually created order referrers. Default order referrers in the system cannot be deleted.

Referrers are required for affiliate service providers

The referrer option is also required for cooperation with affiliate partners. These partners will forward potential customers to you via defined tracking URLs and expect a commission in return when the customer purchases something.

3. Filtering and evaluating orders by order referrer

The order search in the Order » Edit orders menu offers many filters to narrow down the number of results. The Referrer filter searches for orders with a specific referrer (for example Client (shop), Amazon, eBay etc.). Amazon and eBay have both general referrers and sub-referrers for each of the country platforms.

For monthly overviews, it makes sense to combine filters and to use a date as an additional filter, for example the date when orders were received.

The referrer is important for measuring how well your items sell on different platforms. This information tells you which platforms are most profitable. In addition to the search function in the Orders » Edit orders menu, further evaluation options are available in the plentyBI tool. There, you can select an order referrer and see the revenue that was generated by each referrer. Based on this, you can make well-informed decisions on how to use your advertising budget in the future in an efficient manner.

To top