Skip to main content

Catalogues

Catalogues are used to ideally prepare data for the export. Here, a distinction is made between catalogues with marketplace formats and catalogues with standard formats.

Catalogue format Explanation

Marketplace format

You want to prepare variation data for the export to a sales channel? Use catalogues with marketplace formats to export variation data to markets and other sales channels. Currently, you can use catalogues to transfer data to the markets Etsy, Metro, OTTO Market and Amazon.

Default formats

You want to export specific data such as order or item data from your plentymarkets system? Use catalogues with a standard format to export such data.
Note: The standard formats will be transferred to the catalogue step by step. At the moment, the formats Manufacturers, Newsletter recipients, Order, Purchase order, Item (new), Stock movements, Stocks and Warehouses are available.

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 with marketplace formats 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 field. 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 with marketplace formats 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 format. For example, you can use properties to transfer different variation names and descriptions to different sales channels.

Filtering by catalogue name

On the left of the catalogue overview, enter the name of the desired catalogue into the Name field and click on Search () or Enter to find the desired catalogue faster.

2. What is a marketplace format?

A marketplace format provides a framework of the data a sales channel can accept. As such, marketplace formats tell you what data can be transmitted to the sales channel.

A sales channel can offer more than one marketplace format, for example for different product categories (pet food, food, non-food, etc.) or for different languages. Check the documentation of the respective sales channel to find out which marketplace formats are available.

Could not find a marketplace format?

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

3. Assigning rights for back end users

People with Back end access rights can only see certain areas and menus in plentymarkets. This means they only have limited access to the system. If you want back end type users to see catalogues, you have to grant them the following rights:

  • Data > Data exchange > Export > Catalogue > Show

Tip: How to grant rights

Note that only Admins can grant rights.

Assigning rights:

  1. Go to Setup » Settings » User » Rights » User.
    → The user accounts are displayed in an overview.

  2. Click on a user account.
    → The Rights menu item containing the visibilities opens.

  3. Assign the rights for the respective area by ticking the check boxes indicated above.
    Note: You can either grant rights for complete areas or limit the rights you grant the user. To only grant limited rights in a certain area, expand the area.

  4. Save () the settings.

The Rights and Menu visibilities are linked. This means that if you grant a right in one of the two areas, plentymarkets automatically grants the corresponding rights in the other area.

4. Managing variation data using properties

Properties of the Item section 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.

4.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 item » 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

  • In the data field picker, select the data field Diameter unit from the Property folder.

Diameter

  • In the data field picker, select the data field Diameter from the Property folder.

4.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 the 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 item » Open item » Open variation

Brand

  • Open the Texts tab.

  • Add the property Brand.

  • Enter the brand name into the Value field.

Data » Catalogues » Open catalogue

  • In the data field picker, select the brand.

  • In the data field picker, select the respective brand from the Property folder.
    *Note:*The brand name of the sales channel is published on the sales channel.

5. Creating catalogues with marketplace formats

When using marketplace formats, there are data fields that are required by the respective marketplace and data fields that are optional. Proceed as described below to create a catalogue with a marketplace format.

Could not find a marketplace format?

The marketplace formats of some sales channels are only loaded into the Data » Catalogues menu after you have deployed the sales channel’s plugin.

5.1. Creating and setting up a catalogue

Create a catalogue and determine what you want the catalogue to use for.

