RÉSUMÉ

1. Informations générales

a. Définitions importantes d'Amazon

b. Date limite de migration Amazon

2. Page d'erreur business

3. Migration vers la V.2 : étapes à suivre

a. Commandes

b. Publication d'offres

c. Publication produits

4. F.A.Q

a. Amazon Direct > Amazon V.2

b. Comment configurer les déclinaisons ?

c. Attributs fréquemment nécessaires

d. Niveau d'exigences vs. erreurs de publication

e. Publications en erreur

Participez à notre webinar dédié à Amazon V2 pour découvrir en 30 minutes ce qui change, comment migrer facilement, et poser vos questions en direct.

Amazon a apporté des modifications à son API, particulièrement l’abandon des fichiers XML pour les publications. Par conséquent, BeezUP doit migrer vers les fichiers JSON pour le processus de publication.

Nous avons saisi cette opportunité pour créer un nouveau canal intégrant toutes les fonctionnalités de notre V.2, ainsi que quelques nouveautés 😉

Les types de publications seront désormais alignés sur la plupart de nos autres marchés : produits et offres uniquement.

*Les publications dynamiques et avec fréquence de publication en 1h ne sont disponibles que pour certains forfaits BeezUP. Veuillez contacter notre service client si vous souhaitez en savoir plus.

📘 Product types : les catégories Amazon sont liées aux types de produits, et chaque type de produit a des exigences spécifiques en matière d'attributs et de valeurs. Dans le nouveau canal V.2, vous verrez les types de produits au niveau le plus fin du mapping des catégories :

Nous utiliserons le type de produit pour vous montrer uniquement les attributs pertinents pour vos produits sur la page de mapping des colonnes.

📘 Patch mode : Amazon dispose de deux modes de publication définis pour chaque produit : « update » et « patch ».

Par défaut, BeezUP envoie tous les produits en mode "update", ce qui remplacera automatiquement les informations si Amazon accepte l'annonce (produit sans erreurs). Cependant, si vous souhaitez uniquement mettre à jour les informations soumises (sans affecter les attributs non soumis), vous pouvez choisir d'activer le mode « patch » pour un, plusieurs ou tous vos produits. Il s'agit de l'équivalent du mode patial_update sur le canal V.1.

Pour l'activer, vous devez envoyer la valeur True dans le champ Patch Mode du mapping. Vous pouvez utiliser un champ personnalisé pour déterminer les produits à envoyer en mode patch.

📘 Amazon Univers : Le canal V.2 peut lister des produits pour toutes les catégories, ainsi que des produits déjà créés sur Amazon (correspondance EAN effectuée sur Amazon Direct (V.1)).

📘 Erreurs techniques : nous utilisons le terme erreur technique pour les erreurs renvoyées par Amazon lorsque les données soumises ne correspondent pas au schéma d'Amazon. Il peut s'agir d'attributs obligatoires manquants ou de valeurs envoyées avec le mauvais type de données (par exemple, du texte a été envoyé pour un attribut numérique).

📘 Erreurs business : nous utilisons le terme erreur commerciale pour décrire les problèmes liés au contenu des informations soumises ou à l'état de votre compte. Un attribut peut avoir le type de données correct, mais Amazon peut le rejeter ou exiger une autorisation avant de répertorier les produits de certaines marques. Ils peuvent également rejeter des annonces pour des raisons liées à l'état de votre compte.

📅 Amazon arrêtera le traitement des fichiers XML le 30 juin 2025.
⚠️ Vous devez avoir migré vers le canal V.2 avant cette date pour éviter toute interruption.

Les rapports liés aux nouveaux flux JSON ne remontent que les erreurs techniques.
​

Si un produit n'a pas d'erreur dans le rapport de publication produits, vous pouvez considérer qu'il a été accepté d'un point de vue technique. Amazon peut prendre jusqu’à 8 heures pour traiter ce produit.

Si Amazon rejette le produit, vous verrez l'erreur business correspondante sur notre nouvelle page Erreurs business :

Les erreurs 8541/8542 (mismatch) seront visibles sur cette page. Vous pourrez les résoudre en acceptant les ASIN suggérés.

1. Ajoutez le réseau Amazon V.2 pour votre pays.

2. Mappez les catégories sur la page mapping catégories. Veuillez noter que l'arborescence des catégories a été mise à jour, il ne sera donc pas possible de copier le mapping des catégories de la V.1 à la V.2. Si vous utilisez Amazon Direct ou soumettez uniquement des offres, suivez ces étapes.

3. Accédez à la page mapping colonnes et mappez au moins les attributs requis. Si vous avez des questions sur les nouveaux attributs, veuillez consulter les descriptions à côté de chaque attribut et examiner cette section pour obtenir une liste des attributs les plus courants.

