Skip to main content

Kauflux

Kauflux.de  is an open marketplace with independent providers from various fields. Kauflux.de markets your items and services and provides you with direct contact to buyers.

1. Registering with Kauflux

You have to register with Kauflux  before you can set up Kauflux in your plentymarkets system.

Install plugins

You need the following plugins to send item data to Kauflux:
Elastic Export 
Kauflux 

Adding and installing the plugin Elastic Export in your plentymarkets system

Adding plugin to the system:

  1. Go to Plugins » plentyMarketplace.
    → The marketplace opens in a new tab.

  2. Navigate to the plugin Elastic Export.
    Tip: Either use the search function or open the category Plugins » Sales » Marketplaces.

  3. Open the detail view of the plugin.

  4. In the column to the right, click on Go to checkout.
    → The Checkout window opens.

  5. Read and accept the General Terms and Conditions.

  6. Click on Order now.
    → Wait a few minutes before installing the plugin.

Installing plugins:

  1. Go to Plugins » Plugin set overview.

  2. Click on the plugin set in which you want to install the plugin.
    → The plugin set opens.

  3. Click on Add new plugin.

  4. Select Elastic Export from the plugin list.

  5. Click on Install.
    → The plugin is installed.
    → The plugin set is shown.

  6. Switch the plugin active ().

  7. Save () the plugin set.
    Tip: Problems saving the plugin set? Click on Open details to show additional information.

Adding and installing the plugin Kauflux in your plentymarkets system

Adding plugin to the system:

  1. Go to Plugins » plentyMarketplace.
    → The marketplace opens in a new tab.

  2. Navigate to the plugin Kauflux.
    Tip: Either use the search function or open the category Plugins » Sales » Marketplaces.

  3. Open the detail view of the plugin.

  4. In the column to the right, click on Go to checkout.
    → The Checkout window opens.

  5. Read and accept the General Terms and Conditions.

  6. Click on Order now.
    → Wait a few minutes before installing the plugin.

Installing plugins:

  1. Go to Plugins » Plugin set overview.

  2. Click on the plugin set in which you want to install the plugin.
    → The plugin set opens.

  3. Click on Add new plugin.

  4. Select Kauflux from the plugin list.

  5. Click on Install.
    → The plugin is installed.
    → The plugin set is shown.

  6. Switch the plugin active ().

  7. Save () the plugin set.
    Tip: Problems saving the plugin set? Click on Open details to show additional information.

2. Setting up Kauflux in plentymarkets

Carry out the following basic settings in order to transfer item data to Kauflux.

Setting up Kauflux in plentymarkets:

  1. Go to Setup » Markets » Kauflux » Settings.

  2. Carry out the settings as described in Table 1.

  3. Save () the settings.

Table 1. Basic settings for Kauflux
Setting Explanation

Exchange period

Enter the exchange period for the items. The exchange period is specified in days. If you would like to forbid items from being exchanged, then enter the value 0.

Order referrer

Select the order referrer for Kauflux.

Type of stock management

Select whether you would like to transfer your stock and if so, whether you would like it to be publicly visible or not.

API URL for the order import

Kauflux uses this link to transfer orders to plentymarkets. This link is needed for importing orders from Kauflux and not for creating the item catalogue. The item catalogue is created with the elastic export in the Data » Elastic export menu. Further information in German can be found on Kauflux .

3. 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 Kauflux. Go to Setup » Orders » Order referrer to activate the order referrer.

Activating the order referrer for Kauflux:

  1. Go to Setup » Orders » Order referrer.

  2. Activate the option Kauflux.

  3. Save () the settings.

4. Setting the variation availability

You need to activate the variations that you want to sell on Kauflux. This is done in the Availability tab of a variation within the Item » Edit item » [Open item] » [Open variation] menu.

Making a variation available for Kauflux:

  1. Go to Item » Edit item » [Open item] » [Open variation] » Tab: Settings.

  2. Open the variation that you want to sell on Kauflux.
    Tip: To sell all variations of an item on Kauflux, 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 {option-availability}.

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

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

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 Kauflux 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 {option-availability}.

  8. Activate the checkbox to the right of the option {option-availability}.

  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 Kauflux 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 {option-availability}.

  6. Activate the checkbox to the right of the option {option-availability}.

  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.

