Amazon (Setup via Sales Channels » Channel Control Centre)

Amazon has gone from being the largest internet book store to one of the leading universal shopping centres. Many customers appreciate the large portfolio, rely on the high product quality and expect best service such as fast delivery. With PlentyONE, you have full access to Amazon.

1. Registering with Amazon

Before carrying out the settings in PlentyONE, you have to register as a seller on Amazon. Amazon Seller Central is the central Amazon interface for sellers. On the Amazon UK platform, sellers who sell more than 35 items per month are considered Professional sellers and only have the possibility to upload item lists from this amount on. PlentyONE users need to select the Professional option. It is only possible to use automatic procedures and APIs to manage stock and offers with the Professional option. This option includes a monthly subscription fee as well as additional fees for each item sold. For further information, refer to the Amazon website.

2. Where can I sell my items via Amazon?

With PlentyONE, you can sell on the platforms Amazon.de, Amazon.ae, Amazon.bel, Amazon.ca, Amazon.co.uk, Amazon.com, Amazon.com.mx, Amazon.es, Amazon.fr, Amazon.ie, Amazon.it, Amazon.nl, Amazon.pl, Amazon.se, and Amazon.tr.

2.1. European Marketplaces Account

Amazon has unified its European marketplaces. This allows you to create and manage offers on any and all of our Amazon marketplaces in Belgium, France, Germany, Italy, the Netherlands, Poland, Spain, Sweden, and the UK. You decide which products you want to sell in which country. You manage your business from a single seller account interface.
You can find further information on selling within the EU at Amazon.

Which sales channels can I offer my products on with a European seller account?

Your seller account is automatically enabled to allow you to sell on the following Amazon platforms:

  • Amazon.ae

  • Amazon.bel

  • Amazon.de

  • Amazon.co.uk

  • Amazon.es

  • Amazon.fr

  • Amazon.it

  • Amazon.ie (This Amazon platform is not yet fully integrated. Additional information is available here.)

  • Amazon.nl

  • Amazon.pl

  • Amazon.se

  • Amazon.com.tr

If you sell on multiple Amazon platforms with a European Marketplaces Account, then set up a new account for each platform in PlentyONE, depending on which options you want to use, and configure each platform separately.
The same access data is used for all platforms.

When you sign up, you will be asked to define your home marketplace. Amazon recommends that you choose your home marketplace as the country from where you will be operating and fulfilling your orders. Refer to the information provided by Amazon.

2.1.1. Amazon.ie

The platform Amazon.ie (Ireland) is not yet fully integrated. At the moment, the following functions are available for Amazon.ie:

  • MFN and FBA orders which were generated on Amazon.ie are imported into PlentyONE.

  • Delivery and billing addresses are formatted correctly when they are imported.

  • After an order was marked as shipped in PlentyONE, a shipping confirmation is sent to Amazon.ie.

  • Invoices are generated in PlentyONE and uploaded to Amazon.ie. Invoice creation is supported in the following cases:

    • without Amazon VCS

    • with Amazon VCS Lite

  • The VAT rate is aligned with Ireland.

  • Credit notes which were generated on Amazon.ie are imported into PlentyONE.

3. Frequency of data exchange

After you have set up Amazon in PlentyONE, data is exchanged with the market in the intervals described in Table 1.

Table 1. Frequency of data exchange
Data Interval

Product creation

once a day during the night

Offer updates

every 15 minutes

Stock changes

Depending on the Stock changes setting in the Sales Channels » Channel Control Center » [Open your Amazon sales channel] » Settings » [Amazon account] » Tab: Item settings menu, stock updates can be triggered either every 15 minutes or every hour.

Price synchronisation

Depending on the Price changes setting in the Sales Channels » Channel Control Center » [Open your Amazon sales channel] » Settings » [Amazon account] » Tab: Item settings menu, price synchronisation can be triggered either every 15 minutes or every hour.

MFN order import

every 5 minutes

Import of pending orders

every 15 minutes

4. Setting up the data exchange

In order for the interface to successfully carry out the item export, the order import and the stock synchronisation, certain settings are mandatory. Pay attention to the following list.

Table 2. Overview of the transition to catalogue-based integration
Process Export via catalogues

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 Sales Channels » Channel Control Centre » [Select your Amazon sales channel] » 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

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 Sales Channels » Channel Control Centre » [Select your Amazon sales channel] » 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 Sales Channels » Channel Control Centre » [Select your Amazon sales channel] » 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.

Offer creation

Frequency of data exchange:

  • The offer catalogue is exported for the first time within 15 minutes after any value has been changed at 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 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 Sales Channels » Channel Control Centre » [Select your Amazon sales channel] » Settings » [Amazon account] » 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.

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.

5. How are items exported to Amazon?

Item data is exported to Amazon via catalogues. For Amazon, data related to listing creation and listing updates is exported via two distinct catalogue types:

Additionally, you will need to create product listings and offer listings.

5.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 exported to Amazon via a product catalogue combined with a product listing.

  • Offer data (e.g. price, stock, delivery time, condition) is specific to each seller and can differ. It is exported to Amazon via an offer catalogue combined with an offer listing.

Products and offers on Amazon
Figure 1. Products and offers on Amazon
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.

6. Adding the sales channel

First, add Amazon as a sales channel in PlentyONE. You can do this in the Channel Control Centre via Sales Channels » Channel Control Centre.

Adding a sales channel:

  1. Open the Sales Channels » Channel Control Centre menu.

  2. Click on Add sales channel (add).
    → The menu Add sales channel opens.

  3. Click on Continue in the tile of {market}.

  4. Enter a name for the sales channel.

  5. If asked to, select the Client (Shop) from the drop-down list.

  6. Click on add Add {market}.
    → The sales channel for Amazon is added.

7. Carrying out the basic settings

Set up Amazon in your PlentyONE system via the Channel Control Center.

7.1. Carrying out account settings

Next, carry out the account settings for your newly created Amazon account.

Carrying out account settings:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon sales channel].
    → The submenu Settings opens.

  2. In the list of accounts on the left, click on the account you just created.
    → The Settings tab for this account opens.

  3. Carry out the settings in the Settings tab. Pay attention to the explanations given in Table 3.
    Note: All Access data fields are mandatory.

  4. Click Save (save).

Table 3. Account settings
Setting Explanation

Login details

Amazon platform

A platform has to be selected when the account is created. The platform cannot be changed afterwards. If you have a European Marketplaces Account, then you can carry out the settings for each platform on which you want to offer your products separately.

Seller ID

Enter the seller ID that you have received from Amazon. If you have a European Marketplaces Account, then the same seller ID is used for every platform.

Allow access

This button gives PlentyONE access to your Amazon account so that data can be exchanged between Amazon and PlentyONE. You can either allow access now or wait until later when you activate the account.

  1. Click on the button Allow access.
    → You are forwarded to Amazon.

  2. Enter the login details of your seller account to log in.
    → The data PlentyONE will have access to is shown.

  3. Click on Confirm to allow access.
    → In PlentyONE, the window Complete authorization opens.

  4. Click on Complete.

Merchant token

Enter the merchant token that you can find on Seller Central.

Email address

Enter the email address that is used as the user name for the Seller Central account.
Important: All PlentyONE email addresses which are used to send messages to Amazon have to be authorised first within your Seller Central account on Amazon.

Active

Place a check mark to activate the interface.
Note: Only activate the interface when you have finished setting up the Amazon interface. Otherwise, incorrect data might be transferred ahead of time.

B2B

Select to activate this account for Amazon Business.

Initial settings

Client

Select which client should be used for orders from Amazon.

SKU structure

The SKU (Stock Keeping Unit) is a unique reference number for all items and item variations on Amazon.
Select one of the following options:
Variation ID
GTIN if available, otherwise variation ID
Variation number if available, otherwise variation ID
The selected setting only goes into effect for items that are exported to Amazon for the first time. Amazon and your online store exchange data based on these SKUs.
Important: If you have already started selling your items on Amazon and now you want to start selling them with PlentyONE, you have to assign already existing SKUs in the Item » Items » [Open item] » [Open variation] » Area: SKU menu.

Catalogue was listed with SSW

  • Yes = Items are listed on Amazon with starsellersworld. The item SKU will be cut off right behind the last "-" when importing the items. This makes it possible to match the item in the system.

  • No = Items are not listed on Amazon with starsellersworld.

Generate invoice

Select whether invoices should be generated by PlentyONE or by Amazon. See also Setting up invoice generation for Amazon orders.
Note: If you want to use Amazon Business, activate the option VCS plentymarkets (VCS Lite) or VCS Amazon.

  • PlentyONE = PlentyONE calculates the VAT and generates the invoice. You set up an event procedure which uploads the invoices to Amazon via Amazon IDU. See also Using Amazon IDU.

  • VCS plentymarkets (VCS Lite) = Amazon invoices are automatically generated by PlentyONE and transferred to Amazon. Amazon calculates the VAT. Amazon calls this option VCS Lite. See Setting up VCS in PlentyONE.
    Note: VCS must be activated in Amazon Seller Central.

  • VCS Amazon = Invoices for Amazon orders are generated by Amazon.
    Invoices for Amazon orders and credit notes are imported into PlentyONE. See Using VCS Amazon.
    Note: VCS must be activated in Amazon Seller Central.

SKU settings and stock synchronisation

If the same settings for SKU numbers are selected for all platforms, then you can synchronise all sales channels for the European Marketplaces Account with the stock synchronisation. If the settings are not the same, then the synchronisation must be carried out separately for each sales channel.

However, for European Marketplaces Accounts, the stock is managed globally. As such, you only need to activate the stock for your home marketplace. Nevertheless, the SKU settings must match.

7.2. Carrying out item settings

Items are transferred to Amazon via offer and product catalogues. Because many settings are already made in the catalogues, some item settings in the menu Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Settings » [Open Amazon account] » Tab: Item settings are no longer necessary.

Important: Some item settings still need to be configured, even if items are transferred to Amazon via product and offer catalogues.

Table 4 lists the item settings in the Item settings tab that are still mandatory.

Carrying out item settings:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon sales channel].
    → The submenu Settings opens.

  2. In the list of accounts on the left, click on the account you just created.
    → The Settings tab for this account opens.

  3. Click on the Item settings tab.

  4. Carry out the settings in the Item settings tab. Pay attention to the explanations given in Table 4.

  5. Click Save (save).

Table 4. Item settings
Setting Required for item export via catalogue? Explanation

Tab: Item settings

Automatic processes

Item export

No

The item export is activated via the Active toggle of the respective catalogue in the Data » Catalogues menu.

Price changes

Yes

Specifies whether a price should be transferred when offers are updated (regardless of whether the SKU is known to Amazon).
If an SKU is unknown to Amazon, prices will still be transferred.

Stock changes

Yes

Specifies whether stock should be transferred when offers are updated (regardless of whether the SKU is known to Amazon).

Export filter
Tip: If you use export filters, then only items with the selected filters are exported. The item export via catalogues only supports the export filters Flag 1, Flag 2 and Tags.

Item availability

No

This setting is only used in combination with catalogues to determine the maximum shipping time, but not as a filter.

Export categories

No

Which product categories are used is defined via the activated product catalogues. The product category must be added in the Setup » Markets » Amazon » Add catalogue templates menu and a product catalogue for this product category must be created and activated in the Data » Catalogues menu .

BMVD export categories

No

Which product categories are used is defined via the activated product catalogues. The product category must be added in the Setup » Markets » Amazon » Add catalogue templates menu and a product catalogue for this product category must be created and activated in the Data » Catalogues menu .

Flag 1

Yes

Only variations with the selected flags are exported.
Note: Unset flags are filtered out.

Flag 2

Yes

Only variations with the selected flags are exported.
Note: Unset flags are filtered out.

Tags

Yes

Only items with at least one of the selected tags are exported.
Note: If multiple tags are selected, they are interpreted as an OR condition. This means a variation is exported as soon as at least one of the selected tags has been assigned to it. Unset flags are filtered out.

Store item

No

Export settings

Item name

No

The item name is assigned in the product catalogue.

Item description

No

The item description is assigned in the product catalogue.

Allow HTML tags

Yes

The following tags are allowed: < br >, < b >, < i >, < p > ,< ul >, < li >, < table >, < tr >, < td >, < th >, < tbody > and < strong >.

Warehouse selection

Yes

This setting is required because the stock is not assigned in the catalogue.
Select one of the following options: Transfer stock quantity of distribution warehouse that currently has largest stock, Use item’s main warehouse, Transfer sum of the stock quantities from all distribution warehouses, or Select warehouses. If you select the option Select warehouses, then the setting Warehouse is displayed below.
Note: Since 19/5/2021, shipping confirmations to Amazon must contain the address details of the warehouse. In Seller Central, these address details are shown in the Ship from field. As such, make sure that address details are saved for all warehouses from which you want to ship Amazon orders. Go to Setup » Stock » Warehouse » [Open warehouse] » Settings to confirm that all necessary address details are saved.

Warehouse

Yes

Select one or more warehouses. This setting is only displayed if you selected the option Select warehouses under warehouse selection.
The stock of the selected warehouses is summed up and transmitted to Amazon. Buffers and maximum amounts are also taken into consideration. This allows you to systematically offer the stock of specific warehouses on specific Amazon accounts or Amazon sales channels.
If you selected the option Select warehouses under Warehouse selection, but have not selected a warehouse, the item is not exported because the stock cannot be calculated.

Stock buffer

Yes

This setting is required because the stock is not assigned in the catalogue.
If an item is limited to net stock, the exported stock is reduced by the value entered.

Maximum stock

Yes

This setting is required because the stock is not assigned in the catalogue.
Defines the upper limit for exported stock for all items. This setting takes priority over the setting below Quantity for items not limited to stock.

