Skip to main content

Voelkner

Download the Voelkner plugin

You need a plugin to link plentymarkets to Voelkner. Visit the plentyMarketplace  to download the Voelkner plugin.

To use the Voelkner plugin, you also need the Mirakl Connector plugin. You can download Mirakl from plentyMarketplace as well.

Installing Mirakl Connector

Installing plugins:

  1. Go to Plugins » Plugin set overview.

  2. Open () the plugin set you want to edit.
    → The plugin set opens.

  3. Click on Add new plugin.

  4. Select Mirakl Connector from the plugin list. → Information about Mirakl Connector is displayed.

  5. Select the version you want to install from the Select version drop-down list. The newest version is selected by default.

  6. To install the plugin, click on Install.
    → The plugin is installed.
    → After installation has finished, the plugin set opens.
    → Now you can configure the plugin. To do so, proceed as described below.

  7. Switch the plugin active ().

  8. Save () the plugin set.
    → If there’s a problem with saving the plugin set, click on View details to receive further information.

Installing Voelkner

Installing plugins:

  1. Go to Plugins » Plugin set overview.

  2. Open () the plugin set you want to edit.
    → The plugin set opens.

  3. Click on Add new plugin.

  4. Select Voelkner from the plugin list. → Information about Voelkner is displayed.

  5. Select the version you want to install from the Select version drop-down list. The newest version is selected by default.

  6. To install the plugin, click on Install.
    → The plugin is installed.
    → After installation has finished, the plugin set opens.
    → Now you can configure the plugin. To do so, proceed as described below.

  7. Switch the plugin active ().

  8. Save () the plugin set.
    → If there’s a problem with saving the plugin set, click on View details to receive further information.

1. About Voelkner

The Voelkner Plugin connects the marketplace Voelkner with your plentymarkets system. This enables you to automatically exchange item and order data between plentymarkets and Voelkner. This way, you can list your items on Voelkner.

2. Registering with Voelkner

You need your Voelkner access data consisting of the user name and password. You will receive this data from Voelkner. First, you need to become a Voelkner member and create a Voelkner account.

3. About automatic data exchange

After installing and setting up the plugin, the automatic processes described in [data-exchange-Voelkner] become available:

Table 1. Frequency of data exchange
Data Interval

Item data

Item export

daily

Stock synchronisation

Every 15 minutes

Price synchronisation

Every 15 minutes

Order data

Order import

Every 15 minutes

4. 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 Voelkner.

  3. Save () the settings.

5. Defining a sales price

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

Defining a sales price for Voelkner:

  1. Go to Setup » Item » Sales prices » Open sales price » Tab: Settings.

  2. Activate the referrer Voelkner.

  3. Save () the settings.

6. Creating properties

Using properties, you can export fields to the marketplace that aren’t defined in plentymarkets by default. You can create the properties that are specified by Voelkner in the Setup » Settings » Properties » Configuration menu.

For further information on properties, refer to the Characteristics and properties page.

For Voelkner, you need the following properties:

6.1. Creating the logistics class property

For each variation, you need to export a shipping profile code to Voelkner. You can configure shipping profiles in the Mirakl back end. For a list of shipping profiles, refer to the Informations » Carrier costs menu in the Mirakl back end. You can find the code in the Logistics class column in brackets behind the name of the logistics class.

Proceed as described below to create the property Logistics class (Logistikklasse).

Creating the property Logistics class (Logistikklasse)
  1. Go to Setup » Settings » Properties » Configuration.
    → The overview of the properties opens.

  2. Click on Add property ().

  3. Carry out the settings as described in [table-Voelkner-Logistics class (Logistikklasse)].

  4. Enter a position number for the property.

  5. Save () the settings.
    → The property is created and opened for editing.

  6. Carry out any additional settings as described in [table-Voelkner-Logistics class (Logistikklasse)].

  7. Save () the settings.
    → The settings are saved.

Table 2. Property Logistics class (Logistikklasse)

Setting

Option

Section

Item

Property type

Short text

Name

Voelkner logistics class

Group

Select a group.
Tip: Create the property group Voelkner, to sort and manage all properties for this market.

Position

Enter a position.

6.2. Creating the leadtime to ship property

For each variation, you need to export a leadtime to ship in days to Voelkner. This way, you can tell Voelkner how many days you need to ship a variation. Voelkner accepts values between 1 and 45.

Proceed as described below to create the property Leadtime to ship (Versandvorlaufzeit).

Creating the property Leadtime to ship (Versandvorlaufzeit)
  1. Go to Setup » Settings » Properties » Configuration.
    → The overview of the properties opens.

  2. Click on Add property ().

  3. Carry out the settings as described in [table-Voelkner-Leadtime to ship (Versandvorlaufzeit)].

  4. Enter a position number for the property.

  5. Save () the settings.
    → The property is created and opened for editing.

  6. Carry out any additional settings as described in [table-Voelkner-Leadtime to ship (Versandvorlaufzeit)].

  7. Save () the settings.
    → The settings are saved.

