Skip to main content

Managing catalogues

Use catalogues to export variation data to markets and other sales channels. Currently, you can use catalogues to transfer data to the markets REWE, Etsy, Metro and OTTO Market.

Catalogues are used to prepare variation data for exporting them to a sales channel. On this manual page, you will find information on creating and managing catalogues.

1. What is a catalogue?

Each sales channel requires different product data. Often, different product information have to be sent to the same sales channel for different product categories (pet food, household items, food, etc.).

Catalogues allow you to customise information regarding your product portfolio to meet the requirements of each sales channel and target audience. You achieve this by mapping the individual data fields of a sales channel to a suitable plentymarkets data source. When your variation data is transferred to the sales channel, the sales channel’s data fields are then filled with the correct plentymarkets data.

Catalogues offer the following advantages:

  • The sales channel provides the data structure. As such, you know exactly which variation data is necessary to sell your products on this sales channel.

  • You select which variation data you want to publish on each sales channel and for each template. For example, you can use properties to transfer different variation names and descriptions to different sales channels.

Exporting data? FormatDesigner

Catalogues are used to transmit data to sales channels. Catalogue data cannot be exported to a file or any other readable format. Use the FormatDesigner to export data.

2. What is a catalogue template?

A catalogue template provides a framework of the data a sales channel can accept. As such, catalogue templates tell you what data can be transmitted to the sales channel.

A sales channel can offer more than one catalogue template, for example for different product categories (pet food, food, non-food, etc.) or for different languages. Check the documentation to find out which catalogue templates are available for the different sales channels.

Could not find a catalogue template?

The catalogue templates of some sales channels are loaded into the Data » Catalogues menu when you deploy the sales channel’s plugin.

3. Managing variation data using properties

Properties of the Item area allow you to save data for variations for which no default data fields are available in the plentymarkets back end. In the following, you will find some examples on how to use properties.

3.1. Example 1: Diameter information

Use case:
A sales channel allows you to send the diameter and the diameter unit of your products. By default, you cannot save diameter data in the plentymarkets back end.

Recommended:
Table 1 shows the recommended settings for sending diameter data to sales channels.

Table 1. Example 1: Diameter information
Data field sales channel Properties in plentymarkets

Setup » Settings » Properties » Configuration

Diameter unit

  • Create the property Diameter unit:
    Section: Item
    Property type: Selection

  • Save values, e.g. cm and mm

Diameter

  • Create the property Diameter:
    Section: Item
    Property type: Decimal number

Item » Edit items » Open item » Open variation

Diameter unit

  • Open the Properties tab.

  • Add the property Diameter unit.

  • Select the unit from the drop-down list.

Diameter

  • Open the Properties tab.

  • Add the property Diameter.

  • Enter the diameter in the unit you selected for Diameter unit.

Data » Catalogues » Open catalogue

Diameter unit

  • From the drop-down list Source, select the option Property » Diameter unit.

Diameter

  • From the drop-down list Source, select the option Property » Diameter.

3.2. Example 2: Brand names

Use case:
The sales channel allows you to transfer the brand name of products. By default, you can save manufacturers but not brand names in the plentymarkets back end.

Recommended:
If the manufacturer names saved in your system are not identical to the products’ brand names, you can manage brand names using properties. Table 2 shows the recommended settings for managing brands to send to sales channels.

Table 2. Example 2: Brand information
Data field sales channel Properties in plentymarkets

Setup » Settings » Properties » Configuration

Brand

  • Create the property Brand:
    Section: Item
    Property type: Short text

Item » Edit items » Open item » Open variation

Brand

  • Open the Texts tab.

  • Add the property Brand.

  • Enter the brand name.

Data » Catalogues » Open catalogue

  • From the drop-down list Brand, select the brand.

  • From the drop-down list Source, select the option Property » Brand.

  • In the Value field, enter the brand name.
    Note: The brand name of the sales channel is published on the sales channel.

4. Managing catalogues

To create, edit or delete catalogues, go to Data » Catalogues.

Could not find a catalogue template?

The catalogue templates of some sales channel are loaded into the Data » Catalogues menu when you deploy the sales channel’s plugin.

4.1. Creating a catalogue

Proceed as described below to create a catalogue.

Creating a catalogue:

  1. Go to Data » Catalogues.
    → The catalogue overview opens.

  2. Click on Create catalogue ().

  3. Enter a name for the catalogue.

  4. Select a catalogue template from the drop-down list.

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

The toggle button on the right in the catalogue overview allows you to activate or deactivate a catalogue. To edit the name of a catalogue, go to the settings ().

4.2. Mapping data sources

Once you created a catalogue, the catalogue opens. On the left, the sales channel’s data is shown. Fields with an asterisk are mandatory. Further on the right of each data field is a drop-down list. Use these drop-down lists to map one or more plentymarkets data sources to the data fields of the sales channel.

Depending on the product data you want to transfer, you either map a data field or a value. In the upper area, you can map data fields. For example, you select which data field in plentymarkets contains the weight of variations. In the lower section, you can map values. For example, you map the sales channel’s category “Pet food” to your plentymarkets category “Animal food”.

Proceed as described below to map the data fields of the sales channel to a plentymarkets data source.

No free text fields or characteristics

Free text fields and characteristics have been replaced with properties. Thus, you cannot transfer free text fields and characteristics to sales channels anymore. Use the properties instead.