5. Optional: Saving SKU

SKU are generated automatically when your variations are exported. However, you can also save market specific SKU for variations that you want to sell on this market instead.

  1. Go to Item » Edit item » [Open item] » [Open variation] » Tab: Settings.

  2. Click on the Availability tab.

  3. In the SKU area, click on Add ().
    → The New SKU window opens.

  4. Select the referrer Kauflux.

  5. Enter the SKU.

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

Only the most important settings for the import are described here. Is this your first time working with the import tool? Then get familiar with how data imports work in plentymarkets first.
  • Create a CSV file with at least the columns described in Table 2.

  • Create an import with the following settings:

    • Select the type Item.

    • Select the matching field Variation ID.

    • Map the plentymarkets data fields as described in Table 2.

Table 2. Recommended columns of the import file
Column in CSV file Explanation plentymarkets data field for mapping

Variation ID

Enter the variation ID in this column.

Variation ID

Market ID

Enter the referrer ID 116 in this column.

SKU > Marketplace ID

Account ID

This market does not require a marketplace account. As such, enter the number 0 in this column.

SKU > Marketplace ID

SKU

Enter the SKU that you want to save for the variation for this market in this column.

SKU > SKU

6. 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 Kauflux, you need a sales price in which the order referrer Kauflux is activated. The price that you save for this sales price is the price that will be shown on Kauflux.

Defining a sales price for Kauflux:

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

  4. Save () the settings.

7. Activating characteristics for the market

To use characteristics for Kauflux, each characteristic must be activated for the market.

Activating characteristic for the market:

  1. Go to Setup » Item » Characteristics.

  2. Expand the characteristic ().

  3. Activate the option Kauflux.

  4. Save () the settings.

  5. Repeat this for all characteristics that you need for the market.

8. Linking categories

Go to Setup » Markets » Kauflux » Category link to link your plentymarkets categories with the categories on Kauflux. You need the Kauflux CSV file for setting up a category link. This file contains the category IDs for Kauflux. You can download the Kauflux CSV file  from the seller area on the Kauflux website. In the next steps, export a list of categories in your plentyShop, link these categories and then import the category links.

Exporting links:

  1. Go to Setup » Markets » Kauflux » Category link.

  2. Click on the Export link button.
    → A CSV file with your plentymarkets categories is generated.

  3. Open the CSV file.

Entering category IDs:

  1. Open the Kauflux CSV file.

  2. For each plentymarkets category, search for the corresponding category IDs in the CSV file from Kauflux.

  3. Enter the category IDs from the Kauflux CSV file into the KaufluxCat column in the exported CSV file.

  4. Save the exported CSV file on your computer’s hard drive.

Importing links:

  1. Go to Setup » Markets » Kauflux » Category link.

  2. Click on Select file next to File.

  3. Select the CSV file that you saved on your computer’s hard drive.

  4. Click on Open.

  5. Save () the settings.
    → The links are imported and displayed in the Links area.

9. Transmitting item data to Kauflux

Install plugins

You need the following plugins to send item data to Kauflux:
Elastic Export 
Kauflux 

9.1. Setting up the data format KaufluxDE-Plugin in plentymarkets

By installing this plugin you will receive the export format Kauflux-Plugin. Use this format to exchange data between plentymarkets and Kauflux using the elastic export. You need to install the plugin Elastic export from the plentyMarketplace before you can use the format in plentymarkets.

Once both plugins are installed in your plentymarkets system, you can create the export format Kauflux-Plugin. For more information on export formats, see the elastic export page.

Kauflux retrieves item data via an URL. To make sure that your item data can be exported to Kauflux, you have to save the URL at Kauflux.

Creating an export format:

  1. Go to Data » Elastic export.

  2. Click on New export.
    → The New export tab opens.

  3. Carry out the desired settings. Pay attention to the explanations given in Table 3.
    Note: There are no item filters set by default. If you do not add any item filters, all items are exported.

  4. Save () the settings.
    → The export format Kauflux-Plugin is given an ID.
    → The export format is shown in the Exports overview.

  5. Save the URL displayed in the URL field at Kauflux.

Table 3 lists details for settings, format settings and recommended item filters for the format Kauflux-Plugin.

Table 3. Format settings and recommended item filters for the format Kauflux-Plugin
Setting Explanation