Table 3. Property Leadtime to ship (Versandvorlaufzeit)

Setting

Option

Section

Item

Property type

Short text

Name

Voelkner leadtime to ship (Versandvorlaufzeit)

Group

Select a group.
Tip: Create the property group Voelkner, to sort and manage all properties for this market.

Position

Enter a position.

6.3. Creating the reverse charge property

For each variation, you need to specify if the reverse charge mechanism applies to this variation for cross-border business processes. Voelkner accepts the values true and false.

  • false = The reverse charge mechanism isn’t applied.

  • true = The reverse charge mechanism is applied. This means that instead of you, your customers have to pay VAT to the tax authorities.
    Note: Observe the legal requirements for the reverse charge mechanism and consult your tax adviser on the details.

Proceed as described below to create the property Reverse charge.

Creating the property Reverse charge
  1. Go to Setup » Settings » Properties » Configuration.
    → The overview of the properties opens.

  2. Click on Add property ().

  3. Carry out the settings as described in [table-Voelkner-Reverse charge].

  4. Enter a position number for the property.

  5. Save () the settings.
    → The property is created and opened for editing.

  6. Carry out any additional settings as described in [table-Voelkner-Reverse charge].

  7. Save () the settings.
    → The settings are saved.

Table 4. Property Reverse charge

Setting

Option

Section

Item

Property type

Short text

Name

Voelkner reverse charge

Group

Select a group.
Tip: Create the property group Voelkner, to sort and manage all properties for this market.

Position

Enter a position.

7. 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.

8. Carrying out account settings in the assistant

