Intégration de Shop Apotheke marketplace dans M2E Cloud

Ce guide vous explique comment configurer Shop Apotheke avec M2E Cloud et gérer l'intégration au quotidien.

Commencez par suivre les étapes requises du côté de Shop Apotheke, puis configurez les paramètres clés dans M2E Cloud une fois la connexion active.

ℹ️ Shop Apotheke est une marketplace basée sur Mirakl. La plupart des règles décrites ci-dessous s'appliquent également aux autres marketplaces Mirakl prises en charge par M2E Cloud.

Ce qui se passe en dehors de M2E Cloud #

Shop Apotheke est une pharmacie en ligne européenne et une marketplace axée sur la santé. Elle met en relation des marques et des commerçants avec des clients qui achètent en ligne des produits de santé, de bien-être et de santé au quotidien.

Shop Apotheke opère via plusieurs vitrines localisées. Chaque vitrine cible un pays spécifique :

• shop-apotheke.com (Allemagne)
• shop-apotheke.at (Autriche)
• farmaline.be (Belgique)
• redcare.it (Italie)

Shop Apotheke est basé sur Mirakl. Cela signifie qu'il respecte les normes Mirakl en matière de validation et de traitement des données du marketplace. Ces règles sont définies par le marketplace, et non par M2E Cloud.

Cela inclut la manière dont Shop Apotheke gère :

