If you make changes to static data such as shipping groups (merchant_shipping_group) in your Amazon offer catalogue, these will not be automatically transferred to existing offers on Amazon simply by saving or setting a new timestamp.Once an offer exists on Amazon, an offer create is no longer sent, but an offer update. This update process for existing SKUs is primarily triggered by price changes. To ensure that the changed data fields from the offer catalogue are reliably transmitted to Amazon, a price change must be made to the item.How to trigger the updateTo force the transmission of your adjusted shipping groups or other data fields in the offer catalogue, proceed as follows:Make the desired changes in the offer catalogue or to the linked properties of the variants.Temporarily change the price of the affected variants (a minor change is sufficient) to trigger the offer update call.Check in the menu Setup » Markets » Amazon » Feeds whether the update has been processed.Check the status of the transmissionYou can check the succe...

With the offer catalogue, you link offer-specific images.Linking in the offer catalogueThe following data fields are used to link images in the offer catalogue:Main image location (main_offer_image_locator)Other image location (other_offer_image_locator_1-5)Purpose and mandatory fieldsPurpose: You use these fields to link images that are specific to your offer, e.g. to show the condition of a used item.Mandatory: These data fields are not mandatory fields. However, they are especially recommended for used items.

You link the barcode (EAN/GTIN) in the Amazon product listing catalogue by assigning it to the designated data field.Assignment of the barcodeYou link the barcode with the data field External Product ID (externally_assigned_product_identifier).This field is located in the group externally_assigned_product_identifier.

To create or update a product on Amazon, you need an active product catalogue and the correct settings on the item/variant.Settings on the item/product (in the PlentyONE system)Link product type: Link the current product type for the item in the Amazon section.Activate variant: Activate the Active option (toggle_on) in the Availability and visibility section.Add order origin: Add the Web-API option and the desired Amazon origin in the Sales channels section.Settings for the product catalogueAdd catalogue template: Under Setup » Markets » Amazon » Add catalogue templates, you have added the Amazon product type for which you want to create a product catalogue.Create catalogue: You have created a product catalogue for the corresponding product type in the Data » Catalogues menu.Assign data fields: You have linked the required data fields in the product catalogue.Activate catalogue: You have activated the product catalogue.Note: The product catalogue is exported to Amazon once daily (at night) after a value on the variant has been chan...

To display different product variants (e.g. different sizes or colours) on a shared product detail page, you need to create a property for variation themes and correctly link it with the valid Amazon values when using the adapter.1. Create a property for variation themesYou create a new property in PlentyONE specifically for the Amazon variation themes:Create a new property in the menu Setup » Settings » Properties » Configuration.Select the option Item in the dropdown list Scope.Select the option Selection in the dropdown list Type.Enter a unique name in the field Name, e.g. 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 (save) the settings.After saving, the area for selection values appears under the Name section.2. Add selection values from Amazon Seller CentralThe selection values for the property must exactly match the valid values from Amazon.Add values for the property in the selection values area.Enter the exact ...

Since features and free text fields are no longer supported in the new Amazon catalogs, you need to create corresponding attributes in PlentyONE for all features and free text fields used to describe your items.Steps to create attributesBefore creating attributes, you should check which features you currently use for Amazon and create a separate attribute for each of these features.Open the menu for configuring attributes: Setup » Settings » Attributes » Configuration.Click on the Create Attribute button.Adjust the following settings of the new attribute according to your needs.Save the settings you have made.

After you have determined which Amazon product types and which attributes are mandatory for these, you need to check whether you have already created the corresponding properties in your PlentyONE system.Checking and creating propertiesYou can check the existing properties in the configuration menu:Navigate to: Setup » Settings » Properties » Configuration.Check whether corresponding properties already exist in PlentyONE for all mandatory attributes.Create new properties if these are still missing for the mandatory attributes.

To prepare your PlentyONE system for the switch to Amazon catalogs, you should first check which Amazon product types you use and on which Amazon country platforms you offer your items.Check Amazon product types in PlentyONETo find out which Amazon product types you use in your PlentyONE system, the following options are available to you:Single item check: Open the item in the menu Items » Items and check in the Amazon section which product type is linked there.Filter in the item overview: Open the menu Items » Edit items and use the filter Product type with the selection Type selected. This will show you all used Amazon product types.Amazon flat files: You can also check your Amazon flat files.Determining the mandatory attributesAfter you have determined your used product types and country platforms, you can use the list of mandatory attributes to find out which attributes are mandatory for each product type.Filter tips for the list of mandatory attributesThe list of mandatory attributes is useful for filtering out the attributes ...