Quantity for items that are not limited to the stock

Yes

This setting is required because the stock is not assigned in the catalogue.
For items with the setting no limitation, the maximum amount of the real stock and the quantity defined here is transferred.
Example: Setting 0, net stock 8. PlentyONE transfers 8.
Items with the setting Limited to net stock are not taken into consideration.

Average delivery period

Yes

This setting is required because the stock is not assigned in the catalogue.
Select Do not transfer, Transmit "average delivery time in days", or Transmit "average delivery time in days” + Additional delay in delivery.

Processing time

Yes

This setting is required because the stock is not assigned in the catalogue.
Enter a number of days for the additional delay in delivery. This option is only displayed if the Average delivery period option is set to Transmit "average delivery time in days + handling time.

Activate long lead time

Yes

This setting is required because the stock is not assigned in the catalogue.
Select Yes to increase the maximum processing time of Amazon orders from 30 up to 120 days.
Note: You can only activate this setting after it was unlocked for you on Amazon.
No is transferred by default.

Manufacturer part number

No

The manufacturer part number is assigned in the product catalogue.

Additional SKU

Yes

Activate the data exchange for additional Amazon SKUs. Variations linked to additional SKUs are transferred. No new additional SKUs are created.

7.3. Carrying out order settings

In the Order settings tab, you carry out settings related to shipping.

The abbreviation MFN stands for merchant-fulfilled network. This means that the seller takes care of order processing.

Carrying out order settings:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon sales channel].
    → The submenu Settings opens.

  2. In the list of accounts on the left, click on the account you just created.
    → The Settings tab for this account opens.

  3. Click on the Order settings tab.

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

  5. Click Save (save).

Table 5. Order settings
Setting Explanation

Ship own orders (MFN)

Order import

Select whether you want to import order data.

  • Yes: MFN orders are imported into PlentyONE every 5 minutes.

  • No: MFN orders are not automatically imported into PlentyONE.

Order import start date

Enter a date. Only orders starting from this date will be imported into PlentyONE.
Note: Every order that was imported into PlentyONE will be billed.

Notification

Select whether you want to export shipping confirmations to Amazon.

  • Yes: Shipping confirmations are exported to Amazon once an hour.

  • No: Shipping confirmations are_not_ automatically exported to Amazon.

Order item

Defines how the item name is displayed in the order item. Select one of the following options:

  • Copy item name from store

  • Copy item name from Amazon - with SKU

  • Copy item name from Amazon - without SKU

Incoming payment

Select Incoming payment booked if the incoming payment should be displayed as booked when MFN and FBA orders are imported.
Note: This setting applies to both own shipping (MFN) and to shipping by Amazon (FBA).

Status for transmitted returns

Select the order status for returns that were successfully reported to Amazon.

Status for untransmitted returns

Select the order status for returns that were not reported to Amazon.

Pending orders

Select whether you want to import pending orders.

  • Yes: Pending orders are imported into PlentyONE every 15 minutes.

  • No: Pending orders are not automatically imported into PlentyONE.

Credit note import

Select whether Amazon credit notes for MFN and FBA orders should be imported into your PlentyONE system.

No (default)

Credit notes are not imported.

Yes

Amazon credit notes are imported into your PlentyONE system every 4 hours.

Note: This setting applies to both own shipping (MFN) and to shipping by Amazon (FBA).

Shipment by Amazon (FBA)

Active

Place a check mark to activate Amazon FBA.

Referrer

Select whether only orders from Amazon should be processed with FBA or whether orders from other referrers should be processed with FBA as well.

Status

Select the order status for orders that were imported from Amazon.

Warehouse

Select which Amazon FBA warehouse should be used for stock synchronisation with the account. This warehouse is also used to assign the FBA order to the account if no FBA order could be assigned to the country the order originates in.

Warehouse for unsellable stock

Select which Amazon FBA warehouse should be used for unsellable stock for this account. If you do not select a warehouse, the unsellable stock will not be imported.
Unsellable stock is defined as the number of units you have for a SKU in Amazon fulfillment centers in unsellable condition. In Amazon’s "Manage FBA Inventory" report, this stock is equivalent to the quantity in the column afn-unsellable-quantity.

Note: Do not select the same warehouse here that you already selected for the setting Warehouse (FBA warehouse), as stock will be overwritten if you select the same warehouse for both settings.

Outgoing items

Select whether outgoing items should be marked as booked or not. The option Mark as booked does not trigger an item movement. In order to trigger an item movement, select the option Do not mark as booked and set up an event procedure.

Returns import

Do not import returns or select daily import of returns.

Include coupons to returns

Select whether discounts granted by Amazon are considered for returns. A minimum order quantity for the coupon is not taken into consideration.

  • Yes = FBA returns include order items for discounts or additional charges from Amazon. As such, the credit note amount does not match the amount in the original order. If necessary, the credit note must be corrected. Go to Cancellation document » Order adjustment » New credit note to do this.

  • No = Order items for Amazon coupons are not imported. As such, discounts and additional costs applied by Amazon are ignored and not taken into account in the calculation.

Important: "Coupons" can be discounts from Amazon Delivery Campaigns, Amazon Campaigns or any other discounts granted by Amazon. It can also be additional costs that Amazon charges. For example, these might be gift wrapping or cases where Amazon applies its own shipping costs.

Example:

  • Goods value of the original order: 50.00 GBP

  • Additional shipping costs charged by Amazon: 5.00 GBP

  • Amount in credit note depending on selected option:

    • Yes = 55 GBP

    • No = 50 GBP

Stock import

Select whether the stock should be imported hourly or never.

Status for transmitted orders

Select the order status for orders that were successfully transferred to FBA.

Ignore item discounts from campaigns during import

Amazon order reports do not specify if any item discounts were granted by the seller or by Amazon. In both cases, the discounted amount is deducted from the order value during the order import. However, if Amazon granted the discount, the order value differs from the amount that Amazon pays you for the order. In such cases, you need to manually adjust the order. Otherwise, you do not pay enough VAT on the order.

Select how to deal with item discounts when orders are imported.

No (default setting)

The discount amount is imported. If Amazon granted the discount, the order must be adjusted manually.

Discount granted by Amazon:

  • A customer buys one of your items for 10.00 GBP.

  • Amazon grants the customer a discount of 1.00 GBP.

  • The order is imported with an order value of 9.00 GBP.

  • Amazon pays you 10.00 GBP.
    → The order value and the amount that Amazon pays you do not match. The order must be adjusted manually.

Discount granted by the seller:

  • A customer buys one of your items for 10.00 GBP.

  • You grant the customer a discount of 1.00 GBP.

  • The order is imported with an order value of 9.00 GBP.

  • Amazon pays you 9.00 GBP.
    → All amounts are correct.

Yes

The discounted amount is deducted from the order value during the import. This setting is recommended for sellers that do not offer their own discount campaigns on Amazon platforms. If the seller granted the discount, the order must be adjusted manually.

Discount granted by Amazon:

  • A customer buys one of your items for 10.00 GBP.

  • Amazon grants the customer a discount of 1.00 GBP.

  • Amazon pays you 10.00 GBP.

  • The order is imported with an order value of 10.00 GBP.
    → All amounts are correct.

Discount granted by the seller:

  • A customer buys one of your items for 10.00 GBP.

  • You grant the customer a discount of 1.00 GBP.

  • The order is imported with an order value of 10.00 GBP.

  • Amazon pays you 9.00 GBP.
    → The order value and the amount that Amazon pays you do not match. The order must be adjusted manually.

Note: To simplify the examples, the fees that you need to pay Amazon for the order are ignored.

Ignore shipping discounts from campaigns during import

Amazon order reports do not specify if any shipping discounts were granted by the seller or by Amazon. In both cases, the discounted amount is deducted from the order value during the order import. However, if Amazon granted the discount, the order value differs from the amount that Amazon pays you for the order. In such cases, you need to manually adjust the order. Otherwise, you do not pay enough VAT on the order.

Select how to deal with shipping discounts when orders are imported.

No (default setting)

The discount amount is imported. If Amazon granted the discount, the order must be adjusted manually.

Discount granted by Amazon:

  • A customer buys one of your items for 10.00 GBP plus 3.00 GBP shipping.

  • Amazon waives the shipping costs.

  • The order is imported with an order value of 10.00 GBP plus 3.00 GBP shipping.

  • Amazon pays you 13.00 GBP.
    → The order value and the amount that Amazon pays you do not match. The order must be adjusted manually.

Discount granted by the seller:

  • A customer buys one of your items for 10.00 GBP plus 3.00 GBP shipping.

  • You waive the shipping costs.

  • The order is imported with an order value of 10.00 GBP plus 3.00 GBP shipping.

  • Amazon pays you 13.00 GBP.
    → All amounts are correct.

Yes

The discounted amount is deducted from the order value during the import. This setting is recommended for sellers that do not offer their own discount campaigns on Amazon platforms. If the seller granted the discount, the order must be adjusted manually.

Discount granted by Amazon:

  • A customer buys one of your items for 10.00 GBP plus 3.00 GBP shipping.

  • Amazon waives the shipping costs.

  • The order is imported with an order value of 10.00 GBP plus 3.00 GBP shipping.

  • Amazon pays you 13.00 GBP.
    → All amounts are correct.

Discount granted by the seller:

  • A customer buys one of your items for 10.00 GBP plus 3.00 GBP shipping.

  • You waive the shipping costs.

  • The order is imported with an order value of 10.00 GBP plus 3.00 GBP shipping.

  • Amazon pays you 13.00 GBP.
    → The order value and the amount that Amazon pays you do not match. The order must be adjusted manually.

Note: To simplify the examples, the fees that you need to pay Amazon for the order are ignored.

Item bundles Multichannel

Which order items do you want to transfer to Amazon for FBA Multi-Channel orders?

Background: Which option you select depends on how you store item bundles in the Amazon warehouse. Are all bundle components of item bundles packaged and stored together in the Amazon warehouse? Or does Amazon pick the individual bundle components to create item bundles?

Transmit all order positions

Both the package position and the item bundle components are transmitted to Amazon.
Important: Do not activate this option. Otherwise, Amazon may ship items twice or may not fulfil the order.

Transmit package position only

Only the package position is transferred to Amazon.
Requirement: All bundle components of the item bundle are stored in a single package in the Amazon warehouse. The item bundle only has one SKU. As such, Amazon only picks one order item.

Transmit without package position

Only the contents of the package are transferred to Amazon.
Requirement: The item bundle consists of individual items. These items are stored in individual storage locations in the Amazon warehouse(s). Each item has its own SKU. The individual items only become an item bundle by being picked.

Shipping category

Select a shipping category.

Standard

Normal shipping

Expedited

Express shipping

Priority

Fastest shipping service

Additional settings for FBA

The following settings are located in the Ship own orders (MFN) area at the top of the menu. However, these settings apply to both own shipping (MFN) and to shipping by Amazon (FBA). As such, also select options for these settings:

Paid on

Select Incoming payment booked if the incoming payment should be displayed as booked when MFN and FBA orders are imported.

Credit note import

Select whether Amazon credit notes for MFN and FBA orders should be imported into your PlentyONE system.

  • No (default) = Credit notes are not imported.

  • Yes = Amazon credit notes are imported into your PlentyONE system every 4 hours.

Note: These settings apply to both own shipping (MFN) and to shipping by Amazon (FBA).

7.4. Activating the account

Have you completed all the settings? Then activate the account now to start exchanging data with Amazon.

How you activate the account depends on whether or not you have already granted access when you set up the account in plentymarkets.

  • Activate account and allow access

  • Activate account if access already is granted

Activating account and allowing access
  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon sales channel].
    → The submenu Settings opens.

  2. In the account overview to the left, click on the account.
    → The Settings tab for this account opens.

  3. Activate the option Active.

  4. Click on the button Allow access.
    → You are forwarded to Amazon.

  5. Enter the login details of your seller account to log in.
    → The data PlentyONE will have access to is shown.

  6. Click on Confirm to allow access.
    → In PlentyONE, the window Complete authorization opens.

  7. Click on Complete.

  8. Click Save (save).

Activating account if access already is granted:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon sales channel].
    → The submenu Settings opens.

  2. In the account overview to the left, click on the account.
    → The Settings tab for this account opens.

  3. Activate the option Active.

  4. Click Save (save).

8. Activating the order referrer

Go to Setup » Orders » Order referrer to activate the order referrer. This ensures that orders are assigned to the correct sales channel.

What is an order referrer?

An order referrer tags an order with the sales channel on which the order was generated. Sales channels can be e.g. your online shop or markets on which you sell your items. Each sales channel has an individual order referrer. Some order referrers are available by default in your PlentyONE system. Further order referrers are added e.g. if you install a new plugin. For further information about the order referrer, see the page Order referrer of the PlentyONE manual.

Activating the order referrer for Amazon:

  1. Go to Setup » Orders » Order referrer.

  2. Click Search (search).

  3. In the list, navigate to the Amazon platforms.

  4. On the right of the referrer’s line, click Edit (edit).
    → The window Edit referrer opens.

  5. Activate the option Visible in selection (toggle_on).

  6. Click SAVE (save).
    → The referrer is active.

9. 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.

9.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

9.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 corresponding item will continue to be listed on Amazon if it was created previously.

10. Preparing Items for sale on Amazon

You can now get started on preparing your variations for the export to Amazon.

10.1. Setting the variation availability

Variations have to be available for Amazon country platforms. This is done in the Availability and Visibility section of a variation within the Item » Items » [Open variation] menu.

Use group function or batch processing

You can edit the availability of several variations at once by using either the variation group function or batch processing.

Activating the variation availability for an Amazon country platform:

  1. Go to Item » Items » [Open variation].
    Tip: To sell all variations of an item on the Amazon platform, carry out the settings for the item’s main variation. This activates the availability of all variations of the item.

  2. Activate (toggle_on) the variation in the Availability and visibility section

  3. In the Sales channels section, click Add sales channels (add).
    → The window Add sales channels opens.

  4. From the Sales channels drop-down list, select the Amazon country platform(s) for which the variation should be available.

  5. Select the option Web API.

  6. Click Apply.
    → The sales channel is added.

  7. Save () the settings.

  8. In the navigation on the left, open the item for your variation.

  9. Carry out the settings in the Amazon area. Pay attention to the explanations given in Table 6.

  10. Save () the settings.

Table 6. Activating the variation availability for Amazon
Setting Explanation

FBA Fulfillment

Should the item be sold via FBA? If so, then select the appropriate Amazon marketplace from the drop-down list.

  • AMAZON_EU = Europe

  • AMAZON_FE = Far East

  • AMAZON_NA = North America

Product type

Select the appropriate Amazon product type from the drop-down list. You can think of the product type as the Amazon category under which this item should appear. When you transmit your items to Amazon, you’ll transmit one product type at a time, i.e. one category at a time.

Note: You can download an overview of Amazon product types here. The table lists the product types and their corresponding IDs.

Amazon FBA

Should the item be sold via FBA? If so, then select this option ().

Note: By doing so, the FBA stock of this item can be imported into PlentyONE and Amazon Multi-Channel orders that are shipped with FBA can be booked.

Variation availability for MFN and FBA

In order to set up variations for MFN as well as FBA, select the Amazon country platform Amazon country and the platform Amazon country FBA.

10.2. Defining SKU manually

Add SKUs manually for specific referrers in the Item » Items » [Open variation] » Section: SKU menu if needed. If you have already started selling your items on Amazon and now you want to start selling them with PlentyONE, you have to assign already existing Amazon SKUs in this menu.

An Amazon SKU must be assigned to the item in the order to ensure that associated returns can be created and imported.Without a matching Amazon SKU, Amazon cannot identify the item in the event of a return, and the return will not be created.

Adding SKU:

  1. Go to Item » Items » [Open variation].

  2. In the SKU section, click Add SKU (add).
    → The window Add SKU opens.

  3. From the drop-down list Referrer, select the option Amazon.

  4. From the drop-down list Account, select the corresponding Amazon account.

  5. Click Apply.
    → A new entry is created in the SKU section

  6. Enter the SKU in the SKU field.

  7. Enter the parent SKU in the Parent-SKU field.

  8. Save (save) the settings.
    → The SKU is saved and displayed.

SKUs can still be changed afterwards. However, note that Amazon might be unable to assign the items if you make changes to SKUs.

Parent SKU

Parent SKUs can be saved for both items and variations. The manual maintenance of SKUs enables you to assign the Parent SKU of entirely different item variations to variations of an item. For example, you can assign the Parent SKU of a variation which belongs to an entirely different item 5 times to an item with 5 variations. These variations are listed on Amazon as variations of the item with the Parent SKU they are assigned to.
If one variation has a different Parent SKU than the remaining variations of an item, then two different items are listed on Amazon, but you only have to maintain one item in your PlentyONE system.

10.3. Defining additional SKUs manually

Add SKUs manually for specific referrers in the Item » Items » [Open variation] » Section: Additional SKU menu if needed.

Adding SKU:

  1. Go to Item » Items » [Open variation].

  2. In the Additional SKU section, click Add additional SKU (add).
    → The window Add additional SKU opens.

  3. From the drop-down list Referrer, select the option Amazon.

  4. From the drop-down list Account, select the corresponding Amazon account.

  5. Click Apply.
    → A new entry is created in the Additional SKU section

  6. Enter the SKU in the SKU field.
    Note: Avoid SKUs with special characters (e.g. spaces, umlauts or commas). Special characters can cause encoding problems during transmission, so Amazon can no longer match the SKU correctly.

  7. Save (save) the settings.
    → The SKU is saved and displayed.
    Tip: SKUs can still be changed afterwards.

Activating the stock update and price update for additional SKUs

Additional SKUs are automatically included in the Amazon order import. Activate the stock update and price update for additional SKUs manually in the Setup » Markets » Amazon » Settings » Tab: Item settings menu.

The stock update and price update for additional SKUs is carried out along with the normal stock update and price update at the interval that you have selected within Setup » Markets » Amazon » Settings » Tab: Item settings for the options Price changes and Stock synchronisation in the Automatic processes area.

During the stock update for additional SKUs, FBA stock is also updated.

Activating the stock and price update:

  1. Go to Setup » Markets » Amazon » Settings » Tab: Item settings.

  2. In the Export settings area, activate Stock update and Price update for the Additional SKU option, depending on which options you want to activate. ALL activates both the stock update and the price update.

  3. Save () the settings.

An ASIN (= Amazon Standard Identification Number) is a unique product identification number on Amazon which simplifies selling items on Amazon. In order to quickly and comfortably sell items that have already been listed on Amazon, an ASIN should be saved for every variation.

If an ASIN is saved for a variation, then only price, stock, and GTIN need to be saved for the variation to sell the item on Amazon.

Save a GTIN for your variations

The barcode GTIN13 is required to search for ASINs on Amazon and to import them into PlentyONE. Therefore, make sure that a barcode (GTIN13) is saved for your variations. Otherwise, ASINs cannot be found.

Go through the Amazon ASIN import assistant

First, go through the Amazon ASIN import assistant in order to import matching ASINs for your variations into your PlentyONE system. This is done in the Setup » Assistants » Omni-Channel menu. Also use the assistant to define if and how ASINs should be linked to variations.

The menu Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » ASIN matching provides an overview of the ASINs imported into your system. All imported ASINs are displayed here, including ASINs which are linked with a variation and ASINs which have not yet been linked. You can also link ASINs individually or with the group function in this menu.

ASINs are imported into your PlentyONE system stepwise. Therefore, not all variations that can be linked with variations are displayed immediately.

You can either link ASINs with variations manually or you can use the group function to do so.

You have to save some information in your PlentyONE categories in order for your items to automatically be assigned to the existing categories when exporting them to Amazon. The so called Browse Tree Guides (BTG) from Amazon provide you with classification information. This information is provided in table format (MS Excel) and contains unique classification numbers, the so called Browse Node IDs, which you will have to assign to your online store categories. The lists are available in the help centre of the Seller Central or via this link.

Using the official Browse Tree Guides for the Amazon platform that you want to sell your products on ensures that your items can be found quickly and easily in the Amazon catalogue. The Browse Node IDs form the basis for the item/product assignment in the navigation as well as in the product search. Due to the large amount of items offered on Amazon, an explicit assignment of your items into these Browse Node IDs determines whether a customer will find your product in the corresponding category or not. Therefore, we recommend that you take some time when carrying out this next step and that you select the Browse Node IDs carefully.

You can set up category links via Sales Channels » Channel Control Centre » [Open Amazon sales channel] » Category link. In PlentyONE, you can link each item category with up to two Amazon classification numbers from the Browse Tree Guides.

It is absolutely necessary that you link the entered values separately line by line.

The category links are only taken into consideration for the default categories, which were selected for a variation under Item » Items » [Open variation] » Tab: Categories.

Linking Amazon categories:

  1. Use this link to access the help centre within Seller Central.

  2. Select the desired classification list, e.g. apparel.

  3. Look up the desired category name in the node path column (e.g. blouse).

  4. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Category link in your PlentyONE system.

  5. Enter the corresponding Browse Node ID from the list into the table.

  6. Click on the gear-wheel icon that corresponds to the category that you want to link.

Exporting the Browse Node ID

The Browse Node ID that was assigned when selecting the category is inserted into the RecommendedBrowseNode1 field during the data export. The RecommendedBrowseNode2 field is only used for categories that are linked multiple times.

11. Mandatory attributes for Amazon

Some attributes are mandatory for certain Amazon product types. If these mandatory attributes are not linked, then you can no longer list new products or update existing products which are linked to the listed product types on Amazon. We therefore recommend to check which Amazon product types you use.

11.1. Overview of new Amazon product types

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

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

Table 9. 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.

Use new Amazon product types for item import

If you use the import tool to import items into PlentyONE via a CSV file, then you have to add a new column for the new Amazon product types in the import file.
Carry out the item import once again after adding the column for the new Amazon product types. This way, you can make sure that your items are linked with the new Amazon product types.

12. Creating properties

Next, create properties for the mandatory attributes of the Amazon product types you use in your PlentyONE system.
For further information, refer to the Characteristics and properties page.

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

Creating a property:

  1. Go to Setup » Settings » Properties » Configuration.

  2. Click on Create property.

  3. Customise the settings to meet your needs.

  4. Click Save (save).

12.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
  1. Open the variation in the Item » Items » [Open variation] menu.

  2. Open the Properties tab in the navigation bar on the left-hand side.

  3. Click Add properties (add).
    → The window Add properties opens.
    Tip: Use the search to search for the property.

  4. Place a check mark next to the desired property.

  5. Click APPLY.

  6. 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.

  7. Click Save (save).

Step 2: Mapping a property in an Amazon catalogue
  1. Go to Data » Catalogues.

  2. Open the Amazon catalogue for which the property is to be used.

  3. Assign the property to the desired Amazon data field.

  4. Click Save (save).

13. Creating catalogues

Item and offer data is exported to Amazon using 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:

Tip: For more information on the difference between products and offers and useful tips regarding 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.

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.

13.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.

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 Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Add catalogue templates menu. . After adding the product types, you can create product catalogues for the product types that you added.

13.1.1. Adding Amazon product types

In the menu Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Add catalogue templates you can add the Amazon product types (i.e. the product categories) you want to use.

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

Adding Amazon product types:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Add catalogue templates.

  2. Click Add product types (add).
    → The Add product types window opens.

  3. Enter the Seller ID of your Amazon account.

  4. Select the Amazon product type from the Product types drop-down list.

  5. Click SAVE (save).
    → 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.

13.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 product channel map:

  1. Open the menu Sales Channels » Channel Control Centre » [Name of your Amazon Sales Channel] » Mapping » Product mapping.

  2. Click on Create Channel map (add).

  3. Enter a name for the channel map.

  4. In the drop-down list Marketplace, select the option Amazon.

  5. In the drop-down list Catalogue type, select the option Product-[Sales Channel].

  6. In the drop-down list Categories, select the product categories you want to sell on Amazon.

  7. Click on CREATE CHANNEL MAP.
    → The channel map is created.

Once you have created a product channel map for Amazon you can proceed to create catalogues for the different product types you want to sell on Amazon and link them to the channel map. To do so, proceed as follows:

Linking a product catalogue to the channel map:

  1. Open the menu Sales Channels » Channel Control Centre » [Name of your Amazon Sales Channel] » Mapping » Product mapping.

  2. In the row of the channel map you want to edit, click on more_vert More and select Connect catalogues.

  3. In the drop-down list Select catalogues, click on Create catalogue.

  4. Enter a name for the catalogue.

  5. In the drop-down list Marketplace, select the option Amazon.

  6. In the drop-down list Export type, select the option Listing.

  7. In the drop-down list Amazon Account, select the Amazon account for which the catalogue is to be created.

  8. In the drop-down list Sales Channel, select the Amazon sales channel.

  9. In the drop-down list Category, select the Amazon product type.

  10. Click on CREATE AND CONNECT TO CHANNEL MAP.
    → The catalogue is created and connected to the channel map.

13.1.3. Mapping data fields in the product catalogue

After you have created a catalogue, map the sales channel’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
catalogue menu colours
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 (more_vert).

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:

  1. Go to Sales Channels » Channel Control Centre.

  2. Click on the tile of your Amazon Sales Channel.

  3. Click on the catalogue you want to edit.
    → 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.

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

  5. 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:

  1. 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.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

  3. 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.

  4. 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:

gif catalogue mapping simple en
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.

Creating a property:

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

Creating a simple 1:1 mapping with properties:

  1. 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.

  2. Expand the group Property.
    → The property groups are shown.

  3. Expand the group you need.

  4. Click on the Plus sign on the right of the property you want.

  5. From the drop-down list Language, select the language in which you send the data to the market.

  6. 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.

catalogue complex mappings

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:

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

  2. Select the value that you want to map a PlentyONE data field to.
    → The value is mapped.

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

  4. Click on a group.
    → The PlentyONE data fields of the group are shown.

  5. 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.

  6. 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:

gif catalogue mapping complex en
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:

  1. 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.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

  3. 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.

  4. 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".

  5. 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.

  6. 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.

gif catalogue mapping fallback en
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:

  1. 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.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

  3. 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.

  4. Click on Confirm.

  5. 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.

  6. Map one or several additional PlentyONE data fields to the marketplace data field as described above.

  7. Click on Confirm.

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

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

  10. Click on Save.

  11. 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:

  1. 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.

  2. 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.

  3. 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:

gif catalogue own value en
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:

  1. 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.

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

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

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

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

    1. Click on the icon more_vert.

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

    3. Save the settings.

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

  7. Save the settings.
    → The entered formula is displayed in the overview.
    → The calculation will be carried out in the next export.

13.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.

13.1.4.1. Updates required: Amazon product metadata changes
Amazon makes changes to product metadata at irregular intervals.

These changes include new or updated mandatory attributes, adjustments to product types, and changes to the data fields available in product catalogues. Such changes may require existing product catalogues to be updated or additional data fields to be mapped.
Amazon publishes information about these updates on an official documentation page:

We recommend checking the SP-API product metadata updates and your product catalogues regularly and adjusting your product catalogues as necessary to ensure that all required data continues to be transferred to Amazon correctly.

13.1.4.2. 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

