Applicable products: Netmarkets

đź’ˇAmazon - Comment migrer votre canal Amazon vers SP API

Au printemps 2025, Lengow passe de la technologie Amazon actuelle basée sur les fichiers XSD à la nouvelle technologie Amazon Seller Partner API (SP API).
Pour connaître les avantages et le calendrier prévisionnel, consultez cet article.

Comme Amazon va déprécier l'ancien connecteur fin juillet 2025 (initialement le 30 juin, date repoussée par Amazon), tous les vendeurs doivent migrer pour continuer à vendre sur Amazon.

Sur Lengow, cette migration se fera progressivement, en commençant par les canaux Amazon Listing Loader, suivis par les canaux Amazon classiques, et enfin les canaux Amazon Flat File.
Vous serez informé par email lorsque vous devrez migrer chaque type de canal.

Vous devrez suivre ces étapes pour migrer chacun de vos canaux Amazon :

  1. Lengow va dupliquer chaque canal Amazon actif et copier la plupart de votre configuration existante.
    Ce nouveau canal créé, utilisant Amazon SP API, est initialement créé comme brouillon (non activé). 
  2. Vous devez vérifier et ajuster les paramétrages (mapping des catégories et des attributs) de votre nouveau canal Amazon. 
    Lisez nos instructions ci-dessous pour chaque type de canal.
  3. Désactivez l'ancien canal et activez le nouveau.
  4. Consultez les rapports de diffusion et corrigez les erreurs éventuelles.

Conseil : si vous souhaitez d'abord tester la migration avec quelques produits, procédez ainsi :

  • CrĂ©ez un segment avec vos produits test, puis utilisez ce segment pour votre nouveau canal Amazon SP API;
  • Configurez le nouveau canal Amazon SP API;
  • DĂ©sactivez l'ancien canal Amazon;
  • Activez le nouveau canal Amazon pour effectuer vos tests (tant que l'ancien ou le nouveau canal Amazon est actif, vos commandes sont rĂ©cupĂ©rĂ©es par Lengow).

Bien que la plupart des paramétrages aient été répliqués automatiquement par Lengow, plusieurs attributs peuvent avoir été ajoutés ou avoir un nouveau format. Ces attributs doivent donc être renseignés selon les exigences d'Amazon.

Téléchargez sur Amazon la liste complète des attributs requis par type de produit
Note : les attributs qui étaient déjà obligatoires peuvent ne pas être spécifiés dans ce fichier.

Vous trouverez ci-dessous les actions requises pour chaque type de canal Amazon :

Amazon Listing Loader

Fin mars et début avril 2025, Lengow créera progressivement un nouveau canal Listing Loader pour chaque canal actif. 

Votre configuration existante a été copiée sur le nouveau canal Listing Loader. Cependant, vous devez adapter le paramétrage de vos attributs aux changements suivants :

Nom de l'attribut Changements avec SP API
externally_assigned_product_
identifier.value
Cet attribut remplace l'ancien attribut "product-id", mais vous ne pouvez plus y indiquer l'ASIN.
Vous pouvez fournir le code EAN de vos produits dans cet attribut, mais il est désormais facultatif si vous fournissez le code ASIN dans l'attribut "merchant_suggested_asin..value".
Si vous renseignez le code EAN, sélectionnez également la valeur "EAN" dans l'attribut "externally_assigned_product_identifier.type".
merchant_suggested_asin..value Entrez le code ASIN (référence interne Amazon) de vos produits si vous l'avez dans votre catalogue.
Pour tous les produits, vous devez fournir soit l'ASIN ici ou/et l'EAN dans "externally_assigned_product_identifier.value".

Une fois ces paramétrages ajustés, désactivez l'ancien canal Listing Loader et activez le nouveau.

Amazon classique

🎓 Pour bénéficier des conseils détaillés de nos experts Amazon, regardez ce webinaire : Migration Amazon Classique: Guide pour une transition réussie 
(Connectez-vous au Help Center pour y accéder).

En mai 2025, Lengow créera progressivement un nouveau canal Amazon classique pour chaque canal actif. 

Votre configuration existante a été copiée sur le nouveau canal Amazon. Cependant, vous devez adapter vos paramétrages aux changements suivants :

  • Mapping CatĂ©gories :

De nombreuses catégories ont été supprimées et remplacées par des nouvelles dans la version SP API du canal Amazon. Vous devez donc vérifier votre mapping catégories et le compléter si nécessaire.

Cliquez ici pour voir la liste complète des catégories supprimées 
'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'
  • Mapping Attributs :

Nom de l'attribut Changements avec SP API

Attributs de déclinaisons :
- variation_theme..name
- parentage_level..value
- color..value
- size..value
- style..value
etc.

Certains attributs utilisés pour configurer les déclinaisons, tels que "Shoes..VariationData..VariationTheme", n'étaient présents que pour certaines catégories.
La configuration de ces attributs n'a pas pu être copiée sur le nouveau canal SP API, car ils font désormais partie des attributs communs.
Exception : "material..value" et "pattern..value" sont disponibles au niveau catégorie, car les valeurs valides varient pour chaque catégorie.
Assurez-vous que les attributs nécessaires à la configuration de vos variations sont renseignés conformément à nos instructions ici (notamment en sélectionnant la valeur "Variante" pour l'attribut "child_relationship_type").

externally_assigned_product_
identifier.value

Lengow a copié la configuration de cet attribut s'il était renseigné. Cependant, seuls 3 types d'ID sont désormais acceptés par Amazon : EAN, GTIN et UPC.
Si vous fournissiez par exemple un ASIN ou un ISBN dans cet attribut, vous devez fournir un autre type d'identifiant, car il s'agit d'un attribut obligatoire.
Si vous fournissez le code EAN ici, sélectionnez également la valeur "EAN" dans l'attribut "externally_assigned_product_identifier.type".

Attributs de dimensions et poids :
- item_weight..value
- item_package_dimensions..length.value
- item_package_dimensions..width.unit
etc.

Ces attributs sont désormais obligatoires.
Les dimensions et le poids de vos produits et de leur emballage doivent être fournis à Amazon dans les attributs correspondants. Informations détaillées dans cet article.

batteries_required..value

Cet attribut est désormais obligatoire.
Sélectionnez "oui" si l'article nécessite une alimentation par batterie (ou si l'article lui-même est une batterie) ou "non" dans le cas contraire. Notez qu'une batterie interne rechargeable est également considérée comme une batterie.

supplier_declared_dg_hz_regulation..value

Cet attribut est désormais obligatoire.
Si le produit est un produit dangereux, une matière dangereuse, une substance dangereuse ou un déchet soumis à des réglementations spécifiques en matière de transport, de stockage et/ou d'élimination, sélectionnez l'une des valeurs valides. Sinon, sélectionnez "Non applicable".

Prix catalogue (list price) :
list_price..value_with_tax
list_price..currency

Ces attributs sont désormais obligatoires.
Le prix catalogue, ou prix de référence, est le prix de vente conseillé fixé par le fabricant. La devise correspondante doit être indiquée.
Entrez "0" si vous ne disposez pas d'un prix catalogue.

Attributs de dates de promotion :
- purchasable_offer..discounted_price
..schedule..start_at
- purchasable_offer..discounted_price
..schedule..end_at

Si vous avez des promotions en place, assurez-vous que les dates de promotion sont définies selon le nouveau format : aaaa-mm-jj
(exemple : 2025-05-24)
L'ancien format incluait l'heure.

  • Aperçu :

Une fois ces paramétrages ajustés, contrôlez l'aperçu de votre canal Amazon, afin d'identifier de potentielles erreurs de format de données. 

Déclinaisons

Avec le nouveau canal Amazon SP API, les produits parents doivent désormais inclure des valeurs pour certains attributs (exemple : image principale, type de relation, etc.). Il s'agit d'un changement par rapport à la version précédente du canal, où ces attributs devaient être laissés vides pour les produits parents.

Lors de la migration, Lengow a copié les valeurs des produits enfants vers les produits parents afin de répondre aux nouvelles exigences d'Amazon. Ces valeurs ne sont pas visibles dans l'aperçu du canal, mais elles sont envoyées à Amazon.

A noter : lors de la création de nouvelles variations, suivez ces instructions pour remplir les valeurs requises pour les produits parents, car Lengow ne les remplira pas automatiquement après la migration.

Liste des attributs automatiquement renseignés pour les produits parents lors de la 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"

Lorsque vous êtes prêt, désactivez l'ancien canal Amazon classique et activez le nouveau.

  • Rapports de diffusion :

Avec cette nouvelle version SP API, Amazon impose de nouveaux attributs obligatoires dans de nombreuses catégories.

Il est donc important de vérifier les rapports de diffusion pour détecter d'éventuelles erreurs et vous assurer que vos produits sont correctement configurés.

Amazon Flat File

En juin 2025, Lengow créera progressivement un nouveau canal Amazon classique pour chaque canal Flat File actif.
Note : les vêtements et accessoires sont désormais publiés via le canal Amazon API classique, comme tout autre type de produit.

Votre configuration existante a été copiée sur le nouveau canal Amazon. Cependant, vous devez adapter vos paramétrages aux changements suivants :

  • Mapping Attributs :

Nom de l'attribut Changements avec SP API

Attributs de déclinaisons :
- variation_theme..name
- parentage_level..value
- color..value
- size..value
- style..value
etc.

Certains attributs utilisés pour configurer les déclinaisons, tels que "variation_theme", n'étaient présents que pour certaines catégories.
La configuration de ces attributs n'a pas pu être copiée sur le nouveau canal SP API, car ils font désormais partie des attributs communs.
Exception : "material..value" et "pattern..value" sont disponibles au niveau catégorie, car les valeurs valides varient pour chaque catégorie.
Assurez-vous que les attributs nécessaires à la configuration de vos variations sont renseignés conformément à nos instructions ici (notamment en sélectionnant la valeur "Variante" pour l'attribut "child_relationship_type").

condition_type

 

Cet attribut n'était présent que pour certaines catégories. La configuration de cet attribut n'a pas pu être copiée sur le nouveau canal SP API, car il fait désormais partie des attributs communs.

operation_type

 

Deux valeurs sont acceptées en majuscules : UPDATE et DELETE.
Auparavant, trois valeurs étaient acceptées en minuscules : update, partial-update et delete.
L’usage de valeurs en minuscules est désormais bloquant (par exemple, via une règle).

externally_assigned_product_
identifier.value

Lengow a copié la configuration de cet attribut s'il était renseigné. Cependant, seuls 3 types d'ID sont désormais acceptés par Amazon : EAN, GTIN et UPC.
Si vous fournissiez par exemple un ASIN ou un ISBN dans cet attribut, vous devez fournir un autre type d'identifiant, car il s'agit d'un attribut obligatoire.
Si vous fournissez le code EAN ici, sélectionnez également la valeur "EAN" dans l'attribut "externally_assigned_product_identifier.type".

Attributs de dimensions et poids :
- item_weight..value
- item_package_dimensions..length.value
- item_package_dimensions..width.unit
etc.

Ces attributs sont désormais obligatoires.
Les dimensions et le poids de vos produits et de leur emballage doivent être fournis à Amazon dans les attributs correspondants. Informations détaillées dans cet article.

batteries_required..value

Cet attribut est désormais obligatoire.
Sélectionnez "oui" si l'article nécessite une alimentation par batterie (ou si l'article lui-même est une batterie) ou "non" dans le cas contraire. Notez qu'une batterie interne rechargeable est également considérée comme une batterie.

supplier_declared_dg_hz_regulation..value

Cet attribut est désormais obligatoire.
Si le produit est un produit dangereux, une matière dangereuse, une substance dangereuse ou un déchet soumis à des réglementations spécifiques en matière de transport, de stockage et/ou d'élimination, sélectionnez l'une des valeurs valides. Sinon, sélectionnez "Non applicable".

Prix catalogue (list price) :
list_price..value_with_tax
list_price..currency

Ces attributs sont désormais obligatoires.
Le prix catalogue, ou prix de référence, est le prix de vente conseillé fixé par le fabricant. La devise correspondante doit être indiquée.
Entrez "0" si vous ne disposez pas d'un prix catalogue.

Plis généralement, veillez à sélectionner les valeurs valides correctes pour les attributs principaux afin d'éviter toute erreur.

  • Exclusions :

Vérifiez et ajustez vos exclusions dans le nouveau canal Amazon SP API classique afin de vous assurer que vos vêtements et accessoires ne sont pas exclus.

  • Aperçu :

Une fois ces paramétrages ajustés, contrôlez l'aperçu de votre canal Amazon, afin d'identifier de potentielles erreurs de format de données. 

Déclinaisons

Avec le nouveau canal Amazon SP API, les produits parents doivent désormais inclure des valeurs pour certains attributs (exemple : image principale, type de relation, etc.). Il s'agit d'un changement par rapport à la version précédente du canal, où ces attributs devaient être laissés vides pour les produits parents.

Lors de la migration, Lengow a copié les valeurs des produits enfants vers les produits parents afin de répondre aux nouvelles exigences d'Amazon. Ces valeurs ne sont pas visibles dans l'aperçu du canal, mais elles sont envoyées à Amazon.

A noter : lors de la création de nouvelles variations, suivez ces instructions pour remplir les valeurs requises pour les produits parents, car Lengow ne les remplira pas automatiquement après la migration.

Liste des attributs automatiquement renseignés pour les produits parents lors de la 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"

Lorsque vous êtes prêt, désactivez l'ancien canal Amazon Flat File et activez le nouveau canal Amazon API.

  • Rapports de diffusion :

Avec cette nouvelle version SP API, Amazon impose de nouveaux attributs obligatoires dans de nombreuses catégories.

Il est donc important de vérifier les rapports de diffusion pour détecter d'éventuelles erreurs et vous assurer que vos produits sont correctement configurés.

-

Articles dans cette section

Actualités, Services et Rapports d'incidents
Découvrez les mises à jour, les webinaires et les services d’experts pour tirer le meilleur parti de Lengow.