Guide to Configuring the AmazonSeller Platform with Best Practices on Shoppingfeed
This guide helps you set up the AmazonSeller platform using best practices on Shoppingfeed. It is intended for merchants who want to create or update their product listings and offers using Amazon’s new SP-API.
📍 For additional details about the migration, refer to the articles:
Migration to Amazon’s New API & How to Configure the AmazonSeller Platform?
Product Feed Configuration in AmazonSeller
Categories
To create new products on Amazon, you must assign them to a category from the platform’s category database. Note: You don’t need to create new products if they already exist from another third-party seller or Amazon itself. The category database may vary depending on the language setting of your Shoppingfeed account.
Best Practices:
Here is the list of available Amazon categories. Make sure to choose the appropriate category (in the correct language for your account) to access the most relevant mandatory and optional attributes for your catalog.
Attributes
Once you’ve selected the category, Shoppingfeed will automatically display the required attributes under the “Autotag” tab.
Best Practices:
Browsenodes should now be set in this section. These help you assign the correct front-end category on the relevant Amazon country site and can impact the commission Amazon applies. Previously set values for existing products remain unchanged; this setup is only for new products.
Start by filling in the mandatory attributes first. Avoid overloading your initial product export with too many attributes—this makes error management easier and improves product update monitoring.
Be sure to include weight and dimension attributes (both product and packaging), as they are often required for logistics features based on product type.
Pay attention to linked or interdependent attributes—filling in one field may make others mandatory (e.g., measurements and units).
Do not fill in or modify language attributes—Shoppingfeed handles these automatically based on your account language.
Special Attribute Notes
ASINS:
Use
{merchant_suggested_asin.0.value}to manually link an offer to an existing ASIN.
Bullet Points:
These correspond to the descriptive boxes under the product title on Amazon. In Shoppingfeed:
Bullet Point 1 →
{bullet_point.0.value}Bullet Point 2 →
{bullet_point.1.value}Up to a maximum of 5.
Be sure to enter them in order for correct display on Amazon.
Variation Management
You do not need to manually modify variation fields (parent/child). Shoppingfeed manages these automatically based on relationships in your source feed. The correct values are sent by default to Amazon to structure variant products (size, color, etc.) properly.
Sending the Product Feed
By default, Shoppingfeed sends data in "partial_update" mode, meaning only the filled fields are updated—existing Amazon data is left untouched.
You can choose to send in "update" mode if you want to replace all existing data on Amazon for a product.
To activate the product feed on the new AmazonSeller platform, ensure that the following feeds are selected via the “Settings” tab:
product_upsertstatus_get(to verify the existence and status of a product on Amazon)
Offer Feed Configuration in AmazonSeller
Price & Stock Fields
Here’s a summary of the necessary fields to properly configure your offers (pricing and inventory), along with the default values sent by Shoppingfeed:
| Field | Requirement | Meaning | Default Mapping |
|---|---|---|---|
offer.fulfillment_availability.0.lead_time_to_ship_max_days | Recommended | Shipping time in days | shipping time |
offer.fulfillment_availability.0.fulfillment_channel_code | Required | AMAZON_EU, AMAZON_NA, or DEFAULT if not using Amazon fulfillment | DEFAULT |
offer.fulfillment_availability.0.quantity | Required | Quantity available | quantity |
offer.purchasable_offer.0.currency | Required | Currency | CURRENCY_SF |
offer.purchasable_offer.0.discounted_price.0.schedule.0.value_with_tax | Required | Original price for discount | old_price |
offer.purchasable_offer.0.start_at.value | Required for promotions | Format: yyyy-mm-dd 00:00:00 | – |
offer.purchasable_offer.0.end_at.value | Required for promotions | Format: yyyy-mm-dd 00:00:00 | – |
offer.purchasable_offer.0.map_price.0.schedule.0.value_with_tax | Required | Minimum advertised price | – |
offer.purchasable_offer.0.our_price.0.schedule.0.value_with_tax | Required | Final price | price |
Note: If you do not want to update a field (price or stock), do not map it or leave it blank—otherwise, the field will be overwritten on Amazon.
Offer Condition
Map {offer.condition_note} to a conditional text field depending on the product’s status, and verify that {condition_type} contains a valid value. By default, your offers are set as new_new.
| Amazon Label | Amazon API Code (SP-API) |
|---|---|
| New | new_new |
| Used - Like New | used_like_new |
| Used - Very Good | used_very_good |
| Used - Good | used_good |
| Used - Acceptable | used_acceptable |
| Refurbished - Premium | refurbished |
| Collectible | collectible_* |
Note: Only merchants enrolled in the Amazon Renewed program can list offers as refurbished.
Shipping Information
The field {offer.merchant_shipping_group.0.value} is used to indicate the shipping template to be applied to your offer.
To use it correctly, retrieve the template ID from the URL of the configuration page in your Seller Central interface.
Sending the Offer Feed
As with the product feed, Shoppingfeed sends data by default in "partial_update" mode.
You can force the feed into "update" mode to overwrite all data on Amazon for the relevant offer.
Finally, to activate the offer feed on the new AmazonSeller platform, select the offer_upsert feed in the "Settings" tab.