Amazon item name
Figure 2. Example mapping of item name with fallback data source
13.1.4.3. 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 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.

13.1.4.4. 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
    Note: If you map the data field Variation images, then only images that are linked with at least one variation will be exported.

or

  • Image » Item images » Image list, image information Full image URL
    Note: If you map the data field Item images, then only images that are not linked with any variation will be exported.

or

  • Image » All images » Image list, image information Full image URL
    Note: If you map the data field All images, then all images will be exported, regardless of whether the images are linked to a variation or not.

  • 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. hey are only transferred if no mapped single image or image list is found in the main data source.

13.1.4.5. 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 Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » 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.

13.1.4.6. Assigning 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 assign variation themes in the data field group variation_theme as follows:

  • Mapping a variation theme with a single attribute

  • Mapping a variation theme with multiple attributes

Mapping a variation theme with a single attribute:

  1. Go to Data » Catalogues.

  2. Open the product catalogue for Amazon.

  3. Scroll to the data field group variation_theme.

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

  5. Click add Add data source.

  6. 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.

  7. Click Save (save).

Amazon variation theme single 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 them COLOUR_NAME, then you also have to map the data field for COLOUR.

You can also select a variation theme that combines multiple attributes. These are indicated by a forward slash separating the individual attribute names.
Example: COLOUR_NAME/SIZE_NAME

Mapping a variation theme with multiple attributes:

  1. Go to Data » Catalogues.

  2. Open the product catalogue for Amazon.

  3. Scroll to the data field group variation_theme.

  4. For the data field Variation Theme Name, select the appropriate combination of attributes 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.

  5. Click add Add data source.

  6. Select the appropriate attribute with the addition is linked for the first attribute of the variation theme.
    Example: Attribute » Colour » Attribute Colour is linked.

  7. Click link Add data source.

  8. Select the appropriate attribute with the addition is linked for the second attribute of the variation theme.
    Example: * Attribute » Size » Attribute Size is linked* for SIZE_NAME.

  9. Repeat steps 7–8 if the variation theme includes additional attributes.
    Important:

    • The variation theme is only transmitted if all of its attributes are linked to the variation.

    • Do not add the second and all subsequent attributes via Add fallback data source.

    • If you map multiple variation themes with a different number of attributes, arrange them in order of their attribute count. Start with the variation theme that contains the most attributes and continue to the theme with the fewest attributes.

  10. Click Save (save).

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.

13.1.5. Activating the catalogue export

Creating a catalogue:

  1. Open the Sales Channels » Channel Control Centre menu.

  2. Click on the tile of your Amazon.

  3. Click Create catalogue (add).

  4. Enter a name for the catalogue.

  5. In the drop-down list Marketplace, select the option Amazon.

  6. In the drop-down list Export type, select the option Listing.

  7. In the drop-down list Amazon Account, select the Amazon account for which the catalogue is to be created.

  8. In the drop-down list Sales Channel, select the Amazon sales channel.

  9. In the drop-down list Category, select a category of the sales channel.

  10. 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.

Do 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.

13.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.

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.

Creating an offer channel map:

  1. Open the menu Sales Channels » Channel Control Centre » [Name of your Amazon Sales Channel] » Mapping » Offer mapping.

  2. Click on Create Channel map (add).

  3. Enter a name for the channel map.

  4. In the drop-down list Marketplace, select the option Amazon.

  5. In the drop-down list Catalogue type, select the option Offer-[Sales Channel].

  6. In the drop-down list Categories, select the product categories you want to sell on Amazon.

  7. Click on CREATE CHANNEL MAP.
    → The channel map is created.

Once you have created a product channel map for Amazon you can proceed to create catalogues for the different product types you want to sell on Amazon and link them to the channel map. To do so, proceed as follows:

Linking an offer catalogue to the channel map:

  1. Open the menu Sales Channels » Channel Control Centre » [Name of your Amazon Sales Channel] » Mapping » Offer mapping.

  2. In the row of the channel map you want to edit, click on more_vert More and select Connect catalogues.

  3. In the drop-down list Select catalogues, click on Create catalogue.

  4. Enter a name for the catalogue.

  5. In the drop-down list Marketplace, select the option Amazon.

  6. In the drop-down list Export type, select the option Listing.

  7. In the drop-down list Amazon Account, select the Amazon account for which the catalogue is to be created.

  8. In the drop-down list Sales Channel, select the Amazon sales channel.

  9. In the drop-down list Category, select Offer.

  10. Click on CREATE AND CONNECT TO CHANNEL MAP.
    → The catalogue is created and connected to the channel map.

13.2.1. Mapping data fields in the offer catalogue

After you have created a catalogue, map the sales channel’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.

Not all mandatory fields are identified 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
catalogue menu colours
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 (more_vert).

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:

  1. Go to Sales Channels » Channel Control Centre.

  2. Click on the tile of your Amazon Sales Channel.

  3. Click on the catalogue you want to edit.
    → 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.

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

  5. 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:

  1. 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.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

  3. 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.

  4. 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:

gif catalogue mapping simple en
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.

Creating a property:

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

Creating a simple 1:1 mapping with properties:

  1. 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.

  2. Expand the group Property.
    → The property groups are shown.

  3. Expand the group you need.

  4. Click on the Plus sign on the right of the property you want.

  5. From the drop-down list Language, select the language in which you send the data to the market.

  6. 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.

catalogue complex mappings

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:

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

  2. Select the value that you want to map a PlentyONE data field to.
    → The value is mapped.

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

  4. Click on a group.
    → The PlentyONE data fields of the group are shown.

  5. 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.

  6. 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:

gif catalogue mapping complex en
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:

  1. 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.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

  3. 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.

  4. 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".

  5. 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.

  6. 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.

gif catalogue mapping fallback en
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:

  1. 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.

  2. Click on the group you need.
    → The PlentyONE data fields of the group are shown.

  3. 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.

  4. Click on Confirm.

  5. 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.

  6. Map one or several additional PlentyONE data fields to the marketplace data field as described above.

  7. Click on Confirm.

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

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

  10. Click on Save.

  11. 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:

  1. 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.

  2. 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.

  3. 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:

gif catalogue own value en
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:

  1. 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.

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

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

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

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

    1. Click on the icon more_vert.

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

    3. Save the settings.

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

  7. Save the settings.
    → The entered formula is displayed in the overview.
    → The calculation will be carried out in the next export.

13.2.2. Particularities for mapping data fields in the offer 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.

13.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.

13.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 10. 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 the in 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:

  1. Go to Data » Catalogues.

  2. Open the offer catalogue for Amazon.

  3. Expand the group epr_product_packaging (chevron_right).

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

  5. Click add Add data source.

  6. Add the data source Own value (add). Leave the field Value empty.

  7. Click Save (save).
    → The data field will be deleted on Amazon during the next export.

Mapping own value
Figure 3. Example of a mapping with empty own value
13.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

13.2.2.4. Mapping the manufacturing country

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

  • Map the Manufacturing country ID.

or

  • 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:

  1. Go to Data » Catalogues.

  2. Open the offer catalogue for Amazon.

  3. Expand the group country_of_origin (chevron_right).

  4. In the field Export as, select the manufacturing country from the drop-down list.

  5. Click add Add data source and add the data source Item » Manufacturing country ID.
    → The data source Manufacturing country ID is added.

  6. 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.

  7. Click Save (save).

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

Mapping the manufacturing country ISO code:

  1. Go to Data » Catalogues.

  2. Open the offer catalogue for Amazon.

  3. Expand the group country_of_origin (chevron_right).

  4. In the field Export as, select the manufacturing country from the drop-down list.

  5. Click add Add data source and add the data source Item » Manufacturing country ISO-code.
    → The data source Manufacturing country ISO-code is added.

  6. Enter the ISO code of the manufacturing country as Comparative value for Manufacturing country ISO-code, for example GB for the United Kingdom.

  7. Click Save (save).

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

13.2.3. Deactivate 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.

Deactivate creation of new offers on Amazon:

  1. Go to Data » Catalogues.

  2. Open the offer catalogue for Amazon (export type Listing).

  3. Open the settings Settings tab of the catalogue.

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

  5. Click Save (save).

Price and stock updates are not affected

