Skip to main content is a pure B2B portal, which means that both sellers and buyers have to be in possession of a valid traders licence (source: On this page, you will learn how to link the market to your plentymarkets system.

1. Registering with

You have to register in the seller portal before you can set up in your plentymarkets system.

2. Creating a user account

Your plentymarkets system is connected to via the SOAP API. In order to gain access, the market requires its own user account with access rights to the API in your plentymarkets system. Go to System » Settings » User » Accounts and create a new user account for with the user class API. Furthermore, activate the call GetCategoryMappingForMarket. This call ensures that the market will later be able to retrieve your category links.

Creating a user account for

  1. Go to System » Settings » User » Accounts.

  2. Click on New.
    → The Create new user window opens.

  3. Enter the data.

  4. Select the user class API.

  5. Save the settings.
    → The user is created.

  6. Select the user from the list.
    → An editing window opens.

  7. Click on the tab Right » API.

  8. Expand the Item area.

  9. Activate the GetCategoryMappingForMarket call.

  10. Save the settings.

For further information refer to the Managing user accounts page of the manual.

3. Procuring data requires the following data from you in order to connect to your plentymarkets system:

  • The URL for the SOAP API WSDL
    → This URL can be found in the System » Settings » API » Data menu under SOAP WSDL.

  • The user name and password for the user account that you have created for

  • Your login details for the seller portal.

4. Activating an order referrer

In order to link items, properties etc. with, you have to activate the order referrer Restposten in the menu System » Orders » Order referrer.

Activating the order referrer for Restposten:

  1. Go to System » Orders » Order referrer.

  2. Place a check mark next to the option Restposten.

  3. Save the settings.

5. Setting the item availability

Items have to be available for This is done in the Availability tab of an item within the Item » Edit item » Open item » Tab: Variation ID menu.

Setting the item availability for

  1. Go to Item » Edit item » Open item » Tab: Variation ID » Tab: Settings.

  2. Activate the main variation in the Availability section.

  3. Click on the Availability tab.

  4. Click in the selection field in the Markets section.
    → A list with all available markets is displayed.

  5. Place a check mark next to the option Restposten.

  6. Place a check mark next to the option Web API.

  7. Click on Add.
    → The market is added.

  8. Save the settings.
    → The item is available on

The availability for variations can be individually edited in the Item » Edit item » Open item » Tab: Variations » Open variation » Tab: Variation ID » Tab: Availability menu.

6. Defining SKU manually

Add SKUs manually for specific referrers in the menu Item » Edit item » Open item » Tab: Variation ID » Tab: Availability if needed.

Adding SKU:

  1. Go to Item » Edit item » Open item » Tab: Variation ID » Tab: Settings.

  2. Click on the Availability tab.

  3. Click on Add in the section SKU.
    → The window New SKU is displayed.

  4. Select the referrer Restposten.

  5. Enter the SKU.

  6. Click on Add.
    → The SKU is saved and displayed.

7. Defining a sales price

Proceed as described below to define a sales price for the order referrer This price is displayed on

Defining a sales price for

  1. Open the menu System » Item » Sales prices » Open sales price » Tab: Settings.

  2. Place a check mark next to the referrer Restposten.

  3. Save the settings.

8. Creating properties

Use properties to link your items to particular characteristics that you need for the market In order for to be able to retrieve the necessary parameters, the property has to be created with the property type set to the option Selection. Get in contact with to clarify which values are needed for the property.

Creating a property for

  1. Go to System » Item » Properties.

  2. Open the New Property tab.

  3. Enter the name in the Name (internal) field.

  4. Select the option Selection from the Property type drop-down list.
    → An area opens where you enter the name and description.

  5. Save the settings.
    → The property is created.

  6. Open the Properties tab.

  7. Expand the property.

  8. Enter another name in the next selection field of the Selection area.

  9. Save the settings.

  10. Repeat steps 8 and 9 until all required values are created.

  11. Save the settings.

9. Linking categories

Link your online store categories to the categories in order to display your items in these categories. Further items from the linked category are assigned automatically.

Linking categories:

  1. Go to System » Markets » Restposten.
    → The Category link tab is displayed.

  2. Expand the category which you want to link to a Restposten category.

  3. Select a main category for Restposten from the drop-down list.
    → A window with subcategories opens.

  4. Select the appropriate Restposten category from the subcategories that appear.
    → The category path is displayed in the field Category.

  5. Click on Accept.
    → The category window is closed.

  6. Save the settings.

Link to the lowest category level

Always select a path to the lowest level. Otherwise, the item will not be linked.


For returns, you have to create an order with the type return, not credit note. It is also important to specify each individual item’s value as a percentage. This is done within the return’s stock units tab.

To top