Amazon: Switch to new catalogue-based integration

On this page, we will inform you about the new catalogue-based Amazon integration and provide you with useful tips for a smooth transition.

This page will be updated regularly.

1. Overview of the catalogue-based Amazon integration

With the new Amazon interface in PlentyONE, data exchange for creating and updating Amazon listings takes place via two clearly separated catalogue types:

Item data is transferred to Amazon via a product catalogue.
Offer data is transferred to Amazon via an offer catalogue.

Both catalogue types are based on Amazon-compliant structures and replace the previous flat file system. The aim of the new integration is to ensure a stable, transparent and future-proof export process. The catalogue technology also provides maximum flexibility through extended configuration options.

1.1. What is an Amazon listing?

An Amazon listing is the complete representation of an item on the Amazon sales channel. It contains all the relevant information that Amazon needs to display and sell the item, such as title, description, images, price, stock, and shipping information.
A listing consists of two clearly separated components:

Item data (e.g. title, brand, bullet points, technical details) describes the item itself. This data is ASIN-related and therefore the same for all sellers. It is transferred to Amazon via a product catalogue.
Offer data (e.g. price, stock, delivery time, condition) is specific to each seller and can differ. It is transferred to Amazon via an offer catalogue.

Figure 1. Products and offers on Amazon

1.2. When do I need product catalogues and offer catalogues?

Create a product catalogue if the item you want to offer is not yet listed on Amazon or if you want to update existing product information. With the product catalogue, you transfer item data to Amazon so that the item can be listed.
To actually sell the item on Amazon, you also need to create an offer catalogue containing seller-specific data such as price and stock. With a product catalogue, you can list an item that is not yet available on Amazon, but to sell the item on Amazon, you also need an offer catalogue for this item.
Create an offer catalogue if the item you want to sell is already listed on Amazon. With the offer catalogue, you transfer your offer data, such as price, stock, shipping costs, etc., to Amazon.

1.3. Impact on existing business processes

Switching to the catalogue-based integration has an impact on the following processes:

Price update
Stock update
Offer creation
Item creation

Price update

With the catalogue-based integration, prices are transferred to Amazon via the offer catalogue. For this, you must create and activate a corresponding offer catalogue in the Data » Catalogues menu.
To update prices for offers, the following additional settings are required:

Under Setup » Markets » Amazon » Settings » [Open account] » Tab: Item settings, the option 15 minutes or Hourly must be selected for Price changes.
The existing price synchronisation settings must still be configured.

Stock update

With the catalogue-based integration, stock levels are transferred to Amazon every 15 minutes and also together with the offer catalogue. The stock is not mapped in the offer catalogue, but is automatically transferred in parallel with each export of the offer catalogue. For this, you must create and activate a corresponding offer catalogue in the Data » Catalogues menu.
To update stock levels for offers, the following additional settings are required:

Under Setup » Markets » Amazon » Settings » [Open account] » Tab: Item settings, the option 15 minutes or Hourly must be selected for Stock changes.
The existing stock synchronisation settings must still be configured.

Offer creation

With the catalogue-based integration, offers are created and updated via the offer catalogue in the Data » Catalogues menu. If you select the option 15 minutes or Hourly for Stock changes in the Setup » Markets » Amazon » Settings » [Open account] » Tab: Item settings menu, the current stock for the offer is automatically transferred to Amazon together with each offer catalogue export.

Item creation

With the catalogue-based integration, items are created and updated via product catalogues in the Data » Catalogues menu. A separate product catalogue must be created for each product type and sales channel (Amazon.de, Amazon.fr).
Important: Catalogues do not support free text fields or characteristics. Existing characteristics must be migrated to properties.

1.4. Overview of the transition

The following table shows how data is transmitted for the affected processes when using catalogues. It also explains which settings are required and which alternatives are available.
Tip: Start the migration to catalogues as early as possible. Some alternatives are only available temporarily and also require configuration.

Legend for the table:

Export via catalogues: Describes how data is transferred when using catalogues and what settings are required.
Alternative: Explains how to perform the same process without catalogues and until when this alternative is available.

You can either use catalogues or the alternative, but not both at the same time. An exception applies to stock updates.
Stock updates are possible without catalogues, but only for existing offers (i.e. SKUs already known to Amazon).
Until further notice, price updates are also possible without catalogues, but only for existing offers (i.e. SKUs already known to Amazon).
If you use catalogues, you must configure additional settings to enable the transfer of price and stock data.

Table 1. Overview of the transition to catalogue-based integration

Process

Export via catalogues

Alternative

Price update

Frequency of data exchange:

The initial price is transferred when the offer catalogue is exported.
Prices are updated 15 minutes after the price at the variation has been changed.

Required settings:

The offer catalogue must be created and activated.
Under Setup » Markets » Amazon » Settings » [Open account] » Tab: Item settings, the option 15 minutes or Hourly must be selected for Price changes.
The existing price synchronisation settings must still be configured.

Prices for existing offers are updated using the previous method:
- Under Setup » Markets » Amazon » Settings » [Open account] » Tab: Item settings, the option 15 minutes or Hourly must be selected for Price changes.
  Important: This solution only updates prices for existing SKUs.
- The existing price synchronisation settings must still be configured.

Since 15 July 2025, development of price updates without an offer catalogue has been discontinued.
After 15 July 2025, price updates will also be possible without offer catalogues until further notice, but only for existing offers (i.e. SKUs already known to Amazon).

Stock update

Frequency of data exchange:

Stock is updated every 15 minutes using the previous method.
Additionally, stock levels are transmitted automatically in parallel with each offer catalogue export.
Note: The offer catalogue is exported within 15 minutes after a value has been changed on the variation. A new export is triggered when the price of a variation has changed. The offer catalogue and the current stock are transferred 15 minutes after the price change.

Required settings:

The existing settings for stock updates remain necessary:
- Under Setup » Markets » Amazon » Settings » [Open account] » Tab: Item settings, the option 15 minutes or Hourly must be selected for Stock changes.
- The existing price synchronisation settings must still be configured.
To ensure that the stock is also transferred each time the offer catalogue is exported, additional settings are required:
- The offer catalogue must be created and activated.
- Under Setup » Markets » Amazon » Settings » [Open account] » Tab: Item settings, the option 15 minutes or Hourly must be selected for Price changes.
  Note: This setting is necessary to ensure the offer catalogue is exported when prices change for a variation.

Stock for existing offers is updated using the previous method:
- Under Setup » Markets » Amazon » Settings » [Open account] » Tab: Item settings, the option 15 minutes or Hourly must be selected for Stock changes.
  Important: This solution only updates stock for existing SKUs.
- The existing stock synchronisation settings must still be configured.

Stock updates using the previous method remain possible indefinitely.

Offer creation

Frequency of data exchange:

The initial export of the offer catalogue takes place within 15 minutes after any value of the variation has been changed.
A new export is triggered when the price of a variation has changed. The offer catalogue and the current stock are transferred 15 minutes after the price change.

Required settings:

The offer catalogue must be created.
All required data fields must be mapped in the offer catalogue.
The offer catalogue must be activated.
To transfer price and/or stock updates to Amazon, you must also select the option 15 minutes or Hourly for Price changes and/or Stock changes in the menu Setup » Markets » Amazon » Settings » Tab: Item settings.
Note: When exporting new offers for the first time, prices and stock are transferred even if the options for price and/or stock changes are deactivated. Activating these options is only required for subsequent offer data updates.

New offers must be created via an offer catalogue from 31 July 2025 / 1 August 2025 onwards.

Item creation

Frequency of data exchange:

The initial export of the product catalogue takes place within 24 hours after a value has been changed on the variation.
A new export takes place within 24 hours of an update.

Required settings:

A separate product catalogue must be created for each product type and sales channel (Amazon.de, Amazon.fr).
All required data fields must be mapped in the product catalogue.
The product catalogue must be activated.
Important: Catalogues do not support free text fields or characteristics. Existing characteristics must be migrated to properties.

As a transitional solution, you can use an adapter or manually export the data and upload it to Seller Central.
- The adapter supplements the existing flat file information with additional data that can be added via properties.
  Important: Although the adapter solution uses the current flat file information (including characteristics and free text fields), it is only a temporary solution. It is intended to give you time to migrate your characteristics into properties so you can properly configure product catalogues.

The adapter solution is only a temporary option for transitioning to product catalogues. We therefore recommend that you no longer use the adapter solution and switch to product catalogues instead.

1.5. Should I use the adapter or create catalogues?

You can use the adapter to export item data to Amazon. Using the adapter can be helpful if you still use a lot of free text fields and characteristics and if you still need to create properties in order to use catalogues. Hence, the adapter can give you more time to create product catalogues for Amazon.
To use the adapter, go to Setup » Markets » Amazon » Data exchange » Data export and activate the option Activating the item export via the adapter (without test mode) in the section Item export - Adapter. More information about the adapter can be found here.
The adapter only transfers item data, but not offer data. Even if you use the adapter as a temporary solution, it is mandatory to create offer catalogues for Amazon.

The adapter solution is only a temporary option for transitioning to product catalogues. We therefore recommend that you no longer use the adapter solution and switch to product catalogues instead.

Catalogues are the long-term solution to export item data and offer data to Amazon. If you start creating product catalogues for Amazon now, then you do not have to carry out any additional settings when the adapter solution is no longer supported.
If you only export offer data to Amazon and do not want to create new products on Amazon, then you already have to create offer catalogues now. Offer data cannot be exported via the adapter.