The processes for updating prices and stock (the settings Price changes and Stock changes in the Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » [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.

13.2.4. Activating the catalogue export

Creating a catalogue:

  1. Open the Sales Channels » Channel Control Centre menu.

  2. Click on the tile of your Amazon.

  3. Click Create catalogue (add).

  4. Enter a name for the catalogue.

  5. In the drop-down list Marketplace, select the option Amazon.

  6. In the drop-down list Export type, select the option Listing.

  7. In the drop-down list Amazon Account, select the Amazon account for which the catalogue is to be created.

  8. In the drop-down list Sales Channel, select the Amazon sales channel.

  9. In the drop-down list Category, select a category of the sales channel.

  10. 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.

Do 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.

14. 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. If you want to use filters to limit the actual catalogue export, then use the export filters Flag 1, Flag 2 and Tags in the Item settings of your Amazon account. They apply to both product and offer catalogues.

Applying filters for the preview:

  1. Go to Data » Catalogues.

  2. Open the catalogue for Amazon.

  3. Open the filter_alt filter_altFilterfilter_alt tab in the navigation bar on the left.

  4. In the Custom filters section, select the desired filters from the Select filter drop-down list.

  5. Click add Add filter. The available filters are explained in Table 11.
    → The filter is added.

  6. Depending on the filter, enter the desired IDs or select options from the drop-down list.

  7. Click Save (save).

Table 11. Filters for the preview of the export data
Filter Explanation

Variation IDs

Enter one or more order Variation IDs to filter for items with this variation ID. Separate multiple IDs using commas.

Item IDs

Enter one or more order 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:

  1. Go to Data » Catalogues.

  2. Open the catalogue for Amazon.

  3. In the toolbar at the top, click on Preview (preview).
    → A window with the preview of the export data opens.

  4. Optional: Click Download () in the preview window to save the preview as a file.
    → The preview of the export data is downloaded.

15. 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 Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » 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:

Testing the catalogue export:

  1. Go to Data » Catalogues.

  2. Open the catalogue for Amazon.

  3. Open the settings Settings tab in the navigation bar on the left.

  4. Activate the option Test mode in the section Amazon settings.

  5. Click Save (save).

  6. Go to Data » Catalogues.
    → The catalogues are listed.

  7. Scroll to the Amazon catalogue.

  8. 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 Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Data exchange » Data export » Area: Reports for catalogue export.

  • In the menu Data » Log.

    • Search for the integration Plenty\\Modules\\Amazon\\Item\\Listings\\Services\\HTTPDataSenderService and the identifier DataSenderService.

16. Manually exporting catalogues

In the Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » 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:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Data exchange » Data export.

  2. 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.

  3. 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.

  4. Click Export catalogue (settings_b_roll).
    → The catalogue is exported to Amazon.

17. Creating listings

Offers are transferred to Amazon as listings. Carry out the following steps to create listings for Amazon.

What are product listings and offer listings used for?
  • If the item you want to sell is not listed on the sales channel yet you will need to create a product listing for it first. Creating a product listing sends the product data to the sales channel and allows for the item to be listed.
    In order to actually be able to sell the item on the sales channel you will need to additionally create an offer listing. The offer listing contains data related to the sale of the item, such as its price and stock. In other words, a product listing allows you to list an item on a sales channel that did not previously exist on that sales channel, but in order to sell that item on that sales channel you also need an offer listing for that item.

  • If the item you want to sell is already listed on the sales channel you only need to create an offer listing. Offer listings send the data related to your offer, such as the price, stock, shipping costs etc., to the sales channel.
    In most cases you will only need an offer listing in order to offer a product on a sales channel. Many sales channels do not differentiate between product and offer listings. You only need to send offer listings to these kinds of sales channels.

17.1. Creating product listings

Product listings are created in three steps:

  • First, you enter listing details, meaning you select the platform, template, and catalogue for the listing.

  • Next, you select the variations from which the product listings are created.

  • Lastly, check and confirm your selection and create the listings.

Create product listings using the group function

You can also create product listings directly in the Items menu using the variation group function. You can find more information about the variation group function here.

Step 1: Specify listing details:

  1. Open the Sales Channels » Channel Control Centre menu.

  2. Open the account for Amazon.
    → The menu Channel settings opens.

  3. Open the menu format_list_bulleted Product listings.

  4. Click on add Create products.
    → The view Create products opens.

  5. Select the platform Amazon.

  6. Select the template for the catalogue.
    Tip: Only templates that are available for the platform Amazon are displayed.

  7. Select a catalogue with your mapping for item data.
    Tip: If you have no fitting catalogue yet, click on add Create catalogue. You will be forwarded to the Data » Catalogues menu and can create a catalogue.

  8. Optional: Activate Automatically activate listings after creation, if listing data should be automatically transferred to Amazon after the listing is created.

  9. Click arrow_forward NEXT.
    → The Select variations view opens. Next, select the variations you want to add to the listing.

Step 2: Select variations:

  1. Select the variations you want to create the product listing for.
    Tip: Use the search to filter for variations.
    Note: Only variations that are linked to Amazon in the Item » Items » [Open item] » [Open variation] menu are displayed.
    Tip: If you want to create a product listing for all available variations, click on Click here to create listings for all [] variations above. You will be automatically redirected to the Preview and confirmation step. Product listings can be created for a maximum of 50,000 variations at a time.

  2. Click add ADD TO SELECTED VARIATIONS.
    → The selected variations are displayed in the Selected variations section.
    Note: If you check a variation in the Selected variations section, you can remove the variation from the selection by clicking Remove from list.

  3. Click arrow_forward NEXT.
    → The selected variations will be displayed in a new view. In the last step, you preview and confirm your selection.

Step 3: Preview and confirm selection:

  1. Preview your settings in the Listing details section.

  2. Preview your selected variations in the Listing preview section. The listings are grouped by items. Extend a listing group (chevron_right) to see which variations are contained in the respective listing group.

  3. If everything is set and done, click CREATE PRODUCT LISTINGS.
    Note: If you activated Automatically activate listings after creation a window with a summary of your settings opens. Click check CONFIRM to create the product listings.

17.2. Activating product listings

After you have created the product listings, you have to activate the listings so that they can be transferred to Amazon.
To do so, activate the individual listings and the listing group. The listing can only be transferred to the sales channel if both the listing and the listing group are activated.

Note: You can also activate listings immediately after creation by activating the option Automatically activate listings after creation. If you activate the option to automatically activate listings after creation, you still have to activate the data exchange for the listing group.

Activating product listings:

  1. Open the menu Sales Channels » Channel Control Centre » [Open Amazon].
    → The menu Channel settings opens.

  2. Open the Product listings menu.

  3. In the line of the product listing you want to activate, click more_vert.

  4. Click toggle_on Activate data sync.
    Tip: If you want to activate multiple product listings at once, place a check mark next to the desired product listings and click toggle_on arrow_drop_down » Activate data sync at the top of the toolbar.
    → The data exchange for the listing is activated. The listing can only be transferred to the sales channel if the listing group is also activated.

Activating a listing group:

  1. Open the menu Sales Channels » Channel Control Centre » [Open Amazon].
    → The menu Channel settings opens.

  2. Open the Product listings menu.

  3. Open the listing group view (folder).

  4. In the line of the listing group you want to activate, click more_vert.

  5. Click toggle_on Activate data sync.
    Tip: If you want to activate multiple listing groups at once, place a check mark next to the desired listing groups and click toggle_on arrow_drop_down » Activate data sync at the top of the toolbar.
    → The data exchange for the listing group is activated.

17.3. Creating offer listings

Offer listings are created in three steps:

  • First, you enter listing details, meaning you select the platform, template, and catalogue for the listing.

  • Next, you select the variations from which the offer listings are created.

  • Lastly, check and confirm your selection and create the listings.

Step 1: Specify listing details:

  1. Open the Sales Channels » Channel Control Centre menu.

  2. Open the account for Amazon.
    → The menu Channel settings opens.

  3. Open the menu format_list_bulleted Offer listings.

  4. Click add arrow_drop_down and select Create offers.
    → The Create offers view opens.

  5. Select the platform Amazon.

  6. Select the template for the catalogue.
    Tip: Only templates that are available for the platform Amazon are displayed.

  7. Select the sales channel on which the listing should be offered.

  8. Select a catalogue with your mappings for offer data.
    Tip: If you have no fitting catalogue yet, click on add Create catalogue. You will be forwarded to the Data » Catalogues menu and can create a catalogue.

  9. Optional: Activate Automatically activate listings after creation, if listing data should be automatically transferred to Amazon after the listing is created.

  10. Click arrow_forward NEXT.
    → The Select variations view opens. Next, select the variations you want to add to the listing.

Step 2: Select variations:

  1. Select the variations you want to create the offer listing for.
    Tip: Use the search to filter for variations.
    Note: Only variations that are linked to Amazon in the Item » Items » [Open item] » [Open variation] menu are displayed.
    Tip: If you want to create offer listings for all available variations, click on Click here to create listings for all [] variations above. You will be automatically redirected to the Preview and confirmation step. Offer listings can be created for a maximum of 50,000 variations at a time.

  2. Click add ADD TO SELECTED VARIATIONS.
    → The selected variations are displayed in the Selected variations section.
    Note: If you check a variation in the Selected variations section, you can remove the variation from the selection by clicking Remove from list.

  3. Click arrow_forward NEXT.
    → The selected variations will be displayed in a new view. In the last step, you preview and confirm your selection.

Step 3: Preview and confirm selection:

  1. Preview your settings in the Listing details section.

  2. Preview your selected variations in the Listing preview section. The listings are grouped by items. Extend a listing group (chevron_right) to see which variations are contained in the respective listing group.

  3. If everything is set and done, click CREATE OFFER LISTINGS.
    Note: If you activated Automatically activate listings after creation a window with a summary of your settings opens. Click check CONFIRM to create the offer listings.

17.4. Activating offer listings

After you have created the offer listings, you have to activate the listings so that they can be transferred to Amazon.
To do so, activate the individual listings and the listing group. The listing can only be transferred to the sales channel if both the listing and the listing group are activated.

Note: You can also activate listings immediately after creation by activating the option Automatically activate listings after creation. If you activate the option to automatically activate listings after creation, you still have to activate the data exchange for the listing group.

Activating offer listings:

  1. Open the menu Sales Channels » Channel Control Centre » [Open Amazon].
    → The menu Channel settings opens.

  2. Open the Offer listings menu.

  3. In the line of the offer listing you want to activate, click more_vert.

  4. Click toggle_on Activate data sync.
    Tip: If you want to activate multiple offer listings at once, place a check mark next to the desired offer listings and click toggle_on arrow_drop_down » Activate data sync at the top of the toolbar.
    → The data exchange for the listing is activated. The listing can only be transferred to the sales channel if the listing group is also activated.

Activating a listing group:

  1. Open the menu Sales Channels » Channel Control Centre » [Open Amazon].
    → The menu Channel settings opens.

  2. Open the Offer listings menu.

  3. Open the listing group view (folder).

  4. In the line of the listing group you want to activate, click more_vert.

  5. Click toggle_on Activate data sync.
    Tip: If you want to activate multiple listing groups at once, place a check mark next to the desired listing groups and click toggle_on arrow_drop_down » Activate data sync at the top of the toolbar.
    → The data exchange for the listing group is activated.

17.5. Viewing listing errors

The Errors tab of the Sales Channels » Channel Control Centre » [Open sales channel] » Offer listings / Product listings menu provides an overview of all errors that occurred in PlentyONE when exporting your product and offer listings.
Tip: The overview of listing errors is only displayed if at least one error has occurred when exporting the listings.

Here you can see:

  • the affected listings

  • error details

For each error, you can download a CSV file containing the affected listings by clicking the download button. You can correct the errors directly in the CSV file. You can then re-import the corrected CSV file.

Table 12 contains an overview of listing errors.

Table 12. Listing errors of offer listing and product listings
Column Explanation

keyboard_arrow_down [Information about the error]

Information about the error is provided here. It contains the affected field of the data record, a brief description of the error and the number of listings for which this error has occurred.
Example: "Field: gtin Error: Given data is not a string. (1)"
→ The error occurred in the gtin field of the data record.
→ The error occurred because no character string was entered as a value in the gtin field.
→ The error has occurred for one listing.

download Download data as CSV

The CSV file with the data records is downloaded.

Listing name

The name of the listing.

Parent SKU

The parent SKU of the main variation.

SKU

The SKU of the sub-variation.

Variation ID

The ID of the variation.

Channel

The sales channel to which the listing is exported.

Export activity

Shows whether the variation is being exported.

  • Active (circle) = The variation is exported with the listing.

  • Not active (circle) = The variation is not exported with the listing.

Status

The listing’s status on the sales channel.

Possible statuses are:

  • help = Unknown

  • progress_activity = Outstanding

  • progress_activity = Creation pending

  • cancel = Failed (before creation)

  • check_circle = Online

  • cancel = Failed (on update)

  • pause_circle = Paused

  • unpublished = Offline

Errors

The error overview.
No entry = No errors occurred.
circle = Errors occurred. The number indicates the number of errors.

Template

The template selected for the listing.

Catalogue

The catalogue selected for the listing.

18. Manually importing Amazon orders

In the menu Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Data exchange » Order import you can manually import Amazon orders from a CSV file.

Setting up the manual order import:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Data exchange » Order import.

  2. Select the option Import CSV file from the Process for order import drop-down list.
    → The Settings area opens.

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

  4. Click on Preview () to show a preview of the import.

Table 13. Order import for Amazon
Setting Explanation

Book incoming payment

The payment is automatically booked when importing the order.

Use old format

Activate if you still use the old Amazon import format.

Client

Select the client for the order import.

Amazon account

Select the Amazon account.

CSV file

Select the CSV file for the order import.

Selecting the CSV file for the order import:

  1. Click on Select file.

  2. Select the CSV file for the import.

  3. Click on Open.

  4. Click on Preview ().
    → The available orders are displayed.

  5. For the orders that are to be exported, activate the option Import.

  6. Click on the gear-wheel icon to carry out the import.

If orders are imported from Amazon that you did not upload with PlentyONE and/or that contain items which have not yet been created in PlentyONE, then you can manually assign the items for these orders and set the corresponding status.
Missing invoice address

If the invoice address is missing from the orders that were retrieved from Amazon, then contact the Amazon support. Amazon has to carry out this setting.

Original currency and standard currency are different

Additional information is saved for orders that are imported with a different currency than the standard currency saved in PlentyONE. In this case, both the original currency and the original gross and net amounts are saved for every item included in the order.

19. Setting up invoice generation for Amazon orders

Invoices for your Amazon orders can be generated in different ways, depending on the settings you select in the Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » [Select Amazon account] » Tab: Settings.

Table 14. Options for generating invoices
Option Explanation

Amazon Invoice Document Uploader - IDU

PlentyONE calculates the VAT. PlentyONE generates the invoice via a flow.
Note: You need to create the flow manually.
Tip: In the menu Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » [Select Amazon account] » Tab: Settings this option is called plentymarkets.
How to set up Amazon Invoice Document Uploader - IDU

VCS Amazon

Amazon invoice numbers and credit notes for Amazon orders are imported into PlentyONE.
Note: VCS must be activated in Amazon Seller Central.
Important: Invoices for Amazon orders can no longer be created manually or with a flow.
How to set up VCS Amazon

VCS plentymarkets (VCS Lite)

Amazon calculates the VAT. Amazon invoices are automatically generated by PlentyONE and transferred to Amazon.
Tip: Amazon calls this option VCS Lite.
Note: VCS must be activated in Amazon Seller Central.
Important: Invoices for Amazon orders can no longer be created manually or with a flow.
How to set up VCS plentymarkets (VCS Lite)

Best practice for Amazon VCS

Also read the best practice for Amazon VCS. This contains additional information about setting up Amazon’s invoice service VCS in PlentyONE.

19.1. Setting up Amazon IDU

VCS is an optional service. If you activate this service in Amazon Seller Central, Amazon calculates the VAT for your Amazon orders. If you do not want to use Amazon VCS, you can upload invoice documents created in PlentyONE to Amazon (Amazon Invoice Document Uploader - IDU). Proceed as described below.

  • You can only upload invoices to Amazon after a shipping confirmation was sent to Amazon.

  • Amazon rejects invoices if the invoice number contains spaces. As such, make sure that your number range for invoices does not contain any spaces.

Activating Amazon IDU in PlentyONE:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon sales channel] » [Amazon account] » Tab: Settings.

  2. For the setting Generate invoice, select the option plentymarkets.

  3. Click Save (save).
    → PlentyONE calculates the VAT for Amazon orders.
    → Invoices for Amazon orders are created by PlentyONE.

  4. Set up the flow described below to upload invoices to Amazon.

19.1.1. Automatically uploading invoices to Amazon

Create an event-based flow to automatically upload invoices to Amazon that have been created either by PlentyONE or with an external software. However, invoices created by PlentyONE always take priority over external invoices. This means that all invoice documents are checked and if invoices created by PlentyONE are found, they are uploaded first. If there is no PlentyONE invoice, the external invoice will be uploaded to Amazon.

What is PlentyONE Flow?

With PlentyONE Flow (short: "Flow"), you can automate workflows for your business processes. Flow provides you with two functions in the Automation menu:

  • In Flow Studio, you create and configure automated workflows. Depending on the trigger type, there are three types of flows: event-based, time-based or manual.

  • In the Flow Tracker, you can monitor running or completed workflows.

The central element in both functions is the Canvas – a graphical interface on which the workflows are visualised with Actions and Controls. In Flow Studio the canvas can be edited, in Flow Tracker it is only used for visualisation and is therefore read-only.

Creating an event-based flow
  1. Go to Automation » Flow Studio.

  2. Click Create flow (add).
    → A stepper opens and guides you through the following three steps.

    1. General

      1. Enter a unique name and, if necessary, a description for the new flow.

      2. Click Next.

    2. Trigger

      1. Select Event-based as the trigger.

      2. Click Next.

    3. Settings

      1. If desired, select a UI from the optional drop-down list Flow available in.
        → The option to manually trigger the flow directly from the selected UI is added to the group functions in that UI.
        Note: UIs currently selectable: Order UI.

      2. From the drop-down list Trigger selection, select the event according to Table 15.
        Note: If the trigger event has additional settings, then these are invariably mandatory. Without performing these settings, you will not be able to save the flow.

      3. Save () the settings.
        → The flow is created.
        → The Flow Studio Canvas appears, on which two elements are already displayed: The trigger type and the placeholder for the next step.
        Note: With some event-based flows you cannot save the flow if it consists of only a trigger. In such cases, you need to add at least one further step.

  3. Configure the new flow according to Table 15.

  4. Save () the settings.

Note: The selected statuses, controls and filters in Table 15 only serve as an example. Select the statuses, controls and filters for the flow which best suit your workflow.

Table 15. Event-based flow for uploading invoices to Amazon
Setting Option Selection

Trigger selection

Select an event, for example:

  • Document > Document created

Select a document type, for example:

  • Invoice

Controls

Branch

  • Object type: Order

  • Filter settings for the branch:

Note: If there is more than one filter, add the others as conditions (playlist_add). Select AND as the relationship between the conditions.

Filter Operator Input field

Order > Order referrer

Is in (IN)

Select the order referrers for the Amazon sales channels that you want to use this flow for.

Actions

Multichannel > Amazon

Upload invoice / credit note to Amazon

19.2. Setting up VCS plentymarkets/VCS Lite

If you select VCS plentymarkets, Amazon calculates the VAT, but invoices for Amazon orders are created by PlentyONE and automatically uploaded to Amazon. Amazon calls this option VCS Lite.

  • You can only upload invoices to Amazon after a shipping confirmation was sent to Amazon.

  • Amazon rejects invoices if the invoice number contains spaces. As such, make sure that your number range for invoices does not contain any spaces.

19.2.1. Activating VCS plentymarkets/VCS Lite in Amazon Seller Central

To get started, activate the VCS service in Amazon Seller Central.

Activating VCS plentymarkets/VCS Lite in Amazon Seller Central:

  1. Log into Amazon Seller Central.

  2. Go to Settings » Tax settings » VAT calculation settings.

  3. Navigate to the area Invoice generation.

  4. Select the option I will upload my own VAT invoices.

  5. Optional: Select the date that you want the Amazon VAT calculation service to start.

  6. Save the settings.
    → The date on which the VCS service is activated is displayed.

  7. Write down the date shown.
    Tip: On the activation date, the VCS service is activated at 12 pm Universal Time (UTC).

  8. Set yourself a reminder for the day on which you need to activate Amazon VCS in PlentyONE.

19.2.2. Activating VCS plentymarkets/VCS Lite in PlentyONE

On the date Amazon activates the VCS settings, you also need to activate VCS plentymarkets in PlentyONE. To do so, proceed as described below.

Activating VCS plentymarkets/VCS Lite in PlentyONE:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon sales channel] » [Amazon account] » Tab: Settings.

  2. For the setting Generate invoice, select the option VCS plentymarkets.
    Important: Only activate VCS plentymarkets on the date on which Amazon VCS is activated in Amazon Seller Central.
    Tip: On the activation date, the VCS service is activated at 12 pm Universal Time (UTC).

  3. Click Save (save).
    → Invoices for Amazon orders are automatically generated by PlentyONE and transferred to Amazon.
    → Amazon calculates the VAT for Amazon orders.
    → Invoices for Amazon orders can no longer be created manually or with a flow.

  4. Important: If you have used Amazon IDU up to now, deactivate the flow that uploads invoices to Amazon. Otherwise, invoice documents are uploaded to Amazon in douplicates. This can overload the interface so that some invoices are not uploaded to Seller Central at all.

