Configurer une API Miravia

Pour commencer à vendre vos produits sur la marketplace Miravia, vous devez disposer d'un compte vendeur Miravia. Si vous n'en possédez pas encore, nous vous conseillons de contacter Miravia pour en obtenir un. Une fois votre compte vendeur Miravia créé, vous pourrez vous y connecter avec Channable.

Table des matières

• Étape 1 : Créer une nouvelle connexion
• Étape 2 : Créer une nouvelle API dans Channable
• Étape 3 : Créer vos annonces produits dans Channable
• Exigences liées au RSGP et au DSA
• Étape 4 : Envoyer vos annonces produits à Miravia
• Étape 5 : Vérifier vos annonces produits pour détecter les erreurs

Étape 1 : Créer une nouvelle connexion

Pour créer une nouvelle connexion Miravia, suivez les étapes ci-dessous :

1. Commencez par vous rendre sur la page API de votre projet et cliquez sur le bouton "+Ajouter une nouvelle API". Cette action vous redirigera vers la page des connexions de votre entreprise.
   
2. Sur la page des connexions, sélectionnez "+Ajouter une nouvelle connexion".
3. Recherchez la connexion "Miravia", après l'avoir trouvée, indiquez un nom pour cette nouvelle connexion.
   
4. Cliquez sur "Connecter avec Miravia". Vous serez redirigé(e) vers Miravia pour l'étape suivante. Une fois redirigé(e), connectez-vous en utilisant les informations d'identification de Miravia.

Après vous être connecté(e) avec succès, la connexion avec Miravia est établie et disponible ! Vous serez renvoyé(e) vers la configuration de l'API.

Étape 2 : Créer une nouvelle API dans Channable

Une fois de retour, vous devez sélectionner votre nouvelle connexion avec Miravia et continuer à configurer votre API.

1. Configurer les paramètres de l'API :
   • Nommez votre API
   • Sélectionnez la langue de l'API
   • Choisissez l'ID unique par produit. (nous recommandons le champ 'id')
     
     
2. Créer votre API : Cliquez sur "Continuer" pour créer la nouvelle API Miravia.

Étape 3 : Créer vos annonces produits dans Channable

Pour configurer votre API, suivez les étapes décrites ci-dessous. Cliquez sur chaque étape pour afficher les instructions détaillées, qui vous guideront tout au long du processus.

1. Catégorisation

2. Règles

3. Construire

L'étape Construire dans Channable vous permet de configurer tous les attributs nécessaires pour vos produits, en veillant à ce que les données soient conformes aux exigences de la marketplace. Cette étape est cruciale pour réussir la mise en ligne des produits et pour éviter les erreurs.

3.1 Vue d'ensemble

1. Accéder à l'étape Construire : Commencez par accéder à l'interface centralisée de l'étape Construire. C'est là que vous gérerez et attribuerez tous les attributs du produit.
2. Identifier les champs obligatoires et optionnels : Les champs obligatoires sont indiqués en rose, ce qui indique qu'ils sont essentiels pour la mise en ligne de vos produits. Les champs optionnels sont marqués en jaune et peuvent être remplis en fonction de besoins spécifiques.

3.2 Renseigner les attributs partagés

1. Renseigner les attributs partagés : Saisissez les détails communs qui s'appliquent à tous les produits, tels que l'EAN, les prix et les titres. Cette étape garantit l'uniformité des informations de base sur les produits dans l'ensemble de vos annonces produits.
   • Utiliser des valeurs statiques ou dynamiques :
     • Valeurs statiques : Saisissez directement des valeurs qui restent constantes, comme le nom de la marque ou du fabricant.
     • Valeurs dynamiques : Utilisez des champs qui se mettent automatiquement à jour en fonction des données liées, ce qui est idéal pour les variables telles que les niveaux de stock ou les prix.

Après avoir indiqué les valeurs souhaitées pour les attributs partagés, passez aux attributs par catégorie ci-dessous.

3.3 Spécifier des attributs par catégorie

1. Sélectionner une catégorie de produits : Choisissez la catégorie correspondant à votre produit, par exemple vêtements ou meubles.
2. Catégorie - attributs spécifiques : Renseignez les attributs spécifiques à la catégorie sélectionnée, tels que la taille pour les vêtements ou les dimensions pour les meubles. Cette étape permet d'affiner vos annonces en fonction des exigences de la catégorie. Ici encore, vous pouvez utiliser des valeurs statiques ou dynamiques.

Cliquez ici pour en savoir plus sur l'étape Construire de vos APIs.

4. Qualité

L'étape Qualité fournit un retour d'information instantané sur la qualité de la configuration, en mettant en évidence les erreurs obligatoires et optionnelles afin de garantir que les données relatives à vos produits répondent aux normes des marketplaces.

Actions