Settings

Name

Enter a name for the export. This is an internal name, i.e. it is not visible to customers. The export format is listed under this name in the overview.

Type

Select the type item from the drop-down list.

Format

Select Kauflux-Plugin.

Limit

Enter a number. This number determines how many items are exported at maximum.

Note: Do you want to transmit more than 9999 items?

  • Then the output file will only be generated every 24 hours. This is to save resources.

  • Then also select the option Generate cache file further below.

Generate cache file

Select this option () if you want to transmit more than 9999 items.
Note: We recommend that you do not activate this option for more than 20 export formats. This is to ensure a high performance of the elastic export.

Provisioning

Select URL. This option allows external access to the file. Third parties access the file with a URL and an authentication token.

Additional settings:

  1. Click on Generate token ().
    The token and URL will be entered automatically.

File name

The file name must have the ending .csv or .txt for Kauflux to be able to import the file successfully.

Item filters

Add item filters

Select the items you wish to export. To do so, select one or more item filters from the drop-down list and click on Add. There are no filters set by default. You can add all item filters listed below from the drop-down list.

  • Variations = Select the variations to be transferred.

    • Transfer all = All variations are transferred.

    • Only transfer main variations = Only main variations are transferred.

    • Do not transfer main variations = Only the item’s sub-variations are transferred. Main variations are not transferred.
      Tip: Use this filter option if the main variations are virtual and not for sale.

    • Only transfer single variations = Only those main variations of items are transferred that only have a main variation and no other variations.

  • Markets = Select one or more order referrers. The selected order referrer has to be active at the variation for the item to be exported.

  • Currency = Select a currency.

  • Category = Activate to transfer the item with its category link. Only items belonging to this category are exported.

  • Image = Activate to transfer the item with its image. Only items with images are transferred.

  • Client = Select a client.

  • Stock = Select which stocks should be exported.

  • Flag 1-2 = Select a flag.

  • Manufacturer = Select one, several or ALL manufacturers.

  • Active = Activate if you only want to export active variations.

Format settings

Product URL

Choose the URL that you wish to transfer to the interface. You can choose between the item’s URL and the variation’s URL.

Client

Select a client. This setting is used for the URL structure.

URL parameter

Enter a suffix for the product URL if this is required for the export.
→ This character string is added to the product URL if you have activated the transfer option for the product URL further up.

Order referrer

Select the order referrer that should be assigned during the order import from the drop-down list.
→ The selected referrer is added to the product URL so that sales can be analysed later.

Marketplace account

Select the marketplace account from the drop-down list.

Language

Select the language from the drop-down list.

Item name

Select Name 1, Name 2 or Name 3. The names are saved in the Texts tab of the item. Enter a number into the Maximum number of characters (def. text) field if desired. This specifies how many characters are exported for the item name.

Preview text

Select the text that you want to transfer as preview text. Enter a number into the Maximum number of characters (def. text) field if desired. This specifies how many characters are exported for the preview text.
Activate the Remove HTML tags option if you want HTML tags to be removed during the export.
If you only want to allow specific HTML tags to be exported, then enter these tags into the * Permitted HTML tags, separated by comma (def. text)* field. Use commas to separate multiple tags.

Description

Select the text that you want to transfer as description. Enter a number into the Maximum number of characters (def. text) field if desired. This specifies how many characters are exported for the description. Activate the option Remove HTML tags if you want HTML tags to be removed during the export. If you only want to allow specific HTML tags to be exported, then enter these tags into the field * Permitted HTML tags, separated by comma (def. text)* field. Use commas to separate multiple tags.

Target country

Select the target country from the drop-down list.

Barcode

Select the ASIN, ISBN or a GTIN from the drop-down list.
Note: The barcode has to be linked to the order referrer selected above. Otherwise, the barcode will not be exported.

Image

This option does not affect this format.

Image position of the energy label

This option does not affect this format.

Stock buffer

The stock buffer for variations with limitation to the net stock.

Stock for variations without stock limitation

The stock for variations without stock limitation.

Stock for variations with no stock administration

The stock for variations without stock administration.

Live currency conversion

Activate this option to convert the price into the currency of the selected country of delivery. The price has to be released for the corresponding currency.

Sales price