As part of the transition to the new Amazon catalogue technology, the Amazon product types have been renamed and some attributes made mandatory. You will find two lists here to help you with the transition.Overview of mandatory attributesYou can download here a list of the mandatory attributes for Amazon, showing which attributes are required for each product type.Structure of the tableThe table "Mandatory Attributes for Amazon" is structured as follows: Column Explanation Product Type The Amazon product type, e.g. ABDOMINAL_EXERCISER, ABIS_BOOK or ACCESSORY. MP The Amazon Marketplace code indicating the Amazon country platform (e.g. DE for amazon.de). Attribute Name The technical name of the attribute at Amazon. Attribute Label A user-friendly label for better understanding of the attribute. Tip: You can filter the table by platform (MP) to display only the attributes that are mandatory for the Amazon platforms you use. Overview of old and new product typesWith the switch to catalogues, the new Amazon product types wil...

With the transition to using catalogues by Amazon, some attributes that were previously optional have become mandatory for certain Amazon product types.Impact of mandatory attributesIf you have not linked these mandatory attributes, you will no longer be able to perform the following actions for the affected product types :You can no longer list new items on Amazon.You can no longer update existing items.Recommended actionTo ensure that your item listings and updates continue to work, we strongly recommend that you check all Amazon product types you use.Make sure that you correctly link the newly mandatory attributes for the product types you use in your system.

If you want to offer a product with variants (parent-child products) on Amazon, you must ensure that you assign the product name correctly and link the variation themes so that your variants are displayed on a common product page.Maintaining the product nameThe product name should be identical for both the parent product and all child products.The name of the child product must not contain any additional attributes (e.g. size 38).Example: If you are selling a T-shirt, both the parent and the child product should be called T-shirt.Amazon automatically displays the correct attributes (such as colour or size) on the product page, provided that the variation themes and related attributes are linked correctly.Linking the product name and variation themesThe linking of the product name and the variation themes takes place in the product catalogue.Product name: You link the product name by using either a property or, for example, the data field product text » name 1.Variation themes: To have your variants in different colours and sizes di...

You use the Parent-Child Structure on Amazon to clearly group different variants of a product. This structure consists of the overarching Parent Product and the individual, purchasable Child Products.The Parent ProductThe Parent Product serves as a placeholder and as a grouping for the various variants of the product.It is not purchasable and is usually shown in the search results list.It itself has no product-specific offer information (e.g. size or colour).Example: A generic T-shirt.The Child ProductA Child Product is a specific variant of the Parent Product and the actual purchasable product.Child Products differ from each other in at least one attribute, such as size or colour.You can assign several Child Products with different specifications to one Parent.Examples: A blue T-shirt in size 40 or a red T-shirt in size 36.The Variation ThemeThe Variation Theme defines how the Child Products differ from each other and thus establishes the relationship between the Parent and the Childs.It describes the attribute in which the varian...

A Variation Family on Amazon is a logical grouping of products that allows customers to compare and select different variations of an item on a single product page.Structure of a Variation FamilyA Variation Family always consists of two elements:Parent Product (Parent Item):Serves as a parent placeholder under which the variants are grouped.The parent product is not purchasable.Child Products (Variants):Are the actual, purchasable products (e.g., a red, green, or blue T-shirt).They are grouped under the parent product.This structure enables customers to view all variants on a single product page without needing to switch pages.What are Variation Themes?Variation themes are the attributes in which the child products differ from each other.Example ProductPossible Variation ThemesT-shirtColour or SizeT-shirtCombination of Colour and SizeChild products can have more than one variation theme. 

No. The new catalogue-based Amazon integration does not support attributes and does not support free text fields for data transfer.Important noteAttributes: Attributes are not supported by the catalogs.Free text fields: Free text fields are also not supported.Action instruction: Existing attributes relevant for Amazon must be converted into properties.

In order for your attributes to be transferred to Amazon via the adapter, you need to link them with Amazon in the menu Setup » Settings » Attributes » Configuration.Note: In PlentyONE, the old Amazon product types (in the category selection) are still used in this menu. However, the error reports you receive from Amazon already contain the new product types. An overview of the old and new Amazon product types can be found in the manual.Link attributes with Amazon:Open the menu Setup » Settings » Attributes » Configuration.Click on Amazon section on Add link.Select the Amazon platform.Select the category (this corresponds to the old Amazon product type).Select the field.Example: If an Amazon error report states "Bullet Point is required", you select the field bullet_point here.Save the settings.Only attributes that are linked with Amazon in this menu will be exported via the adapter.It is still possible to link fields (attributes) that are also present in the old flat files. During export, these old fields are automatically linked ...

