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
É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 :
- 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.
- Sur la page des connexions, sélectionnez "+Ajouter une nouvelle connexion".
- Recherchez la connexion "Miravia", après l'avoir trouvée, indiquez un nom pour cette nouvelle connexion.
- 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.
-
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')
- 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
Pour que vos données produit soient créées, vos produits ont besoin d'une catégorie. Ajoutez des catégories à ces derniers en utilisant la fonction de génération de catégories, ou créez de nouvelles catégories à partir de zéro.
- Smart Categorization : Cette fonction attribue automatiquement des catégories à vos produits sur la base de critères prédéfinis, ce qui simplifie le processus de catégorisation.
- Catégorisation manuelle : Attribuez manuellement des catégories à vos produits en définissant des règles spécifiques. Vous pouvez créer des filtres détaillés pour associer chaque produit à la bonne catégorie.
- Produits non catégorisés : Examinez et catégorisez tous les produits qui ne le sont pas encore afin de vous assurer qu'ils sont tous correctement organisés.
Cliquez ici pour en savoir plus sur la catégorisation dans les APIs.
2. Règles
Créez différentes règles pour optimiser les données relatives à vos produits. Pour des exemples, reportez-vous à notre article d'aide sur les règles les plus courantes.
- Configuration des règles : Définissez diverses règles pour affiner les données relatives à vos produits. Il peut s'agir de filtrer, de modifier ou d'améliorer les champs de données pour répondre aux exigences de la marketplace.
Cliquez ici pour en savoir plus sur la mise en place de règles dans les APIs.
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
- 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.
- 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
-
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.
-
Utiliser des valeurs statiques ou dynamiques :
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
- Sélectionner une catégorie de produits : Choisissez la catégorie correspondant à votre produit, par exemple vêtements ou meubles.
- 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
L'étape Résultat fournit une vue d'ensemble des résultats de la configuration de l'API, y compris les annonces correctes, les erreurs et un aperçu des produits envoyés. Cette étape permet de s'assurer que vos données produits sont correctement traitées et d'identifier les problèmes à résoudre.
- Vue d'ensemble : Indique l'état de vos annonces produits, en mettant en évidence les erreurs et les problèmes pour obtenir des informations détaillées.
- Aperçu des produits : Affiche une vue d'ensemble des produits à envoyer à la marketplace, permettant de vérifier que les attributs sont correctement remplis.
- Correctes : Liste des produits traités avec succès et prêts à être diffusés sur la plateforme.
- Erreurs : Identifie les erreurs en fournissant des informations détaillées pour les résoudre.
Les onglets supplémentaires tels que les erreurs de Repricer, l'historique des événements du Repricer, les mises à jour des stocks et les mises à jour de l'exécution des commandes n'apparaissent que s'ils sont pertinents pour l'API que vous utilisez. Cliquez ici pour en savoir plus sur l'étape Résultat de vos APIs.
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 liste. S'il n'y a pas de variantes multiples, sélectionnez l'ID unique du produit dans le champ ID du groupe de produits.
Onglet Livraison
- Champs obligatoires : Assurez-vous que tous les champs concernant la livraison, tels que le poids, la longueur et le contenu, sont remplis avec des valeurs supérieures à 0 et ne comportant pas plus de deux décimales. Si ces valeurs ne sont pas connues, définissez-les à 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 à 1 à l'aide d'une règle.
Onglet Images
- Lien d'images : Liez le(s) champ(s) contenant vos images dans l'onglet Images.
-
Exigences en matière d'image : 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.
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.