Ce guide vous accompagne dans le paramétrage de la plateforme AmazonSeller avec les bonnes pratiques à adopter sur Shoppingfeed. Il s'adresse aux marchands souhaitant créer ou mettre à jour leurs fiches produits et offres via la nouvelle API SP-API d'Amazon.
📍 Pour des informations complémentaires sur la migration, consultez les articles : Migration vers la nouvelle API Amazon & Comment paramétrer la plateforme Amazonseller ?
Paramétrage du flux produit dans Amazonseller
Catégories
Afin de créer de nouveaux produits sur Amazon, vous devez affecter ceux-ci à une des catégories du référentiel de la plateforme. Pour rappel, il n'est pas nécessaire de créer des produits si ces derniers existent déjà via un autre vendeur tiers ou Amazon lui-même. Le référentiel des catégories peut varier selon la langue de votre compte Shoppingfeed.
Bonnes pratiques :
Vous trouverez ici la liste des catégories disponibles pour Amazon . Assurez-vous de choisir la bonne catégorie (et dans la bonne langue selon votre compte Shoppingfeed) afin d'obtenir les attributs obligatoires et optionnels les plus pertinents pour votre catalogue.
Attributs
Une fois la catégorie définie, Shoppingfeed affichera dynamiquement les attributs requis via l'onglet "Autotag".
Bonnes pratiques :
Les Browsnodes sont désormais à renseigner dans cette section. Pour rappel, ils vous permettent d'attribuer la bonne catégorie en front sur le site Amazon de votre pays et ont un impact sur la commission appliquée par la plateforme. Les valeurs associées à vos anciens produits restent inchangées dans la cadre de la migration, ce paramétrage ne concerne donc que les nouveaux produits à créer.
Renseignez progressivement vos attributs en commençant par ceux indiqués comme obligatoires. Nous vous recommandons en effet de ne pas surcharger votre export produits avec trop d’attributs dès le départ. Ceci vous permettra de maîtriser la gestion des erreurs et de mieux monitorer la mise à jour de vos fiches produits.
Nous vous recommandons notamment le renseignement des attributs de poids et de dimensions (du produit et de l'emballage) obligatoires selon la typologie de produit et le calcul de certaines fonctionnalités logistiques.
Soyez attentifs aux attributs liés (ou attributs inter-dépendants) : le remplissage d'un champ de ce type peut rendre les autres obligatoires par la suite (exemple : mesures et unités de mesure).
Pensez également à ne pas renseigner/modifier les attributs de langue : Shoppingfeed les gère automatiquement pour vous en se basant sur la langue de votre compte.
- ASINS
L'attribut {merchant_suggested_asin.0.value} permet de lier manuellement une offre à un ASIN existant.
- BulletPoint
Les bullet points visibles sur la fiche produit Amazon (les encadrés descriptifs sous le titre) correspondent aux attributs {bullet_point.X.value} dans Shoppingfeed. Le Bullet Point 1 sur Amazon correspond à {bullet_point.0.value}, le Bullet Point 2 à {bullet_point.1.value} et ainsi de suite jusqu’à 5 bullet points maximum.
Il est donc important de les renseigner dans le bon ordre dans Shoppingfeed pour que l’affichage final sur Amazon soit cohérent et vendeur.
- Gestion des variations
Il n’est pas nécessaire de modifier manuellement les champs liés aux variations (parent/enfant). Shoppingfeed gère automatiquement ces attributs en fonction des relations définies dans votre flux source. Les bonnes valeurs sont envoyées par défaut à Amazon pour assurer une structuration correcte des produits variant (taille, couleur, etc.).
Envoi du flux produit
Par défaut, Shoppingfeed envoie les données en mode "partial_update", ce qui signifie que seuls les champs renseignés sont mis à jour, sans toucher aux autres données déjà présentes sur Amazon.
Il est possible de forcer l’envoi en mode "update" si vous souhaitez remplacer l’intégralité des données existantes côté Amazon pour le produit concerné.
Pour valider l’activation du flux produits sur la nouvelle plateforme Amazonseller, assurez-vous que les flux suivants sont bien sélectionnés : product_upsert et status_get (pour vérifier le statut et donc l'existence d'un produit sur Amazon) via l'onglet "Paramètres".
Paramétrage du flux offre dans Amazonseller
Champs prix et stock
Voici un rappel des champs nécessaires au bon paramétrage de vos offres (prix / stock) ainsi que les informations envoyées par défaut via Shoppingfeed :
| offer.fulfillment_availability.0.lead_time_to_ship_max_days | Recommended – Time in days between receiving an order and shipping it | 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 |
| offer.purchasable_offer.0.currency | Required | CURRENCY_SF |
| offer.purchasable_offer.0.discounted_price.0.schedule.0.value_with_tax | Required | old_price |
| offer.purchasable_offer.0.discounted_price.0.schedule.0.start_at | Required if promotion – Format: yyyy-mm-dd 00:00:00 | – |
| offer.purchasable_offer.0.discounted_price.0.schedule.0.end_at | Required if promotion – Format: yyyy-mm-dd 00:00:00 | – |
| offer.purchasable_offer.0.map_price.0.schedule.0.value_with_tax | – | |
| offer.purchasable_offer.0.our_price.0.schedule.0.value_with_tax | Required | price |
A noter : si vous ne souhaitez pas modifier un champ (prix ou stock), ne le mappez pas ou laissez-le vide. Sinon, il sera écrasé côté Amazon.
Etat de l'offre
Associez {offer.condition_note} avec un champ texte conditionnel selon le statut du produit et vérifier que le champ {condition_type} est bien renseigné avec les valeurs autorisées (par défaut vos offres sont paramétrées avec la condition "new_new") :
| Libellé Amazon (FR) | Code API Amazon (SP-API) |
| Neuf | new_new |
| Occasion - Comme neuf | used_like_new |
| Occasion - Très bon état | used_very_good |
| Occasion - Bon état | used_good |
| Occasion - Acceptable | used_acceptable |
| Reconditionnée - Premium | refurbished |
| Collectors (rare) | collectible_* |
A noter : seuls les marchands éligibles au programme Amazon Renewed peuvent paramétrer des offres de type reconditionné {refurbished}.
Les informations logistiques
Le champ {offer.merchant_shipping_group.0.value} permet d’indiquer le template de livraison à utiliser pour votre offre. Pour utiliser ce champ correctement, il vous suffit de récupérer l’identifiant du modèle d'expédition dans l’url de la page de configuration de celui-ci depuis votre interface Seller Central.
Envoi du flux offre
Par défaut, Shoppingfeed envoie les données en mode "partial_update" ce qui signifie que seuls les champs renseignés sont mis à jour, sans toucher aux autres données déjà présentes sur Amazon.
Il est possible de forcer l’envoi en mode "update" si vous souhaitez remplacer l’intégralité des données existantes côté Amazon pour l'offre concernée.
Enfin, pour valider l’activation du flux offres sur la nouvelle plateforme Amazonseller, sélectionnez le flux offer_upsert via l'onglet "Paramètres" :
Récupération des adresses de facturation et du numéro de TVA intra-communautaire
Pour récupérer le numéro de TVA intra-communautaire, disponible dans les informations API de chaque commande Amazon concernée, sur votre compte Shoppingfeed et par la même occasion votre CMS, rendez-vous sur votre seller Amazon, dans la rubrique "Commandes > Rapports de commandes" et activez les rapports de commandes ainsi que cette option :
Pour récupérer les adresses de facturation disponible dans les informations API de chaque commande Amazon concernée, sur votre compte Shoppingfeed et par la même occasion votre CMS, rendez-vous sur votre seller Amazon, dans la rubrique "Nouvelles commandes > Ajouter ou supprimer des colonnes de rapport sur la commande" et activez cette option :
Enfin pour les 2 informations, pensez ensuite bien à contacter votre chargé de compte ou le support afin que nous activions la remontée de notre côté également.