4. Reproduisez manuellement les mêmes conditions d’exclusion de canal V.1 dans Amazon V.2.

5. Récupérez le token API à partir de la page Paramètres API et sélectionnez les pays pour la récupération des commandes (vous pouvez accéder aux paramètres API du canal V.1 pour voir les paramètres actuels). Il n'est pas nécessaire d'activer un quelconque type de publication pour le moment.

6. Activez le canal Amazon V.2 - pendant que les réseaux V.1 restent actifs.

Il n'y aura aucun impact sur la récupération des commandes et les demandes de changement de statut. Une fois le canal Amazon V.2 activé, la récupération des commandes se déroulera comme d'habitude.

Que vous modifiiez le statut d'une commande via notre module, directement sur le site BeezUP, ou via l'API, le processus actuel restera le même. Vous n’avez pas besoin d’apporter de modifications ou d’adaptations.

⚠️ Veuillez faire attention aux pays sélectionnés dans les paramètres de l'API Amazon Channel V.1 afin que vous puissiez avoir les mêmes paramètres dans V.2.

Nous vous recommandons de commencer par migrer vos publications d'offres.

Mappez au moins les attributs mentionnés ici et activez la publication d'offres sur la page Paramètres de l'API Amazon V.2.

Attendez ensuite la première publication automatique de l'offre : si vous constatez des erreurs dans la publication de l'offre, examinez le rapport et mappez les champs nécessaires ou corrigez les valeurs mappées (certains attributs ont une liste de valeurs valides).

Une fois que vous n’avez plus d’erreurs dans votre publication d’offre, félicitations 🎉. Vous pouvez désormais désactiver la publication des stocks et des prix sur les réseaux V.1.

Après avoir activé la publication d'offres, vous pouvez commencer à migrer les publications produits.

Mappez au moins les attributs mentionnés ici et ici si vous avez des déclinaisons. Ensuite, désactivez les publications de produits, les images et les relations (déclinaisons) sur les réseaux V.1.

Vous pouvez à présent activer la liste des produits sur la page Paramètres de l'API Amazon V.2.

Attendez la première publication automatique produit : si vous constatez des erreurs techniques dans la publication du produit, examinez le rapport et mappez les champs nécessaires ou corrigez les valeurs mappées (certains attributs ont une liste de valeurs valides). Rendez-vous dans cette section pour plus d'informations sur ces erreurs techniques.

Une fois que vous ne voyez aucune erreur technique dans votre rapport de publication de produits, félicitations 🎉.

7. Une fois que vous avez activé avec succès les deux types de publication sur le réseau V.2 en suivant les étapes ci-dessus, vous êtes prêt 🙌. Désactivez le(s) réseau(x) V.1.

Amazon Direct est un canal V.1 qui vous permet de lister des produits qui existent déjà dans la base de données d'Amazon. Utilisez l'ASIN (Amazon Standard Identification Number) pour associer le SKU à la liste des produits Amazon, avec un minimum d'effort (aucune catégorisation ni mappage d'attributs spécifiques).

Pour publier les produits avec Amazon V.2 en utilisant la même approche, vous devez catégoriser tous les produits dans la catégorie « Amazon Direct ».

Lors de la catégorisation des produits avec Amazon Direct, vous verrez les attributs minimum requis sur la page mapping colonnes (similaire au réseau V.1).

Amazon vous demande de créer une fiche produit pour le produit « parent » afin que vous puissiez ensuite associer toutes les listes de produits de variantes à ce produit parent.

Suivez le tableau ci-dessous pour mapper (ou non) les attributs requis pour créer une variante :

Voici un exemple concret :

Certains attributs peuvent apparaître comme obligatoires dans le rapport de publiction des produits, mais ne sont pas marqués comme obligatoires sur la page mapping colonnes.

Veuillez noter que chez BeezUP, nous marquons les attributs comme obligatoires s'ils sont également marqués comme obligatoires dans le schéma Amazon pour le type de produit spécifié.

Cependant, Amazon applique également des exigences conditionnelles : un attribut peut devenir obligatoire si vous mappez une valeur spécifique à un attribut ou à un groupe d'attributs. Nous n'affichons pas ces exigences conditionnelles sur la page de mapping.

⚠️ Veuillez surveiller les publications produits, car certains attributs marqués comme facultatifs dans le mapping peuvent être obligatoires en fonction des informations que vous soumettez.

Si vous lancez des publications juste après avoir activé le réseau Amazon V.2, il est possible qu'elles soient en erreur.

Il y a des actions faites automatiquement après l'activation qui prennent quelques minutes, alors, c'est normal de voir les publications en erreur quand vous les lancez.

Notez que nous vous recommandons d'attendre les publications automatiques plutôt que lancer manuellement les publications lors de la migration à la V.2