19.3. Setting up VCS Amazon

If you activate VCS Amazon, Amazon calculates the VAT and generates the invoices for your Amazon orders. Amazon invoice numbers and credit notes for Amazon orders are imported into PlentyONE.

19.3.1. Activating VCS Amazon in Amazon Seller Central

To get started, activate the VCS service in Amazon Seller Central.

Activating VCS Amazon in Amazon Seller Central:

  1. Log into Amazon Seller Central.

  2. Go to Settings » Tax settings » VAT calculation settings.

  3. Navigate to the area Invoice generation.

  4. Select the option I want Amazon to automatically generate VAT invoices..

  5. Optional: Select the date that you want the Amazon VAT calculation service to start.

  6. Save the settings.
    → The date on which the VCS service is activated is displayed.

  7. Write down the date shown.
    Tip: On the activation date, the VCS service is activated at 12 pm Universal Time (UTC).

  8. Set yourself a reminder for the day on which you need to activate Amazon VCS in PlentyONE.

19.3.2. Activating VCS Amazon in PlentyONE

On the date Amazon activates the VCS settings, you also need to activate VCS Amazon in PlentyONE. To do so, proceed as described below.

Activating VCS Amazon in PlentyONE:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon sales channel] » [Amazon account] » Tab: Settings.

  2. For the setting Generate invoice, select the option VCS Amazon.
    Important: Only activate VCS Amazon on the date on which Amazon VCS is activated in Amazon Seller Central.
    Tip: On the activation date, the VCS service is activated at 12 pm Universal Time (UTC).

  3. Click Save (save).
    → Amazon calculates the VAT for Amazon orders.
    → Invoice numbers for Amazon orders are generated by Amazon and imported into PlentyONE.
    → Invoices for Amazon orders can no longer be created manually or with a flow.

  4. Important: If you have used Amazon IDU up to now, deactivate the flow that uploads invoices to Amazon. Otherwise, invoice documents are uploaded to Amazon in douplicates. This can overload the interface so that some invoices are not uploaded to Seller Central at all.

19.4. Troubleshooting: Manually uploading invoices

If all your settings for the invoice creation are correct, invoice information is exchanged with Amazon automatically. Were not all invoices for your Amazon orders uploaded to Amazon?

  • Make sure that you have set up the upload of invoices for Amazon orders correctly as described in this chapter.

  • If all settings are correct and only some invoices are missing, you can upload these invoices to Amazon manually. To do so, proceed as described below.

Manually uploading invoices to Amazon:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Data exchange » Reports.

  2. Open the tab Upload invoices.

  3. From the drop-down list Order ID type, select the option Order ID.
    Tip: If part shipments exist in the system, not all invoices are uploaded when you select the option Amazon order ID. As such, we recommend the option Order ID.

  4. Enter the ID of the invoice.
    Tip: Enter more than one order ID separated by commas.

  5. Click on Apply ().
    → PlentyONE starts to upload any missing invoices for valid orders to Amazon.

19.5. Troubleshooting: Unlocking VCS orders for manual invoice creation

When you use the VCS service, you do not generate invoice documents yourself. Instead, all order documents are generated automatically when the VCS reports are imported. As such, orders are locked for manual invoice generation. However, in some cases you need to manually generate invoices for VCS orders:

  • Amazon is the customer.

  • You did not save a VAT identification number (VATIN) for the country in which the order originated in Seller Central.

  • The order is not really a VCS order and was imported retroactively. This happens if the order was placed before you activated VCS but imported after you activated VCS.

In such cases, you need to unlock the VCS orders manually. This allows you to generate the necessary invoice documents.

VCS reports still have the highest priority. That includes unlocked orders for which you have manually generated invoice documents. If Amazon sends invoice documents in a subsequent VCS report, the invoices you generated are cancelled and a new invoice is generated.

Unlocking VCS orders:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Data exchange » Reports.

  2. Switch to the tab Unlock VCS orders

  3. In the drop-down list Order ID type, select if you want to enter the Amazon order ID or the PlentyONE Order ID to search for the orders.

  4. In the field Order ID list, enter the ID of the orders. To enter several IDs, separate them by commas.

  5. Click Unlock VCS orders ().
    → The Results area shows how many orders were unlocked. The table shows the status of each order.
    → You can manually generate invoice documents for the unlocked orders.
    Important: If Amazon transfers their own documents in a subsequent VCS report, the invoice documents that you created manually will become invalid: As a result, your invoice documents are cancelled and a new invoice is created.

Viewing unlocking events in the data log

Go to Data » Log to find out when and by which user orders were unlocked. Table 16 shows the filters you can use to find unlocking events in the log.

Table 16. Recommended filters for unlocking events
Filter Selection

Integration

PlentyLegacy\\ModMarkets

Identifier

AmazonUnlockVcsOrder

References

  • amazonOrderId

  • orderId

Viewing unlocking events in the data log:

  1. Go to Data » Log.

  2. In the column to the left, select appropriate filters from the drop-down lists.

  3. Optional: Select filters for dates and/or times to only show entries from a specific period.
    Tip: For further information about the filters, refer to the Data log page of the manual.

  4. Click Search ().
    → The results are shown.

20. Permitting payment method in customer classes

As soon as an active Amazon account exists, the Amazon payment method is automatically available in your plentymarkets system. No separate configurations are needed for this. You just need to permit the payment method in one or more customer classes.

Permitting the payment method in a customer class:

  1. Go to Setup » CRM » Customer classes.

  2. Open the customer class for which you want to permit the payment method.

  3. For the setting Allowed payment methods, activate the option Amazon.

  4. Save () the settings.

21. Carrying out Amazon specific shipping profile settings

Since 19/4/2021, the names of shipping service providers and shipping services that are communicated to Amazon to register a shipping must be identical to the names used in Seller Central. To ensure that the names are identical, you need to link your shipping service providers and shipping services with the values that Amazon accepts. This is done in your shipping profiles.

Carrying out Amazon specific shipping profile settings:

  1. Go to Setup » Orders » Shipping » Settings.

  2. Click on the Shipping profiles tab.

  3. Open the shipping profile.

  4. Click on the Table of shipping charges tab.

  5. Expand the region ().

  6. Navigate to the area Amazon shipping settings.

  7. Select the drop-down list Transport service, select the shipping service provider.

  8. From the drop-down list Shipping service, select the type of shipping.
    Note: The drop-down lists contain values for most common services. If you want to send other values, select the option Other and enter the value in the input field.

  9. Click Save (save).
    → When registering the shipping, the selected values are sent to Amazon for this shipping profile.
    Note: If you do not select any values from the drop-down lists, the shipping profile’s default values are sent to Amazon.

  10. Optional: Repeat these settings for all shipping profiles that you use for Amazon.

22. Sending shipping confirmations to Amazon

As soon as the Amazon order was processed in your PlentyONE system and the goods were shipped, you have to inform Amazon of the new status so that the sales figures can be credited to your account. Your PlentyONE system automatically takes care of this important step via the interface as well.

Orders have to meet the following requirements in order for the shipping confirmation to be sent to Amazon:

  • Referrer: Amazon or an Amazon sub-referrer

  • Status range 7 (less than 8)

  • External order number

  • Imported order (not created manually)

  • Outgoing items booked (time must not be in the future)

Important: For Amazon.co.uk orders, a "Ship From" address can also be transmitted in the shipping confirmation. This address affects Amazon’s VAT calculation. If the address is missing, Amazon may assume a different shipping country, causing the calculated VAT to not match that of your actual shipping country.

The "Ship From" address is transmitted automatically once the required sender information has been entered and saved for each warehouse. You can enter the sender information in the menu Setup » Orders » Shipping » Shipping service provider » Settings » [Open warehouse].

The following fields are transmitted:

  • Company

  • Street

  • House number

  • Additional address information

  • Postcode

  • Town

  • Country

To ensure the VAT is calculated correctly, at a minimum the fields Company, Street and Country must be completed.

22.1. Manually sending shipping confirmations:

If the shipping confirmation is not automatically transferred, for example because the servers are temporarily unavailable, or if you want orders to be manually confirmed shortly before an accounting deadline, so that they will still be taken into consideration during the next payment, then you can also transfer shipping confirmations manually to Amazon. No shipping confirmation is sent to Amazon for Prime orders (Amazon_Prime, Amazon_PrimeSame_Day, Amazon_Prime_NextDay, and Amazon_Prime_SecondDay).

Manually sending shipping confirmations to Amazon:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Data exchange » Shipping confirmation.

  2. Select an Amazon account from the drop-down list.

  3. Enter a date next to Items shipped on.
    → All of the outgoing items from this date are transmitted to Amazon.

  4. Click on Send shipping confirmation.

Note: Currently it is not possible to send shipping confirmations for orders of the type delivery order to Amazon via PlentyONE.

23. Editing returns

Even with Amazon, you have to anticipate the occasional order cancellation after a shipment has taken place. The customer then has to send the items back to you directly.

Important: To create and import Amazon returns, an Amazon SKU must be assigned to the item in the order. For further information refer to the Define SKU manually sections.

For further information about creating a return in PlentyONE and resetting the outgoing items again, refer to the Booking items out page of the manual.

Amazon received the customer’s payment on your behalf. As such, the reversal also has to take place via Amazon. You also have to take care of this in the order folder in the Amazon Seller Central.

Carrying out a reversal manually or via flow

The interface does not automatically trigger the refund of the purchase price with Amazon. Rather, this has to be carried out manually or automatically with the help of a flow. If you forget to manually refund the sum or if you forget to set up a flow for automatically refunding the purchase price, you risk a customer complaint with Amazon and negative feedback.

MFN returns (= shipment by the seller) can be reported to Amazon in form of credit notes with an event procedure. Returns for Amazon can only be created for orders of the type Credit note. To do so, proceed as described below.

23.1. Creating order statuses

First, create an order status for Amazon returns in the Setup » Orders » Order status menu, for example [9.6] Return sent to Amazon. You need this order status for the Amazon settings.

23.2. Setting the order status

Set this order status in the Amazon settings as described below.

Setting an order status for returns:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon sales channel] » Settings.

  2. Select the Amazon account.

  3. Click on the Order settings tab.

  4. For the setting Status for transmitted returns, select the order status that you previously created for Amazon returns.

  5. Click Save (save).

23.3. Sending returns to Amazon automatically

Create an event-based Flow to automatically send returns in form of credit notes to Amazon. As soon as the flow action Create a return at Amazon is triggered in PlentyONE, the credit note created at Amazon is repayed.

Flows and credit note import

Use flows to initiate refunds in PlentyONE. The automatic credit note import (option "Credit note import" in the order settings) ensures that credit notes are not duplicated in your system. If you manually create credit notes or have them created by a third-party system and there are no credit notes in your PlentyONE system, a credit note is created during the import.

What is PlentyONE Flow?

With PlentyONE Flow (short: "Flow"), you can automate workflows for your business processes. Flow provides you with two functions in the Automation menu:

  • In Flow Studio, you create and configure automated workflows. Depending on the trigger type, there are three types of flows: event-based, time-based or manual.

  • In the Flow Tracker, you can monitor running or completed workflows.

The central element in both functions is the Canvas – a graphical interface on which the workflows are visualised with Actions and Controls. In Flow Studio the canvas can be edited, in Flow Tracker it is only used for visualisation and is therefore read-only.