• Voir les produits : Pour voir les produits présentant des problèmes spécifiques.
• Voir dans Construire : Redirige vers l'étape Construire pour lier les informations manquantes.
• Catégoriser : Renvoie à l'étape Catégorisation pour classer les produits.
• Source : Disponible pour les champs IDs, dirige vers l'étape Paramètres.

Cliquez ici pour en savoir plus sur l'étape Qualité de vos APIs.

5. Aperçu

L'étape Aperçu affiche les attributs mappés de plusieurs produits et met en évidence les erreurs avant l'export vers la marketplace.

Caractéristiques

• Rechercher et filtrer : Recherchez des produits spécifiques ou filtrez par message d'erreur/catégorie.
• Vue d'ensemble des produits : Affiche tous les produits à exporter; elle peut être filtrée pour n'afficher que les produits comportant des erreurs.
• Aperçu détaillé du produit : Affiche les informations manquantes et les actions pour corriger les erreurs.

Checklist pour la finalisation des attributs

• Examiner les attributs partagés : Assurez-vous que tous les attributs partagés obligatoires sont remplis.
• Examiner les attributs par catégorie : Veillez à ce que tous les attributs obligatoires spécifiques à chaque catégorie soient remplis.
• Vérifier les erreurs : Corrigez les champs indiqués en rouge.

Cliquez ici pour en savoir plus sur l'étape Aperçu de vos APIs.

6. Résultat

Exigences supplémentaires pour Miravia

Les informations suivantes sont spécifiques à Miravia, nous expliquons par onglet ce à quoi vous devez faire attention.

Onglet Produits

• ID du groupe de produits : Ce champ est utilisé pour regrouper plusieurs variantes de produits dans une seule annonce. S'il n'y a pas de variantes multiples, sélectionnez l'ID unique de vos produits comme ID du groupe de produits.

Onglet Livraison

• Champs obligatoires : Assurez-vous que tous les champs concernant la livraison, tels que le poids, la longueur, etc. sont remplis avec des valeurs supérieures à 0 et ne comportent pas plus de deux décimales. Si ces valeurs ne sont pas connues, définissez-les sur 1 à l'aide d'une règle.
• Expédié par le vendeur : Ne mettez cette option sur "Oui" qu'avec l'autorisation préalable de Miravia; sinon, mettez-la sur "Non" pour éviter les erreurs. Reportez-vous à l'article sur l'utilisation de "Delivery by Miravia" dans Channable pour plus d'informations.
• Valeurs par défaut : Si les informations de livraison vous sont inconnues, définissez les toutes sur 1 à l'aide d'une règle.

Onglet Images

• Liens d'images : Liez le(s) champ(s) contenant vos images dans l'onglet Images.
• Exigences en matière d'images : Respectez les exigences strictes de Miravia en matière d'images, tant pour l'URL que pour l'image elle-même. Le non-respect de ces exigences entraînera l'apparition de l'erreur "Impossible de télécharger l'image en raison de : E302 : Description de l'erreur", dans l'onglet des résultats.
  

Exigences liées au RSGP et au DSA

L'Union Européenne (UE) a introduit de nouvelles exigences liées au RSGP et au DSA pour les plateformes en ligne, y compris les marketplaces.

Comment ajouter les informations liées au DSA dans Channable

Pour se conformer aux nouvelles réglementations de l'UE, des étapes spécifiques doivent être suivies. Nous avons détaillé ci-dessous ces étapes pour vous aider avec le processus.

Étape 1 : Enregistrer les informations du fabricant et de la personne responsable

Commencez par créer des profils dans Seller Central, puis accédez à la page de gestion des informations du fabricant (Manufacturer Information management). Vous trouverez deux onglets :

• Informations sur le fabricant (Manufacturer information)
• Informations sur la personne responsable dans l'UE (EU responsible person information)

Dans l'onglet Informations sur le fabricant, ajoutez les détails du fabricant. Dans l'onglet Informations sur la personne responsable dans l'UE, ajoutez les détails de la personne responsable dans l'UE. Ci-dessous, vous trouverez des captures d'écran du processus.

Une fois terminé, vous recevrez un ID du fabricant et un ID de la personne responsable dans l'UE. Ces identifiants sont essentiels pour l'étape suivante. En cas de doute, vous pouvez contacter Miravia pour plus d'informations.

Étape 2 : Remplir les attributs Fabricant et Personne Responsable avec les ID nouvellement reçus

Avec les ID requis obtenus à l'étape 1, vous pouvez commencer à remplir les attributs dans Channable. Dans Channable, utilisez les noms d'attributs suivants :

• Manufacturer Info : L'ID enregistré du fabricant.
• EU Responsible : L'ID enregistré de la personne responsable associée au produit.