2. Variation Family: Parent products and child products on Amazon

A variation family on Amazon is a combination of a parent product, under which various variations (child products) of this product are grouped, for example, a T-shirt in red, green, and blue. The parent product serves as a higher-level placeholder under which the variations are grouped. The parent product cannot be bought. The child products, i.e. the variations of the product, are the products which can actually be bought.
This structure allows customers on Amazon to compare and select different variations of a product on a single product page without having to leave the product page.

variation themes are the attributes in which the child products differ from each other, for example, the different colours of a T-shirt. Child products can have more than one variation theme. Possible variation themes for a T-shirt are colour or size, for example. Variation themes can be combined, for example colour and size.

2.1. Overview: parent products and child products on Amazon

Parent product:

Grouping of child products (grouping of different variations of a product)
Serves as a placeholder and cannot be bought
Example: T-shirt

Child product:

Variation of the parent product
Actual purchasable product
Different child products differ in at least one property, such as size or colour
Examples: blue T-shirt in size 12, red T-shirt in size 8

Variation theme:

Property that distinguishes child products from one another, for example colour or size
Child products can have more than one variation theme
Examples: colour, size

2.2. What do I need to consider when offering an item with variations on Amazon?

Parent products and child products should have the same item name. For example, if you sell a T-shirt, then the parent product and the child product should both be called “T-shirt”. The child product’s attributes, such as “size 10”, should not be included in the name. Amazon automatically displays the correct attributes, such as colour or size, on the product page if you have correctly mapped variation themes and associated attributes in the product catalogue.
- The item name is mapped in the product catalogue. To do so, you can use a property or map the data field Item text » Name 1. How to map the item name is described here.
To display your variations in different colours and sizes on a product page on Amazon, you must map variation themes in the product catalogue. How to do this is described here.
If an error occurs during the item export and a variation cannot be created, this variation is skipped during the export and the item export continues. The associated item will still be listed on Amazon if it was created previously.

3. Mandatory attributes for Amazon

With the transition to catalogues, some optional attributes have now become mandatory for specific product types. You can no longer list new items or update existing items which are linked to the listed product types on Amazon if the mandatory attributes are not linked. We therefore recommend to check which Amazon product types you use.

3.1. Overview of new Amazon product types

Here you can download a list of the mandatory attributes for Amazon:

List of mandatory attributes

This list shows you which attributes are required for the respective product type. Here’s how the list is structured:

Table 2. Mandatory attributes for Amazon
Column	Explanation
Product Type	The Amazon product type, for example ABDOMINAL_EXERCISER, ABIS_BOOK, ACCESSORY.
MP	The Amazon marketplace code (= the Amazon platform), for example DE = amazon.de. *Tip:* You can filter the table by the Amazon platform. This way, you can only display attributes which are required for the Amazon platforms that you sell your items on.
Attribute Name	The technical name of the attribute.
Attribute Label	A user-friendly label for a better understanding of the attribute.

Additionally, the Amazon product types were renamed. With the transition to catalogues, the new Amazon product types will also be available in PlentyONE. The old Amazon product types will automatically be migrated to the new product types. Here is an overview of the old and corresponding new product types:

List of old and new Amazon product types

Use new Amazon product types for item import

If you use the import tool to import items into PlentyONE with a CSV file, then add a column for the new Amazon product types in the import file.
To make sure that your items are linked with the new Amazon product types, run the item export once again after you added the column for the new Amazon product types.

3.2. Check Amazon product types and Amazon platforms

In order to prepare your PlentyONE system for the transition to catalogues, first check which Amazon product types you use and on which Amazon platforms you list your items. You can then check the list of mandatory attributes to find out which attributes are mandatory for which product type.

Check which Amazon product types you use in your PlentyONE system. There are several ways to do this:

Open the item within Item » Items and check which product type is linked in the Amazon section.
Go to Item » Edit item and use the filter Product type with the selection Type selected to display the Amazon product types which you use.
Check your Amazon flatfiles.

Tip: You can filter the list of mandatory attributes by Amazon product types and only display the product types that you use. To do so, use the filter in the Product type column.

Tip: If you only offer your items on specific Amazon platforms, then you can filter the list of mandatory attributes by Amazon platforms. To do so, use the filter in the MP column.

3.3. Check your properties in PlentyONE

After you have checked which Amazon product types you use and which attributes are mandatory for those product types, next check whether you already created properties for those attributes.

Go to Setup » Settings » Properties » Configuration and check whether you already created properties corresponding to the mandatory attributes. Create new properties, if necessary.

4. Creating properties

Characteristics and free text fields cannot be used for the catalogue export. Therefore, you must create properties for all characteristics and free text fields that you use to describe your items in more detail on Amazon.
First, check which characteristics you use to describe your items on Amazon and then create a property for each characteristic. For further information, refer to the Characteristics and properties page.

Creating a property:

Go to Setup » Settings » Properties » Configuration.
Click Create property.
Customise the settings to meet your needs.
Save () the settings.

4.1. Requirements for exporting properties to Amazon

In order for a property to be transferred to Amazon, it must be linked to the desired variation and assigned in the offer or product catalogue for Amazon.

Step 1: Linking a property with a variation

Open the variation in the Item » Items » [Open variation] menu.
Open the Properties tab in the navigation bar on the left-hand side.
Click Add properties (add).
→ The window Add properties opens.
Tip: Use the search to search for the property.
Place a check mark next to the desired property.
Click APPLY.
Enter additional information depending on the property type. If the property is a selection property, for example, you must also select a suitable value from the drop-down list.
Save () the settings.

Step 2: Mapping a property in an Amazon catalogue

Go to Data » Catalogues.
Open the Amazon catalogue for which the property is to be used.
Assign the property to the desired Amazon data field.
Save () the settings.

5. Creating catalogues

With the new integration, item and offer data will be exported to Amazon via catalogues. Go to Data » Catalogues to create catalogues for Amazon. Afterwards, link the Amazon data fields with item data saved in PlentyONE in the catalogue.
After you activate the catalogue, the catalogue data is automatically exported to Amazon in regular intervals.

There are two types of catalogues for Amazon:

Item data is transferred to Amazon via a product catalogue.
Offer data is transferred to Amazon via an offer catalogue.

Tip: For more information on the difference between products and offers and useful tips when to use an offer or a product catalogue, check out the overview.

What is a catalogue?

Catalogues are used to export data from your PlentyONE system. There are two different catalogue formats:

Marketplace formats are used to export item data to markets.
Standard formats are used to export data from your PlentyONE system into a file.

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.

Is this your first time working with catalogues? Then read up on the basic concept of catalogues first.

Data is exported to Amazon if the catalogue is activated

As soon as you activate an offer or a product catalogue and do not use the Test mode any longer, the data in this catalogue is exported to Amazon. This may lead to data being overwritten on Amazon.
We therefore recommend to test the export before activating the catalogues. You can activate the Test mode in the catalogue settings. However, note that the test mode only includes a technical validation and no content check.

5.1. Creating product catalogues

If you only want to offer items that already exist on Amazon, you do not need to create a product catalogue beforehand. In this best practice you will learn how to create offers for existing Amazon items and what to consider during the process.

You have to add the Amazon product types (= product categories) that you use for Amazon before you create product catalogues. This is done in the Setup » Markets » Amazon » Add catalogue templates menu. After adding the product types, you can create product catalogues for the product types that you added.

Gradual transition to item export via product catalogues

We recommend to gradually switch to the item export via catalogues. To do so, proceed as follows:

In the Setup » Markets » Amazon » Add catalogue templates menu, add the Amazon product type for which you want to create a catalogue.
In the Data » Catalogues menu, create a product catalogue for the Amazon product type that you added and map the data fields in the catalogue.
Deactivate the Amazon product type in the Setup » Markets » Amazon » [Open account] » Settings » Tab: Item settings menu in the section Export categories to make sure that no flatfiles will be exported for this product type.
Activate the product catalogue in the Data » Catalogues menu.

5.1.1. Adding Amazon product types

Note: Your Amazon account must be connected to Amazon and must be active. Otherwise, you cannot add product types.

Adding Amazon product types:

Go to Setup » Markets » Amazon » Add catalogue templates.
Click Add product types ().
→ The Add product types window opens.
Enter the Seller ID of your Amazon account.
Select the Amazon product type from the Product types drop-down list.
Save () the settings.
→ The product type is added. You can now create a product catalogue for this Amazon product type in the Data » Catalogues menu.
Note: You don’t need to add the product type separately for each sales channel (e.g. Amazon.de, Amazon.fr). The product type is automatically available for all sales channels using the selected seller ID.

Note: The product types which you already used before switching to the catalogue-based Amazon integration are already added here by default.

5.1.2. Creating a product catalogue

Item data is exported to Amazon using catalogues. To export your items to Amazon, create a product catalogue in the Data » Catalogues menu. Afterwards, link the Amazon data fields with item data saved in PlentyONE in the catalogue.
After you activate the product catalogue, the catalogue data is automatically exported to Amazon within 24 hours after a value has been changed on the variation.

To simplify the creation of new catalogues, you can now create Channel maps for Amazon. With Channel maps, you can create cross-category mappings for a marketplace and apply them to catalogues afterwards. All linked catalogues automatically inherit the mapping from the Channel map. This will save you a lot of time as you don’t need to carry out the mappings for each catalogue.
You can find more information on how to create Channel maps in the Channel maps section.