Creating an event-based flow
  1. Go to Automation » Flow Studio.

  2. Click Create flow (add).
    → A stepper opens and guides you through the following three steps.

    1. General

      1. Enter a unique name and, if necessary, a description for the new flow.

      2. Click Next.

    2. Trigger

      1. Select Event-based as the trigger.

      2. Click Next.

    3. Settings

      1. If desired, select a UI from the optional drop-down list Flow available in.
        → The option to manually trigger the flow directly from the selected UI is added to the group functions in that UI.
        Note: UIs currently selectable: Order UI.

      2. From the drop-down list Trigger selection, select the event according to Table 17.
        Note: If the trigger event has additional settings, then these are invariably mandatory. Without performing these settings, you will not be able to save the flow.

      3. Save () the settings.
        → The flow is created.
        → The Flow Studio Canvas appears, on which two elements are already displayed: The trigger type and the placeholder for the next step.
        Note: With some event-based flows you cannot save the flow if it consists of only a trigger. In such cases, you need to add at least one further step.

  3. Configure the new flow according to Table 17.

  4. Save () the settings.

Note: The selected statuses, controls and filters in Table 17 only serve as an example. Select the statuses, controls and filters for the flow which best suit your workflow.

Table 17. Event-based flow to report returns to Amazon
Setting Option Selection

Trigger selection

Select a suitable trigger.
Important: Do not select the trigger Order > Order created and the order type Credit note. This may lead to credit notes being created multiple times at Amazon.

Controls

Branch

  • Object type: Order

  • Filter settings for the branch:

Note: If there is more than one filter, add the others as conditions (playlist_add). Select AND as the relationship between the conditions.

Filter Operator Input field

Order > Order referrer

Is in (IN)

Select the order referrers for the Amazon sales channels that you want to use this flow for.
Note: Do not select an Amazon FBA referrer such as Amazon FBA Germany for the Order > Referrer filter if you use the automatic credit note import.

Actions

Multichannel > Amazon

Create a return at Amazon

24. Reserving stock for pending orders

Pending orders are imported into your PlentyONE system with the status [1] Incomplete data and remain there until Amazon approves the orders. Until the approval, no addresses or prices will be saved for the order. After the approval by Amazon, the order is updated and addresses and prices are saved. The automatic stock update decides in which status the order is placed.

If Amazon does not approve the order, the order is not updated, but instead automatically set to status [8] Cancelled.

There are two ways to reserve stock for pending orders in PlentyONE:

  • Option 1: PlentyONE Flow

  • Option 2: Directly in the basic order settings

24.1. Option 1: PlentyONE Flow

Create an event-based flow to automatically put the order from status 1 to a status where stock is reserved.

What is PlentyONE Flow?

With PlentyONE Flow (short: "Flow"), you can automate workflows for your business processes. Flow provides you with two functions in the Automation menu:

  • In Flow Studio, you create and configure automated workflows. Depending on the trigger type, there are three types of flows: event-based, time-based or manual.

  • In the Flow Tracker, you can monitor running or completed workflows.

The central element in both functions is the Canvas – a graphical interface on which the workflows are visualised with Actions and Controls. In Flow Studio the canvas can be edited, in Flow Tracker it is only used for visualisation and is therefore read-only.

Creating an event-based flow
  1. Go to Automation » Flow Studio.

  2. Click Create flow (add).
    → A stepper opens and guides you through the following three steps.

    1. General

      1. Enter a unique name and, if necessary, a description for the new flow.

      2. Click Next.

    2. Trigger

      1. Select Event-based as the trigger.

      2. Click Next.

    3. Settings

      1. If desired, select a UI from the optional drop-down list Flow available in.
        → The option to manually trigger the flow directly from the selected UI is added to the group functions in that UI.
        Note: UIs currently selectable: Order UI.

      2. From the drop-down list Trigger selection, select the event according to Table 18.
        Note: If the trigger event has additional settings, then these are invariably mandatory. Without performing these settings, you will not be able to save the flow.

      3. Save () the settings.
        → The flow is created.
        → The Flow Studio Canvas appears, on which two elements are already displayed: The trigger type and the placeholder for the next step.
        Note: With some event-based flows you cannot save the flow if it consists of only a trigger. In such cases, you need to add at least one further step.

  3. Configure the new flow according to Table 18.

  4. Save () the settings.

Note: The selected statuses, controls and filters in Table 18 only serve as an example. Select the statuses, controls and filters for the flow which best suit your workflow.

Table 18. Event-based flow for automatically updating order statuses
Setting Option Selection

Trigger selection

Select a trigger, for example:

  • Order > Order created

For Order types, select the type Incomplete order.

Controls

Branch

  • Object type: Order

  • Filter settings for the branch:

Note: If there is more than one filter, add the others as conditions (playlist_add). Select AND as the relationship between the conditions.

Filter Operator Input field

Order > Order type

Is in (IN)

Sales order

Order > Order referrer

Is in (IN)

Select the order referrers for the Amazon sales channels that you want to use this flow for.

Actions

Order > Change order status

Select the order status from the drop-down list in which stock will be reserved.

24.2. Option 2: Directly in the basic order settings

In the basic settings of the order you can define in which order statuses stock is reserved with the setting Status for order reservation.

Defining order status for stock reservation:

  1. Go to Setup » Orders » Settings.

  2. For Status for order reservation, select the statuses for which stock should be reserved.

  3. Click Save (save).

25. Managing Amazon reports

The Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Reports » Processing menu provides an overview of the processing status of your Amazon reports. In this menu, you can see which reports have already been processed and which reports are still in the queue.
You can also reset or skip your Amazon reports here. That way, you can define which reports should be processed first. Or you can reduce your system’s workload by skipping reports.
Besides that, you can also download your Amazon reports in this menu.
Note: When importing reports, orders are imported asynchronously. This means that when reports are imported, orders are imported in parallel.

Table 19 contains an overview of the Amazon reports in the menu Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Reports » Processing.

If you only want to take a look at certain reports, then you can apply filters and narrow down the reports which are displayed. To do so, click on Filters (tune) at the top of the menu.
Table 19. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon sales channel] » Reports.
Column Explanation

Seller ID

The seller ID of your Amazon seller account.

Report ID

The report ID of the Amazon report.

Processing status

The processing status of the report.
Reports can have the following statuses:
Pending (circle) = The report has not been processed yet.
Processing (circle) = The report is currently being processed.
Skipped (circle) = The report was skipped and has not been processed.
Done (circle) = The report was processed.
Done with errors (circle) = One or more errors occurred while processing the report, but at least one order was processed successfully.
Error (circle) = None of the orders could be processed successfully. The import of the report information failed.

Report type

The report type. An overview of all Amazon report types is available here.
If you hover over a report type, a tooltip with information about this report type is shown.

Report created on

Shows the date and the time when the report was created.

Report updated on

Shows the date and the time when the report was last updated.

Actions

Which Amazon report types are available?

The table below contains an overview of all Amazon report types.

Table 20. Report types
Report type What does the report do?

Amazon Fulfillment Network - Stock report

  • Stock synchronization for FBA stock

Amazon Fulfillment Network - Returns

  • Importing FBA returns

Amazon Fulfillment Network - Order report - EU

  • Importing FBA orders for EU sellers

Amazon Fulfillment Network - Order report - NA

  • Importing FBA orders for North American sellers

VCS Lite - Data

  • Correcting orders for VCS Lite and VCS plentymarkets

  • Generating missing invoices

VCS - Invoices generated by Amazon

  • Correcting and importing external invoices and credit notes based on VCS/VCS Amazon

Merchant Fulfilled Network - Order report - EU

  • Importing FBM orders for EU sellers

Merchant Fulfilled Network - Order report - NA

  • Importing FBM orders for North American sellers

25.1. Requesting reports

In the menu Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Reports » Request you can request Amazon reports manually. For example, this can be useful if data is missing in your Amazon reports and you want to request a new report.

Notes on requesting reports:

  • You can only request reports of a period of a maximum of one week.

  • The timeframe of the requested report should be as short as possible, as processing big reports can cause issues due to the amount of data.

  • The number of requests is limited. For example, you can only request certain report types 2 or 5 times per day.

Reports without data cannot be created

If no data exists for the requested time frame of the report, then Amazon will not create the report. Currently, it is not possible for PlentyONE to inform customers that a report could not be created.

Requesting a report:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon sales channel] » Reports » Request.

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

  3. Click on Request.
    → The requested report is created by Amazon. As soon as the report is available, you can retrieve it in the Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Reports » Processing menu in your PlentyONE system.
    → It can take several minutes until the report is available in your system.

Table 21. Requesting the creation of a report
Setting Explanation

Start date (mandatory)

Enter a date in the format DD.MM.YYYY or select a date via the calendar (today).

Start time (mandatory)

Enter a time or select it via (schedule).

End date

Enter a date in the format DD.MM.YYYY or select a date via the calendar (today).

End time

Enter a time or select it via (schedule).

Seller ID (mandatory)

Select the seller ID of the Amazon seller account that you want to requests reports for.

Report type (mandatory)

Select the report type. If you hover over a report type in the drop-down list, a tooltip with information about this report type is shown.
Note: The number of requests is limited. After you selected a report type, you will see how often per day you can request it below the report.

26. Retrieving Amazon feeds

The Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Feeds menu provides an overview of the processing status of your Amazon feeds. You can also download the feed requests sent by PlentyONE to Amazon and the feed submission results received from Amazon. This allows you to see which data PlentyONE has sent to Amazon for processing a specific feed type and whether Amazon has successfully processed this data.

Note: You can retrieve and view the data that PlentyONE has sent to Amazon for updating prices and stock levels in the data log. If errors have occurred during the price or stock update, you can download the error reports in the data export menu.

What is an Amazon feed?

An Amazon feed is a structured data file that contains information about your items, orders, listings or invoices. This data file is sent to Amazon to create listings on the Amazon marketplace or update item data, order data, listing data and invoice data. Amazon feeds contain data such as product titles, prices, images and stock levels. Depending on the task, the Amazon feeds are divided into different feed types.

What are feed request and feed submission result?

The feed request contains the data that PlentyONE transmits to Amazon. The transmitted data varies depending on the feed type (e.g. Order Fulfillment Feed, Upload VAT invoice Feed, etc.). In the feed submission result, you can see whether Amazon has successfully processed the data from the feed request.

Table 22 contains an overview of the Amazon feeds in the menu Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Feeds.

If you only want to take a look at certain Amazon feeds, then you can apply filters and narrow down the Amazon feeds which are displayed. To do so, click on Filters (tune) at the top of the menu.
Table 22. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon sales channel] » Feeds.
Column Explanation

Seller ID

The seller ID of your Amazon seller account.

Feed type

The feed type. An overview of the feed types for Amazon feeds is available here.

Processing status

The processing status of the Amazon feed.
Amazon feeds can have the following statuses:

  • Uploaded (circle) = The Amazon feed has been sent to Amazon but has not yet been processed. The feed submission result will be ready for download in several minutes.

  • Ready to request (circle) = The feed submission result can be requested manually. To do so, click on Request Feed Submission Result on Amazon (schedule_send) in the row with the desired Amazon feed.
    Note: This status is only available for Amazon feeds of the feed type Upload VAT invoice. For the feed type Upload VAT invoice, the feed submission results are not automatically available for download. They have to be requested manually first.

  • Done (circle) = The Amazon feed has been processed by Amazon. The feed request and the feed submission result are available for download.

  • Done with warnings (circle) = The Amazon feed was sent to Amazon, but warnings occurred during processing. The feed request and the feed submission result are available for download. You can view the warnings in the feed submission result.

  • Done with errors (circle) = The Amazon feed was sent to Amazon, but errors occurred during processing. The feed request and the feed submission result are available for download. You can view the errors in the feed submission result.

  • Unparseable (circle) = The file format of the feed submission result is not readable.

Feed ID

The feed ID of the Amazon feed.

Marketplace IDs

The marketplace IDs of the Amazon marketplaces to which the Amazon feed is applied.
The marketplace ID corresponds to the country code of the Amazon URL, e.g:

  • de = Germany

  • nl = Netherlands

  • co_uk = United Kingdom

Actions

  • Request Feed Submission Result on Amazon (schedule_send): The feed submission result is requested on Amazon. After clicking Request Feed Submission Result on Amazon, the button is deactivated and greyed out.
    Note: The system checks every 5 seconds whether the feed submission result is available. As soon as the feed submission result is available for download, the processing status changes to Done, Done with warnings o or Done with errors.

  • Download Feed Request (sim_card_download): The feed request is downloaded.
    Note: The feed submission result is downloaded as an XML, CSV or PDF file. The file type depends on the feed type and cannot be selected individually.

  • Download Feed Submission Result (file_download): The feed submission result is downloaded.
    Note: The feed submission result is downloaded as an XML or CSV file. The file type depends on the feed type and cannot be selected individually.

Which feed types are available for Amazon?

The table below contains an overview of the feed types used for Amazon.

Table 23. Feed types
Feed type What does the feed do?

Order Fulfillment Feed

  • Directing Amazon:

    • to charge the buyer,

    • to credit the amount to the seller’s account, and

    • notify the buyer that the order is on the way.

Order Adjustments Feed (refunds)

  • Issuing a refund for an order

Flat File Listings Feed

  • Creating a listing for a product that is not yet in Amazon’s catalogue

Flat File Inventory Loader Feed

  • Creating or updating a listing for a product that is already in Amazon’s catalogue

Upload VAT invoice

  • Submitting a VAT invoice for a shipment

FBA Inbound Shipment Carton Information Feed

  • Submitting carton content information for inbound shipments with Amazon shipping (Amazon FBA)

26.1. Downloading feed requests

