The Marketplaces app

Send and sync your product data across various marketplaces using the Productsup Marketplaces app.

Introduction

The Productsup Marketplaces app lets you publish product data from the platform. Once that product data is in the Marketplaces app, you can send and sync it to several marketplaces.

marketplaces_app.png

The Marketplaces app supports the following Amazon Marketplace locales:

  • France (FR)

  • Germany (DE)

  • Italy (IT)

  • Poland (PL)

  • Spain (ES)

  • United Kingdom (UK)

Set up product data flow from platform to Marketplaces app and Amazon Marketplace

  1. First, you need to export your product data from the Productsup Platform to the Marketplaces app catalog.

  2. When your products are in the Marketplaces app, you can connect your Marketplaces catalog to various marketplaces.

  3. Once connected to the various marketplaces, you can add products to specific listings catalogs.

  4. The Marketplaces app lets you confirm that your products meet specific marketplace requirements before submitting them to your chosen marketplace.

  5. Get constant feedback on the latest product listing submissions to your marketplaces. This feedback helps you discover if the Marketplaces app detected any problems during and after submitting products and if there is something else requiring your attention.

Prerequisites

To access and use the Marketplaces app, Productsup must:

  1. First, you must have an Amazon Marketplace Seller Central account and login credentials.

  2. Request a marketplace instance for your account.

  3. Link your marketplace instance to your Productsup account.

  4. Create export channels for the Amazon product types you require.

You can begin the data setup stage and use the Marketplaces app once Productsup establishes your marketplace instance and the appropriate channels for your product types.

Export product data from PUP to Marketplaces app

  1. Create a site in the Productsup platform by performing the following, or see Create a site for more information:Create and copy a site

    1. Go to a project where you want to add a site.

    2. Select ADD SITE.

      adding_site.png
    3. Enter a name for your site.

    4. Select Save.

  2. Add and set up a data source to import your products using the following, or see data source to import your products for more information:

    1. Go to Data Sources from your site's main menu and select ADD DATA SOURCE.

      data_sources_add_data_source.png
    2. Search for your data source import channel and select Add. Give it a custom name as desired and select Continue.

    3. Set up the data source.

      1. See Import data from internal systems for more information on which options are available and how to import different data types.

      2. See Import data from third-party external systems for more information on which options are available for importing data from external systems.

        save_data_source.png
    4. Enter any advanced settings if required and select Save.

  3. Choose the Marketplaces app export channel(s) for your required product types. You can recognize all Marketplaces app export channels by their titles, for example, Marketplaces app - CHAIR PT - Amazon ES, IT, UK, FR, PL, DE. CHAIR PT stands for Amazon Chair Product Type or category.

    marketplaces_app_chair_pt.png
    marketplaces_app_desk_pt.png
    1. Go to Exports A/B from your site’s main menu.

    2. Go to Exports A/B from your site’s main menu, select ADD EXPORT. and search for the appropriate export channel for your required product types. This example uses the Marketplaces app - CHAIR PT - Amazon ES, IT, UK, FR, PL, DE export channel.

    3. Select Add and confirm adding it again as an export.

    4. In the export setup, select Add Destination and choose Marketplaces experience from the drop-down list. Optionally, you give your destination a custom description in Name.

      add_destination.png
    5. Select the correct language representing the product translations in the Select language drop-down list. The platform uses this information in the Marketplaces app to distinguish language-specific product catalogs.

      select_language.png
    6. In Select category, ensure the selected category matches the defined category in the export channel name and represents the product category assigned to this channel. The platform uses this information to classify the products in the Marketplaces app.

      select_category.png
    7. Turn on the destination by switching Active to On.

    8. Select Save.

  4. Map your imported data to the export channels to meet data requirements. Apply rule boxes where necessary and map all available attributes in the import feed. Use the following example instructions to map import data for export, or for mapping information, see Map import data attributes for export:

    Important

    Ensure you map the SKU attribute. The product SKU, language, and category parameters you set in the destination settings uniquely identify products in the Marketplaces app.

    1. Go to Dataflow from your site's main menu.

    2. Select the export channel where you are sending your product data. This example uses Google Merchant Center.

      Productsup platform Dataflow view - demonstrating export channel selection
    3. To map Import attributes to Intermediate attributes:

      • In the Import column, select a node on an attribute.

      • In the Intermediate column, select a node on an attribute.

      Guide to mapping product attributes to intermediate layer
    4. Map Intermediate attributes to the export channel, following the same steps noted in step 3.

      Guide to map intermediate attributes to export attributes

      Tip

      You can get more information about each available attribute in the channel template using a schema example. See react-jsonschema-form playground.

  5. Export your data to the Marketplaces app by setting up scheduling. Scheduling lets you automatically sync new or updated products to the Marketplaces app catalog. Use the following instructions or see Schedule your sites to process automatically for more information.

    1. Go to Data Sources from your site's main menu and select the Scheduling tab.

    2. Select Add Schedule.

    3. Select the days, hours, and minutes you want to schedule a run start. Choose from:

      1. Everyday

      2. Every 2nd Day

      3. Every Hour

    4. Select Save.

      add_schedule_calendar.png
  6. Login to the Marketplace app. Add your site number before the sub-domain marketplace. For example, https://{your site number}.marketplace.productsup.com. You can expect to land on the My Product Catalog page that contains all the product data you exported from the Productsup platform. If you don't see your product data, try exporting again and check the platform notifications to troubleshoot.

Marketplaces app's “My product Catalog” languages and categories

The language and category settings you defined in the Marketplaces app export destination settings let you filter language-specific product catalogs and categories.