Use the Voelkner - Wizard assistant in the Setup » Assistants » Plugins » Select plugin set to set up your {marketplace account in plentymarkets.

Carrying out settings in the assistant:

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

  2. Click on the assistant Voelkner.

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

  4. In the step Summary, check your settings to makes sure they are correct.
    Tip: Click on the arrow () 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 Productive to Test 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. if you switch from Productive to Test mode, you need to generate a new API key.

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 a Voelkner refund reason.
    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

This setting is not applicable to Voelkner.

Step Warehouse selection

Warehouse selection

Select the warehouse you want to use for stock export.

Step Shipping profile mapping

Shipping profile mapping

For each shipping profile in plentymarkets, enter the corresponding abbreviation of the shipping service provider. To find the abbreviations, go to Information » Shipping in Mirakl.

Step Offer properties mapping

Offer properties mapping

From the drop-down list Reverse charge, select the property Voelkner Reverse charge.
From the drop-down list Lead time to ship, select the property Voelkner Leadtime to ship.
From the drop-down list Logistic class, select the property Voelkner Logistic class.

9. Setting up the item export

Item data is exported to Voelkner via marketplace catalogues. Go to Data » Catalogs to create catalogues. Is this your first time working with catalogues? Then read up on the basic principle of catalogues first.

If you want to sell your products in multiple Voelkner product categories, create a separate catalogue for each of them. Link the Voelkner data fields with the item data saved in plentymarkets in the marketplace format afterwards. Once you’ve activated a catalogue, plentymarkets automatically exports the catalogue templates to Voelkner daily.

Error log

If there’s a problem during export, you can find the related log entries on Mirakl and not the plentymarkets log.

9.1. Creating additional properties

In addition to the properties described previously, you need properties for all data fields of the marketplace whose data you want to export, but that don’t exist in plentymarkets by default. For further information on the properties you need, check the documentation of the marketplace. Is this your first time working with properties? For further information, refer to the Properties page of the manual.

9.2. Creating a catalogue in the assistant

Creating a catalogue in the assistant:

  1. Open the menu Setup » Assistants » Plugins » Select plugin set..

  2. Click on the assistant Voelkner Catalogue.

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

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

  5. If everything is as it should be, click on Finalise.
    → The catalogue is created.

  6. Map the fields in the Data » Catalogues menu.
    Note: pass:quotes[Only select bottom level categories. You can find a better overview of the category hierarchy on Miracle by going to *My account » My product data settings*.

Options in the assistant

Setting Explanation

Settings

Select a Voelkner category for offering your items. Then, enter a name for the corresponding category in plentymarkets.
pass:quotes[Only select bottom level categories. You can find a better overview of the category hierarchy on Miracle by going to *My account » My product data settings*.

9.3. Mapping data fields in the catalogue

After you have created a catalogue, map the market’s data fields to item data saved in plentymarkets. Check the documentation of the sales channel to find out what data the market expects for the individual data fields.

Using properties

Use properties to export values for data fields that have no corresponding item data saved in plentymarkets.

Mapping data fields in the catalogue:

  1. Go to Data » Catalogues.

  2. Click on the catalogue.
    → The Mapping tab with the market data fields opens.
    → In the left-hand column, the market’s data fields are listed.
    Tip: Mandatory fields are flagged with an asterisk (*).

  3. To the right of the first marketplace data field, click on Add data field.
    → To the left, the plentymarkets data fields are listed in groups.

  4. Click on a group to expand the associated data fields.
    → The data fields are shown.

  5. Next to the data field you want to select, click on the plus.
    → The data field is added to the view.
    Tip: Do you want to export a fixed value for every variation for one of the market data fields? Click on the plus next to Own value.
    → The field for the own value is added to the view.

  6. Enter a value into the input field.

  7. Click on the X to close the editing mode.
    → The data field is mapped.

  8. Optional: Do you want to export two or more plentymarkets fields for a single marketplace data field?

    1. To the right of the data field you just mapped, click on Add data field ().

    2. Map an additional plentymarkets data field to the marketplace data field as described above.

    3. To the right of the column, click on Settings ().

    4. Select a separator from the drop-down list Separator or add a custom separator.

    5. Save the settings.
      → The additional data field is mapped. During the export, the content of the two plentymarkets data fields is combined and exported as one field.

  9. Optional: Click on Add fallback data field to select a data field that is exported in case another one is not available or empty. You can also add more than one fallback data field.
    Note: Even if you assign a fallback data field to a market data field, only one value is exported. The fields are checked in the order in which you mapped them. This means that if the first data field does not provide a value, the first fallback data field is exported etc.

  10. Repeat this mapping for all data fields of the market that you want to export.
    Note: All fields flagged with asterisks (*) are mandatory and must be mapped to a plentymarkets data field.

  11. Save () the settings.
    → The mappings are saved.

Do not map plentymarkets data fields to the following marketplace data fields for the market Voelkner:

Product group

You can ignore the warning shown when you save the mapping.

Table 5. xxx
Marketplace data field plentymarkets data field

Produktbezeichnung

Map one or more of the following plentymarkets data fields to this marketplace data field:

  • Name 1

or

  • Name 2

or

  • Name 3

or

  • Property

Hersteller-Teilenummer (Manufacturer Part Number)

Map the following plentymarkets data field to this marketplace data field: Model (Manufacturer’s Part Number, MPN)

Content unit

Create a property for this marketplace data field. Create a property value for each type of unit that you use for your products:

  • sheet = unece.unit.ST

  • centimetre = unece.unit.CMT

  • gram = unece.unit.GRM

  • kilogram = unece.unit.KGM

  • litre = unece.unit.LTR

  • meter = unece.unit.MTR

  • millilitre = unece.unit.MLT

  • square meter = unece.unit.MTK

  • pair = unece.unit.PR

  • pieces = unece.unit.NPT

  • unit = unece.unit.C62

  • sheet = unece.unit.QR

  • set = unece.unit.SET

Tip: If all your variations for this catalogue have the same content unit, you can export your own value instead of creating a property. For example, to export the unit “pieces” for every variation, enter unece.unit.C62 in the field Own value.

Verkaufsmengeneinheit (sales unit)

Create a property for this marketplace data field. Create a property value for each type of unit that you use for your products:

  • Piece = ST

  • Role = ROL

  • pallet = PAL

  • Package = PAK

  • pair = PAA

  • meter = M

  • Cardboard box = KAR

  • LE = LE

  • cubic meter = M3

  • square meter = M2

  • kilogram = KG

  • gram = G

Tip: If all your variations for this catalogue have the same sales unit, you can export your own value instead of creating a property. For example, to export the unit “pieces” for every variation, enter ST in the field Own value.

Gewicht Einheit (weight unit)

Create a property for this marketplace data field. Create a property value for each type of unit weight that you use for your products:

  • gram = unece.unit.GRM

  • kg/m = unece.unit.KL

  • g/m = unece.unit.GM1

  • g/m² = unece.unit.gqm

  • KG = unece.unit.KGM

Tip: If all your variations for this catalogue have the same weight unit, you can export your own value instead of creating a property. For example, to export the unit “gram” for every variation, enter unece.unit.GRM in the field Own value.

Variantengruppe (variation group)

The data field Variantengruppe (variation group) is used to group products, i.e. to tell the market what a number of products have in common. As such, map the plentymarkets data field Item ID to this field.

Variation

The data field Variante (variation) is used to differentiate products. It tells the market in what ways a number of products are different from each other. As such, map the plentymarkets data field Attribute value names to this field.

The following CSV files contain the valid values for the respective catalogue fields:

Missing brands

If you notice any missing brands, contact stefanie.schlosser@re-in.de.

10. Linking variations to a Voelkner catalogue category

After you created a marketplace format for Voelkner with the Voelkner assistant or manually, the property Voelkner is created in your plentymarkets system. A new selection value is added to the Voelkner category group property for each category selected in the Settings step of the assistant. In order for your variations to be exported in the appropriate catalogue, they have to be linked to the Voelkner category group property in the Properties tab of a variation.

Linking a variation to a category:

  1. Go to Item » Edit item » Open item.

  2. Click on the Variations tab.

  3. Open the variation that should be linked.

  4. Open the Properties tab.

  5. In the Variation properties area, select the property Voelkner category group from the Properties drop-down list and click on Add ().
    → The property is added.

  6. Select the desired category group from the Value drop-down list for the Voelkner category group property.
    → The variation will be exported in this catalogue.
    Example:*If you pick the value *VHS Cassettes, the catalogue variation is exported for the VHS Cassettes category.

  7. Repeat steps 5 and 6 for all categories where you want to offer the variation.

  8. Save () the settings.

10.1. Linking properties with variations and saving values

All properties, sales prices and barcodes that you have created for mapping them in the catalogue now need to be linked to the variations that you want to export to the market. This is described on the Item pages of the manual:

10.2. Activating the catalogue export

You have set up Voelkner and created a catalogue for exporting your item data? Then start the export of your item data.

Activating the catalogue export to Voelkner:

  1. Go to Data » Catalogues.
    → The catalogues are listed.

  2. Scroll to the Voelkner catalogue.

  3. In the Active/Inactive column, move the toggle button to the right ().
    → The catalogue is active.
    → The catalogue data is exported to Voelkner Daily{if-active}.

11. Setting the variation availability

You need to activate all variations that you want to sell on Voelkner. This is done in the Availability tab of a variation within the Item » Edit item » Open item » Tab: Variation ID menu.

Use group function or batch processing

You can edit the availability of several variations at once by using either the variation group function or batch processing.

Setting the variation availability for Voelkner:

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

  2. Open the variation that you want to sell on Voelkner.
    Tip: To sell all variations of an item on Voelkner, carry out the settings for the item’s main variation. This activates the availability of all variations of the item.

  3. In the Availability area, activate the option Active.

  4. Click on the Availability tab.

  5. In the Markets area, click in the selection field.
    → A list of all available markets is displayed.

  6. Activate the option Voelkner.

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

  8. Save () the settings.
    → The variation is available for Voelkner.

12. Setting up event procedures

Set up an event procedure to automatically update the order status on Voelkner whenever specific events occur. You can set up the following event procedures:

  • Send shipping confirmation to Voelkner

  • Report refund to Voelkner

  • Upload invoice to Voelkner

How to set up the event procedures in plentymarkets is described in the following chapters.

Additional procedures

In addition to the event procedures listed above, the Voelkner plugin provides several other event procedures. These procedures exist because order processing differs between plentymarkets and Mirakl.

However, we recommend that you only use the procedures described in detail.

12.1. Report shipping confirmation to Voelkner

Setting up an event procedure
  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 6.

  5. Save () the settings.

  6. Carry out the settings according to Table 6.

  7. Place a check mark next to the option Active ().

  8. Save () the settings.

Table 6. Event procedure to send shipping confirmations to Voelkner

Setting

Option

Selection

Event

Status change

Select an event, for example [7.1] Order exported.

Filter

Order > Referrer

Voelkner

Procedure 1

Plugins: Voelkner: Update the carrier tracking information for a payment

Procedure 2

Plugins > Voelkner: Validate shipping

12.2. Report refund to Voelkner

Setting up an event procedure
  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 7.

  5. Save () the settings.

  6. Carry out the settings according to Table 7.

  7. Place a check mark next to the option Active ().

  8. Save () the settings.

Table 7. Event procedure to send refunds to Voelkner

Setting

Option

Selection

Event

Status change

Select an event, e.g. [11] Credit note.

Filter

Order > Referrer

Voelkner

Procedure

Plugins > Voelkner: Refund order lines

12.3. Upload invoice to Voelkner

Setting up an event procedure
  1. Go to Setup » Orders » Events.

  2. Click on Add event procedure ().
    → The Create new event procedure window opens.

  3. Enter a distinct name for the event procedure.

  4. Select the event according to Table 8.

  5. Save () the settings.

  6. Carry out the settings according to Table 8.

  7. Place a check mark next to the option Active ().

  8. Save () the settings.

Table 8. Event procedure to upload an invoice to Voelkner

Setting

Option

Selection

Event

Status change

Select an event, for example [7] Outgoing items booked.

Filter

Order > Referrer

Voelkner

Procedure

Plugins > Voelkner: Upload invoice

To top