For some data fields with complex mappings in the Amazon product listing catalogue, it is necessary to assign an empty custom value in order for this data to be deleted on Amazon. Simply not mapping the data field is not sufficient.Affected data fields (selection)The following data fields must be assigned an empty custom value in order to be transmitted to Amazon as "delete":Main material of the EPR product packagingType of external product IDGHS hazard statement code (H-Code)Hazardous substance regulationList price (RRP) – currency (uvp_list_price)Instructions: Assign empty custom value (example EPR product packaging)Open the menu: Data » Catalogues.Open the product listing catalogue for Amazon.Expand the relevant group (e.g. epr_product_packaging).Navigate to the corresponding data field (e.g. Main material of the EPR product packaging).Note: The value in the field Export as must be mapped and must not be removed.Click on add Add data source.Add the data source Custom value. Leave the field Value empty.Save the settings.The next ...

With Variation Themes, you can display multiple product variants (e.g. different sizes or colours) on a shared Amazon product detail page. The assignment is done via the data field group variation_theme.Assign a single variation themeOpen the menu: Data » Catalogues.Open the product catalogue for Amazon.Scroll to the data field group variation_theme.Select the appropriate variation theme from the dropdown list for the data field Variation theme designation under Export as (e.g. COLOUR_NAME).Note: The designation in the field Export as may differ after selection, as the dropdown list often provides a translated guide.Click on add Add data source.Select the appropriate attribute with the addition is linked (e.g. Attribute » Colour » Attribute Colour is linked).Note: This ensures that the variation theme is only transmitted if the corresponding attribute is actually linked to your variant.Save your settings.Assign combination of variation themesYou can also select a combination of variation themes (e.g. COLOUR_NAME/SIZE_NAME).Perform ...

Using the data field recommended_browse_nodes, you can assign the appropriate Amazon browse categories to your items. This ensures your items appear in the corresponding category when customers browse on Amazon.Recommended assignment methodCreate a property of the type selection for the browse categories.Add the required Browse Node IDs as individual selection values to this property.Alternative (fall-back) assignmentIf you do not assign the data field recommended_browse_nodes in the product catalogue, the system will instead use the category links from the menu Setup » Markets » Amazon » Category Link.What are Browse Node IDs?Browse categories are assigned via so-called Browse Node IDs. Each category path on Amazon has its own unique Browse Node ID. An up-to-date list of these IDs can be found in the Browse Tree Guides (BTG) in your Amazon Seller Central.

You can export an image list with item or variant images to Amazon via the data field main_product_image_locator.Step-by-step guide for mappingAssign the image list to the data field main_product_image_locator as follows:Image » Variant images » Image list, image information full-size URLorImage » Item images » Image list, image information full-size URLAdditionally, enter the number of images you want to transfer from the image list under Maximum number of images.How image transfer worksThe image URLs from the image list are automatically assigned to the next available free data fields other_product_image_locator_1 through other_product_image_locator_8.Example: If the image list contains three images, then:The URL of the first image is assigned to the data field main_product_image_locator.The URL of the second image is assigned to other_product_image_locator_1.The URL of the third image is assigned to other_product_image_locator_2.Important notesSkipping: If a subsequent other_product_image_locator data field already has an assign...

With the data field bullet_point in Amazon product catalogues, you can add short descriptive texts to your items that are displayed as bullet points next to the product photo on Amazon.Transferring multiple bullet pointsTo transfer multiple bullet points to Amazon, you can add additional bullet points in the catalogue via add fallback data source.Important: These additional bullet points are not treated as fallback data sources. Instead, they are transferred additionally to Amazon and displayed there as individual bullet points listed one below the other for your item.

You assign the item name for your Amazon products in the catalogue to the data field Item Name (item_name.value) in the data field group item_name.Recommended AssignmentsThe following assignments are recommended but not mandatory, as the best option depends on how you maintain your item name in PlentyONE:Item text » Name 1, Name 2 or Name 3Property of the type TextImportant Note for Variant ItemsIf you offer variants of an item (e.g. T-shirts in different colours) on Amazon, use a generic item name. Attributes of the variant (such as colour or size) should not be included in the name, as Amazon automatically adds these attributes.