Pour remplir ces attributs, accédez à [Votre API Miravia] > Construire > Attributs par catégorie. Cliquez sur une catégorie et recherchez les attributs mentionnés. Entrez les ID obtenus de Seller Central dans les attributs et cliquez sur Enregistrer.

Si vous travaillez avec plusieurs fabricants ou personnes responsables, créez une règle pour remplir un champ de projet en conséquence.

Règlement sur la Sécurité Générale des Produits (RSGP)

En plus de la conformité au DSA, Miravia a ajouté des champs liés à la sécurité des produits.

Avertissements de sécurité

Les vendeurs doivent indiquer si le produit comporte des avertissements de sécurité. Si oui, les attributs suivants doivent être remplis :

• Does this product have a safety warning ? : Yes/No
• Safety Warning Content : Fournissez le contenu de l'avertissement de sécurité ici.

Si "Yes" (Oui) est sélectionné pour l'avertissement de sécurité, assurez-vous de saisir les informations de sécurité nécessaires dans l'attribut Contenu de l'avertissement de sécurité.

Étiquette d'emballage physique

Vous devez fournir une étiquette produit incluant les détails nécessaires, chaque produit doit également inclure une photo étiquetée. L'étiquette d'emballage physique doit contenir :

• Informations sur le fabricant (et la personne responsable dans l'UE, si le fabricant n'est pas basé dans l'UE)
• Informations d'identification du produit
• Marquages ou avertissements de sécurité

Dans Channable, vous pouvez trouver cet attribut dans la section Attributs par catégorie sous Package/Label Photo (EU).

Certifications de conformité du produit

Miravia a introduit des attributs supplémentaires spécifiques à certaines catégories, qui n'apparaîtront dans Channable que si vos produits appartiennent à certaines catégories. Ces attributs permettent de soumettre les certifications appropriées, telles que les certificats CE et les rapports de tests. Les attributs disponibles varient selon la catégorie de produit.

• Certificat CE
• Certificat ECE
• Certificat CPNP
• RoHS Testing Report : Vérifie si les produits électroniques sont conformes aux réglementations sur les substances nocives.
• REACH Report : Confirme que les produits chimiques répondent aux normes de l'UE tout au long de la chaîne d'approvisionnement.
• BPR Registration Certificate : Confirme l'approbation pour l'utilisation de produits antibactériens selon les lois de l'UE.
• EU Food Contact Materials Test Report (FCM) : Confirme que les matériaux sont sûrs pour le contact alimentaire dans l'UE.

Pour certaines catégories, des rapports de test spécifiques sont également requis, tels que :

• Document PIF : Dossier complet avec les informations nécessaires pour la vente de produits cosmétiques dans l'UE.
• Rapport de test EMC/LVD : Valide la conformité avec les normes de sécurité électromagnétique.
• Rapport de test EMC : Vérifie qu'un produit n'interfère pas électromagnétiquement.
• Rapport de test EN71 : Prouve que les jouets sont sûrs conformément aux normes de l'UE.
• Rapport de test R44 : Certifie que les sièges auto pour enfants répondent aux normes de sécurité de l'ONU.
• Rapport de test pour produits de construction : Confirme que les matériaux de construction répondent aux normes de l'UE.
• Rapport de test MDR : Indique que les dispositifs médicaux respectent les réglementations de l'UE.
• Rapport de test pour tétines (EN1400:2013) : Vérifie que les tétines sont sûres selon les normes de l'UE.
• Rapport de test EPI : Assure que les équipements de protection individuelle répondent aux normes de l'UE.
• EN62115 : Garantit que les jouets électriques sont sûrs.
• Rapport de test RED : Confirme que les appareils sans fil sont conformes à la directive sur les équipements radio.

Pour plus de détails sur les réglementations de l'UE et la conformité, veuillez consulter cet article ou contacter Miravia pour obtenir de l'aide.

En suivant ces lignes directrices, vous vous assurerez que vos annonces produits sur Miravia sont correctement paramétrées et conformes à leurs exigences.

Étape 4 : Envoyer vos annonces produits à Miravia

Une fois vos annonces produits configurées, vous pouvez les envoyer à Miravia. Si vous n'avez pas encore activé le projet, accédez à "Paramètres > Paramètres du projet > Activer le projet". Ensuite, dirigez vous vers "APIs > Votre API Miravia > Activer l'API".

Lorsque vous cliquez sur "Exécuter", vos produits seront envoyés à Miravia et affichés sur la marketplace. 

Étape 5 : Vérifier vos annonces produits pour détecter les erreurs

Pour vérifier s'il y a des erreurs, rendez-vous sur la page Résultat de l'API > onglet Erreurs, où vous verrez les annonces produits qui comportent des erreurs. En cliquant sur une erreur spécifique, vous obtiendrez plus d'informations sur la cause de l'erreur. Pour plus d'informations sur la signification des erreurs, lisez cet article.