Language-specific product catalogs

To define the product catalog language, you must establish a single language at the site so the app can translate that language at the export destination.

Once you have established language parameters in your destination settings, as seen in step e, you can apply filters to split product data by language and assign localized products to the correct country or region for each specified marketplace destination. The Marketplaces app supports the following languages:

  • English (UK)

  • French (FR)

  • German (DE)

  • Italian (IT)

  • Polish (PL)

  • Spanish (ES)

In My Product Catalog, you can choose the language of your products from the language drop-down list.

select_language_my_prod_catalog.png

Category filters

The only category filters available in the Marketplaces app My Product Catalog page are those you configured in the platform for your Marketplaces app destination. See step f.

categories.png
filter_categories.png

Connect the Marketplaces app to a specific marketplace

  1. In the Marketplaces app, go to Marketplaces from the top menu ribbon and select Add a marketplace.

    add_marketplace.png
  2. Choose your marketplace region. The platform then redirects you to Amazon Seller Central to authenticate your account login. Once you have authenticated, you return to the platform to continue with the setup.

    select_region.png

Note

You must have an Amazon Marketplace Seller Central account and login credentials.

Add products to a marketplace-specific listings catalog

Once connected to your desired Marketplace(s), you can start distributing products from My Product Catalog to their intended Marketplace(s) for listing.

  1. Add your products to the Marketplace app by selecting the products listed on the My Product Catalog page and choosing Add to Marketplace.

  2. You can add the same products to one or several marketplaces.

    Note

    Only the marketplaces you have connected with are available for product distribution.

Check if added listings meet marketplace product requirements and fix data issues

Once you have added products to your selected marketplace listings catalog, you can get insights into the listings' data quality. You can confirm if:

  • Your products contain all required and mandatory attributes.

  • Product data validates against Amazon's schema.

The following details are available before you submit your listings to marketplaces for all products on the following pages:

  • Listings

  • Errors

    listings_details.png

Product attribute edits

If there are listing issues, you can edit and enhance your product data from the following three areas:

  • A site in the Productsup platform that exports product data to the Marketplaces app. The suggestion is to update data on the source side and apply modifications using rule boxes for broader data management, addressing issues, and optimizing multiple products where applicable.

    Note

    All changes you perform in the site apply across all marketplace listings whenever you add products.

  • In the Marketplaces app, go to the selected Marketplaces listings and the Listing Detail Page.

    Note

    Changes you perform on the Listing Detail Page (LDP) apply only to specific marketplace listings where you made the changes. Your changes to duplicate product listings in other marketplaces do not affect multiple marketplace listings. If you perform edits on the LDP, they overrule product data received from platform exports or updates on the PDP. This overruling means that product attribute edits on the LDP have the highest priority compared to those from the PDP and platform site or data source.

Submit listings to your marketplaces

Automated listings submission

By default, the Marketplaces app continuously checks and submits listings for products that pass data validation and meet Amazon's minimum data requirements. The app also processes data changes and reattempts Amazon submissions.

Manual listings submission

A Marketplaces app user can perform the submission of a manual listing if they initiate the submission by going to the Marketplaces app, Marketplaces, selected marketplace, and selecting the Listings view. Users have a few options on how they can initiate submissions:

  1. Select one or multiple product listings from the Listings table and begin with the selected listings submissions to the marketplace.

    Note

    You can only select Listings within one chosen category.

    There is a similar process for automated submissions, where the app can only submit queued listings meeting Amazon's minimum requirements. If some listings are missing required data, the app excludes them from submission.

  2. Submit a single listing from an LDP.

    Note

    If a user made data changes on the LDP after saving those changes, a user must submit the listing manually. This submission ensures that any changes the user performs on the listing apply in the Marketplace Seller Central catalog.

Listings statuses

Not submitted - New listings are under this status. It can also indicate if the app performed a validation check and a listing did not meet Amazon's minimum requirements, therefore not allowing a listing submission.

Queued - After passing a validation check, the listing meets Amazon's minimum requirements. The app pushed the listing to the queue and is pending submission to Amazon.

Pending feedback - The app submitted the listing to Amazon and is currently pending feedback from Amazon.

Submitted - The app successfully submitted the listing to Amazon. Amazon feedback indicates the listing contains no errors.

Failed - The submitted app submitted failed based on feedback from Amazon. Amazon reports the listing contains errors. Check the Errors page for more information.

Marketplaces app errors

The Errors page helps you locate errors in the Marketplaces app for failed listings submissions. It displays the following information for errors:

  • Main image

  • Product SKU

  • Product name

  • Error Code

  • Error description

  • Submission timestamp

  • Submission ID

To locate errors in the Marketplaces app for failed listings submissions:

  • Go to Marketplaces, select the {marketplace region}, and Errors.

Pre-submission validation errors

Pre-submission validation errors are directly related to product listing attributes, data readiness validations, or they can indicate missing or wrong values. The Marketplaces app distinguishes these errors using error code 0 and the submission ID 0.

errors_page.png

Marketplace feedback errors

Marketplace feedback errors include direct, indirect, and unrelated listing data issues, such as submission API request errors and submission processing errors.

If Amazon discovers issues during listing submissions, these errors are directly related to the listing data attributes. Amazon errors contain five (5) digits, for example, 90220. You can find a list and descriptions of all Amazon errors here, Error code explanations.

Amazon generates a Submission ID visible on the Errors page if you receive any errors from Amazon. Give this ID to Amazon's customer support team for assistance.

errors_subm_id.png
errors_unrelated_listing_data_issues.png

Indirect and unrelated listing data issues