Note: There is a separate catalogue format for each Amazon product type. Different item data is exported in each format, depending on which information Amazon requires for a product category.
Product catalogues are also account-specific. This means that you have to create a separate catalogue for each product type and each sales channel (Amazon.de, Amazon.fr) that you want to sell your items on.

Creating a catalogue:

Go to Data » Catalogues.
Click on Create catalogue ().
Enter a name for the catalogue.
In the drop-down list Marketplace, select the option Amazon.
In the drop-down list Export type, select the option Listing.
In the drop-down list Amazon Account, select the Amazon account for which the catalogue is to be created.
In the drop-down list Sales Channel, select the Amazon platform.
In the drop-down list Category, select the Amazon product type*.
Save () the settings.
→ The catalogue is created.
→ The catalogue is opened for editing.

Other catalogue settings

Other catalogue settings are optional. Once you carried out the settings described on this page, your catalogue is automatically exported to Amazon. That means you can ignore the catalogue settings for Format settings, Export settings and Download settings.

The Format settings, Export settings, and Download settings allow you to create a file with the variation data contained in the catalogue. However, this file does not contain information about whether the data export to Amazon was successful.

You should not change the format in the catalogue’s Format settings. To ensure that the export to the sales channel works, all required settings are already configured when you create a catalogue. If you change the settings, errors might occur during the export.
Note: Product catalogues (Product TYPE Product) are activated for all Amazon accounts by default.

5.1.3. Mapping data fields in the product catalogue

After you have created a catalogue, map the market’s data fields to item data saved in PlentyONE. This chapter describes how you map data fields and what particularities apply for item exports to Amazon.

The market expects product data that cannot be saved in the PlentyONE item menu? Then create a property for this data. Link this property with your variations. The actual values are saved as property values for this property. Is this your first time working with properties? Then read up on the principles of properties first.

Getting to know the catalogue menu for marketplace formats

Availability	Explanation
Navigation	When you open a catalogue, the view Mapping is shown. On the very left is the navigation. Switch to other views of the catalogue. Open the catalogue settings. Use filters that limit the data that is exported. Go back to the list of catalogues. Create a new catalogue.
Toolbar	The toolbar provides actions for the catalogue. For example, save your mappings, restore an older version of the catalogue or hide or show optional marketplace data fields.
Marketplace data field	To the right of the navigation, all data fields available for the market are listed. Mandatory fields are marked with an asterisk (✱). *Tip:* Show or hide optional marketplace data fields in the toolbar. To do so, click on the further actions ().
PlentyONE data fields	On the right side of the catalogue, you map the marketplace data fields to appropriate PlentyONE data fields. In the screenshot above, a few of the fields are already mapped.

Availability

Explanation

Navigation

When you open a catalogue, the view Mapping is shown. On the very left is the navigation.

Switch to other views of the catalogue.
Open the catalogue settings.
Use filters that limit the data that is exported.
Go back to the list of catalogues.
Create a new catalogue.

Toolbar

The toolbar provides actions for the catalogue. For example, save your mappings, restore an older version of the catalogue or hide or show optional marketplace data fields.

Marketplace data field

To the right of the navigation, all data fields available for the market are listed. Mandatory fields are marked with an asterisk (✱).
Tip: Show or hide optional marketplace data fields in the toolbar. To do so, click on the further actions ().

PlentyONE data fields

On the right side of the catalogue, you map the marketplace data fields to appropriate PlentyONE data fields. In the screenshot above, a few of the fields are already mapped.

Mapping catalogue fields:

Go to Data » Catalogues.
Click on the catalogue.
→ The Mapping tab opens.
→ In the left-hand column, the market’s data fields are listed.
Tip: Mandatory fields are flagged with an asterisk (*).
→ In the right column, you map the PlentyONE data fields. Any PlentyONE data fields that you already mapped are also shown in this column.
Map suitable PlentyONE data fields to the market data fields.
For each marketplace data field, you have a number of mapping options. Expand the info boxes below to get more information about each of these mapping options.
- Simple 1:1 mapping
- Simple 1:1 mapping with properties
- Complex 1:1 mapping
- 1:1 mapping with fallback data fields
- 1:n mapping
- Own value mapping
- Mapping with mathematical calculations
Save () the catalogue.
→ The mappings are saved.

Simple 1:1 mapping: 1 marketplace data field, 1 PlentyONE data field

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

As such, simple 1:1 mappings allow you to:

I want to fill this marketplace data field with the data from this PlentyONE setting.
If the data field is empty for a variation, no value is exported for this variation.

Creating a simple 1:1 mapping:

Next to the marketplace data field, click on + Add data field.
→ To the left, the list of available PlentyONE data fields are shown in groups.
Click on the group you need.
→ The PlentyONE data fields of the group are shown.
Click on the plus to the right of the PlentyONE data field you want to select.
→ The PlentyONE data field is added to the right.
Click on Confirm.

Example: Sales price and RRP for Otto Market

This gif shows you how to map the marketplace data fields Sales price and RRP for Otto Market to PlentyONE data fields:

Simple 1:1 mapping: with properties: 1 marketplace data field, no PlentyONE data field

Reminder: In a simple 1:1 mapping, you map a PlentyONE data field to the marketplace data field. However, what can you do if PlentyONE does not offer a suitable data field? Then it’s the properties' moment to shine. Properties allow you to save any kind of information in your properties.

Is this your first time working with properties? Then read up on the principles of properties first.

Creating a property:

Create a property with the necessary values.
Tip: Find out how to do that here.

Creating a simple 1:1 mapping with properties:

Next to the marketplace data field, click on + Add data field.
→ To the left, the list of available PlentyONE data fields are shown in groups.
Expand the group Property.
→ The property groups are shown.
Expand the group you need.
Click on the Plus sign on the right of the property you want.
From the drop-down list Language, select the language in which you send the data to the market.
Click on Confirm.
→ The property is mapped to the marketplace data field.

Complex 1:1 mapping: 1 marketplace data field, 1 PlentyONE data field

Like with the simple 1:1 mappings, you map a PlentyONE setting or property to a marketplace data field. Complex mappings are necessary whenever a marketplace data field has more than one possible value. Instead of mapping data fields, for complex mappings you map individual values of these data fields. For example, you cannot simply map the PlentyONE data field Shipping profile to the marketplace data field Shipping method. Why? The market cannot know which of your shipping profiles in PlentyONE corresponds to which of their shipping methods.

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.

In complex mappings, the value of the market is always exported. Only when you map an own value, the own value that you enter is exported.

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.

Examples for complex 1:1 mappings are:

Categories
Brands
Shipping setting

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

Creating a complex 1:1:n mapping:

Click on the field for the marketplace data field.
→ A list of the available values is shown.
Select the value that you want to map a PlentyONE data field to.
→ The value is mapped.
Next to the marketplace data field, click on + Add data field.
→ To the left, the available PlentyONE data fields are listed in groups.
Click on a group.
→ The PlentyONE data fields of the group are shown.
Click on the PlentyONE data field for which you want to map values.
Important: Do not map own values or properties of the type None.
Your next steps depend on the PlentyONE data field 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 field 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 field.
  - Click on Confirm.
- Alternative 3: The PlentyONE data field 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 field.
    Exception: Only when you map an own value, the own value that you enter is exported.

Example: Delivery time in days for Otto Market

This gif shows you how to map suitable PlentyONE values to the values of the marketplace data fields Delivery time in days for Otto Market:

1:1 mapping with fallback data fields: 1 marketplace data field, 1 PlentyONE data field with alternative(s)

In a 1:1 mapping with one or more fallback data fields, you map a PlentyONE data field to the marketplace data field. In addition, you specify one or more fallback data fields. This ensures that the system keeps looking if the first PlentyONE data field is missing or empty.

So this mapping specifies:

I want to fill the marketplace data field with the data from the selected PlentyONE setting.
If that data field is missing or empty for a variation, the first fallback data field is checked. The value of that fallback data field is exported instead.
If the first fallback data field is also missing or empty for the variation, the second fallback data field is checked. If a value is found, the value of the second fallback data field is exported for the variation etc.

Two separate fallback conditions are available:

Null (default)

The fallback data field is used if the data field above is mapped in the catalogue but not linked to the variation.

The condition "Null" is useful when you want to map fallback data fields for the following types of PlentyONE data fields:

SKU
Barcodes
Sales prices
Properties

Important: When you add a fallback data field, the fallback condition "null" is selected automatically. To apply the fallback condition "leer", you need to change the default setting.

Empty

The fallback data field is used if the data field above is mapped in the catalogue and linked to the variation, but is empty.

The condition "Empty" is useful when you want to map fallback data fields for the following type of PlentyONE data fields:

PlentyONE data fields that are available for variations by default

Important: When you add a fallback data field, the fallback condition "null" is selected automatically. To apply the fallback condition "leer", you need to change the default setting.

Note: Even if you assign one or more fallback data fields, the value of only one of those fields is exported. For each variation, the mapped PlentyONE data fields are checked in the order in which you mapped them. This means that if the first data field does not provide a value for a variation, the first fallback data field is exported etc.

Creating a 1:1 mapping with fallback data fields:

Next to the marketplace data field, click on + Add data field.
→ To the left, the list of available PlentyONE data fields are shown in groups.
Click on the group you need.
→ The PlentyONE data fields of the group are shown.
Click on the plus to the right of the PlentyONE data field you want to select.
→ The PlentyONE data field is added to the right.
In the list of PlentyONE data fields, click on the plus icon next to the PlentyONE data field that you want to map.
→ The fallback data field is added with the fallback condition "null".
Alternative 1: To add the fallback data field with the fallback condition "null":
1. Click on Confirm.
  → The fallback data field is exported if the data field above is not linked to the variation.
