Skip to main content

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, 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 something else requires 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 organization.

  3. Link your marketplace instance to your Productsup organization.

  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:

    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 Add a main 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 available options 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 export channels

    1. Go to Exports 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.

    2. Hover the pointer over the necessary export and select Add to confirm.

    3. In the Exports page, select the cogwheel icon (⚙) next to the added export.

    4. In the export setup, select Add Destination and choose Marketplaces experience from the drop-down list. Optionally, 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 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.

    Warning

    You can't add custom attributes in the Marketplaces app's export channels. If custom attributes exist, the export fails, and the Marketplaces app and Amazon Seller Center do not receive new or updated product data.

    Important

    Be advised that some attributes are country or language specific. For example, if you select language de_DE in the destination, you must map the UVP_list_price attributes ($.uvp_list_price[0].currency & $.uvp_list_price[0].value). And if you select the languages for the following destinations:

    • it_IT

    • es_ES

    • en_GB

    • Or another language

    Then you must map the List_price attributes ($.list_price[0].currency & $.list_price[0].value_with_tax). There are more attributes similar to these. The system checks if you mapped the languages and destinations correctly; if not, the export fails. See the Troubleshoot export section.

    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 schedules. Scheduling lets you automatically sync new or updated products to the Marketplaces app catalog. Use the following instructions or see Set up scheduling and triggering processes in Scheduling 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.

Troubleshoot export

  1. Check Notifications to see if your export was successful and if no errors occurred during your run. 

    error_log.png

  2. If Feed Upload Failed or Destination Failed errors occur, check the Error log for more information on the root cause. You can see errors if you add custom attributes to the export channel or incorrectly map attributes for your selected destination language.

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.

Edit authentication data

Marketplace authentication data can expire or become invalid based on user management actions in your Amazon Seller Center account. In both cases, you should modify your authentication data in the Marketplaces app.

If you need to edit the authentication data of your marketplace, follow these steps:

  1. Go to Marketplaces.

  2. Select the marketplace where you want to edit the authentication data.

  3. In the left-side menu, select Settings.

  4. In the Authentication panel, select Edit.

    Edit marketplace authentication data

  5. On the EDIT AUTHENTICATION page, select Continue to let the app redirect you to your Amazon Seller Center account. Once finished with the new authentication, you go back to the Marketplaces app to save the changes.

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

Tip

To be proactive about the correctness of the provided product data, you can use the info boxes next to every attribute field in your product catalogs.

These info boxes explain what input a chosen marketplace expects in each attribute field. With this information, you can prevent listing errors that cause marketplaces to remove or suppress your catalog placement.

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.

In case you edited your product data in the Marketplaces app, you can view the original values imported from Productsup by following these steps:

  1. Go to Marketplaces.

  2. Select the marketplace where you changed your product data.

  3. Select the listing where you changed the data.

  4. Next to the value you changed in the Marketplaces app, select View imported value to see what value Productsup exports for this attribute.

    View the value the Marketplaces app imported from Productsup

  5. If you want to undo the changes and use the value as imported from Productsup, select Revert to this value. The app then removes the current value from the attribute and populates it with the value shown in the pop-up.

    Revert to the value imported from Productsup and delete the one changed in the Marketplaces app

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.

If you want to pause or unpause automated listings submission, follow these steps:

  1. Go to Marketplaces.

  2. Select the marketplace where you want to pause listings submission.

  3. In the left-side menu, select Settings.

  4. Toggle on the Listings submissions button.

  5. If you pause a listing submission, a warning message appears at the top of the page, and the state of the marketplace changes to Inactive.

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

    If you select and submit multiple product listings and some of those listings contain incomplete data, the app submits only the listings with sufficient data to the selected marketplace. It shows you a note displaying the number of listings excluded from the submission due to missing data. You can revisit those listings, provide the needed data, and resubmit.

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

Statuses of product listings

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.

Submitted with errors - The app submitted the listing to Amazon, but this listing contains invalid media data. For example, invalid images.

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.

Tip

Using the Download CSV option, you can collaborate on error resolution with colleagues and partners who don't have access to Productsup and the Marketplaces app:

  1. In the upper ribbon on the Errors page, select Product SKU or Error code to choose how you want the app to group errors in the output CSV file.

  2. Select Download CSV to let your browser start downloading the CSV file. Once this process is over, you can share the file for collaboration on listings 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.

pre-validation errors

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

Delete products from Amazon Seller Central

To delete product listings from your Amazon Seller Central account, you must go to your relevant Productsup site. You have the following options to remove products from export in a Productsup site:

  • You can go to your data source and delete the unwanted products there.

  • You can add a rule box in Dataflow or Data View to let the platform skip certain products during export. See Exclude products with skip rule boxes.

  • You can set up a list containing the products the platform should skip during export. See Inclusion/Exclusion lists.

Note

Once you remove the unwanted products from export, you need to select Run in the top-right corner of your site's view to let Productsup send your product deletion updates to the Marketplaces app.

Once you send your product deletion updates to the Marketplaces app, the app syncs the new Productsup export feed with your products on the My product catalog page. It also syncs the updates with your product listings in each added marketplace. The app then sends a deletion request to your Amazon Seller Central account to remove unwanted product listings.

The Marketplaces app assigns the status Pending deletion to all products undergoing the deletion process. You can see this status only if the app has already started the deletion process but hasn't yet deleted all the needed products. This can happen, for example, because of a long queue of pending changes.

Note

You can't make any changes to products with the status Pending deletion.

Retry deletion after failed deletion requests

Expired authentication and API call issues can cause automated product deletion requests to fail. If this happens, a red banner appears at the top of the My product catalog page in the Marketplaces app.

You can retry deletion manually by selecting submit a deletion request in the red banner at the top of the My product catalog page.

Pending deletion status shown for products planned for deletion, submitting a manual deletion request
In this section: