Applicable products: Netmarkets

💡Amazon - How to migrate your Amazon channel to SP API

In Spring 2025, Lengow is transitioning from the current Amazon technology based on XSD files to the new and improved Amazon Seller Partner API (SP API).
Read about the advantages and the estimated schedule in this news article.

As Amazon will deprecate the previous connector at the end of July 2025 (initially June 30, postponed by Amazon), all sellers are required to migrate to continue selling on Amazon.

In Lengow, this migration will be done gradually, starting with the Amazon Listing Loader channels, followed by the classic Amazon channels, and concluding with the Amazon Flat File channels.
You will be informed by email when it is time to migrate each type of channel.

You will need to follow these steps to migrate each Amazon channel:

Lengow will duplicate your active Amazon channel and copy most of your existing configuration.
This newly created channel, using Amazon SP API, is initially created as draft (not activated).
You must check and adjust the settings (category and attributes mapping) of your new Amazon channel.
Read our instructions below for each channel type.
Deactivate the former channel and activate the new one.
Monitor the channel reports and correct the potential errors.

Tip: If you first want to test the migration with a few products, follow these steps:

Create a segment with your test products, and use this segment for your new Amazon SP API channel.
Configure the new new Amazon SP API channel.
Deactivate the former Amazon channel.
Activate the new Amazon channel to perform your tests (as long as either the former or new Amazon channel is active, your orders are retrieved by Lengow).

Although most settings have been replicated automatically by Lengow, several attributes may have been added or have a new format. These attributes must therefore be completed according to Amazon's requirements.

Download from Amazon the complete list of required attributes by product type
Note: Attributes that were already mandatory may not be specified in this file.

You will find below the required actions for each Amazon channel type:

Amazon Listing Loader channel

At the end of March or beginning of April 2025, Lengow will progressively create a new Listing Loader channel for each active one.

Your existing configuration has been copied onto the new Listing Loader channel. However, you must adapt your attributes settings to the following changes:

Attribute name	Changes with SP API
externally_assigned_product_ identifier.value	This attribute replaces the former "product-id" attribute, but you cannot enter the ASIN here anymore. You may provide the EAN code of your products in this attribute, but it is now optional if you provide the ASIN code in the "merchant_suggested_asin..value" attribute. If you provide the EAN code, also select the value "EAN" in the "externally_assigned_product_identifier.type" attribute.
merchant_suggested_asin..value	Enter the ASIN code (internal Amazon reference) of your products if you have it in your catalogue. For all products, you must provide either the ASIN here or/and the EAN in "externally_assigned_product_identifier.value".

Once these settings have been adjusted, deactivate the former Listing Loader channel and activate this new one.

Classic Amazon channel

🎓 To benefit from detailed advice from our Amazon experts, watch this webinar: Amazon Classic Migration: Guide to a smooth transition with Lengow
(Log in to the Help Center to access it).

In May 2025, Lengow will progressively create a new classic Amazon channel for each active one.

Your existing configuration has been copied onto the new Amazon channel. However, you must adapt your settings to the following changes:

Category mapping:

As many categories have been removed and replaced by new ones in the SP API version of the Amazon channel, you must review your category mapping and complete it if necessary.

Click here for the full list of removed categories

'Arts',
'AutoAccessory',
'AutoAccessory..PowersportsVehicle',
'Baby',
'Beauty..BeautyMisc',
'Books',
'Books..BooksMisc',
'CE',
'CameraPhoto',
'Coins',
'Collectibles',
'Computers',
'EUCompliance',
'EducationSupplies',
'EntertainmentCollectibles',
'FBA',
'FoodAndBeverages',
'FoodServiceAndJanSan',
'Furniture',
'GiftCard',
'Gourmet',
'Home',
'HomeImprovement',
'Industrial',
'Jewelry',
'LabSupplies',
'LargeAppliances',
'LightMotor',
'Lighting',
'Luggage',
'LuxuryBeauty',
'MechanicalFasteners',
'Miscellaneous',
'Miscellaneous..Event_Tickets',
'Miscellaneous..Gifts_and_Occasions',
'Motorcycles',
'Music',
'MusicalInstruments',
'Office',
'Outdoors',
'PowerTransmission',
'RawMaterials',
'Shoes',
'SoftwareVideoGames',
'SoftwareVideoGames..DownloadableSoftware',
'SoftwareVideoGames..DownloadableVideoGame',
'Sports',
'SportsMemorabilia',
'TiresAndWheels',
'Toys',
'ToysBaby',
'Video',
'Video..AbisDvd',
'WineAndAlcohol',
'Wireless'

Attributes mapping:

Attribute name	Changes with SP API
Variation attributes: - variation_theme..name - parentage_level..value - color..value - size..value - style..value etc.	Certain attributes used to set up variations, such as "Shoes..VariationData..VariationTheme", were only present at category level. The configuration of such attributes could not be copied onto the new SP API channel, as they are now among the common attributes. Exception: "material..value" and "pattern..value" are available at category level, as the valid values vary for each category. Ensure the attributes required to set up your variations are completed according to our instructions here (including selecting the value "Variant" for the "child_relationship_type" attribute).
externally_assigned_product_ identifier.value	Lengow copied the configuration of this attribute when it was completed. However, only 3 types of ID are now accepted by Amazon: EAN, GTIN and UPC. If you were for example providing ASIN or ISBN in this attribute, you must provide another type of identifier, as it is a mandatory attribute. If you provide the EAN code here, also select the value "EAN" in the "externally_assigned_product_identifier.type" attribute.
Dimensions and weight attributes: - item_weight..value - item_package_dimensions..length.value - item_package_dimensions..width.unit etc.	These attributes are now mandatory. The dimensions and weight of your products and their package must be provided to Amazon in the corresponding attributes. Read the details in this article.
batteries_required..value	This attribute is now mandatory. Select "yes" if the item requires battery power (or if the item itself is a battery) or "no" if it does not. Note that an internal rechargeable battery is also considered a battery.
supplier_declared_dg_hz_regulation..value	This attribute is now mandatory. If the product is a dangerous good, hazardous material, substance, or waste subject to specific regulations regarding transportation, storage, and/or disposal, select an item from the list of valid values. Otherwise, select "Not applicable".
List Price: list_price..value_with_tax list_price..currency	These attributes are now mandatory. The List Price, or reference price, is the suggested retail price set by the manufacturer. The corresponding currency must be provided. Enter "0" if you do not have a List Price.
Promotion dates attributes: - purchasable_offer..discounted_price ..schedule..start_at - purchasable_offer..discounted_price ..schedule..end_at	If you have promotions in place, make sure the promotion dates are set under the new format : yyyy-mm-dd (example : 2025-05-24) The previous format included the time.

Preview:

Once these settings have been adjusted, check the Preview of your channel, to identify possible format errors.

Variations

With the new Amazon SP API channel, parent products must now include values for certain attributes (e.g. main image, relationship type, etc.). This is a change from the previous channel version, where these fields had to be left empty for parents.

During the migration, Lengow copied values from child products to parent products to meet Amazon’s new requirements. These values are not visible in the channel preview, but they are sent to Amazon.

Note: When creating new variations, follow our updated guidelines to fill in required values for parent products, as Lengow will not auto-fill them after the migration.

List of the attributes automatically populated for parent products through the migration:
- "main_product_image_locator..media_location"
- "bullet_point.value_01"
- "child_parent_sku_relationship..child_relationship_type"
- "country_of_origin..value"
- "list_price..value_with_tax"
- "supplier_declared_dg_hz_regulation..value"

When you are ready, deactivate the former classic Amazon channel and activate this new one.

Channel reports:

With this new SP API version, Amazon requires new mandatory attributes in many categories.

It is therefore important to check the channel reports for errors, to verify if your products are properly configured.

Amazon Flat File channel

In June 2025, Lengow will progressively create a new classic Amazon channel for each active Flat File channel.
Note: Clothing and accessories are now published through this channel, just like any other product type.

Your existing configuration has been copied onto the new Amazon channel. However, you must adapt your settings to the following changes:

Attributes mapping:

Attribute name	Changes with SP API
Variation attributes: - variation_theme..name - parentage_level..value - color..value - size..value - style..value etc.	Certain attributes used to set up variations, such as "variation_theme", were only present at category level. The configuration of such attributes could not be copied onto the new SP API channel, as they are now among the common attributes. Exception: "material..value" and "pattern..value" are available at category level, as the valid values vary for each category. Ensure the attributes required to set up your variations are completed according to our instructions here (including selecting the value "Variant" for the "child_relationship_type" attribute).
condition_type operation-type	These attributes were only present at category level. The configuration of these attributes could not be copied onto the new SP API channel, as they are now among the common attributes.
externally_assigned_product_ identifier.value	Lengow copied the configuration of this attribute when it was completed. However, only 3 types of ID are now accepted by Amazon: EAN, GTIN and UPC. If you were for example providing ASIN or ISBN in this attribute, you must provide another type of identifier, as it is a mandatory attribute. If you provide the EAN code here, also select the value "EAN" in the "externally_assigned_product_identifier.type" attribute.
Dimensions and weight attributes: - item_weight..value - item_package_dimensions..length.value - item_package_dimensions..width.unit etc.	These attributes are now mandatory. The dimensions and weight of your products and their package must be provided to Amazon in the corresponding attributes. Read the details in this article.
batteries_required..value	This attribute is now mandatory. Select "yes" if the item requires battery power (or if the item itself is a battery) or "no" if it does not. Note that an internal rechargeable battery is also considered a battery.
supplier_declared_dg_hz_regulation..value	This attribute is now mandatory. If the product is a dangerous good, hazardous material, substance, or waste subject to specific regulations regarding transportation, storage, and/or disposal, select an item from the list of valid values. Otherwise, select "Not applicable".
List Price: list_price..value_with_tax list_price..currency	These attributes are now mandatory. The List Price, or reference price, is the suggested retail price set by the manufacturer. The corresponding currency must be provided. Enter "0" if you do not have a List Price.

More broadly speaking, ensure that the correct valid values are selected for the main attributes to prevent errors.

Exclusions:

Check and adjust your exclusions in the new Amazon SP API classic channel, to ensure that your clothing and accessories products are not excluded.

Preview:

Once these settings have been adjusted, check the Preview of your channel, to identify possible format errors.

Variations

Note: When creating new variations, follow our updated guidelines to fill in required values for parent products, as Lengow will not auto-fill them after the migration.

When you are ready, deactivate the former Amazon Flat File channel and activate the new Amazon API channel.

Channel reports:

With this new SP API version, Amazon requires new mandatory attributes in many categories.

It is therefore important to check the channel reports for errors, to verify if your products are properly configured.

Updated June 26, 2025 08:11

Amazon Listing Loader channel

Classic Amazon channel

Category mapping:

Attributes mapping:

Preview:

Variations

Channel reports:

Amazon Flat File channel

Attributes mapping:

Exclusions:

Preview:

Variations

Channel reports:

Articles in this section