• contenu des produits (titres, images, descriptions, attributs)
• offres et tarification (prix, TVA, remises)
• commandes et expéditions (importation des commandes, confirmation d'expédition, suivi)

ℹ️ Remarque : Shop Apotheke ne prend pas en charge les canaux de vente. Si vous souhaitez vendre dans plusieurs pays, vous devez signer un contrat distinct et effectuer l'intégration pour chaque boutique en ligne.

À qui Shop Apotheke convient-il #

Shop Apotheke convient aux commerçants qui vendent des produits liés à la santé avec des identifiants stables et des données produit claires.

Les catégories typiques auxquelles il convient sont les suivantes :

• Produits de santé et de bien-être
• Produits en vente libre et compléments alimentaires
• Soins personnels et hygiène
• Dispositifs médicaux et optique
• Produits liés à la santé pour bébés, animaux domestiques et ménages

ℹ️ Les produits pharmaceutiques et réglementés peuvent nécessiter des autorisations et des documents supplémentaires. L'accès aux catégories et les autorisations de vente sont définis par Shop Apotheke, et non par M2E Cloud.

Demander un compte vendeur Shop Apotheke #

Avant de pouvoir configurer Shop Apotheke dans M2E Cloud, vous devez demander un compte vendeur directement auprès de Shop Apotheke.

Il existe une façon d'entamer l'intégration:

• Contactez Shop Apotheke par e-mail et demandez votre inscription

Lors de l'inscription, Shop Apotheke peut vous demander :

• Coordonnées de l'entreprise et informations relatives à la TVA
• Catégories de produits que vous prévoyez de vendre
• Un exemple de flux de produits à examiner

Dans certains cas, Shop Apotheke examine votre flux de produits avant la création de votre boutique. Cela lui permet de vérifier si votre catalogue est conforme à ses règles et à la portée de ses catégories.

L'approbation du compte est gérée par Shop Apotheke. Les délais peuvent varier.

Une fois votre compte approuvé, vous aurez accès à l'administration Mirakl Seller. Cet accès est nécessaire pour continuer, car vous avez besoin des identifiants Mirakl pour connecter Shop Apotheke à M2E Cloud.

ℹ️ Shop Apotheke ne facture aucun frais d'installation. Vous payez un forfait mensuel fixe de 39,00 €. Vous payez également une commission qui dépend de la catégorie de vos produits. Le taux exact est convenu avec la marketplace lors de l'inscription du vendeur.

Que se passe-t-il dans M2E Cloud #

Une fois votre compte vendeur Shop Apotheke approuvé, M2E Cloud devient le système de gestion de vos opérations quotidiennes sur la marketplace. Il sert de couche de contrôle entre votre boutique et la marketplace Shop Apotheke.

Avec M2E Cloud, vous gérez Shop Apotheke à partir d'un seul endroit. La plateforme gère l'échange, la validation et la synchronisation des données, vous n'avez donc pas besoin de travailler directement dans le back-end Mirakl pour les tâches courantes.

Grâce à M2E Cloud, vous pouvez :

• Connectez Shop Apotheke via l'API Mirakl
• Exportez le contenu de votre boutique vers la marketplace
• Mappez les catégories et les attributs requis
• Gérez les prix, la TVA et les remises
• Synchronisez les commandes, les niveaux de stock et les expéditions

Toutes les mises à jour suivent des règles prédéfinies et s'exécutent automatiquement. Cela réduit le travail manuel et permet de synchroniser votre boutique et la marketplace.

Conditions préalables avant de commencer #

Avant de connecter Shop Apotheke à M2E Cloud, assurez-vous que toutes les conditions ci-dessous sont remplies. Si l'une d'entre elles n'est pas remplie, les exportations seront bloquées ou la synchronisation sera interrompue.

ℹ️ Assurez-vous que votre boutique utilise une plateforme prise en charge, telle que Shopify, BigCommerce, PrestaShop, etc. Toutes les applications M2E sont disponibles dans les annonces officielles d'applications. Par exemple, l'intégration Hygi.de pour Shopify proposée par M2E nécessite d'installer au préalable l'application Shopify.

Vous devez disposer :

• Un compte vendeur Shop Apotheke approuvé
• Identifiants API Mirakl valides
• Enregistrement à la TVA
• Prix des produits disponibles en EUR
• Codes EAN ou GTIN valides pour tous les produits

Des exigences linguistiques s'appliquent également. Le contenu du produit doit être fourni en allemand ou en italien, selon la boutique en ligne sur laquelle vous vendez.

Des exigences supplémentaires peuvent s'appliquer dans certains cas spécifiques :

• Les produits électriques et électroniques nécessitent des données DEEE ou EPR
• Les produits réglementés et liés à la pharmacie peuvent nécessiter des identifiants et des autorisations supplémentaires

Connexion de Shop Apotheke à M2E Cloud #

Shop Apotheke est une marketplace basée sur Mirakl. Vous pouvez la connecter à M2E Cloud à l'aide de Mirakl Connect Single Sign-On.

Pour démarrer la connexion, vous devez avoir accès à votre Mirakl Seller Admin et disposer d'une clé API valide.

Étapes de connexion :

1. Connectez-vous à votre compte administrateur Mirakl Seller.
2. Générez ou copiez votre clé API.
3. Dans M2E Cloud, ouvrez la section Connect Mirakl Account (Connecter le compte Mirakl).
4. Collez la clé API.
5. Sélectionnez Shop Apotheke dans la liste déroulante des marketplaces Mirakl.
6. Saisissez votre identifiant de boutique si vous gérez plusieurs boutiques.
7. Confirmez la connexion.

Après la soumission, M2E Cloud valide automatiquement les informations d'identification. Une fois la validation réussie, les données produit, les offres, les commandes et les expéditions peuvent être synchronisées.

ℹ️ Consultez les instructions complètes pour la configuration de M2E Mirakl dans ce guide.

Les problèmes de connexion courants comprennent :

• Utilisation d'une clé API incorrecte ou obsolète
• Autorisations API manquantes dans Mirakl
• Tentative de connexion avant que le compte Shop Apotheke ne soit entièrement approuvé

ℹ️ Si vous régénérez votre clé API dans Mirakl ultérieurement, vous devez la mettre à jour dans M2E Cloud. Sinon, la synchronisation s'arrêtera.

Une fois connecté : que se passe-t-il ensuite ? #

Une fois la connexion active, vous configurez le comportement de Shop Apotheke dans M2E Cloud. Cette section couvre les principales étapes opérationnelles à suivre pour préparer les listes et gérer la synchronisation continue.

1. Répertorier les nouveaux produits sur Shop Apotheke #

Sélectionnez les produits que vous souhaitez vendre et exportez-les vers Shop Apotheke en tant que nouvelles annonces sur la marketplace.

Pendant l'exportation, M2E Cloud peut envoyer :

• Contenu du produit, tel que les titres, les images et les attributs
• Offres de produits, telles que le prix, la TVA et la disponibilité

Ce comportement est contrôlé par l'attribut Stratégie d'exportation. À un niveau élevé, il définit si M2E Cloud exporte l'intégralité du contenu du produit ou s'il propose uniquement des données.

✅ Utilisez les politiques M2E Cloud pour contrôler les données synchronisées.

2. Liez les annonces existantes sur les marketplaces aux produits de votre boutique #

Si vos produits existent déjà sur Shop Apotheke et utilisent les mêmes références que votre boutique, M2E Cloud peut les lier automatiquement.

Si les SKU ne correspondent pas, vous pouvez lier les annonces manuellement à l'aide d'un fichier CSV. La liaison est nécessaire pour la synchronisation. Elle indique à M2E Cloud quel magasin contrôle le prix, le stock et le traitement des commandes pour chaque annonce sur le marketplace.

3. Catégories de mappage et attributs requis #

Le mappage des catégories est obligatoire. Chaque produit doit être attribué à une catégorie Shop Apotheke avant de pouvoir être exporté.

Cette étape couvre :

• Choisir la bonne catégorie Shop Apotheke
• Choisir les attributs de contenu, tels que les descriptions et les caractéristiques des produits
• Mapper les attributs, tels que les champs liés à la TVA et aux prix

Une fois mappées, M2E Cloud utilise ces mappages pour synchroniser les données conformément aux politiques actives.

✅ Pour savoir comment les données circulent entre les systèmes, consultez le guide des politiques de synchronisation.

4. Configurer les règles relatives aux prix et aux devises #

Tous les prix envoyés à Shop Apotheke doivent être exprimés en euros. La TVA est obligatoire et doit être indiquée pour chaque produit.

La gestion des prix est assurée par les politiques commerciales dans M2E Cloud. Ces politiques contrôlent la manière dont les prix de base, les remises et les règles quantitatives sont appliqués.

Vous pouvez créer plusieurs politiques de vente pour gérer différents groupes de produits, règles de tarification ou marchés.

5. Configurer les paramètres de commande et le mappage des statuts #

Les politiques de commande définissent la manière dont les commandes Shop Apotheke sont traitées dans M2E Cloud et dans votre boutique.

Cela comprend :

• Lorsque les commandes sont importées
• Comment Shop Apotheke associe les statuts des commandes aux statuts des magasins
• Comment les confirmations d'expédition sont renvoyées à la marketplace

Un mappage correct évite les conflits de statut et garantit la cohérence des données de commande.

6. Configurez les règles d'expédition, la livraison et le traitement des factures #

Le comportement d'expédition est contrôlé par les politiques d'expédition.

Pour Shop Apotheke, vous devez fournir un code de suivi et une URL de suivi pour tous les envois. Le mappage des transporteurs est facultatif mais recommandé, car il améliore la visibilité du suivi sur la marketplace.

Vous configurez ici :

• Transporteurs et modes d'expédition disponibles
• Comment les expéditions sont confirmées
• Comment les numéros de suivi sont synchronisés

7. Surveiller les annonces et résoudre les problèmes #

Une fois la configuration effectuée, vous pouvez surveiller le comportement des annonces directement dans M2E Cloud.

À partir de la page Annonces, vous pouvez :

• Vérifier l'état de l'exportation et de la validation
• Examiner les commentaires et les erreurs de la marketplace
• Corriger les problèmes de mappage, de tarification ou de contenu sans désactiver le canal

Cela vous permet de maintenir vos annonces actives et de résoudre rapidement les problèmes.

💡 Consultez la documentation M2E pour comprendre comment fonctionnent l'annonce et la gestion des commandes.

Que se passe-t-il dans le back-end de la marketplace ? #

Une fois les produits et les offres exportés depuis M2E Cloud, toutes les validations et tous les traitements finaux sont effectués par Shop Apotheke. Ces règles sont appliquées par la marketplace via Mirakl et ne peuvent pas être modifiées dans M2E Cloud.

Comprendre ces limitations permet d'éviter les rejets silencieux et les retards dans la mise en ligne des annonces.

Fonctionnalités de la marketplace Shop Apotheke #

Shop Apotheke prend en charge un ensemble défini de fonctionnalités de la marketplace Mirakl.

Prise en charge

• Contenu du produit
• Offres de produits
• Commandes
• Annulations par le commerçant
• Retours par le commerçant
• Correspondance des transporteurs
• Formatage HTML
• Plusieurs emplacements de stock
• Offres groupées
• Téléchargement des factures
• Règlements

Non pris en charge

• Relations automatiques
• Variantes de produits (taille ou couleur)
• Produits reconditionnés
• Réévaluation
• Annulations sur la marketplace
• Retours sur la marketplace
• Expéditions
• Services de traitement des commandes sur la marketplace
• Canaux de vente

ℹ️ Chaque boutique nationale présente les mêmes fonctionnalités de base, mais les règles d'intégration peuvent varier.

Exigences relatives aux produits et aux offres #

Pour que les produits soient annoncés correctement, tous les champs obligatoires doivent respecter les règles de validation de Shop Apotheke et Mirakl.

Contenu du produit (obligatoire)

Chaque produit doit inclure les données suivantes :

• EAN ou GTIN. Utilisé comme identifiant principal du produit. Les codes invalides ou manquants bloquent l’annonce.
• Titre du produit
  • Texte brut uniquement
  • Longueur maximale : 100 caractères
  • Les quantités et les balises HTML ne sont pas autorisées.
• Image principale
  • Fond blanc
  • Format carré
  • Formats pris en charge : JPG, PNG, WEBP
  • Résolution minimale : 450 × 450 px. Résolution recommandée : 1000 × 1000 px
  • Taille maximale du fichier : 5 Mo.
• Marque. Doit correspondre à la marque réelle du produit.
• Quantité et unité
  • L'unité doit être sélectionnée parmi des valeurs fixes telles que g, ml ou l
  • La quantité peut comporter jusqu'à trois valeurs séparées par un « x ».
• Attributs spécifiques à la catégorie. Les champs obligatoires dépendent de la catégorie sélectionnée et doivent être correctement mappés.

Contenu du produit (facultatif)

Vous pouvez améliorer la qualité de votre annonce en fournissant des informations supplémentaires :

• Images supplémentaires
• Descriptions longues et courtes
• Caractéristiques du produit et mode d'emploi
• Variantes utilisant un code de groupe
• Champs réglementaires tels que PZN ou WEEE, le cas échéant

Les champs facultatifs sont toujours validés. Des valeurs incorrectes peuvent bloquer les exportations.

Règles relatives aux offres, aux prix et à la TVA #

Les prix et les taxes sont soumis aux règles Mirakl et doivent être configurés correctement.

• La TVA est obligatoire. Chaque produit doit inclure un taux de TVA valide.
• Devise. Shop Apotheke n'accepte que l'euro.

Réductions et promotions

Shop Apotheke prend en charge la logique de réduction Mirakl.

• La tarification v1 utilise le prix réduit, la date de début de la réduction et la date de fin de la réduction. Le prix réduit doit être inférieur au prix de base.
• La tarification v2 utilise le prix d'exercice comme prix normal et le prix comme valeur réduite. Le prix et le prix d'exercice ne peuvent pas être identiques.
• Les remises sur volume nécessitent un seuil de quantité supérieur à 1.
• Le formatage de la date doit respecter le format Mirakl : AAAA-MM-JJ HH:MM:SS, en UTC.

Une configuration incorrecte des prix empêche la publication des offres.

Expédition, suivi et attributs spécifiques à Mirakl #

Les marketplaces Mirakl s'appuient sur de nombreux autres attributs. Vous devez mapper ceux qui sont requis pour votre catégorie.

Voici quelques exemples typiques :

• Délai avant expédition. Définit le nombre de jours avant l'expédition.
• Classe logistique. Contrôle la gestion des livraisons. Les codes de marketplace valides sont : klein, mittel, groß, extragroß.
• Exigences en matière de suivi. Un code de suivi et une URL de suivi sont requis pour toutes les expéditions. Le mappage des transporteurs est facultatif, mais recommandé.
• Attributs Eco et EPR. Les attributs facultatifs s'appliquent aux produits soumis à des réglementations environnementales. Il s'agit notamment des contributions écologiques et des identifiants d'enregistrement des producteurs.

FAQ #

Pourquoi mon produit n'apparaît-il pas dans l'annonce ? #

La plupart des problèmes liés à l'annonce sont dus à des erreurs de validation du marketplace. Les raisons courantes incluent des codes EAN manquants, des images non valides, des attributs requis non mappés, une TVA manquante ou des prix incorrects.

Où puis-je voir les erreurs de validation du marketplace ? #

Si aucune erreur n'apparaît dans M2E Cloud, vérifiez le back-end Mirakl.

Allez dans Catalogue → Importations de produits et téléchargez le rapport sur les produits non intégrés pour obtenir des commentaires détaillés.

Shop Apotheke prend-il en charge les remises et les promotions ? #

Les remises sont prises en charge par les règles de tarification Mirakl. Les versions Pricing v1 et Pricing v2 sont toutes deux prises en charge.

Les factures sont-elles obligatoires pour les commandes Shop Apotheke ? #

Les exigences en matière de facturation dépendent de votre configuration. Dans certains cas, les factures des commerçants sont facultatives. Dans d'autres, une facture doit être jointe avant la confirmation de l'expédition.

✅ Si vous avez besoin d'aide pour la configuration ou si vous rencontrez des problèmes de validation, contactez l'équipe d'assistance M2E Cloud.