In the menu Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Feeds you can download feed requests and Feed Submission Results for Amazon feeds. This can be useful if an Amazon feed has the processing status Done with warnings or Done with errors. The feed submission result provides you with further information about the warnings and errors. In addition to a warning or error message, this information also includes an Amazon order ID and a message ID or an original record number and a SKU. In the feed request, you can use this information to find and view the data for which the warning or error has occurred.

Downloading a feed request:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon sales channel] » Feeds.

  2. Click Search (search).
    A table with the transmitted Amazon feeds opens.
    Note: The Amazon feeds are sorted by feed ID in ascending order by default.

  3. Select the desired Amazon feed.
    Tip: You can apply filters to narrow down the Amazon feeds displayed.

  4. Click Download Feed Request (sim_card_download) in the row with the desired Amazon feed.
    → The feed request is downloaded as an XML, CSV or PDF file. The file format depends on the feed type.

26.2. Downloading feed submission results

In the menu Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Feeds you can download feed requests and Feed Submission Results for Amazon feeds. This can be useful if an Amazon feed has the processing status Done with warnings or Done with errors. The feed submission result provides you with further information about the warnings and errors. In addition to a warning or error message, this information also includes an Amazon order ID and a message ID or an original record number and a SKU. In the feed request, you can use this information to find and view the data for which the warning or error has occurred.

Notes on downloading feed submission results:

  • Feed submission results are only available for Amazon feeds which are in the processing status Done (circle), Done with warnings (circle) or Done with errors (circle) .

  • For Amazon feeds which are in Ready to request (circle) processing status, the feed submission result must first be requested before it can be downloaded. To do so, click on Request Feed Submission Result on Amazon (schedule_send) in the row with the desired Amazon feed.

  • Downloading feed submission result

  • Downloading the feed submission result when you have just downloaded the feed request

Downloading feed submission result:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon sales channel] » Feeds.

  2. Click Search (search).
    A table with the transmitted Amazon feeds opens.
    Note: The Amazon feeds are sorted by feed ID in ascending order by default.

  3. Select the desired Amazon feed.
    Tip: You can apply filters to narrow down the Amazon feeds displayed.

  4. Click Download Feed Submission Result (file_download) in the row with the desired Amazon feed.
    → The feed submission result is downloaded as an XML or CSV file. The file format depends on the feed type.

Downloading the feed submission result when you have just downloaded the feed request
  1. Click Download Feed Submission Result (file_download) in the row with the desired Amazon feed.
    → The feed submission result is downloaded as an XML or CSV file. The file format depends on the feed type.

26.3. Analysing information in the feed submission result

If you have downloaded the feed submission result for an Amazon feed, you can open it to see whether the Amazon feed has been successfully processed by Amazon. If an Amazon feed has been processed with the status Done with warnings or Done with errors, the feed submission result will give you more information about the warnings and errors. Table 24 contains an overview of the information in the feed submission result.

Note: This table only contains the information that is relevant for analysing the feed submission result.

Table 24. Content of a feed submission result
Content Explanation

Feed submission result in CSV format

Feed Processing Summary:

The summary of the feed processing.

Number of records processed

The number of processed data records. The number after Number of records processed indicates how many records have been processed from the feed request.

Number of records successful

The number of successfully processed data records. The number after Number of records successful indicates how many records have been successfully processed by Amazon.

Note:

  • If the numbers after Number of records processed and Number of records successful are identical, the Amazon feed was processed successfully.

  • If the number after Number of records successful is smaller than the number after Number of records processed, errors have occurred during the processing of the Amazon feed.

original-record-number

The number of the processed data record.

Note: This content only appears if warnings or errors occurred when processing the data records.

Tip: You can use the original-record-number and the SKU to find and view the data for which the warning or error occurred in the feed request.

SKU

The SKU of the processed data record.

Note: This content only appears if warnings or errors occurred when processing the data records.

Tip: You can use the original-record-number and the SKU to find and view the data for which the warning or error occurred in the feed request.

Error code

Code to identify the error or warning.

Note: This content only appears if warnings or errors occurred when processing the data records.

Error type

  • Warning = Warnings occurred when processing the data record.

  • Error = Errors occurred while processing the data record.

Note: This content only appears if warnings or errors occurred when processing the data records.

error-message

Description of the error or warning and how to proceed.

Note: This content only appears if warnings or errors occurred when processing the data records.

Feed submission result in XML format

Note: Feed submission results in XML format are .

MessageID

The message ID. It identifies the processed data set.

Tip: You can use the MessageID and the AmazonOrderID to find and view the data for which the warning or error occurred in the feed request.

ProcessingReport

The processing report. It contains the summary of the feed processing and, in the case of warnings or errors during feed processing, further information on the warnings and errors.

ProcessingSummary

The summary of the feed processing.

MessagesProcessed

The number of successfully processed data records. The number after MessagesProcessed indicates how many records have been processed from the feed request.

MessagesSuccessful

The number of successfully processed data records. The number after MessagesSuccessful indicates how many records have been successfully processed by Amazon.

MessagesWithError

The number of data records for which errors occurred during processing. The number after MessagesWithError indicates the number of data records for which errors occurred during processing.

MessagesWithWarning

The number of data records for which warnings occurred during processing. The number after MessagesWithWarning indicates the number of data records for which warnings occurred during processing.

Result

The result of the feed processing. If warnings or errors occurred during feed processing, further information is provided here.

Note: This content only appears if warnings or errors occurred when processing the data records.

ResultCode

Result code. It identifies the type of processing result.

  • Warning = . Warnings occurred when processing the data record.

  • Error = . Errors occurred while processing the data record.

Note: This content only appears if warnings or errors occurred when processing the data records.

ResultMessageCode

Code to identify the error or warning.

Note: This content only appears if warnings or errors occurred when processing the data records.

ResultDescription

Description of the error or warning and how to proceed.

Note: This content only appears if warnings or errors occurred when processing the data records.

AdditionalInfo

Additional information on the affected data record.

Note: This content only appears if warnings or errors occurred when processing the data records.

AmazonOrderID

The Amazon order ID.

Tip: You can use the MessageID and the AmazonOrderID to find and view the data for which the warning or error occurred in the feed request.

Note: This content only appears if warnings or errors occurred when processing the data records.

26.4. Find data in the feed request using the information from the feed submission result

If you have downloaded the feed request and the feed submission result for an Amazon feed, you can open the feed submission result to see whether the Amazon feed has been successfully processed by Amazon. If an Amazon feed has been processed with the status Done with warnings or Done with errors, the feed submission result will give you more information about the warnings and errors. In addition to a warning or error message, this information also includes an Amazon order ID and a message ID or an original record number and a SKU. In the feed request, you can use this information to find and view the data for which the warning or error occurred.

  • Find data in an XML feed request

  • Find data in a CSV feed request

Find data in the feed request using Amazon order ID and message ID:

  1. Go to the location with the downloaded feed request and the downloaded feed submission result.

  2. Open the feed submission result.

  3. Search the document for the message ID of the data record where the warning or error occured.

  4. Open the feed request.

  5. Navigate to the line with the corresponding message ID.
    → This is the data record where the warning or error occured.

Find data in the feed request using original record number and SKU:

  1. Go to the location with the downloaded feed request and the downloaded feed submission result.

  2. Open the feed submission result.

  3. Search the document for the original record number of the record where the warning or error occured.

  4. Open the feed request.

  5. Navigate to the line with the corresponding original record number. → This is the data record where the warning or error occured.

27. 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 whether you are using the test mode the (error) reports are found in different menus.

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

Table 25. Overview of available (error) reports
Process Test mode activated? (Error) reports

Catalogue export

yes

  • CSV file in Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Data exchange » Data export » Area: Reports for catalogue export

Amazon reports catalogue test mode en

Export of a newly created offer catalogue

no

  • Feed requests and Feed Submission Results in Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » 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.

      Amazon reports offer catalogue creation en
    • Click Search (search).

    • The feed request and the feed submission result are available for download. To download the results, click on Download feed requests (sim_card_download ) and Download feed submission results (file_download) in the line with the desired feed.

    • In the feed submission result, search for messagesProcessed: and messagesAccepted:. If the number after messagesProcessed: matches the number after messagesAccepted:, all data has been successfully transferred to Amazon.
      Example:

      Amazon FeedSubmissionResult Successful
    • Did any data not get transferred to Amazon? Here you will find instructions on how to find and view data in the feed request for which warnings or errors have occurred.
      Note: Here you can find more information on Amazon feeds.

Offer catalogue update

no

  • Feed requests and feed submission results in Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » 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 update.

      Amazon reports offer catalogue update en
    • Click Search (search).

    • The feed request and the feed submission result are available for download. To download the results, click on Download feed requests (sim_card_download ) and Download feed submission results (file_download) in the line with the desired feed.

    • In the feed submission result, search for messagesProcessed: and messagesAccepted:. If the number after messagesProcessed: matches the number after messagesAccepted:, all data has been successfully transferred to Amazon.
      Example:

      Amazon FeedSubmissionResult Successful
    • Did any data not get transferred to Amazon? Here you will find instructions on how to find and view data in the feed request for which warnings or errors have occurred.
      Note: Here you can find more information on Amazon feeds.

Product catalogue export

no

  • CSV file in the menu Sales Channels » Channel Control Centre » [Select your Amazon sales channel] » Data exchange » Data export » Section: Reports for catalogue export.

Amazon reports product catalogues en

Stock update

no

  • Feed request and feed submission result in the menu Sales Channels » Channel Control Centre » [Select your Amazon sales channel] » Feeds

    • Use the filter Feed type and select the option Common listing feed.

    • Also use the filter Process type and select the option Stock update on catalogue export.

    • Click Search (search).

    • The feed request and the feed submission result are available for download. To download the results, click on Download feed requests (sim_card_download ) and Download feed submission results (file_download) in the line with the desired feed.

    • Here you will find instructions on how to find and view data in the feed request for which warnings or errors have occurred.
      Note: Here you can find more information on Amazon feeds.

Amazon reports stock updates en

28. Viewing the data log for price and stock updates

Events in your system are logged in the menu Data » Log. This allows you to check the data log for errors without relying on our support.
For Amazon, you can view log files for price and stock level updates here.

Viewing the data log:

  1. Go to Data » Log.

  2. Click Filters (tune) at the top of the menu.

  3. In the Integration field, enter the option AmazonItemExportWorker.

  4. In the Identifier field, enter the option:

    • AmazonPriceUpdate to retrieve log files for price updates
      or

    • AmazonStock to retrieve log files for stock level updates.

  5. In the Reference type field, enter the option sku to search for a specific SKU.

  6. In the Reference value field, enter the SKU of the variation.

  7. Optional: Select a date if you only want to see entries for a specific day.

  8. Click Search () to display the results.

In the log files, you will find important information, including the following:

  • Log file for prices

  • Log file for stock

Table 26. Important information in the log file for prices:
Property Explanation

errors:

The error message, if errors have occurred during the process. If the field is empty, the transmission was successful.

issues:

The issues regarding the data.

productType:

The Amazon product type.

prices:

The price that was transferred to Amazon.

createdAt:

The timestamp at which the log file was created.

identifier:

The identifier of the log file assigned by PlentyONE.

Table 27. Important information in the log file for stock levels:
Property Explanation

errors:

The error message, if errors have occurred during the process. If the field is empty, the transmission was successful.

issues:

The issues regarding the data.

productType:

The Amazon product type.

quantity:

The stock level that was transferred to Amazon.

createdAt:

The timestamp at which the log file was created.

identifier:

The identifier of the log file assigned by PlentyONE.

29. Downloading error reports for price and stock updates

If issues occurred during price or stock updates, you can download the corresponding error reports. To access the reports, go to Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Data exchange » Data export and navigate to the section Price and stock update errors.
In this section, a new report is generated daily whenever errors are detected during the price or stock update. Each report includes information about both price and stock update errors, helping you to identify the problem without having to contact support.

Note: If no errors occur during price and stock updates on a given day, no report will be generated.

Table 28 contains an overview of the reports in the Price and stock update errors section.

Table 28. Reports in the Price and stock update errors section
Column Explanation

Seller ID

The seller ID of your Amazon seller account.

Price and stock update errors

The file name of the error report. It contains the creation date in the format YYYY-MM-DD.

Actions

  • Download (): The report is downloaded in CSV format.

Downloading a report on price and stock update errors:

  1. Navigate to Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Data exchange » Data export.

  2. Navigate to the section Price and stock update errors.

  3. In the drop-down list Seller ID, select the desired seller ID.
    → The reports for the selected seller ID are displayed.

  4. Click Download () on the right in the line with the report.
    → The report is downloaded in CSV format.

30. FAQ

30.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 (toggle_on).

  • 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 Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » 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 Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » 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 Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Settings » [Open account] » Tab: Item settings » Section: Export filter menu.
    Note: If multiple tags are selected, they are interpreted as an OR condition. This means a variation is exported as soon as at least one of the selected tags has been assigned to it.

Offer catalogue settings:

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

  • Add order referrer: Add the option Web API and the desired Amazon referrer in the Sales channels section.

Settings for price and stock updates in the Sales Channels » Channel Control Center » [Open your Amazon sales channel] » Settings » [Amazon account] » Tab: Item settings menu:

  • 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:

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

  • 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 types for which you want to create product catalogues under Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » 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.
Stock updates are carried out according to the setting Stock changes in the Sales Channels » Channel Control Center » [Open your Amazon sales channel] » Settings » [Amazon account] » Tab: Item 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.

30.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 Sales Channels » Channel Control Centre » [Open your Amazon Sales Channel] » Settings ] » [Amazon account] » Tab: Item settings and make sure that Never is selected for the setting Price changes and that no price is mapped in the catalogue.