Skip to main content

Setting up Voelkner


Learn on this page how to set up the interface to Voelkner. First, you have to carry out some preparatory settings in your plentymarkets system.

1. Activating the order referrer

An order referrer tags an order with the sales channel on which the order was generated. You also need to activate the order referrer in order to link items, characteristics etc. with Voelkner. Go to Setup » Orders » Order referrer to activate the order referrer.

Activating the order referrer for Voelkner:

  1. Go to Setup » Orders » Order referrer.

  2. Activate the referrer Voelkner.

  3. Activate the referrer Mirakl.

  4. Save () the settings.

2. Defining a sales price

Sales prices define the conditions under which a variation is sold at a specific price and on a specific sales channel. That means that to sell variations on Voelkner, you need a sales price in which the order referrer Voelkner is activated. The price that you save for this sales price is the price that will be shown on Voelkner.

Defining a sales price for Voelkner:

  1. Go to Setup » Item » Sales prices » [Open sales price].
    Tip: No sales prices? Then create a new sales price first.

  2. Open the Settings tab.

  3. Activate the referrer Voelkner.

  4. Activate the referrer Mirakl.

  5. Save () the settings.

3. Creating properties

Using properties, you can export fields to the marketplace that aren’t defined in plentymarkets by default. For further information on properties, refer to the Characteristics and properties page.

The following properties are automatically available in your plentymarkets system and will be mapped in the assistant:

  • Logistics class

    • This is the link of a variation with a certain market shipping profile. You can see the market shipping profiles in the market back end in the Platform settings > Shipping menu. The value in brackets is the value that has to be transferred.

  • Leadtime to ship

    • The so-called leadtime-to-ship is the time that a seller needs from the order acceptance to the shipping registration. Here, a whole number between 1 and 45 has to be transferred.

  • Reverse charge

    • This is the so-called Reverse-charge procedure. You can either transfer true or false.

  • update-delete

    • The option to delete an offer. If no value is selected at the variation, the market used update by default.

4. Generating the API key

To create the connection for Voelkner between plentymarkets and Mirakl, you need an API key. To generate the API key, proceed as follows:

Generating the API key:

  1. Open the Mirakl back end.

  2. Click on the user icon ().

  3. Go to the API keys tab.

  4. Generate a new API key for Voelkner.

  5. Copy the API key to your clipboard. You need this key to set up your Voelkner account in plentymarkets.

5. Completing the Voelkner assistant

Use the VoelknerExtension assistant in the Setup » Assistants » Plugins » [Select plugin set] menu to set up your Voelkner account in plentymarkets.

Carrying out settings in the assistant:

  1. Go to Setup » Assistants » Plugins » [Select plugin set].

  2. Click on the assistant VoelknerExtension.

  3. Follow the instructions on the screen. If you need additional information about one of the options, expand the info box shown below this instruction ().

  4. In the step Summary, check your settings to makes sure they are correct.
    Tip: Click on the arrow in the step Summary () to show the settings.

  5. If everything is as it should be, click on Finalise.
    → The settings are saved.

Options in the assistant

Setting Explanation

Step Authentication

API environment

Select an API environment from the drop-down list. Get in touch with your contact person at Voelkner to confirm which API environment you should select.
Note: If you switch to another API environment, e.g. from Test to Productive mode, you need to generate a new API key.

API key

Enter the API key that you generated.
Note: If you switch to another API environment, e.g. from Test to Productive mode, you need to generate a new API key.

Client selection

Select the client that your orders should be assigned to.

Step Data exchange

Data exchange

Select processes for data exchange. This selection determines which data is exchanged between plentymarkets and Mirakl.

Step Refund mapping

Refund mapping

Map the refund reasons of Voelkner to plentymarkets order statuses.

  1. Click on Add new entry.
    → A new line is inserted.

  2. From the drop-down list on the left, select the plentymarkets status.

  3. From the drop-down list on the right, select one of the Voelkner refund reasons.
    The following reasons can be sent to Voelkner:

    • 15 = Out of stock

    • 16 = Cancelled by client prior to shipping

    • 17 = Item returned

    • 18 = Item not received

    • 19 = Agreement found with the vendor

Step Cancellation mapping

Cancellation mapping

  1. Click on Add new entry.
    → A new line is inserted.

  2. From the drop-down list on the left, select the plentymarkets status.

  3. From the drop-down list on the right, select a Voelkner cancellation reason.
    The following reasons can be sent to Voelkner:

    • 34 = Cancellation: Wrong item ordered

    • 35 = Cancellation: Unwanted payment method

    • 37 = Cancellation: Delivery time too long

    • 39 = Agreement reached between customer and vendor

Step Warehouse selection

Warehouse selection

Select the warehouse you want to use for stock export. For each warehouse, enter the address in the following format:
Name of the warehouse, Any Street 1, 12345 Any Town

Step Shipping profile mapping

Shipping profile mapping

For each shipping profile in plentymarkets, enter the corresponding abbreviation of the shipping service provider. You can find the abbreviations in the Mirakl menu Platform settings » Shipping.

Step Offer properties mapping

Offer properties mapping

From the drop-down list Logistic class, select the property Voelkner Logistic class.
The Leadtime to ship and Reverse charge properties are selected by default.

  • Reverse charge: This is the so-called Reverse-charge procedure. You can either transfer true or false.

  • Leadtime to ship: The so-called leadtime-to-ship is the time that a seller needs from the order acceptance to the shipping registration. Here, a whole number between 1 and 45 has to be transferred.

  • Logistics class: This is the connection of a variation with a certain market shipping profile. The shipping profiles of the market are listed in the back end in the Platform settings » Shipping menu. The value in brackets is the value to be transferred.

  • update-delete: This is the option to delete an offer. If this field is not filled, update will be used automatically.

  • product-id-type: This field does not have to be defined. SHOP_SKU is transferred by default.

  • Base price gross content quantity: Here you can define the gross content quantity for the base price at the variation.

  • Product base price unit of measurement: Here you can define the unit of measurement of the base price unit at the variation. Valid values are KG, L, M, M2 or M3.

Step Offer export settings

Offer export settings

Here you can define the amount of stock that is exported for variations that are not limited to net stock or for variations where no stock is managed. Offer data of these variations is transferred once a night.


To top