Alternative 2: To add the fallback data field with the fallback condition "empty":
1. To the left of the fallback data field, click on the cog ().
  → The window Data column settings is shown.
2. For the setting Fallback condition, select the option Empty.
3. Click on Save.
  → The fallback data field is added with the fallback condition "empty".
4. Click on Confirm.
  → The fallback data field is exported if the data field above is empty for the variation.

Example: Fallback data field for SKU for Otto Market

This GIF shows you the mapping for the OTTO Market marketplace data field SKU. The PlentyONE data field SKU is mapped to this marketplace data field. The PlentyONE data field Variation ID is mapped as the fallback data field. The fallback condition "null" is applied automatically.

Result: The fallback data field Variation ID is exported if the data field SKU is not linked to the variation.

1:n mapping: 1 marketplace data field, several PlentyONE data fields

In a 1:n mapping, you map several PlentyONE data fields to the marketplace data field. You can link these data fields 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:

Next to the marketplace data field, click on + Add data field.
→ To the left, the list of available PlentyONE data fields are shown in groups.
Click on the group you need.
→ The PlentyONE data fields of the group are shown.
Click on the plus to the right of the PlentyONE data field you want to select.
→ The PlentyONE data field is added to the right.
Click on Confirm.
To the right of the mapped PlentyONE data field, click on Add data field ().
→ To the left, the list of available PlentyONE data fields again are shown in groups.
Map one or several additional PlentyONE data fields to the marketplace data field as described above.
Click on Confirm.
To the very right of the row, click on Settings ().
Select a separator from the drop-down list Separator or add a custom separator.
Click on Save.
Save () the catalogue.
→ The mappings are saved.
→ During the export, the content of the PlentyONE data fields is combined and exported as one field.

Own value mapping: 1 marketplace data field, the same value for all variations

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:

For this marketplace data field, I want to export the value that I entered in the field Own value for all variations of this catalogue. The value you enter is always exported. The value overwrites the market value also in complex mappings where usually the value of the market is exported. As such, make sure you enter an own value that the market accepts for this marketplace data field.

Creating an own value mapping:

Next to the marketplace data field, click on + Add data field.
→ To the left, the list of available PlentyONE data fields are shown in groups.
Click on the plus next to Own value at the top of the list.
→ The field for the own value is added to the view.
Enter a value into the input field.
→ This value is exported for all variations.

Example: Diameter information

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 the variations, you can enter the own value cm.

This is an example of how you can map an own value for the diameter unit:

Mapping with mathematical calculations: 1 Marketplace data field, the PlentyONE value is recalculated using the formula during export

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

This function only works for data fields that contain numerical values.
This functionality is new and not available for all catalogue formats.

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.

Recalculating numerical values:

Next to the marketplace data field, click on + Add data field.
→ To the left, the list of available PlentyONE data fields are shown in groups.
At the very top of the list, click on the plus icon next to Formula ().
→ The data field Formula is added to the field on the right.
Click into the data field.
→ The window Modify value is shown.
Enter a numerical value or select a PlentyONE data field at the bottom right of the window to add it to the calculation ().
Tip: Use the search function. This helps you to find data fields quickly.
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 icon .
2. In the window shown, select the assignments from the drop-down list.
3. Save the settings.
Enter numbers and mathematical operators with the on-screen calculator or the keyboard.
Save the settings.
→ The entered formula is displayed in the overview.
→ The calculation will be carried out in the next export.

5.1.4. Particularities for mapping data fields in the product catalogue

Every market structures item data differently. As such, there are some particularities for each market when mapping data fields. This chapter contains mapping information for important data fields for Amazon.

5.1.4.1. Mapping the item name

The item name is mapped in the Amazon product catalogues using the data field Item name (item_name.value) within the group item_name.

Note: If you offer variations of an item on Amazon, use a generic item name that can be used for all variations. A variation’s attributes, such as the colour of a T-shirt, should not be included in the item name. The attributes of a variation will be automatically added by Amazon. More information on variation families on Amazon can be found here.

The following mappings are possible for the item name. Note that the mappings are recommendations only. Depending on how you manage your item data, other mappings may be more appropriate than the recommendations given here.

Item text » Name 1, Name 2, or Name 3
Property of the type Text

Figure 2. Example mapping of item name with fallback data source

5.1.4.2. Mapping bullet points

Use the data field bullet_point in the Amazon product catalogues to add short descriptive texts to your items which will be shown as bullet points next to the product image.

To export multiple bullet points to Amazon, click Add fallback data source and add more bullet points. Those bullet points are not treated as a fallback data source, but also exported to Amazon and listed as bullet points.

5.1.4.3. Exporting an image list

You can export a list of item or variation images to Amazon via the data field main_product_image_locator. To do this, map the image list as follows:

Image » Variation images » Image list, image information Full image URL
or
Image » Item images » Image list, image information Full image URL
Under Maximum number of images, enter the number of images you want to export from the image list.

The image URLs from the image list are automatically mapped to the next available data fields other_product_image_locator_1 to other_product_image_locator_8.

Example: The image list is mapped to the data field main_product_image_locator and contains three images:

The URL of the first image is mapped to the data field main_product_image_locator,
the URL of the second image to other_product_image_locator_1,
the URL of the third image to other_product_image_locator_2.

Note: If a subsequent data field is already mapped, this data field is skipped. The image URL is then mapped to the next available empty other_product_image_locator data field instead.
Important: Only as many images are mapped as the number of available following other_product_image_locator data fields. Excess images from the image list are not added.
Tip: If you map another image list in the fallback data source in addition to the image list in the main data source, both image lists are combined into a single list. From this combined list, as many images are transferred to Amazon as the number of available following other_product_image_locator data fields in the catalogue. Excess images are not transferred.
Single images from the fallback data source are not combined with the image list from the main data source. They are only transferred if no mapped single image or image list is found in the main data source.

5.1.4.4. Linking categories

You can map suitable Amazon browse categories to your items using the recommended_browse_nodes data field. This ensures your items appear in the relevant category when customers browse this category on Amazon.
If you don’t map this data field, the category links from the menu Setup » Markets » Amazon » Category link will be used for your item instead.
Note: Browse categories are mapped using so-called Browse Node IDs. Each category path has its own unique Browse Node ID. You can find an up-to-date list of these IDs in the Browse Tree Guides (BTG) in the Amazon Seller Central.
For data field mapping in the product catalogue, we recommend creating a property of the type Selection for browse categories. Add the required Browse Node IDs as individual selection values.

5.1.4.5. Mapping variation themes

With variation themes, you can display multiple product variations, such as different sizes or colours, on a single product detail page. This allows your customers to see all the available options at a glance. The variation themes available depend on the respective product category.

You map variation themes in the data field group variation_theme as follows:

Mapping a single variation theme
Mapping a combination of variation themes

Mapping a single variation theme:

Go to Data » Catalogues.
Open the product catalogue for Amazon.
Scroll to the data field group variation_theme.
For the data field Variation Theme Name, select the appropriate variation theme from the drop-down list under Export as.
Example: COLOUR_NAME
Note: After selecting the variation theme, the field Export as may display a different label. This is normal. The options in the drop-down list are primarily for better orientation and usually show a translation of the actual value. The data field displays the actual value transmitted.
Click Add data source.
Select the appropriate attribute with the addition is linked.
Example: Attribute » Colour » Attribute Colour is linked.
Note: The selected variation theme is only transmitted if the corresponding attribute is linked to your variation.
Save () your settings.

Note that you must also link the data fields in the product catalogue that correspond to the variation theme so that the data can be transferred to Amazon. For example, if you use the variation them COLOUR_NAME, then you also have to map the data field for COLOUR.

You can also select a combination of variation themes. These are indicated by a forward slash separating the individual themes.
Example: COLOUR_NAME/SIZE_NAME

Mapping a combination of variation themes:

Go to Data » Catalogues.
Open the product catalogue for Amazon.
Scroll to the data field group variation_theme.
For the data field Variation Theme Name, select the appropriate combination of variation themes from the drop-down list under Export as.
Example: COLOUR_NAME/SIZE_NAME
Note: After selecting the variation theme, the field Export as may display a different label. This is normal. The options in the drop-down list are primarily for better orientation and usually show a translation of the actual value. The data field displays the actual value transmitted.
Click Add data source.
Select the appropriate attribute with the addition is linked for the first variation theme.
Example: Attribute » Colour » Attribute Colour is linked for COLOUR_NAME.
Click Add data source.
Select the appropriate attribute with the addition is linked for the second variation theme.
Example: Attribute » Size » Attribute Size is linked for SIZE_NAME.
Repeat steps 7–8 for all other variation themes in the combination.
Important:
- The combination of variation themes is only transmitted if all attributes are linked to the variation.
- Do not add the second and all subsequent attributes via Add fallback data source.
Save () your settings.

Amazon variation theme combination mapped en

Note that you must also link the data fields in the product catalogue that correspond to the variation theme so that the data can be transferred to Amazon. For example, if you use the variation themes COLOUR_NAME and SIZE_NAME, then you also have to map the data fields for COLOUR and SIZE.

5.1.5. Activating the catalogue export

Deactivate export categories in the Amazon item settings