Carrying out the basic settings:

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

  2. Click on Create catalogue ().
    → A new view opens.

  3. Carry out the settings. Pay attention to the explanations given in Table 3.

  4. Save () the settings.
    → The catalogue is created and the Mapping tab (icon:order_return_create_edit[set=plenty[) opens.

Table 3. Carrying out basic settings
Setting Explanation

Name (mandatory field)

Enter the name of the catalogue.

Export type (mandatory field)

Select the export type (e.g. Amazon) from the drop-down list. This is the marketplace format that you want to use for the export.

Format type (mandatory field)

Select a format (e.g. Item) from the drop-down list.

Format (mandatory field)

Select a format from the drop-down list. This is the desired category.

5.2. Carrying out the format settings

Once you have carried out the basic settings, you can determine a format as well as separators in the format settings.

Carrying out the format settings:

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

  2. Select the catalogue for which you want to carry out the format settings.
    → The catalogue opens.

  3. Click on the Settings () tab on the left.
    → The different settings options are shown.

  4. Go to the section Format settings.

  5. Carry out the settings. Pay attention to the information given in Table 4.

  6. Save () the settings.

Table 4. Carrying out the format settings
Setting Explanation

File name

Enter the file name. There is no need to add the extension .csv or .txt as this is done automatically by the system.

Note: Use placeholders to automatically add further information to the file name. For example, you can add the current date to the file name. The following placeholders are available: $name, $type, $format, $timestamp, $datetime, $year, $month, $day, $hour, $minute, $second

Examples:

  • file-name.csv

  • file-name_2020_10_25.csv

  • file-name_$year_$month_$day.csv

Format

Select the format of your file.
Note: The available formats may vary.

Field separator

Select a field separator from the drop-down list.

Text delimiter

Select a text delimiter from the drop-down list.

Decimal separator

Select a decimal separator from the drop-down list.

Line break

Select the type of line break from the drop-down list.

Header is included

Indicate whether there is a header row included in your file.

5.3. Carrying out the export settings

If available, carry out the export settings. Note that these settings are not available for each marketplace format.

Carrying out the export settings:

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

  2. Select the catalogue for which you want to carry out the export settings.
    → The catalogue opens.

  3. Click on the Settings () tab on the left.
    → The different settings options are shown.

  4. Go to the section Export settings.

  5. Carry out the settings. Pay attention to the explanations given in Table 5.

  6. Save () the settings.

No export to marketplaces when selecting FTP

By selecting the option FTP in the export settings, you only determine how the export should be provided. No data is transferred to marketplaces.

Table 5. Carrying out the export settings
Setting Explanation

Provisioning

Select from the drop-down list, in which form you want the export to be provided.
If you select FTP, FTPS or SFTP, further fields become visible.

Server

Enter the server. We recommend to leave out the protocol prefix (ftp://, ftps:// etc.).
This field is only visible if you have selected FTP, FTPS or SFTP.

Port

Enter the port or use the default setting. Use port 21 for FTP and FTPS. Use port 22 for SFTP.
This field is only visible if you have selected FTP, FTPS or SFTP.

User name

Enter the user name.
This field is only visible if you have selected FTP, FTPS or SFTP.

Password

Enter a password.
This field is only visible if you have selected FTP, FTPS or SFTP.

Path

Enter the path for the storage location of your file. Note: If you are using SFTP, it is necessary to provide the full path.
This field is only visible if you have selected FTP, FTPS or SFTP.

Transfer

Define when you want the export to start. To do so, select an option from the drop-down list. When selecting Schedule, a window opens where you can choose the time.

Schedule

Select from the drop-down list, at which time you want the export to happen.
This field is only visible if you have selected Schedule for the transfer.

Display mandatory fields only

By default, both mandatory fields (marked with a *) and non-mandatory fields of a catalogue are shown. In order to only see the mandatory fields, activate the toggle button in the further actions () of the catalogue.

5.4. Mapping and linking data fields

In the Mapping tab of a catalogue you can map the sales channel’s data fields to your plentymarkets data fields. Depending on the product data you want to transfer, you either map a data field or a value. 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”.

For the export of a data field you can map as many fields as you like. To do so, add further data fields and select a separator for each combination. Moreover, you can add fallback data fields. In case a value does not exist, you can define here which value should be exported instead.

catalogue menu colours

Menu structure of a catalogue with marketplace format

In the following you will find explanations on the individual sections.

  • Navigation: Here you can switch between the different sections. Access the catalogue settings, map the respective plentymarkets data fields as well as own data fields to the ones of the marketplace, or set filters in order to narrow down data.

  • Toolbar: Here you can carry out actions that are relevant for the catalogue, such as saving the mapping of the data fields.

  • Data fields of the marketplace: Here, all available marketplace data fields are listed. Mandatory fields are marked with an asterisk (*).

  • Mapped plentymarkets data fields: Shows all data fields that have been mapped to the data fields of the marketplace for the export. Furthermore, you can add own values and select fallback data fields that are exported in case the mapped data field could not be found or is empty.

Additional mapping for specific data fields

Data fields such as VariationSalesPrice.price require an additional mapping, because more than one price may exist for each variation. The mapping allows you to export a specific sales price. To export more than one sales price, you can add the data field several times. Data fields that require additional mapping have a drop-down list. The default value is always preselected.

No free text fields or characteristics

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

Adding all data fields of a group at once

If you want to add all data fields of a group to a catalogue at once, click on the plus on the right of the group.

Adding own data fields

In the Own data fields area in the side navigation you can add your own data fields and specify a name. Make sure to choose an individual name for each data field.
Note: This option is not available for all catalogues.

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

Mapping and linking data fields:

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

  2. Click on a catalogue.
    → The Mapping tab () with the marketplace data fields opens.
    Tip: Mandatory fields are marked with an asterisk.

  3. To the right of the first marketplace data field, click on Add data field.
    → The editing mode opens and the available plentymarkets data fields are displayed as groups on the left.

  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.
    Or: Enter the name of the data field into the search field and navigate to the desired entry. Afterwards, press Enter to add it to the view.
    Tip: Do you want to export a fixed value for every variation for one of the marketplace data fields? Click on the plus next to Own value.
    → The field for the own value is added to the view.

  6. If you selected Own value, enter a value into the input field below.

  7. Close the editing mode via the X or by clicking outside the window.
    Optional: Click on Add fallback data field to select a data field that is exported in case another one is not available. You can also add more than one fallback data field.
    Optional: To map another data field to an existing one, click on Add data field () on the right.
    → The editing mode opens.

  8. Next to the data field you want to select, click on the plus or select Own value.
    → The data field is added to the view.

  9. Close the editing mode via the X or by clicking outside the window.

  10. On the right in the data row, click on Settings () to select a separator for linking the data fields.
    → The window Data column settings opens.

  11. Select a separator from the drop-down list or add an own separator.

  12. Save the settings.
    → The data fields are linked and will be exported with the respectively selected separator.
    Note: If a data field in a combination does not exist, only the remaining data fields will be exported.

  13. Map the desired data fields.

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

Own value

The option Own value allows you to export a fixed value for a data field. This fixed value is thus identical for each data record that is exported via this catalogue.

Replacing data fields

Do you want to replace a data field in a specific position without having to delete linked data fields and to select new ones again? To do so, click on the further actions () on the right of the data field you want to replace and select a new one.

Moving data fields in a mapping

When mapping data fields, you can move each data field as desired. To do so, go to the respective data field and drag and drop it to the desired position.

5.5. Transferring combined mappings to a marketplace

Combined mappings allow you to transfer data fields that have a dependency to a marketplace.
Example (see image below): You want to transfer the data field Barcode and additionally need the Barcode type ASIN. Therefore, you specify the Barcode type ASIN as additional information and define that this will be transferred, if the data field Barcode can be filled with the value from the plentymarkets data field Amazon Germany.
If this is not possible, because no value can be found, the next possibility is checked. Thus, the Barcode type GTIN will be transferred to the marketplace, if the data field Barcode can be filled with the value from the plentymarkets data field GTIN 13 or GTIN 128.
Note: In case none of the defined possibilities applies, neither Barcode nor Barcode type will be transferred.

combined mappings png

5.6. Deleting data fields

In the Mapping tab of a catalogue with a marketplace format you can delete individual or several data fields at once. You can also remove the selected fallback data fields.

Deleting data fields:

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

  2. Open a catalogue with marketplace format.
    → The Mapping tab (icon:order_return_create_edit[set=plenty[) with all available data fields opens.

  3. Click on the further actions () on the right of the data field that you want to delete.

  4. Click on Delete data field ().
    → The data field is deleted.
    Or: On the right side in the data row, click on Reset ().
    → All data fields that have been added to the data row are deleted. Note: This only works for data fields that have just been added, but have not been saved yet.

5.7. Available plentymarkets data fields

  • Marketplace data fields: Information about the target data fields can be found in the documentation for the specific sales channel.

  • plentymarkets data fields: This page provides information about the plentymarkets data fields and how to use them.

6. Creating catalogues with standard formats

In the following, you will find detailed information on how to create and manage catalogues with standard formats in the Data » Catalogues menu. Standard formats include specific data such as item or order data that you can export from your plentymarkets system.

6.1. Creating and setting up a catalogue

Carrying out the basic settings:

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

  2. Click on Create catalogue ().
    → A new view opens.

  3. Carry out the settings. Pay attention to the explanations given in Table 6.

  4. Save () the settings.
    → The catalogue is created and the Settings tab () opens.

Table 6. Carrying out basic settings
Setting Explanation

Name (mandatory field)

Enter the name of the catalogue.

Export type (mandatory field)

Select the export type from the drop-down list. This is the standard format that you want to use for the export.

Format type (mandatory field)

Select the respective format type - e.g. Item (new) - from the drop-down list.
Note: At the moment, the formats Manufacturers, Newsletter recipients, Order, Purchase order, Item (new), Stock movements, Stocks and Warehouses are available.

Format (mandatory field)

Select one of the formats from the drop-down list.

6.2. Carrying out the format settings

Once you have carried out the basic settings, you can determine a format as well as separators in the format settings.

Carrying out the format settings:

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

  2. Select the catalogue for which you want to carry out the format settings.
    → The catalogue opens.

  3. Click on the Settings () tab on the left.
    → The different settings options are shown.

  4. Go to the section Format settings.

  5. Carry out the settings. Pay attention to the explanations given in Table 7.

  6. Save () the settings.

Table 7. Carrying out the format settings
Setting Explanation

File name

Enter the file name. There is no need to add the extension .csv or .txt as this is done automatically by the system.

Note: Use placeholders to automatically add further information to the file name. For example, you can add the current date to the file name. The following placeholders are available: $name, $type, $format, $timestamp, $datetime, $year, $month, $day, $hour, $minute, $second

Examples:

  • file-name.csv

  • file-name_2020_10_25.csv

  • file-name_$year_$month_$day.csv

Format

Select the format of your file.

Field separator

Select a field separator from the drop-down list.

Text delimiter

Select a text delimiter from the drop-down list.

Decimal separator

Select a decimal separator from the drop-down list.

Line break

Select the type of line break from the drop-down list.

Header is included

Indicate whether there is a header row included in your file.

6.3. Carrying out the export settings

Once you have carried out the basic and format settings, it is time to take a look at the export settings. Here you determine how the export should be provided.

Carrying out the export settings:

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

  2. Click on the catalogue for which you want to carry out the export settings.
    → The catalogue opens.

  3. Click on the Settings () tab on the left.
    → The different settings options are shown.

  4. Go to the section Export settings.

  5. Carry out the settings. Pay attention to the explanations given in Table 8.

  6. Save () the settings.

Table 8. Carrying out the export settings
Setting Explanation

Provisioning

Select from the drop-down list, in which form you want the export to be provided.
If you select FTP, FTPS or SFTP, further fields become visible.

Server

Enter the server. We recommend to leave out the protocol prefix (ftp://, ftps:// etc.).
This field is only visible if you have selected FTP, FTPS or SFTP.

Port

Enter the port or use the default setting. Use port 21 for FTP and FTPS. Use port 22 for SFTP.
This field is only visible if you have selected FTP, FTPS or SFTP.

User name

Enter the user name.
This field is only visible if you have selected FTP, FTPS or SFTP.

Password

Enter a password.
This field is only visible if you have selected FTP, FTPS or SFTP.

Path

Enter the path for the storage location of your file. Note: If you are using SFTP, it is necessary to provide the full path.
This field is only visible if you have selected FTP, FTPS or SFTP.

Transfer

Define when you want the export to start. To do so, select an option from the drop-down list. When selecting Schedule, a window opens where you can choose the time.

Schedule

Select from the drop-down list, at which time you want the export to happen.
This field is only visible if you have selected Schedule for the transfer.

6.4. Adding and linking data fields

In catalogues with standard formats, you can also add and link several data fields for the export from your plentymarkets system. Moreover, you can add fallback data fields. In case a value does not exist, you can define here which value should be exported instead.

menu structure standard format

Menu structure of a catalogue with standard format

In the following you will find explanations on the individual sections.

  • Navigation: Here you can switch between the different sections. Access the catalogue settings, select plentymarkets data fields for the export or set filters in order to narrow down data.

  • Toolbar: Here you can carry out actions that are relevant for the catalogue and for example download your data after mapping the data fields in order to start the export.

  • Available plentymarkets data fields: Select here, which of the available plentymarkets data fields you want to export. Besides the data fields, there are also own values and formulas available which you can use in order to tailor the export to your specific needs.

  • Selected data fields: Here, all data fields that you selected for the export are shown. Via drag-and-drop, you can move them as desired and thus adjust the order in which they are exported. Furthermore, you can define the export key - the name under which the data field will be exported. For the event that a selected value is not available, you can also add fallback data fields.

Determining an export key for added data fields

To the left of newly added data fields, you can enter an export key. All values of the respective row will then be exported under the key name. Make sure that the key is unique and do not use any special characters such as spaces . / etc.

Adding all data fields of a group at once

If you want to add all data fields of a group to a catalogue at once, click on the plus on the right of the group.

Adding and linking data fields:

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

  2. Click on a catalogue.
    → The Data fields tab () opens and displays all available plentymarkets data fields as groups on the left.

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

  4. Next to the data field you want to select, click on the plus.
    → The data field is added to the view.
    Or: Enter the name of the data field into the search field and navigate to the desired entry. Afterwards, press Enter to add it to the view.
    Tip: Do you want to export a fixed value for every variation for one of the data fields? Click on the plus next to Own value.
    → The field for the own value is added to the view.

  5. If you selected Own value, enter a value into the input field below. Optional: Click on Add fallback data field to select a data field that is exported in case another one is not available. You can also add more than one fallback data field.

  6. Optional: To link another data field to an existing one, click on Add data field () on the right.
    → The editing mode opens.

  7. Next to the data field you want to select, click on the plus or select Own value.
    → The data field is added to the view.

  8. On the right in the data row, click on Settings () to select a separator for linking the data fields.
    → The window Data column settings opens.

  9. Select a separator from the drop-down list or add an own separator.

  10. Save the settings.
    → The data fields are linked and will be exported with the respectively selected separator.

  11. Add all desired data fields and create links where needed.

  12. Save () the settings.

Own value

The option Own value allows you to export a fixed value for a data field. This fixed value is thus identical for each data record that is exported via this catalogue.

Determining the order of CSV columns

You can move single data fields or whole columns as desired and thus determine the order in which the data fields are exported. If you want to move a single data field, go to the data field and drag and drop it to the desired position. However, if you want to move a whole column, click on the symbol () on the left side and drag and drop it to the desired position.

6.5. Adjusting values using mathematical calculations

Mathematical calculations allow you to changes values during the export. Note that this function is only applicable to data fields that contain numerical values.

Adjusting values using mathematical calculations:

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

  2. Open a catalogue.
    → The tab Data fields opens.

  3. In the list of data fields, click on the plus next to Formula ().
    → The field Formula is added to the view on the right.

  4. Click on the field Formula.
    → The Modify value window opens.

  5. Select a decimal separator from the drop-down list.

  6. At the bottom right of the window, select a data field to add it to the calculation ().
    Tip: Use the search function to find data fields quickly.
    → The data field is added to the calculation.

  7. Optional: If the symbol is shown in the data field, select the correct assignment for the data field.
    Tip: A number tells you how many assignments are necessary for the data field.

    1. Click on the symbol .

    2. In the window shown, select the assignments from the drop-down list.

    3. Save the settings.

  8. Enter numbers and mathematical operators with the on-screen calculator or the keyboard.

  9. Save the settings.
    → The entered formula is displayed in the overview.
    Tip: If a preview is available for the format, check the result by using the preview function ().
    → The calculation will be carried out in the next export.

6.6. Deleting data fields

In the Mapping tab of a catalogue with a standard format you can delete individual or several data fields at once.

Deleting data fields:

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

  2. Open a catalogue with standard format.
    → The Data fields tab (icon:order_return_create_edit[set=plenty[) with all available data fields opens.

  3. Click on the further actions () on the right of the data field that you want to delete.

  4. Click on Delete data field ().
    → The data field is deleted.
    Or: If you want to delete a complete row, click on Delete data row () on the right in the respective row.
    → The complete row is deleted.
    Or: Tick the box on the left for all rows containing data fields that you want to delete. Afterwards, click on Delete selected data fields () at the top right.
    → All selected data fields are deleted.

(De)activating automatic export

The toggle button on the left side in the catalogue overview allows you to activate or deactivate a catalogue for the automatic export. By activating the toggle button, the data are transferred to the marketplace or exported from your system on a daily basis.

7. Filtering export data

You can use filters to limit the data that should be exported. You can find the filters in the side navigation of the Data » Catalogues menu.
In catalogues with marketplace formats, both user-defined filters and template filters are visible. Template filters apply automatically and cannot be deselected. User-defined filters can be set as needed to only export specific items. The user-defined filters available depend on the marketplace format.

Adding a filter:

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

  2. Select a catalogue.
    → The overview opens.

  3. On the left in the side navigation, click on the Filters () tab.
    → The filter overview opens.

  4. Select a filter from the drop-down list.

  5. Afterwards, click on Add filter () on the right.
    → The filter is added.

  6. If available, select an operator from the drop-down list.

  7. If available, enter the corresponding value in the field next to it.

  8. Save () the settings.
    → The filter is saved.

  9. Add additional filters as necessary.
    → Only data that meets all filter criteria is exported.

8. Creating a preview for the export

After you have mapped the data fields, you can test the catalogue export using the preview function. The preview function allows you to download the first 5 data rows of the export. However, the preview function is not available for all catalogue formats.

Creating a preview for the export:

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

  2. In the row of the catalogue for which you want to create a preview, click on the further actions ().

  3. Click on Preview ().
    Or: Open a catalogue.

  4. Click on Preview ().
    → A window opens and displays the preview of the first 5 data rows.

  5. Optional: Click on Download data () to test the catalogue export and to download the preview.

9. Manually exporting catalogue data

Once you have carried out all settings and added at least one data field, you can manually export your catalogue and download the export file in the desired format. At the moment, the formats CSV, TXT, JSON and XML are available.

Manual export does not export data to marketplaces

By using the function Download data, you just carry out a manual export. In this case, your data will not be transferred to any marketplace.

Manually exporting catalogue data:

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

  2. In the row of the catalogue that you want to export, click on the further actions ().

  3. Click on Download data ().
    → The export starts.
    Or: Open a catalogue.

  4. At the top, click on Download data ().
    → The export is started and runs in the background so you can continue working without any disruptions.

  5. As soon as the export is finished, you will be notified () that the export file can be downloaded.

  6. If you want to download the export file, click on Download in the notification.
    → The downloaded export file opens.

Exports only kept for 15 days

Once you have carried out an export, it will automatically be removed from the plentymarkets storage after 15 days. If you want to keep an export, use the scheduler or carry out a manual export via the Download data function.

10. Generating a URL for the download

In the Download settings of a catalogue you can generate a URL for the download. Via this URL you can directly download the catalogue that has just been exported. This can be done by using either an admin link or a public link.

Generating a URL for the download:

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

  2. Select a catalogue.
    → The catalogue opens.

  3. Open the Settings tab () on the left and select the Download settings section.
    → The settings for generating the URL are displayed.

  4. Carry out the settings. Pay attention to the explanations given in Table 9.
    → The URL for the catalogue’s download is displayed as soon as the export has been finished. The URL that was last generated will always be displayed in the menu.

  5. Click on the URL or copy the URL () to use it.

Table 9. Generate URL
Setting Explanation

Shop URL

Select a domain for generating the URL.

Receive notifications

When activating the toggle you will get a notification when the export is finished.

Options for admin link

Use hash

Select whether a hash should be used. If this option is active, a new URL including hash key is created each time the catalogue is modified.
The hash represents all settings that are relevant for the catalogue export. If these settings change, the hash changes and all future links will include the new hash. Older links will be valid for 15 days from the last export with that hash. If you always want to have the export of the current catalogue settings, do not use the hash.

Admin link

You can only use an admin link, if you are logged in as an admin. By clicking on the icon on the right (), you can copy the URL.

Options for public link

Activate options

Activates or deactivates the public link and enables the use of the options Use hash and Use token.

Use hash

Select whether a hash should be used. If this option is active, a new URL including hash key is created each time the catalogue is modified.
The hash represents all settings that are relevant for the catalogue export. If these settings change, the hash changes and all future links will include the new hash. Older links will be valid for 15 days from the last export with that hash. If you always want to have the export of the current catalogue settings, do not use the hash.

Use token

When active, a token is generated.

Security token

By clicking on the icon on the right (), a new token is generated.

Public link

Use a public link, if you are not logged in as an admin. By clicking on the icon on the right (), you can copy the URL.

11. Managing catalogues

Read the following chapters to learn how to copy, delete and restore existing catalogues. This information applies to both marketplace and standard formats.

11.1. Customizing catalogue overview columns

You can customize the information that is displayed in the table columns. To do so, proceed as follows:

Customizing catalogue overview columns:

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

  2. At the top right, click on Configure columns ().
    → The window Configure columns opens.

  3. Select which columns you want to be displayed.

  4. Move () the columns so they are displayed in the desired order.

  5. Click on Confirm to save your settings.

11.2. Copying catalogues

You can copy catalogues to use well configured catalogues to quickly create a new catalogues. Any data fields that you have already mapped are copied, even if you select a different format. You can also select a different language for the copy.

Coping a catalogue:

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

  2. In the row of the catalogue that you want to copy, click on the further actions ().

  3. Click on Copy ().
    Or: Tick the box of the catalogue that you want to copy.

  4. At the top in the catalogue overview click on Copy catalogue ().
    → A window opens.

  5. If desired, adjust the automatically created name for the copy.

  6. Optional: Select another format from the drop-down list. Data fields that have already been mapped will be transferred.

  7. Optional: Select another language from the drop-down list.

  8. Click on Copy.
    → The catalogue is copied and displayed in the catalogue overview.

You can also copy several catalogues at once. However, in this case you cannot change the format or language of the catalogues.

Copying several catalogues:

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

  2. Select the catalogues that you want to copy.

  3. Click on Copy catalogue ().
    → All selected catalogues are copied and displayed in the catalogue overview.

  4. Optional: If you want to edit the automatically created names of the copied catalogues, open the catalogues individually and adjust the name in the basic settings.


11.3. Deleting catalogues

You can delete one catalogue or multiple catalogues at the same time.

Deleting catalogues:

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

  2. In the row of the catalogue that you want to delete, click on the further actions ().

  3. Click on Delete ().
    → You are asked to confirm your decision.

  4. Confirm the deletion.
    → The catalogue is deleted.
    Or: Open a catalogue.

  5. Click on the further actions () at the top.

  6. Click on Delete catalogue ().
    → You are asked to confirm your decision.

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

Proceed as follows in order to delete several catalogues at once.

Deleting several catalogues:

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

  2. Select the catalogues that you want to delete.

  3. At the top right, click on Delete selected catalogues ().
    → You are asked to confirm your decision.

  4. Confirm the deletion.
    → The catalogues are deleted.


11.4. Restoring deleted catalogues

In the catalogue overview, you can restore the last version of a deleted catalogue.

Restoring a deleted catalogue:

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

  2. Click on Restore deleted catalogue ().
    → A window opens.

  3. Select a catalogue from the drop-down list.

  4. Click on Restore.
    → The catalogue is restored and displayed in the catalogue overview.

11.5. Restoring a catalogue version

You can restore a previous catalogue version via the further actions or in the view of a catalogue.

Restoring a catalogue version:

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

  2. In the row of the catalogue for which you want to restore a different version, click on the further actions ().

  3. Click on Restore catalogue version ().
    Or: Open a catalogue and click on the further actions () at the top.

  4. Click on Restore catalogue version ().
    → A window opens.

  5. Select the version that you want to restore.

  6. Click on Restore.
    → The catalogue version is restored and displayed in the catalogue overview.

11.6. Exporting catalogues

Export catalogues to import them into other plentymarkets systems afterwards. At the same time, an export also serves as data backup.

Exporting catalogues:

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

  2. Place a check mark for the catalogue that you want to export. You can also select several catalogues at once.

  3. At the top, click on Export catalogue ().
    → A window opens.

  4. Select a storage location.
    → The selected catalogues are exported and saved at the desired location.

11.7. Importing catalogues

Use the import function to import catalogues from other plentymarkets systems or catalogues that have been saved as backup beforehand.

Importing catalogues:

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

  2. At the top, click on Import catalogue ().
    → A window opens.

  3. Select the catalogue file that you want to import.
    Important: You can only import one catalogue at a time. → The catalogue is imported and displayed in the overview.
    → The name of the imported catalogue contains the addition (1). If the catalogue originates from another system, the name from this system is maintained.

To top