Select gross price or net price from the drop-down list.

Offer price

This option does not affect this format.

RRP

Activate to transfer the RRP.

Shipping costs

Activate this option if you want to use the shipping costs that are saved in a configuration. If this option is activated, then you are able to select the configuration and the payment method from the drop-down lists. Activate the option Transfer flat rate shipping charge if you want to use a flat rate shipping charge. If this option is activated, a value has to be entered in the line underneath.

VAT note

This option does not affect this format.

Item availability

Activate the overwrite option and enter item availabilities into the fields 1 to 10. The fields represent the IDs of the availabilities. This overwrites the item availabilities that are saved in the Setup » Item » Availability menu.

9.2. Available columns for the export format

Table 4 shows the columns available for the export file.

Table 4. Available columns for the export format
Column header Explanation

ProductID

The item ID of the variation.

BestellNr

The SKU of the variation.

EAN

According to the format setting Barcode.

Manufacturer

The name of the manufacturer of the item. The external name saved in the Setup » Item » Manufacturers menu is preferred if existing.

BestandModus

The type of stock management, according to Setup » Markets » Kauflux » Settings.

BestandAbsolut

The net stock of the variation. If a variation is not limited to its net stock, the stock is set to 999.

Liefertyp

Shipment type: V = Versand (Shipping).

VersandKlasse

According to the format setting Shipping costs.

Delivery time

The name of the item availability saved in the Setup » Item » Item availability or the translation according to the format setting Item availability.

Umtausch

The exchange period after delivery in days, according to Setup » Markets » Kauflux » Settings.

Name

According to the format setting Item name.

KurzText

According to the format setting Preview text.

DetailText

According to the format setting Description.

Keywords

The keywords of the item.

Bild1

URL of the image. Variation images are prioritised over item images.

Bild2

URL of the image. Variation images are prioritised over item images.

Bild3

URL of the image. Variation images are prioritised over item images.

Weight

The overall weight in grams.

Price

The sales price.

VAT

The VAT in %.

RRP

The recommended retail price (RRP) of the variation. If the RRP is activated in the format setting and is higher than the sales price, the RRP is exported.

Katalog1

The name of the category.

Flags

The store special of the item.

ExtLinkDetail

The URL path of the item depending on the chosen client in the format settings.

Status

Status of the item:

  • 0 = visible

  • 1 = blocked

  • 2 = hidden

FreeVar1

Free text field 1

FreeVar2

Free text field 2

FreeVar3

Free text field 3

InhaltMenge

The lot of the variation (example: 250).

InhaltEinheit

The unit for the lot (example: ml).

InhaltVergleich

The comparative amount of the net content quantity for the automatic calculation of a commercial quantity.

HerstellerArtNr

The model of the variation.

9.3. Exporting item data

After you set up Kauflux in plentymarkets, you can export your item data. To do so, go to Data » Elastic export.

For an automatic item data export, you have to copy the complete URL and save it at Kauflux. The prerequisites for this are that you have carried out at least one export of your item data manually and that you have assigned the individual fields in Kauflux. Additionally, the automatic item data export from Kauflux has to be activated.

9.4. Exporting variation data

During the export, variation data is exported as additional CSV fields. If you would like to import this CSV or ZIP file into Kauflux, you are asked to map the categories.

Example

The variation fields colour, size and length are displayed in the mapping. For all variation fields, you have to select GroupParam as the mapping field so that these fields can be saved as variations on Kauflux.de. The field GroupID serves exclusively to identify the items that belong together in a group.

10. Importing orders

Orders from Kauflux can be imported into your plentymarkets system automatically. You have to save the API URL at Kauflux. This URL is found under Setup » Markets » Kauflux » Settings. After completing this step, orders are automatically imported into your plentymarkets system and displayed in the Orders » Edit orders menu.

11. Sending an email when orders are imported

It is possible to send automatic emails when orders are imported into plentymarkets. Go to Setup » Client » [Select client] » Email » Templates to create and activate an email template for Kauflux.

Sending an email when orders are imported:

  1. Go to Setup » Client » [Select client] » Email » Automatic.

  2. Select the previously created email template for the New order from Kauflux option.

  3. Save () the settings.

Click on Edit email template to access the Setup » Client » [Select client] » Email » Templates menu and edit the email template.

To top