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

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. 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 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 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 this description ().

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

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

  6. Open the catalogue in the Data » Catalogues menu to map the fields.
    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

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. Next to the marketplace data field, click on + Add data field.
    → To the left, the list of available plentymarkets data fields are shown in groups.

  4. Map the field:

    • Alternative 1: Map one or more plentymarkets data fields

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

      2. Click on the plus to the right of the plentymarkets data field you want to select.

      3. Optional: Add one or more fallback data fields. To do so, click on the plus to the right of the plentymarkets data field you want to select.
        → The fallback data field is exported when the first data field does not exist or is empty.
        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.

      4. Click on Confirm.

    • Alternative 2: Always export the same value for the market data field

      1. Click on the plus next to Own value at the top of the list.
        → The field for the own value is added to the view.

      2. Enter a value into the input field.
        → This value is exported for all variations.

  5. Continue to map all data fields of the market for which you want to export product information.

  6. Save () the catalogue.
    → The mappings are saved.

Optional: Mapping several plentymarkets data fields to a marketplace data field
  1. Map a plentymarkets data field or an own value to the marketplace data field as described above.

  2. To the right of the mapped plentymarkets data field, click on Add data field ().
    → To the left, the list of available plentymarkets data fields again are shown in groups.

  3. Map one or several additional plentymarkets data fields to the marketplace data field as described above.

  4. Click on Confirm.

  5. To the very right of the row, click on Settings ().

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

  7. Save the settings.

  8. Save () the catalogue.
    → The mappings are saved.
    → During the export, the content of the plentymarkets data fields is combined and exported as one field.

Unresolved directive in _textblocks/templates/mirakl-marketplace-template.adoc - include::../instructions/catalogue-mirakl-conrad-mapping.adoc[]

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

Making a variation available 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.

The variation group function allows you to edit several variations at once. You select the variations that you want to edit.

Making several variations available for Voelkner using the variation group function:

  1. Go to Item » Edit item.

  2. Set the filter Table type to Variations.

  3. Choose additional filters on the left if needed and click on Search ().

  4. Select () the variations to be edited from the overview on the right.

  5. Click on Variation group function.
    → The Variation group function window opens.

  6. Navigate to the area Market availability.

  7. Activate the checkbox to the left of the option Voelkner.

  8. Activate the checkbox to the right of the option Voelkner.

  9. Navigate to the area Availability.

  10. Activate the checkbox to the left of the option Active.

  11. Activate the checkbox to the right of the option Active.

  12. Click on Execute to apply the settings.

Batch processing allows you to edit several variations at once. You use filters to limit which variations are edited.

Making several variations available for Voelkner using batch processing:

  1. Go to Item » Batch processing.

  2. Click on the tab Variations in the upper left corner.

  3. Use the filters on the left to specify which variations should be processed.

  4. Navigate to the area Market availability.

  5. Activate the checkbox to the left of the option Voelkner.

  6. Activate the checkbox to the right of the option Voelkner.

  7. Navigate to the area Availability.

  8. Activate the checkbox to the left of the option Active.

  9. Activate the checkbox to the right of the option Active.

  10. Click on Apply to apply the settings to the variations.

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

  5. Save () the settings.

  6. Carry out the settings according to Table 5.

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

  8. Save () the settings.

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