Mapping data sources:

  1. Go to Data » Catalogues.
    → The catalogue overview opens.

  2. Click on the catalogue.
    → The catalogue opens.
    → On the left, the sales channel’s data fields are displayed.
    Tip: Fields with an asterisk are mandatory.
    → In the middle, drop-down lists with plentymarkets data sources are displayed.

  3. From the drop-down list, select a plentymarkets source for the data fields of the sales channel.
    Note: Check the information in the user guide of the sales channel’s plugin for details on the target data fields. Table 3 contains information regarding the plentymarkets data sources and how to map these data sources.

  4. To map another plentymarkets source to a data field, click on Add source on the right. A source that has been added can be removed again by clicking on Remove source.
    → A new line is added.
    Note: The selected data fields are checked in the order in which they were mapped. So if the first data field does not contain a value, the second data field is transferred, etc. In case you map more than one data source to a data field, only one value is transferred. However, there is the possibility of combining data sources.

  5. Map all data you want to send to the sales channel.

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

Table 3. Available plentymarkets data sources
Type Available sources Explanation

Variation

  • Variation ID

  • Is main variation

  • ID of main variation

  • Position

  • Active

  • Show unit price

  • Variation no.

  • Model

  • External variation ID

  • Net purchase price

  • Order picking

  • Stock limit

  • Online store: visible if net stock is positive

  • Online store: invisible if net stock is 0 or negative

  • Available if net stock is positive

  • Not available if net stock is 0 or negative

  • Max. order quantity

  • Min. order quantity

  • Interval order quantity

  • Available until

  • Release date

  • Variation name

  • Gross weight in g

  • Net weight in g

  • Width in mm

  • Length in mm

  • Height in mm

  • Extra shipping charge 1

  • Extra shipping charge 2

  • Units contained

  • Quantity of packing units

  • Net transportation costs

  • Net storage costs

  • Customs

  • Operating costs

  • Invisible: in item list

  • Default shipping costs

  • VAT rate

  • Availability

  • Content unit

  • Content amount

The value saved for the variation in the data field is transferred.

Attribute

  • The attribute values saved in the system

Barcode

  • The barcodes saved in the system

The variation’s code saved for this barcode is transferred.

Sales price

  • The sales prices saved in the system

The variation’s price saved for this sales price is transferred.

Property

  • The properties saved in the system

Once you select a source, a drop-down list containing the available languages is shown.

SKU

  • SKU

  • Parent SKU

The value saved for the variation in the data field is transferred.

Item

  • Item ID

  • Manufacturer ID

  • Manufacturer name

  • External manufacturer name

  • Manufacturing country ID

  • Manufacturing country name

Stock

  • Virtual warehouse

  • The warehouses saved in the system

The stock information for the selected warehouse is transmitted to the sales channel.

Item text

  • Name 1

  • Name 2

  • Name 3

  • Preview text

  • Meta description

  • Item text

  • Technical data

  • URL path

Once you select a source, a drop-down list containing the available languages is shown.

Default category

  • Category ID

  • Category name

  • Category description

  • URL name

  • Meta title

  • Meta description

  • Meta keywords

Image

  • All available images

ASIN

  • All

  • Amazon Germany

  • Amazon Espania

  • Amazon France

  • Amazon United Kingdom

  • Amazon Italy

  • Amazon United States

Manufacturer

  • The manufacturers saved in the system

In drop-down lists for target and source, the manufacturers of the sales channel are mapped to the manufacturers saved in plentymarkets one by one. On the left, click on Add manufacturer () to map additional target manufacturers.
Note: The manufacturer name of the sales channel is published on the sales channel.

Category

  • The categories saved in the system

In drop-down lists for target and source, the categories of the sales channel are mapped to the categories saved in plentymarkets one by one. On the left, click on Add categories () to map additional target categories.
Note: The category name of the sales channel is published on the sales channel.

Also show non-obligatory fields

By default, only obligatory fields of a catalogue are displayed. They are highlighted with a *. In order to display non-obligatory fields, too, activate the toggle button at the top of the overview of a catalogue.

4.3. Combining data sources

To export a data field, you can use the Own value to combine as many sources as you like. To do so, create Additional sources and select a separator for each combination.

Combining data sources:

  1. Go to Data » Catalogues.
    → The catalogue overview opens.

  2. Click on a catalogue.
    → The catalogue opens.

  3. In the line of the data field you want to export, select a plentymarkets source from the drop-down list.

  4. Underneath the source that you want to combine, click on Additional source ().
    → Another source is added.

  5. From the left drop-down list, select Own value.

  6. In the field Value, enter the separator that you want to place between the sources.

  7. Underneath the Own value, click on Additional source ().
    → Another source is added.

  8. From the drop-down list, select a plentymarkets source that you want to combine with the first source.

  9. If required, select further additional sources and separators via the Own value. Between two sources, there always has to be a separator.

  10. Click on Save.
    → The sources are combined and displayed with the respectively selected separator.
    Note: In case you create several combinations of sources for a data field, only the first combination is transferred. However, a prerequisite is that all of the selected values exist. If, for example, the first value is empty or does not exist, the combination is ignored and the next combination of data sources is used.

4.4. Copying a catalogue

You can copy catalogues and thus use catalogues that you have already configured in order to quickly create a new catalogue.

Coping a catalogue:

  1. Go to Data » Catalogues.
    → The catalogue overview opens.

  2. Select one or multiple catalogues.

  3. Click on Copy catalogue.
    → The catalogue is copied. Copy of is added to a copied catalogue.

4.5. Deleting a catalogue

Proceed as described below to delete a catalogue.

Deleting a catalogue:

  1. Go to Data » Catalogues.
    → The catalogue overview opens.

  2. Click on the catalogue that you want to delete.
    → The catalogue opens.

  3. In the upper right corner, click on Delete ().
    → You are asked to confirm your decision.

  4. Confirm the deletion.
    → The catalogue is deleted.

5. Transferring catalogue data to the sales channel

The catalogues created in the Data » Catalogues menu allow you to map the data fields of a sales channel to the correct plentymarkets data sources. Transferring the variation data to the sales channel is activated in the settings of the sales channel.

To top