Using marketplace formats

Use the marketplace formats of the catalogue to export variation data and stock data to many markets and price portals. PlentyONE is working on moving all markets to catalogue formats.

The following marketplace formats are currently available in PlentyONE:

On this page you can find out how to export variation data to markets using catalogues. However, only the general workflow is explained. Once you have familiarised yourself with the underlying principles of marketplace formats, head over to the setup page for a specific marketplace to find out how to create and structure catalogues for that marketplace.

1. Understanding the catalogue menu for marketplace formats

When you open the menu Data » Catalogues, the first thing you see is the catalogue overview. You can get to know this catalogue overview here.

The catalogue menu for marketplace formats is what you see when you open a catalogue with marketplace format.

The catalogue menu is the same for all marketplace formats:

catalogue menu colours

Tip: Your catalogue still looks different? Then you probably opened a catalogue with a standard format. Standard formats are used to export data to a file and are elaborated on here instead.

When you open a catalogue, the view Mapping is shown by default. Use the navigation to switch to other views of the catalogue.

catalogue market navigation

Catalogues

Go back to the catalogue overview, that is to the list of catalogues.

List of opened catalogues

The navigation shows all catalogues that you accessed during your current session. This allows you to quickly switch between the catalogues you are currently working on. The catalogue that is currently on view is shown in blue. The names of the other catalogues are shown in grey.

Tip: You can remove a catalogue or channel map from the navigation by hovering over it with your cursor and clicking on the X that appears.

Settings

This menu contains all settings for the catalogue. The settings consist of four sections:

  • Basic settings = Name and format type of the catalogue. You enter this information to create a catalogue.

  • Format settings = Settings for the export file structure.

  • Export settings = Settings for automatic export.

  • Download settings = Settings for the URL that is used to access the export file.

These sections also appear in the navigation bar, but do not need to be accessed separately.

Important: You do not need these settings for most markets. These settings are only relevant if you want to export data to a file.

Mapping

This menu is shown when you open the catalogue. Here, you map suitable PlentyONE data fields to the marketplace data fields.

filter_alt Filter

Add filters to only export specific records.
Note: Filters are not available for all catalogues.

Tip: The number of filters that you activated for a catalogue is always shown. Template filters, i.e. filters that are applied by default, are not included in the count.

filters number of filters

Own data sources

Own data sources are currently not available for most exports.

The toolbar provides actions for the catalogue.

catalogue market toolbar

save Save

Saves the catalogue settings.

preview Preview

Creates a preview of the export data. The preview contains the first 5 data rows of the export file.

Important: The preview function is not available for all catalogue formats.

Asynchronous download

Starts a manual download of the catalogue data.

Important: This option starts a manual export. The data is not exported to the market.

play_circle Live download

Downloads the catalogue data as a file. The download starts immediately. The file is automatically saved on your computer when the export is done.

Important: This option downloads the catalogue data to your computer. The data is not exported to the market.

playlist_play Status

Opens the menu Data » Catalogue export status and filters the list for this catalogue. Shows information about the status of the catalogue.

more_vert More

Shows additional actions.

history

Restores an earlier version of the catalogue. The last 100 versions of the catalogue are available.

How do I restore other catalogue versions?

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

  2. Alternative 1: In the catalogue overview

    1. In the row of the catalogue, open the further actions (more_vert).

    2. Click on Restore catalogue version (history).

  3. Alternative 2: In the catalogue menu

    1. Open the catalogue.

    2. In the toolbar, click on the additional actions ().

    3. Click on Restore catalogue version (history).

  4. In the window shown, select the version that you want to restore.
    Tip: The last 100 versions of the catalogue are available.

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

delete

Deletes the catalogue.