To prevent conflicts with the old flatfile export and/or the adapter, we recommend to deactivate the respective Amazon product type in the Setup » Markets » Amazon » [Open account] » Settings » Tab: Item settings menu in the section Export categories.

You have set up Amazon in PlentyONE and created a catalogue for exporting your item data? Then start the export of your item data. To do so, activate the catalogues which should be exported to Amazon in the Data » Catalogues menu.

Activating the catalogue export to Amazon:

Go to Data » Catalogues.
→ The catalogues are listed.
Scroll to the Amazon catalogue.
In the Active column, move the toggle button to the right ().
→ The catalogue is active.
→ The catalogue data is exported to Amazon once a day.
Tip: In the chapter Retrieving (error) reports you can find information on where to access export reports for Amazon. Note that reports for test mode and for live export are located in different menus.

5.2. Creating an offer catalogue

Offer data is exported to Amazon using catalogues. To export your items to Amazon, create an offer catalogue in the Data » Catalogue menu. Afterwards, link the Amazon data fields with item data saved in PlentyONE in the catalogue.
After you activate the offer catalogue, the catalogue data is automatically exported to Amazon within 15 minutes after a value has been changed on the variation.

Creating a catalogue:

Go to Data » Catalogues.
Click on Create catalogue ().
Enter a name for the catalogue.
In the drop-down list Marketplace, select the option Amazon.
In the drop-down list Export type, select the option Listing.
In the drop-down list Amazon Account, select the Amazon account for which the catalogue is to be created.
In the drop-down list Sales Channel, select the Amazon platform.
In the drop-down list Category, select Offer.
Save () the settings.
→ The catalogue is created.
→ The catalogue is opened for editing.

Other catalogue settings

5.2.1. Mapping data fields in the offer catalogue

Not all mandatory fields are marked in the offer catalogue

At the moment, not all mandatory fields and dependencies between data fields can be displayed in the offer catalogue for Amazon.

The market expects product data that cannot be saved in the PlentyONE item menu? Then create a property for this data. Link this property with your variations. The actual values are saved as property values for this property. Is this your first time working with properties? Then read up on the principles of properties first.

Getting to know the catalogue menu for marketplace formats

Availability	Explanation
Navigation	When you open a catalogue, the view Mapping is shown. On the very left is the navigation. Switch to other views of the catalogue. Open the catalogue settings. Use filters that limit the data that is exported. Go back to the list of catalogues. Create a new catalogue.
Toolbar	The toolbar provides actions for the catalogue. For example, save your mappings, restore an older version of the catalogue or hide or show optional marketplace data fields.
Marketplace data field	To the right of the navigation, all data fields available for the market are listed. Mandatory fields are marked with an asterisk (✱). *Tip:* Show or hide optional marketplace data fields in the toolbar. To do so, click on the further actions ().
PlentyONE data fields	On the right side of the catalogue, you map the marketplace data fields to appropriate PlentyONE data fields. In the screenshot above, a few of the fields are already mapped.

Availability

Explanation

Navigation

When you open a catalogue, the view Mapping is shown. On the very left is the navigation.

Switch to other views of the catalogue.
Open the catalogue settings.
Use filters that limit the data that is exported.
Go back to the list of catalogues.
Create a new catalogue.

Toolbar

The toolbar provides actions for the catalogue. For example, save your mappings, restore an older version of the catalogue or hide or show optional marketplace data fields.

Marketplace data field

PlentyONE data fields

On the right side of the catalogue, you map the marketplace data fields to appropriate PlentyONE data fields. In the screenshot above, a few of the fields are already mapped.

Mapping catalogue fields:

Go to Data » Catalogues.
Click on the catalogue.
→ The Mapping tab opens.
→ In the left-hand column, the market’s data fields are listed.
Tip: Mandatory fields are flagged with an asterisk (*).
→ In the right column, you map the PlentyONE data fields. Any PlentyONE data fields that you already mapped are also shown in this column.
Map suitable PlentyONE data fields to the market data fields.
For each marketplace data field, you have a number of mapping options. Expand the info boxes below to get more information about each of these mapping options.
- Simple 1:1 mapping
- Simple 1:1 mapping with properties
- Complex 1:1 mapping
- 1:1 mapping with fallback data fields
- 1:n mapping
- Own value mapping
- Mapping with mathematical calculations
Save () the catalogue.
→ The mappings are saved.

Simple 1:1 mapping: 1 marketplace data field, 1 PlentyONE data field

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

As such, simple 1:1 mappings allow you to:

I want to fill this marketplace data field with the data from this PlentyONE setting.
If the data field is empty for a variation, no value is exported for this variation.

Creating a simple 1:1 mapping:

Next to the marketplace data field, click on + Add data field.
→ To the left, the list of available PlentyONE data fields are shown in groups.
Click on the group you need.
→ The PlentyONE data fields of the group are shown.
Click on the plus to the right of the PlentyONE data field you want to select.
→ The PlentyONE data field is added to the right.
Click on Confirm.

Example: Sales price and RRP for Otto Market

This gif shows you how to map the marketplace data fields Sales price and RRP for Otto Market to PlentyONE data fields:

Simple 1:1 mapping: with properties: 1 marketplace data field, no PlentyONE data field

Is this your first time working with properties? Then read up on the principles of properties first.

Creating a property:

Create a property with the necessary values.
Tip: Find out how to do that here.

Creating a simple 1:1 mapping with properties:

Next to the marketplace data field, click on + Add data field.
→ To the left, the list of available PlentyONE data fields are shown in groups.
Expand the group Property.
→ The property groups are shown.
Expand the group you need.
Click on the Plus sign on the right of the property you want.
From the drop-down list Language, select the language in which you send the data to the market.
Click on Confirm.
→ The property is mapped to the marketplace data field.

Complex 1:1 mapping: 1 marketplace data field, 1 PlentyONE data field

In complex mappings, the value of the market is always exported. Only when you map an own value, the own value that you enter is exported.

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.

Examples for complex 1:1 mappings are:

Categories
Brands
Shipping setting

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

Creating a complex 1:1:n mapping:

Click on the field for the marketplace data field.
→ A list of the available values is shown.
Select the value that you want to map a PlentyONE data field to.
→ The value is mapped.
Next to the marketplace data field, click on + Add data field.
→ To the left, the available PlentyONE data fields are listed in groups.
Click on a group.
→ The PlentyONE data fields of the group are shown.
Click on the PlentyONE data field for which you want to map values.
Important: Do not map own values or properties of the type None.
Your next steps depend on the PlentyONE data field 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 field 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 field.
  - Click on Confirm.
- Alternative 3: The PlentyONE data field 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 field.
    Exception: Only when you map an own value, the own value that you enter is exported.

Example: Delivery time in days for Otto Market

This gif shows you how to map suitable PlentyONE values to the values of the marketplace data fields Delivery time in days for Otto Market:

1:1 mapping with fallback data fields: 1 marketplace data field, 1 PlentyONE data field with alternative(s)

So this mapping specifies:

I want to fill the marketplace data field with the data from the selected PlentyONE setting.
If that data field is missing or empty for a variation, the first fallback data field is checked. The value of that fallback data field is exported instead.
If the first fallback data field is also missing or empty for the variation, the second fallback data field is checked. If a value is found, the value of the second fallback data field is exported for the variation etc.

Two separate fallback conditions are available:

Null (default)

The fallback data field is used if the data field above is mapped in the catalogue but not linked to the variation.

The condition "Null" is useful when you want to map fallback data fields for the following types of PlentyONE data fields:

SKU
Barcodes
Sales prices
Properties

Important: When you add a fallback data field, the fallback condition "null" is selected automatically. To apply the fallback condition "leer", you need to change the default setting.

Empty

The fallback data field is used if the data field above is mapped in the catalogue and linked to the variation, but is empty.

The condition "Empty" is useful when you want to map fallback data fields for the following type of PlentyONE data fields:

PlentyONE data fields that are available for variations by default

Important: When you add a fallback data field, the fallback condition "null" is selected automatically. To apply the fallback condition "leer", you need to change the default setting.

Creating a 1:1 mapping with fallback data fields:

Next to the marketplace data field, click on + Add data field.
→ To the left, the list of available PlentyONE data fields are shown in groups.
Click on the group you need.
→ The PlentyONE data fields of the group are shown.
Click on the plus to the right of the PlentyONE data field you want to select.
→ The PlentyONE data field is added to the right.
In the list of PlentyONE data fields, click on the plus icon next to the PlentyONE data field that you want to map.
→ The fallback data field is added with the fallback condition "null".
Alternative 1: To add the fallback data field with the fallback condition "null":
1. Click on Confirm.
  → The fallback data field is exported if the data field above is not linked to the variation.
Alternative 2: To add the fallback data field with the fallback condition "empty":
1. To the left of the fallback data field, click on the cog ().
  → The window Data column settings is shown.
2. For the setting Fallback condition, select the option Empty.
3. Click on Save.
  → The fallback data field is added with the fallback condition "empty".
4. Click on Confirm.
  → The fallback data field is exported if the data field above is empty for the variation.

Example: Fallback data field for SKU for Otto Market

Result: The fallback data field Variation ID is exported if the data field SKU is not linked to the variation.

1:n mapping: 1 marketplace data field, several PlentyONE data fields

In a 1:n mapping, you map several PlentyONE data fields to the marketplace data field. You can link these data fields 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:

Next to the marketplace data field, click on + Add data field.
→ To the left, the list of available PlentyONE data fields are shown in groups.
Click on the group you need.
→ The PlentyONE data fields of the group are shown.
Click on the plus to the right of the PlentyONE data field you want to select.
→ The PlentyONE data field is added to the right.
Click on Confirm.
To the right of the mapped PlentyONE data field, click on Add data field ().
→ To the left, the list of available PlentyONE data fields again are shown in groups.
Map one or several additional PlentyONE data fields to the marketplace data field as described above.
Click on Confirm.
To the very right of the row, click on Settings ().
Select a separator from the drop-down list Separator or add a custom separator.
Click on Save.
Save () the catalogue.
→ The mappings are saved.
→ During the export, the content of the PlentyONE data fields is combined and exported as one field.

Own value mapping: 1 marketplace data field, the same value for all variations

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:

For this marketplace data field, I want to export the value that I entered in the field Own value for all variations of this catalogue. The value you enter is always exported. The value overwrites the market value also in complex mappings where usually the value of the market is exported. As such, make sure you enter an own value that the market accepts for this marketplace data field.

Creating an own value mapping:

Next to the marketplace data field, click on + Add data field.
→ To the left, the list of available PlentyONE data fields are shown in groups.
Click on the plus next to Own value at the top of the list.
→ The field for the own value is added to the view.
Enter a value into the input field.
→ This value is exported for all variations.

Example: Diameter information

This is an example of how you can map an own value for the diameter unit:

Mapping with mathematical calculations: 1 Marketplace data field, the PlentyONE value is recalculated using the formula during export

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

This function only works for data fields that contain numerical values.
This functionality is new and not available for all catalogue formats.

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.

Recalculating numerical values:

Next to the marketplace data field, click on + Add data field.
→ To the left, the list of available PlentyONE data fields are shown in groups.
At the very top of the list, click on the plus icon next to Formula ().
→ The data field Formula is added to the field on the right.
Click into the data field.
→ The window Modify value is shown.
Enter a numerical value or select a PlentyONE data field at the bottom right of the window to add it to the calculation ().
Tip: Use the search function. This helps you to find data fields quickly.
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 icon .
2. In the window shown, select the assignments from the drop-down list.
3. Save the settings.
Enter numbers and mathematical operators with the on-screen calculator or the keyboard.
Save the settings.
→ The entered formula is displayed in the overview.
→ The calculation will be carried out in the next export.

5.2.2. Particularities for mapping data fields in the offer catalogue

5.2.2.1. Behaviour of unassigned data fields in the offer catalogue

With the setting Delete data fields that are not mapped in the offer catalogue for Amazon, you can define whether data fields that are not mapped in the offer catalogue should be exported to Amazon as “Delete”. If you activate this setting, then all data fields that are not mapped will be deleted on Amazon.

Note: This setting is deactivated by default.

5.2.2.2. Deleting mappings for complex data fields in the Amazon offer catalogue

Some data fields with complex mappings in the Amazon offer catalogue have to be mapped with an empty own value to delete the data on Amazon.

List of data fields

The following data fields with complex mappings in the Amazon offer catalogue have to be mapped with an empty own value to delete the data on Amazon.

Table 3. Data fields which have to be mapped with an empty own value
Group	Data field
epr_product_packaging	EPR Product Packaging Main Material
externally_assigned_product_identifier	External Product ID Type
ghs_chemical_h_code	GHS Chemical H Code
hazmat	Hazmat Aspect
merchant_suggested_asin	Merchant Suggested ASIN
num_batteries	Battery Type
purchasable_offer	Audience
uvp_list_price	UVP List Price Currency

Do not delete data field mappings

For the data fields listed above, the mapped value of the complex mapping in the Export as field must not be deleted. Otherwise, Amazon will not know which data should be deleted. For these data fields, you have to map an empty own value to delete the data on Amazon.
It does not suffice to not map the data field - it is mandatory to map an empty own value.

An example of how to map the data field EPR Product Packaging Main Material in the group epr_product_packaging with an empty own value is provided below. This data field will then be exported to Amazon as “Delete”.

Mapping an empty own value:

Go to Data » Catalogues.
Open the offer catalogue for Amazon.
Expand the group epr_product_packaging ().
Navigate to the data field EPR Product Packaging Main Material.
Note: The value within the field Export as has to be mapped and must not be deleted. Otherwise, Amazon will not know which data to delete.
Click Add data source.
Add the data source Own value (). Leave the field Value empty.
Save the settings.
→ The data field will be deleted on Amazon during the next export.

Figure 3. Example of a mapping with empty own value

5.2.2.3. Mapping the target group

Use the data field Audience in the Amazon offer catalogue to define a target group for the catalogue. The data field Audience can be mapped in the following groups within the offer catalogue:

purchasable_offer (offer for all customers on Amazon)
purchasable_offer_fba (offer for all customers on Amazon with FBA)
purchasable_offer_mfn_b2b (offer for Amazon Business customers / B2B)
purchasable_offer_fba_b2b (offer for Amazon Business customers / B2B with FBA)

Note: These data fields are automatically mapped with the correct values.

The following values are pre-mapped:

The data fields purchasable_offer_mfn_b2b and purchasable_offer_fba_b2b are mapped with this value:
- Own value with the value B2B
The data fields purchasable_offer und purchasable_offer_fba are mapped with this value:
- Own value with the value ALL

5.2.2.4. Mapping the manufacturing country

The data field Country of origin within the group country_of_origin in the Amazon offer catalogue indicates the manufacturing country of an item. You can use the following data sources to map the manufacturing country:

Map the Manufacturing country ID.

Map the Manufacturing country ISO-code.

Note: PlentyONE recommends to map the Manufacturing country ID, as this mapping is less prone to errors.

Mapping the manufacturing country ID
Mapping the manufacturing country ISO code

Mapping the manufacturing country ID:

Go to Data » Catalogues.
Open the offer catalogue for Amazon.
Expand the group country_of_origin ().
In the field Export as, select the manufacturing country from the drop-down list.
Click add Add data source and add the data source Item » Manufacturing country ID.
→ The data source Manufacturing country ID is added.
Enter the ID of the manufacturing country as Comparative value for Manufacturing country ID, for example 12 for the United Kingdom.
Tip: Use the country IDs in PlentyONE. The list of PlentyONE country IDs is available here.
Save () the settings.

Figure 4. Example mapping of a manufacturing country ID with the United Kingdom as country of origin

Mapping the manufacturing country ISO code:

Go to Data » Catalogues.
Open the offer catalogue for Amazon.
Expand the group country_of_origin ().
In the field Export as, select the manufacturing country from the drop-down list.
Click add Add data source and add the data source Item » Manufacturing country ISO-code.
→ The data source Manufacturing country ISO-code is added.
Enter the ISO code of the manufacturing country as Comparative value for Manufacturing country ISO-code, for example GB for the United Kingdom.
Save () the settings.

Figure 5. Example mapping of a manufacturing country ISO code with the United Kingdom as country of origin

5.2.3. Deactivating the creation of new offers on Amazon

In the offer catalogues for Amazon, you can define that existing offers on Amazon should only be updated and no new offers should be created on Amazon. This is done with the setting Deactivate creation of new offers (existing offers will continue to be updated) in the settings of an offer catalogue. This setting must be activated or deactivated separately for each offer catalogue.
Note: This setting is deactivated by default.

If you activate the setting Deactivate creation of new offers (existing offers will continue to be updated) in an offer catalogue, then no new offers will be created on Amazon. This means that if your offer catalogue contains an offer which does not yet exist on Amazon, the offer will not be created, even if the offer catalogue is activated.

Deactivating the creation of new offers on Amazon:

Go to Data » Catalogues.
Open the offer catalogue for Amazon (export type Listing).
Open the settings Settings tab of the catalogue.
Check the setting Deactivate creation of new offers (existing offers will continue to be updated.
- If offers should only be updated on Amazon and no new offers should be created, then this setting must be activated.
- If new offers should be created on Amazon, this setting must be deactivated.
Save () the settings.

Price and stock updates are not affected

The processes for updating prices and stock (the settings Price changes and Stock changes in the Setup » Markets » Amazon » [Open account] » Settings » Tab: Item settings menu) are not affected by the setting for deactivating the creation of new offers on Amazon. If those settings are activated, then prices and stock will continue to be updated on Amazon.

5.2.4. Activating the offer export

Activating the catalogue export to Amazon:

Go to Data » Catalogues.
→ The catalogues are listed.
Scroll to the Amazon catalogue.
In the Active column, move the toggle button to the right ().
→ The catalogue is active.
→ The catalogue data is exported to Amazon 15 minutes after the price change at a variation.
Tip: In the chapter Retrieving (error) reports you can find information on where to access export reports for Amazon. Note that reports for test mode and for live export are located in different menus.

6. Creating a preview of the export data

Once you have created a catalogue for Amazon and mapped the data fields in the catalogue, you can create and download a preview of the export data. You have the option of narrowing down the displayed export data with filters.

Important: The filters only affect the preview of the export data and have no influence on the actual catalogue export to Amazon.

Applying filters for the preview:

Go to Data » Catalogues.
Open the catalogue for Amazon.
Open the Filter tab in the navigation bar on the left.
In the Custom filters section, select the desired filters from the Select filter drop-down list.
Click Add filter. The available filters are explained in Table 4.
→ The filter is added.
Depending on the filter, enter the desired IDs or select options from the drop-down list.
Save () the settings.

Table 4. Filters for the preview of the export data
Filter	Explanation
Variation IDs	Enter one or more Variation IDs to filter for items with this variation ID. Separate multiple IDs using commas.
Item IDs	Enter one or more Item IDs to filter for items with this item ID. Separate multiple IDs using commas.
Has tags	Select one or more tags from the drop-down list to filter for items with this tag.
Without tags	Select one or more tags from the drop-down list to filter for variations without this tag.

Creating and downloading a preview of the export data:

Go to Data » Catalogues.
Open the catalogue for Amazon.
In the toolbar at the top, click Preview ().
→ A window with the preview of the export data opens.
Optional: Click Download () in the preview window to save the preview as a file.
→ The preview of the export data is downloaded.

7. Testing the catalogue export

After you have created a catalogue for Amazon and mapped the data fields in the catalogue, you can test the catalogue export. To do so, open the catalogue’s settings.
After testing the export you can check the reports in the menus Setup » Markets » Amazon » Data exchange » Data export and Data » Log to identify why a catalogue was not accepted by Amazon and if you need to map more data fields in the catalogue.

Note: However, note that the test mode only includes a technical validation and no content check.

Prerequisites

The new product type for the variation is linked at item level in the menu Item » Items » [Open item] » Section: Amazon.
For product catalogues:
- You have added the Amazon product types for which you want to create product catalogues under Setup » Markets » Amazon » Add catalogue templates.
- You have created a product catalogue for the corresponding product type.
- You have mapped the data fields in the product catalogue.
For offer catalogues:
- You have created an offer catalogue.
- You have mapped the data fields in the offer catalogue.

Testing the catalogue export:

Go to Data » Catalogues.
Open the catalogue for Amazon.
Open the Settings tab in the navigation bar on the left.
Activate the option Test mode in the section Amazon settings.
Save () the settings.
Go to Data » Catalogues.
→ The catalogues are listed.
Scroll to the Amazon catalogue.
In the Active column, move the toggle button to the right ().
→ The catalogue is active.
→ A test export is sent to Amazon within 15 minutes. The test export includes all updates since the last export.

You can view and download the reports for the test export in either of these menus:

In the menu Setup » Markets » Amazon » Data exchange » Data export » Section: Reports for catalogue export.
In the menu Data » Log.
- Search for the integration Plenty\\Modules\\Amazon\\Item\\Listings\\Services\\HTTPDataSenderService and the identifier DataSenderService.

8. Manually exporting catalogues

In the Setup » Markets » Amazon » Data exchange » Data export menu, you can manually export product catalogues and offer catalogues to Amazon. This can be helpful if you have created a new catalogue which you want to export to Amazon immediately without having to wait for the automatic offer or product export.

Note: The same catalogue can only be exported every 5 minutes.

Manually exporting a catalogue:

Go to Setup » Markets » Amazon » Data exchange » Data export.
In the section Export catalogue to Amazon, select the catalogue that should be exported to Amazon from the drop-down list. You can export product catalogues and offer catalogues.
If you want to export an offer catalogue, then select from the drop-down list Export type (offer) whether you want to create offers or update existing offers.
Note: If you want to export a product catalogue, then do not select anything here. Products are always created and updated automatically.
Click Export catalogue (settings_b_roll).
→ The catalogue is exported to Amazon.

9. Temporary solution: The adapter

The adapter facilitates an automated transition from the old item data export using flatfiles to the new item data export using catalogues. Hence, the adapter acts as a “bridge” between the old flatfile logic and the new catalogue export in order to facilitate a gradual migration to the new catalogue-based Amazon integration.

The adapter only serves as a temporary solution

The adapter solution is only a temporary option for transitioning to product catalogues. It allows you more time to create properties for your characteristics, since catalogues do not support characteristics.
We therefore recommend that you no longer use the adapter solution and switch to product catalogues instead.

What is the adapter?

The adapter’s purpose is to correctly transfer item data to Amazon without having to immediately transfer all characteristics and free text fields into properties. Thus, the adapter can serve as a temporary solution if you cannot directly switch to the catalogue export, for example if you still use many characteristics and free text fields.

Important: The adapter only transfers item data, but not offer data. To export offer data, you additionally have to create an offer catalogue. Hence, the adapter can serve as a replacement for the product data catalogue. As the adapter only serves as a temporary solution, we highly recommend to create product catalogues for Amazon instead.

You only need to employ the adapter if you export item data to Amazon via PlentyONE; hence, if you selected Yes for the setting Item export in the Setup » Markets » Amazon » Settings » Tab: Item Settings menu. If you do not export item data to Amazon via PlentyONE, then you do not have to employ the adapter.

9.1. Working with the adapter

There is no separate menu for the adapter in PlentyONE and you do not have to carry out any specific settings in order to use the adapter. The adapter’s functions can be found in the Setup » Markets » Amazon » Data exchange » Data export menu within the sections Item export - Adapter and Processing results of item export via the adapter. Here you can download error reports on the item data export and you can start a manual item data export.

With the adapter, item data is export to Amazon once per day. In addition, you can trigger a manual export. A CSV file is generated after every export. This CSV file contains errors which occurred during the export.

Activating the adapter for productive use

Until now, the adapter has only been available in validation mode. In validation mode, item data is not sent to Amazon’s productive environment, but is still transmitted in parallel via flat files. This allows you to test your adapter settings safely and without risk.
You can now activate the adapter for productive use via the checkbox Activating the item export via the adapter (without test mode) in the Setup » Markets » Amazon » Data exchange » Data export menu. Once activated, your item data will be exported to Amazon’s productive environment via the adapter if you have not created any product catalogues yet. Parallel flat file transfer will no longer take place.
Note: You can switch between validation mode and productive mode at any time using the checkbox Activating the item export via the adapter (without test mode).
Important: Make sure to activate the adapter for productive use before Amazon disables the interface for flat files.

9.1.1. Manually exporting item data

In the Setup » Markets » Amazon » Data exchange » Data export menu, you can manually export item data using the adapter. This can be useful if you have updated your items or if you have created new items.

Manually exporting item data:

Go to Setup » Markets » Amazon » Data exchange » Data export.
In the section Item export - Adapter, click on Start export ().
→ The item data is exported to Amazon.

After the export was carried out, you can download a CSV file with the exported items. This file is available in the section Processing results of item export via the adapter. This file contains errors that occurred during the export.

9.1.2. Linking properties with Amazon

Properties that you want to export to Amazon using the adapter are linked with Amazon in the Setup » Settings » Properties » Configuration menu.

The properties in PlentyONE still contain the old Amazon product types. The error reports, which are generated by Amazon, already contain the new product types. Click here for an overview of old and new product types.

Linking properties with Amazon:

Go to Setup » Settings » Properties » Configuration.
In the Amazon area, click on Add link.
Select the Amazon platform.
Select the category (= the Amazon product type).
Note: The old Amazon product types are displayed in PlentyONE.
Select the field.
Example: If the error report shows “Bullet point is missing”, then select the field bullet_point.
Save () the settings.

Only properties that are linked with Amazon in the Setup » Settings » Properties » Configuration menu are exported via the adapter.

You can still link fields (= attributes) that are used in the old flatfiles. The old fields will automatically be matched with the new fields during the export.
Further information on the new fields (=attributes) is available here.

9.1.3. Exporting variation themes using the adapter

If you are using the adapter, you must create a property for variation themes so that the information can be correctly transmitted to Amazon. To do this, proceed as follows:

Create a new property in the menu Setup » Settings » Properties » Configuration.
- In the drop-down list Section, select the option Items.
- In the drop-down list Type, select the option Selection.
- In the Name field, enter a unique name, for example Amazon variation themes.
Link the property with Amazon.
- Add links for all Categories (= the Amazon product types) for which you want to use variation themes.
Save () the settings.
→ The Selection values section appears under the Names section.
Add selection values for the property.
- Enter the exact name of the valid values for the variation theme on Amazon as the Name for each selection value.
  Important: The variation theme will only be transferred correctly to Amazon if the name of the selection value exactly matches the name of the valid value.
  Tip: You do not need to add all possible valid values for a variation theme as selection values. Just create selection values for the values you actually use for your variation themes.
Save () the settings.

Where can I find the valid values for the variation theme?

You can find the valid values in your reports within Amazon Seller Central.

Log into Amazon Seller Central.
Go to Reports » Inventory Reports.
Select the report type Category Listings Report from the drop-down list Select Report Type.
Open the inventory report for the respective category.
Switch to the Valid Values tab.
Scroll to the Variations section.
- In the first column, you will find the variation theme name, for example Variation theme name - [ FIDGET_TOY ].
- The adjacent columns contain the valid values that you must enter as selection values for the property in PlentyONE, for example NUMBER_OF_ITEMS and MATERIAL/STYLE.
  Note: Do not use any values marked as (Deprecated: Do not use).

9.2. Adapter: Troubleshooting

In this chapter, you will learn how to interpret the error reports for the item data export and how you can adjust your items so that they will be accepted by Amazon.

9.2.1. Understanding the error reports

Amazon generates a CSV file which contains errors after each item export via the adapter. Those error reports help you to adjust your items.

The file is saved in the section Processing results of item export via the adapter in the Setup » Markets » Amazon » Data exchange » Data export menu.
If the file is empty or if no file was generated after the export, then no errors occurred during the export.
The file contains errors of individual SKUs or missing attributes, for example “Bullet point is missing”. If information is missing (for example bullet points), then you have to create a property for the missing information and link the property with Amazon.

9.2.2. Troubleshooting tips

If the error report shows that an attribute is missing, then you can follow these steps to adjust your item:

Step 1: Check whether the property exists in your PlentyONE system.

Is the property available in the Setup » Settings » Properties » Configuration menu?
If the property does not exist: Create the property and link the property with the respective items.

Step 2: Check whether the property is linked with the item.

Is the property linked with the item in the Item » Items » [Open item] » [Open variation] menu?
If the property is not linked: Link the property with the respective items.

Step 3: Check whether the property’s content is correct.

Does the property in the Setup » Settings » Properties » Configuration menu meet the requirements by Amazon?
If the property does not meet Amazon’s requirements, then adjust the property.

10. Retrieving (error) reports

Events in your system are logged in (error) reports. If something does not work as expected, you can use these reports to identify the issue yourself without relying on our support.
Depending on the process you are using (catalogue export, item export via the adapter or updating prices and stock) and whether you are working in test mode, the (error) reports are located in different menus.

Table 5 provides an overview of where to find each (error) report:

Table 5. Overview of available (error) reports
Process	Test mode activated?	(Error) reports
Catalogue export	yes	CSV file in the menu Setup » Markets » Amazon » Data exchange » Data export » Section: Reports for catalogue export
Export of a newly created offer catalogue	no	Feed request and feed submission result in the menu Setup » Markets » Amazon » Feeds Use the filter Feed type and select the option Common listing feed Also use the filter Process type and select the option Offer catalogue create. *Note:* Here you can find more information on Amazon feeds.
Offer catalogue update (including price update)	no	Feed request and feed submission result in the menu Setup » Markets » Amazon » Feeds Use the filter Feed type and select the option Common listing feed Also use the filter Process type and select one of the options Stock update or Offer catalogue update. *Note:* Here you can find more information on Amazon feeds.
Product catalogue export	no	CSV file in the menu Setup » Markets » Amazon » Data exchange » Data export » Section: Reports for catalogue export
Item export via adapter	yes	CSV file in the section Processing results of item export via the adapter in the Setup » Markets » Amazon » Data exchange » Data export menu
Item export via adapter	no	CSV file in the section Processing results of item export via the adapter in the Setup » Markets » Amazon » Data exchange » Data export menu
Price update (without catalogue)	no	Feed request and feed submission result in the menu Setup » Markets » Amazon » Feeds Use the filter Feed type and select the option Common listing feed. Also use the filter Process type and select the option Price update. *Note:* Here you can find more information on Amazon feeds.
Stock update	no	Feed request and feed submission result in the menu Setup » Markets » Amazon » Feeds Use the filter Feed type and select the option Common listing feed. Also use the filter Process type and select the options Stock update and Stock update on catalogue export. *Note:* Here you can find more information on Amazon feeds.

11. FAQ for the new Amazon integration

11.1. Catalogue

What settings do I need to configure to create an offer on Amazon?

Item settings in the menu Item » Items » [Open item]:

Link product type: Link a current product type for the item In the Amazon section.

Variation settings in the menu Item » Items » [Open variation]:

Activate variation: In the Availability and visibility section, enable the option Active ().
Add order referrer: Add the option Web API and the desired Amazon referrer in the Sales channels section.
Positive net stock: The variation must have a positive net stock in the Stock section.
Consider the Store items export filter: If you have selected Only items visible in online store for the Store items export filter in the Setup » Markets » Amazon » Settings » [Open account] » Tab: Item settings menu, make sure that the variation is also activated for the online store in the Client (store) section.

Optional: If you only want to export variations with certain flags and tags, also configure the following settings:

Select flags: In the menu Setup » Markets » Amazon » Settings » [Open account] » Tab: Item settings » Section: Export filter, select the desired flags from the drop-down lists Flag 1 and/or Flag 2.
Add tags: Add the desired tags from the drop-down list in the Setup » Markets » Amazon » Settings » [Open account] » Tab: Item settings » Section: Export filter menu.

Offer catalogue settings:

Create catalogue: You have created an offer catalogue.
Map data fields: You have mapped the required data fields in the offer catalogue.
Activate catalogue: You have activated the offer catalogue.

Note: The offer catalogue is exported within 15 minutes after a value has been changed on the variation.

What settings do I need to configure to update an offer on Amazon?

Item settings in the menu Item » Items » [Open item]:

Link product type: Link a current product type for the item In the Amazon section.

Variation settings in the menu Item » Items » [Open variation]:

Activate variation: In the Availability and visibility section, enable the option Active ().
Add order referrer: Add the option Web API and the desired Amazon referrer in the Sales channels section.

Price and stock update settings in the menu Setup » Markets » Amazon » Settings » [Open account] » Tab: Item settings:

Activate price updates: Select the option 15 minutes or Hourly for Price changes .
Optional: If you also want to update stock, then select the option 15 minutes or hourly for Stock changes.

Offer catalogue settings:

Create catalogue: You have created an offer catalogue.
Map data fields: You have mapped the required data fields in the offer catalogue.
Activate catalogue: You have activated the offer catalogue.

Note: The updated offer is transmitted to Amazon at the following intervals:

Within 15 minutes if the price of the variation has been changed.

What settings do I need to configure to create or update a product on Amazon?

Item settings in the menu Item » Items » [Open item]:

Link product type: Link the current product type for the item In the Amazon section.

Variation settings in the menu Item » Items » [Open variation]:

Activate variation: In the Availability and visibility section, enable the option Active ().
Add order referrer: Add the option Web API and the desired Amazon referrer in the Sales channels section.

Product catalogue settings:

Add catalogue template: You have added the Amazon product type for which you want to create a product catalogue under Setup » Markets » Amazon » Add catalogue templates.
Create catalogue: You have created a product catalogue for the corresponding product type.
Map data fields: You have mapped the required data fields in the product catalogue.
Activate catalogue: You have activated the offer catalogue.

Note: The product catalogue is exported to Amazon once per day (at night) after a value has been changed on the variation.

How do I map the barcode / EAN / GTIN in the offer catalogue?

The barcode is mapped with the data field External product ID (group: externally_assigned_product_identifier).

There is no data field for mapping stock in the Amazon offer catalogue. How can I transfer stock to Amazon?

There is no data field for stock because stock is not mapped in the offer catalogue.
Instead, stock updates are transferred to Amazon with the setting Stock changes in the Setup » Markets » Amazon » Settings menu. If this setting is activated, the information from this setting is automatically added during the catalogue export.

Which images are mapped in the offer catalogue?

Use the data fields Main Image Location (group: main_offer_image_locator) and Other Image Location (group: other_offer_image_locator_1-5) in the offer catalogue to map offer-specific images, for example if you sell a used item and want to show the item’s condition.
These data fields are not mandatory, but they are recommended if you sell used items.

11.2. Other

I use a third-party tool for repricing which is not integrated in PlentyONE. What do I need to do?

If you use a third-party repricing tool, then go to Setup » Markets » Amazon » Settings and make sure that Never is selected for the setting Price changes and that no price is mapped in the catalogue.

Amazon: Switch to new catalogue-based integration

1. Overview of the catalogue-based Amazon integration

1.1. What is an Amazon listing?

1.2. When do I need product catalogues and offer catalogues?

1.3. Impact on existing business processes

Price update

Stock update

Offer creation

Item creation

1.4. Overview of the transition

Legend for the table:

1.5. Should I use the adapter or create catalogues?

2. Variation Family: Parent products and child products on Amazon

2.1. Overview: parent products and child products on Amazon

2.2. What do I need to consider when offering an item with variations on Amazon?

3. Mandatory attributes for Amazon

3.1. Overview of new Amazon product types

3.2. Check Amazon product types and Amazon platforms

3.3. Check your properties in PlentyONE

4. Creating properties

4.1. Requirements for exporting properties to Amazon

5. Creating catalogues

5.1. Creating product catalogues

5.1.1. Adding Amazon product types

5.1.2. Creating a product catalogue

Other catalogue settings

5.1.3. Mapping data fields in the product catalogue

5.1.4. Particularities for mapping data fields in the product catalogue

5.1.4.1. Mapping the item name

5.1.4.2. Mapping bullet points

5.1.4.3. Exporting an image list

5.1.4.4. Linking categories

5.1.4.5. Mapping variation themes

5.1.5. Activating the catalogue export

5.2. Creating an offer catalogue

Other catalogue settings

5.2.1. Mapping data fields in the offer catalogue

5.2.2. Particularities for mapping data fields in the offer catalogue

5.2.2.1. Behaviour of unassigned data fields in the offer catalogue

5.2.2.2. Deleting mappings for complex data fields in the Amazon offer catalogue

5.2.2.3. Mapping the target group

5.2.2.4. Mapping the manufacturing country

5.2.3. Deactivating the creation of new offers on Amazon

5.2.4. Activating the offer export

6. Creating a preview of the export data

7. Testing the catalogue export

Prerequisites

8. Manually exporting catalogues

9. Temporary solution: The adapter

What is the adapter?

9.1. Working with the adapter

9.1.1. Manually exporting item data

9.1.2. Linking properties with Amazon

9.1.3. Exporting variation themes using the adapter

9.2. Adapter: Troubleshooting

9.2.1. Understanding the error reports

9.2.2. Troubleshooting tips

10. Retrieving (error) reports

11. FAQ for the new Amazon integration

11.1. Catalogue

11.2. Other

Is this page helpful?

Is this page helpful?