How do I delete a catalogue?

  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 (more_vert).

  3. Click on Delete (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 (more_vert) at the top.

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

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

search Search

You can search for the names of marketplace data fields and the values that you have selected in marketplace fields with an input field.

toggle_off Show mandatory fields only

Use the toggle button in order to decide whether you want to display all fields (toggle_off) or mandatory fields only (toggle_on).

All / Mapped / Unmapped

Select one of the three tabs depending on whether you want to see all fields (default), only mapped fields or only unmapped fields. Note that the tab selection also affects the search.

Live preview

You can use the Live preview feature to display which values of a given variation would be exported to the marketplace by each mapping. Simply activate the toggle and enter the ID of the variation you want to use in order to show live previews for that variation.
Important: Live preview is only available for catalogues that also support the Preview (preview) function.

To the right of the navigation, all data fields available for the market are listed. Marketplace data fields are the fields for which you can export data to the market. Because every market structures and processes item data differently, each market also has different marketplace data fields.

catalogue market market fields

What you should know about marketplace data fields:

  • In the catalogue, mandatory fields are flagged with an asterisk (*). You must map PlentyONE data sources for these mandatory fields and ensure that your selected data sources contain fitting data for each variation you want to sell on the marketplace. Otherwise, the variation will not be exported to the market.

  • All other data fields are optional but will likely increase your sales performance. If no data is saved for one or more of these optional fields is saved for a variation, the variation is still exported to the market.

  • The best information about marketplace data fields is provided by the market itself. Check the market’s documentation to find out exactly what data is expected. When in doubt, ask your contact person at the market.

Tip: In the toolbar, click on the further actions (more_vert) to show or hide optional data fields.

On the right side of the catalogue, you map the marketplace data fields to appropriate PlentyONE data sources.

catalogue market plenty fields

Tip: One field was already mapped in the screenshot.

You can use the following data sources to map your data:

What you should know about PlentyONE data sources:

  • A market expects product data that cannot be saved for a variation directly? Then create a property, link this property with your variations and save the product data as the values for this property instead.

  • You can map a fallback data source in addition to a PlentyONE data source. The content of the fallback data field is only exported if the first mapped PlentyONE data field does not return a value.

2. What are catalogues with marketplace formats?

Every market structures product data differently. Often, you even need different product information for different product categories of the same market. For example, your product data for shoes will be different from that for cat food. For shoes, you specify the shoe size and the material. For cat food, you need to specify the base price, a list of ingredients and so on.

Catalogues with marketplace formats allow you to tailor your item information exactly to the needs of the market. Because here, you assign a suitable PlentyONE data field to each of the data fields of the market. When your variation data is exported to the market, the market’s data fields are then filled with the correct PlentyONE data.

  • A marketplace format contains a matrix of the data fields that a market can process. As such, marketplace formats tell you what data can be exported to the market. The asterisks also help you to see straight away which data is obligatory and which is option.

  • One market can offer several marketplace formats. For example, there might be different formats for different product categories (pet food, food, non-food, etc.) or for different languages. However, for some market you export all item data in a single catalogue. An example for this is Etsy.

What are the advantages of these catalogues?

  • Every format is based on the data structure of a specific market. As such, you know exactly which variation data is necessary to sell your products on the market.

  • You choose for each market and sometimes even for each market category which variation data is going to be published on the market. For example, you can use properties to export different variation names and descriptions to different markets.

  • You can easily copy and adjust well configured catalogues.

Map your data carefully!

There are very few limits to how you can map your data in a catalogue. However, this also means that there are no safeguards against incorrect mapping. In other words, your system will not prevent you from creating mappings that export incorrect data to a marketplace. As such, you should always make sure that the mappings you set up would export your item data as intended.
You can find recommendations for data field mappings on the manual pages for most marketplaces. Use these recommendations to double-check your mappings.

3. Which mappings are available?

In this chapter, we give you the lowdown of the available mappings.

This information is structured like this:

Simplify mappings with Channel maps

With Channel maps, you can create cross-category mappings for a marketplace and apply them to your catalogues afterwards. All linked catalogues will automatically inherit the mapping from the Channel map. For more information, refer to the Channel maps manual page.

3.1. What is "mapping"?

Mapping means that you link a marketplace data field with a PlentyONE data source. You can create a mapping by clicking on Add data source next to the marketplace data field you want to map your data to.

But what happens when you map a field? Let us assume the following use case:

  • For this marketplace data field, I want to export the data to the market that is saved in this PlentyONE item data field for the variation.

Example:

You map the PlentyONE data field Item text » Name 1 to the marketplace data field Item name:

productname example 1

As such, the name that is saved in the menu Item » Items » [Open variation] » Tab: Description for the setting Name 1 is exported to the market for all variations.

For the variation you can see in the screenshot below, that means that the name Sessel »New York« Echtlederbezug in braun is exported to the market.

productname example 2
You can use the Live preview feature to immediately see what data would be exported to the marketplace for a particular variation.

3.2. Simple 1:1 mappings

Map 1 marketplace data field to the PlentyONE data source

In a 1:1 mapping, you map a PlentyONE data source to the marketplace data field. If no suitable setting exists in PlentyONE. you can map a property instead.

In other words, this mapping specifies:

  • I want to fill this marketplace data field with the data from this PlentyONE data source.

  • If the PlentyONE data field does not return a value, no value is exported for this variation.

Creating a simple 1:1 mapping

  1. Next to the marketplace data field, click on + Add data source.
    → To the left, the list of available PlentyONE data sources are shown in groups.

  2. Select a PlentyONE data source in the list.
    → The data source is added to the right, but not yet confirmed or saved.

  3. Click on Confirm.

3.3. Complex 1:1 mappings

Map the value of one marketplace data field to the value of 1 PlentyONE data field

Complex mappings are necessary whenever a marketplace data field only has a select number of possible values. Like the name implies, they cannot be resolved by simply mapping the whole data field to one of your PlentyONE data sources. Instead, you map the individual values that can be entered in the data field to PlentyONE data sources.
For example, a marketplace may only allow for the color of an item to be described using a limited selection of terms such as "Blue", while the variations saved in your system may use more distinct terms such as "Sky blue" or "Royal blue". In such cases the marketplace data field for item colors will be a complex mapping that allows you to map the colors "Sky blue" and "Royal blue" saved in your variations to the value "Blue" used by the marketplace.

Do not enter own values for complex mappings. All values that you enter must be saved for the variations, either in a setting or as a property value. This also applies if the value Comparative value is shown. You still need to enter exactly the value of the setting or property that you mapped.

A complex mapping will always export the value selected for the marketplace data field, regardless of what kind of data source you mapped it to. The only exception are own values, which will be exported as-is.

You can recognise complex mappings from the field that is shown below the name of the marketplace data field. Click on the field to show the values available for the marketplace data field.

catalogue complex mappings

Examples for complex 1:1 mappings are:

  • Categories

  • Brands

  • Shipping settings

Important: For complex mappings, do not map own values or properties of the type None.

Creating a complex 1:1:n mapping

  1. Click on the field for the marketplace data field.
    → A list of the available values is shown.

  2. Select the value that you want to map a PlentyONE data source to.
    → The value is added as a mappable field.

  3. Next to the added field, click on + Add data source.
    → To the left, the available PlentyONE data sources are listed in groups.

  4. Select the PlentyONE data source you want to map tho the marketplace value.
    Important: Do not map own values or properties of the type None.

  5. Your next steps depend on the PlentyONE data source you selected:

    • Alternative 1: The available values for the PlentyONE data value are shown on the left.

      • Next to the value you want to select, click on the plus.
        → The value is added to the field on the right.

      • Click on Confirm.

    • Alternative 2: The PlentyONE data source is inserted and the field Comparative value is shown.

      • In the field Comparative value, enter a value that is saved in the setting or the property of the mapped PlentyONE data source.

      • Click on Confirm.

    • Alternative 3: The PlentyONE data source is inserted and a drop-down list is shown.

      • Select a value from the drop-down list.

      • Click on Confirm.
        → The value of the marketplace data field is exported, not the value of the PlentyONE data source.
        Exception: If you map an own value to a marketplace data field, the own value that you enter is exported directly.

3.4. 1:1 mappings with fallback data fields

Map 1 marketplace data field to the PlentyONE data field and specify an alternative

You specify:

  • I want to fill this marketplace data field with the data from this PlentyONE setting.

  • If the PlentyONE data field does not return a value for a variation, the fallback data field is checked and the value of that fallback data field is exported instead.

All PlentyONE data field are available as fallback data fields. However, the content of the fallback data field is only exported if the first mapped PlentyONE data field does not return a value.

Workflow for fallback data fields:

  • During the export, the mapped PlentyONE data field of each variation is checked for content.

  • If data is saved for a variation for that PlentyONE data field, then this data is exported.

  • If the PlentyONE data field does not return any data, the system jumps to the first fallback data field and checks if this returns any data.

    • Example 1: You mapped Name 3 as the first PlentyONE data field. However, in the variation date a name is only saved in the field Name 1. The field Name 3 is empty.

    • Example 2: You mapped a property as the first PlentyONE data field. However, this property is not linked to the variation.

  • If the fallback data field also does not contain data for the variation, the second fallback data field is checked and so on.

  • If no data is found for a marketplace data field for a variation, what happens next depends on whether or not the data field is mandatory or not. If so, the variation is not exported. If not, the variation is exported. The variation is exported but the marketplace data field is not filled on the market.

fallback data fields
Figure 1. Example "Colour": An attribute for colour as the main data field, a property for colour as the fallback data field
Creating a 1:1 mapping with fallback data fields

  1. Next to the marketplace data field, click on + Add data source.
    → To the left, the list of available PlentyONE data sources are shown in groups.

  2. Click on the plus to the right of the PlentyONE data source you want to use as the primary data source.
    → The PlentyONE data source is added to the right.

  3. Click on + Add fallback data source below the primary data source.
    → The fallback data source is added with the fallback condition Null.

  4. (Optional) If you want to use the fallback condition Empty instead:

    1. Hover over the fallback data source with your cursor and click on the Settings () option that appears to the right.
      → The window Data column settings is shown.

    2. For the setting Fallback condition, select the option Empty.

    3. Click on Save.
      → The fallback data source’s fallback condition is changed to Empty.

  5. Click on Confirm.
    → The fallback data source is exported if the fallback condition is fulfilled.

3.5. 1:n mappings

Map SEVERAL PlentyONE data fields to the marketplace data field

In a 1:n mapping, you map several PlentyONE data fields to the marketplace data field. You can link these settings with a separator.

So this mapping specifies:

  • I want to combine these PlentyONE data fields during export so that the marketplace data field is filled with the data of these two or more PlentyONE settings.

Creating a 1:n mapping

  1. Next to the marketplace data field, click on + Add data source.
    → To the left, the list of available PlentyONE data sources are shown in groups.

  2. Click on the plus to the right of the PlentyONE data source you want to select.
    → The PlentyONE data source is added to the right.

  3. Click on Confirm.

  4. To the right of the mapped PlentyONE data source, click on Add data source ().
    → To the left, the list of available PlentyONE data sources again are shown in groups.

  5. Map the desired number of additional PlentyONE data sources to the marketplace data field as described above.

  6. Click on Confirm.

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

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

  9. Click on Save.

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

3.6. Own value mappings

Map the same value for all variations to the marketplace data field

You are sure that you want to export the same value for all variations of a catalogue for a marketplace data field? Then specify an own value. This own value is then exported for all variations.

So this mapping specifies:

  • I want to export the value that I entered in the field Own value for all variations of this catalogue.

Example:

You want to export diameter information for some of your variations. The diameter is saved in centimetres for all your variations. Instead of creating a property for the unit and linking this property to every variations, you can enter the own value cm.

catalogue diameter
Figure 2. Own value for the diameter unit
Creating an own value mapping

  1. Next to the marketplace data field, click on + Add data source.
    → To the left, the list of available PlentyONE data sources are shown in groups.

  2. Select the Own value option at the top of the list.
    → The data source Own value is mapped to the data field.

  3. Enter a value into the input field in the Own value.

  4. Click on Confirm.
    → The entered value is exported for all variations.

3.7. Recalculating numerical values (Formula)

You save a mathematical formula. This formula is applied to numerical values during the export.

Mathematical calculations allow you to change numerical values automatically during the export.

  • This function is new and has not been implemented for all marketplace formats yet.

  • This function only works for data fields that contain numerical values.

So this mapping specifies:

  • I want the numerical value of a PlentyONE data field to be recalculated during the export. Basic arithmetic operations are available for the formulas.

Creating mappings with mathematical calculations

Mathematical formulas allow you to change numerical values automatically during the export. In other words, this mapping specifies:

  • I want the numerical value of a PlentyONE data source to be recalculated during the export. Basic arithmetic operations are available for the formulas.

Recalculating numerical values:

  1. Next to the marketplace data field, click on + Add data source.
    → To the left, the list of available PlentyONE data sources are shown in groups.

  2. At the very top of the list, click on the + icon next to Formula (calculate).
    → The data field Formula is added to the field on the right.

  3. Click into the data field.
    → The window Modify value is shown.

  4. Enter a numerical value or select a PlentyONE data source at the bottom right of the window to add it to the calculation (add).
    Tip: Use the search function. This helps you to find data fields quickly.

  5. Optional: If the symbol more_vert 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 icon more_vert.

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

    3. Save the settings.

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

  7. Save the settings.
    → The entered formula is displayed in the overview.
    → When an export is carried out, the formula is used to calculate the value that is exported for each variation.

4. Optional: File export (no market export)

Catalogues with marketplace formats are automatically exported to markets if all your settings are correct. That means you can ignore the catalogue settings for Format settings, Export settings and Download settings.

However, you can also export a file that contains the data that is also exported to the market.

4.1. One-time catalogue export to a file

Use these instructions to create a one-time export of the catalogue data. The catalogue data is not exported to the market.

There are two ways to manually export the catalogue data:

Asynchronous download

The export runs in the background. Once the download is completed, you download the export file from the Notifications (notifications).

Live download

The file is downloaded to your computer automatically. You can follow the export progress in real time.
However:

  • Do not close or reload the browser tab or the PlentyONE tab Data export while the export is in progress. If you do so, the export will be cancelled.

  • The import can run into a timeout if you try to import large amounts of data. If that happens, the download is cancelled. For lots of data or if a timeout occurs, use the asynchronous download instead.

  • Starting an asynchronous download

  • Starting a live download

For asynchronous downloads, the export runs in the background. So note that there will be no window for downloading the file straight away. Even exporting small amounts of data will take around 30 minutes. When the export is completed, you can download the export file from the Notifications (notifications).

Starting an asynchronous download:

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

  2. Open the catalogue.

  3. In the toolbar at the top, click on Download data (file_download).
    Or: Even quicker: Start the download from the Additional actions (more_vert) in the catalogue overview.
    → The export starts.
    Important: The export runs in the background. Note that there will be no window for downloading the file straight away. Even exporting small amounts of data will take around 30 minutes.
    Once the export is finished, you will be notified (notifications_none) that the export file can be downloaded.

  4. In the notification centre, click on link Download.
    Tip: The notification is no longer shown? Use the URL shown in the Download settings to access the file at any time.

  5. Save the file on your computer.

The live download creates the file and automatically downloads it to your computer. In the tab Data export, you can follow the download progress in real time. However:

  • When you start the live download, a new browser tab opens. In this browser tab, the PlentyONE tab Data export is shown. Do not close or reload the browser tab and the PlentyONE tab Data export while the export is in progress. If you do, the export stops and is cancelled.

  • You can start live downloads for several catalogues at the same time. However, you can only start a new live download for the same catalogue once the current export is complete.

  • The import can run into a timeout if you try to import large amounts of data. If that happens, the download is cancelled. For lots of data or if a timeout occurs, use the asynchronous download instead.

Starting a live download:

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

  2. Open the catalogue.

  3. In the toolbar at the top, click on Live download (play_circle_outline).
    Or: Even quicker: Start the download from the Additional actions (more_vert) in the catalogue overview.
    → A new browser tab opens. PlentyONE and the tab Data export are shown.
    No new tab? Then you are probably using a pop-up blocker. Allow pop-ups for your system to continue.
    → The export starts.
    Important: Do not close or reload the browser tab or the PlentyONE tab Data export while the export is in progress. If you do, the export stops and is cancelled.
    → The progress is shown in real time.
    → The file is automatically saved on your computer when the export is done.

Stopping a live download

Do you want to stop a live download? No problem:

  • In the tab Data export, click on Cancel export (highlight_off) at the top right.
    → The download is stopped.
    Important: The download cannot be restarted. If necessary, start a new download.

4.2. Regular catalogue export to a file

Use these instructions to save the variation data of the catalogue regularly to a specified storage location. You can set the frequency of the export yourself. The catalogue data is not exported to the market.

Setting up regular file exports:

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

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

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

  4. Carry out the settings. Note Table 1.

  5. Save () the settings.
    → The catalogue data is exported to a file in the specified intervals.
    → The file is saved at the specified storage location.

Table 1. Settings for optional file export
Setting Explanation

Format settings

File name

Enter a file name. The exported file is saved with this name.
Tip: The file extension is automatically added during the export. As such, enter the file name without a file extension. File extensions are for example .csv and .txt.

Tip: You can use placeholders in the file name. Placeholders are automatically replaced by additional information to the file name during export.

List of available placeholders

The following placeholders are available:

$$name

The catalogue name.

$type

The export type.

$format

The format type.

$timestamp

The time stamp of the export.

$datetime

The date and time when the export was started.

$year

The year when the export was started.

$month

The month the export was started in.

$day

The day the export was started on.

$hour

The hour the export was started in.

$minute

The minute the export was started in.

$second

The second at which the export was started

$lastChangeTimestamp

The timestamp of when the catalogue was last changed.

$lastChangeDatetime

The date and time when the catalogue was last changed.

$lastChangeYear

The year in which the catalogue was last changed.

$lastChangeMonth

The month in which the catalogue was last changed.

$lastChangeDay

The day on which the catalogue was last changed.

$lastChangeHour

The hour in which the catalogue was last changed.

$lastChangeMinute

The minute at which the catalogue was last changed.

$lastChangeSecond

The second at which the catalogue was last changed.

Examples for using placeholders:

Entry Result

item-export_$year_$month_$day

  • item-export_2022_01_02.csv

$type_$format_$year_$month_$day

  • order_order_2022_01_02.csv

    • check24_offer_2020_10_25.csv

Format

Select the file format for the export.

Possible values:

  • CSV

  • CSV - Array to JSON

  • JSON

  • TXT

  • XML

Field separator

Which field delimiter should separate the individual records from each other?

Possible values:

  • Comma = ,

  • Semicolon = ;

  • Pipe = |

  • Tabulator = ␉

Text delimiter

Which text delimiter should separate the individual records from each other?

Possible values:

  • "

  • '

Encode special characters ()

If you activate this option, unicode characters (e.g. umlauts: ä, ö, ü) will be exported in encrypted form.
Note: This option is only available for the formats JSON and CSV - Array to JSON.

Line break

How do you want to handle line brakes in the export file?

Possible values:

  • Carriage return

  • Line feed

  • Carriage return an line feed

Header is included

Activate the option if you want the export file to contain a header line. The export keys are used as headings for the columns.

Decimal separator

Select the character that is used for decimal values.

Possible values:

  • Comma = Default in German speaking countries
    Example: 20,00 Euro

  • Dot = Default in English speaking countries
    Example: 20.00 Euro

Export settings

Limit

Do you want to limit the number of records that is exported?

*Skip empty files*t

If this toggle is activated, then empty files will not be exported to the target location.

Provisioning

Where do you want to save the export?
Important: This setting does not export data to markets.

None

The export is not saved.

FTP

The export is saved on an FTP server.

SFTP

The export is saved on an SFTP server.

FTPS

The export is saved on an FTPS server.

Server
(for FTP, SFTP, FTPS)

Enter the server where you want to save the export.
Note: Do not enter a protocol prefix. Some examples for protocol prefixes are ftp:// and ftps://.

Port
(for FTP, SFTP, FTPS)

Enter a port or use the default setting.

Recommended port settings:

  • For FTP and FTPS = Port 21

  • For SFTP = Port 22

User name
(for FTP, SFTP, FTPS)

Enter the user name for the server.

Password
(for FTP, SFTP, FTPS)

Enter the password for the server.

Path
(for FTP, SFTP, FTPS)

Where should the export be saved? Enter the path to a storage location.
Note: If you use SFTP, enter the complete path.

Test connection
(for FTP, SFTP, FTPS)

Tests the server settings that you entered:

  • Can PlentyONE connect to the server?

  • Can an export file be saved at the storage location?

Tip: A test file is saved at the storage location. This test file is called plentymarkets_ConnectionTestFile.txt.

Note: This only tests if a file export is possible with the current export settings. The option does not check if a connection can be established to a market.

Transfer

When do you want to start the export?

Never

No data is exported.

Every 20 minutes;
Once per hour;
Once per day

Current data is exported in the selected interval.

Schedule: times

The option Schedule: times is shown.

Schedule: times
(for option Schedule)

Click into the field. In the drop-down list shown, select one or more points in time. The export starts at these times.

Weekdays
(for Transfer ≠ Never)

By default, all weekdays are selected. To deactivate exports for specific days of the week:

  1. Click in the field Weekdays.
    → A drop-down list with weekdays is shown.

  2. Uncheck the checkbox for one or more weekdays (icon:check_box_outline_blank).
    → Exports are only started on weekdays with a check mark ().

Tip: The setting Weekdays is only shown if you select an interval or schedule for the setting Transfer.

5. FAQ: Questions and answers

Why can I not see the catalogues?

Users with back end access rights can only see catalogues if an admin gave them access.

  1. Find someone who has administrator rights for the PlentyONE system.

  2. This person will open the menu Setup » Settings » User » Rights » User.

  3. Then they will open your user account and activate the necessary rights:

    • Data > Data exchange > Export > Catalogue > Show

  4. Save () the settings.

I want to import, export, delete, copy or restore catalogues. How do I do that?

You can find information on how to manage your catalogues here: