So integrieren Sie den Shop Apotheke-Marktplatz mit M2E Mirakl Connect

In dieser Anleitung erfahren Sie, wie Sie den Shop Apotheke-Marktplatz über M2E Mirakl Connect anbinden und verwalten können.

Shop Apotheke ist eine in Europa ansässige Online-Apotheke und ein auf Gesundheitsprodukte spezialisierter Marktplatz. Die Plattform basiert auf Mirakl und hält sich somit an die Mirakl-Standards für Produktdaten, Angebote, Preisgestaltung und Auftragsabwicklung.

Mit M2E Mirakl Connect können Sie Shop Apotheke direkt von Ihrem Shop aus verwalten. Nach der Anbindung können Sie:

• Produkte und Angebote synchronisieren,
• Preise und Lagerbestände aktualisieren,
• Bestellungen importieren und bearbeiten,
• Sendungsverfolgungs- und Versandbestätigungen versenden,
• sowie den Status der Auflistung und Validierungsergebnisse überwachen.

ℹ️ Die meisten Schritte in dieser Anleitung gelten auch für andere Mirakl-Marktplätze, die von M2E Mirakl Connect unterstützt werden.

Außerhalb von M2E Mirakl Connect #

Shop Apotheke verbindet Marken und Händler mit Kunden, die Gesundheits-, Wellness- und Alltagsprodukte online kaufen. Der Marktplatz betreibt mehrere lokalisierte Shop-Seiten, die jeweils auf ein bestimmtes Land ausgerichtet sind:

• shop-apotheke.com (Deutschland)
• shop-apotheke.at (Österreich)
• farmaline.be (Belgien)
• redcare.it (Italien)

ℹ️ Shop Apotheke unterstützt keine Multi-Channel-Konten innerhalb eines Vertrags. Wenn Sie in mehreren Ländern verkaufen möchten, müssen Sie für jeden Shop einen separaten Vertrag abschließen und die Einrichtungsprozesse durchführen.

Für wen ist Shop Apotheke geeignet? #

Shop Apotheke eignet sich am besten für Händler, die gesundheitsbezogene Produkte mit eindeutigen Identifikatoren und strukturierten Produktdaten verkaufen.

Zu den typischen Kategorien gehören:

• Gesundheits- und Wellnessprodukte,
• rezeptfreie Produkte und Nahrungsergänzungsmittel,
• Körperpflege- und Hygieneartikel,
• Medizinprodukte und Optikartikel,
• Gesundheitsprodukte für Babys, Haustiere und den Haushalt.

ℹ️ Für Arzneimittel und regulierte Artikel sind unter Umständen zusätzliche Genehmigungen und Unterlagen erforderlich. Der Zugang zu den einzelnen Kategorien sowie die Verkaufsberechtigungen werden von Shop Apotheke festgelegt.

Kosten für den Verkauf auf Shop Apotheke #

Der Verkauf auf Shop Apotheke umfasst:

• Monatliche Gebühr: 39,00 €
• Provision: variiert je nach Produktkategorie und geschäftlicher Vereinbarung
• Einrichtungsgebühr: keine

Die Provisionssätze werden bei der Erfassung der Händler vereinbart und hängen von der Kategoriestruktur des Marktplatzes ab.

Technische Voraussetzungen #

Stellen Sie vor Beginn der Einrichtung sicher, dass die folgenden Voraussetzungen erfüllt sind:

• Sie sind in den Ländern, in denen Sie verkaufen möchten, umsatzsteuerlich registriert.
• Ihre Produkte verfügen über gültige EAN- oder GTIN-Codes.
• Die Produktdaten sind vollständig und entsprechen den Inhaltsrichtlinien von Shop Apotheke.
• Die Versandbedingungen sind klar definiert.
• Sie sind für den Verkauf in den ausgewählten Kategorien zugelassen.

Produkte, die nicht den Standards des Marktplatzes entsprechen, können bei der Validierung abgelehnt werden.

Verkäuferkonto und Zugriff beantragen #

Bevor Sie Shop Apotheke mit M2E Mirakl Connect verbinden, müssen Sie direkt beim Marktplatz ein Verkäuferkonto beantragen.

Im Rahmen des Freigabeverfahrens kann Shop Apotheke Folgendes anfordern:

• Unternehmens- und Umsatzsteuerdaten,
• Informationen zu den Kategorien, in denen Sie verkaufen möchten,
• einen Beispiel-Produkt-Feed zur Überprüfung.

In einigen Fällen überprüft Shop Apotheke Ihren Katalog, bevor Ihr Shop eingerichtet wird. Dadurch wird sichergestellt, dass Ihre Produkte dem Kategoriebereich und den Compliance-Regeln entsprechen.

Die Genehmigung erfolgt durch Shop Apotheke. Die Bearbeitungszeiten können variieren.

Nach der Genehmigung erhalten Sie Zugang zum Mirakl Händler Admin-Portal. Dieser Zugang ist erforderlich, um fortzufahren. Sie benötigen Ihre Mirakl-Anmeldedaten und Ihren API-Schlüssel, um Shop Apotheke mit M2E Mirakl Connect zu verbinden.

In M2E Mirakl Connect #

Um Shop Apotheke über M2E zu verwalten, verbinden Sie Ihr Mirakl-Verkäuferkonto mithilfe eines API-Schlüssels. Diese Verbindung ermöglicht es M2E, Produkt-, Angebots- und Bestelldaten in Echtzeit mit dem Marktplatz auszutauschen.

Nach der Verbindung synchronisiert M2E:

• Produkte und Angebote
• Preise und Lagerbestände
• Bestellungen und Bestellstatus
• Sendungsverfolgungsdaten und Versandaktualisierungen

So verbinden Sie Shop Apotheke #

Sie können Shop Apotheke über M2E Mirakl Connect in Ihren Adobe Commerce (Magento)-Shop integrieren. Die Einrichtung folgt dem Standardablauf, der für alle Mirakl-basierten Marktplätze verwendet wird.

Einrichtungsschritte:

1. Installieren Sie die Erweiterung M2E Mirakl Connect und genehmigen Sie die erforderlichen Berechtigungen.
2. Melden Sie sich bei Ihrem M2E-Konto an oder erstellen Sie ein neues.
3. Fügen Sie Ihr Shop Apotheke-Marktplatzkonto mithilfe Ihrer Mirakl-API-URL und Ihres API-Schlüssels hinzu.
4. Verknüpfen Sie Magento-Produkte mit den entsprechenden Shop Apotheke-Auflistungen.
5. Aktivieren Sie die Synchronisierung des Lagerbestandes, um die Bestandsmengen korrekt zu halten.
6. Konfigurieren Sie den Bestellimport, damit Shop Apotheke-Bestellungen in Magento angezeigt und automatisch vom Lagerbestand abgezogen werden.

Sobald die Einrichtung abgeschlossen ist, bleiben Ihr Katalog, Ihr Lagerbestand und Ihre Bestellungen zwischen Magento und Shop Apotheke in sync.

✅ Ausführliche Anweisungen finden Sie im M2E Mirakl Connect-Benutzerhandbuch

Tägliche Verwaltung #

Sobald die Verbindung hergestellt ist, laufen die meisten Vorgänge automatisch ab.

Sie verwalten die Produkte in Magento. M2E übermittelt Änderungen am Lagerbestand und an den Preisen an Shop Apotheke. Bestellungen werden ohne manuelle Eingabe zurück an Magento synchronisiert.

Ihr Team bearbeitet Bestellungen über den Marktplatz genauso wie Bestellungen über die Website – ohne zusätzlichen Arbeitsaufwand.

Einrichtung der Produktsynchronisierung #

Sie haben zwei Optionen:

• Neue Auflistungen erstellen (in Kürze verfügbar). Verwenden Sie Magento-Daten, um Produkte auf Shop Apotheke zu veröffentlichen. M2E hält Preise und Mengen auf dem neuesten Stand.
• B Bestehende Auflistungen verknüpfen.B Wenn bereits Auflistungen vorhanden sind, verknüpfen Sie diese mit Magento-Produkten. Die Verlinkung ist erforderlich. Sie teilt M2E mit, welcher Magento-Artikel das jeweilige Angebot steuert. Danach bleiben Lagerbestände und Preise automatisch synchronisiert.

Produktverwaltung und Synchronisierungsrichtlinien #

In M2E Mirakl Connect erfolgt die Produktverwaltung bei Shop Apotheke über Richtlinien.

Eine Richtlinie fungiert als Regelwerk. Sie legt fest, wie Preisaktualisierungen, der Lagerbestand und die Bestelleinstellungen angewendet werden.

Dieser Ansatz vereinfacht die Katalogverwaltung. Anstatt Produkte einzeln zu konfigurieren, ordnen Sie einer Richtlinie mehrere Artikel zu. M2E verwaltet diese dann nach denselben Regeln.

Tägliche Anwendung von Richtlinien:

• Richtlinien steuern, wie Informationen aus Magento an Shop Apotheke übertragen werden, einschließlich Menge, Preis und Listungsstatus.
• Durch das Bearbeiten einer Richtlinie werden alle zugewiesenen Produkte sofort aktualisiert.
• Sie können mehrere Richtlinien erstellen, um unterschiedlichen Verkaufszielen oder Produktgruppen gerecht zu werden.
• Richtlinien werden im Bereich „Konfiguration“ oder direkt innerhalb der Auflistungen verwaltet.

Kategoriemanagement #

Korrekte Kategorien sind entscheidend für die Sichtbarkeit auf Shop Apotheke.

Mit M2E Mirakl Connect können Sie Kategorien effizient zuweisen und aktualisieren. Sie können die Kategorizierung jederzeit anpassen, um den Anforderungen des Marktplatzes gerecht zu werden. Eine korrekte Zuordnung reduziert Validierungsfehler und stellt sicher, dass Produkte in den richtigen Rubriken angezeigt werden.

Auftragsverwaltung #

Die Auftragsabwicklung erfolgt automatisch, sobald die Integration aktiv ist.

Bestellungen von Shop Apotheke werden ohne manuelle Eingabe in Magento importiert. Sie verwalten diese über Ihren regulären Shop-Workflow.

Die automatische Auftragserstellung kann in den Kontoeinstellungen aktiviert werden. Ist diese aktiviert, werden für jede neue Shop-Apotheke-Transaktion Magento-Aufträge generiert. Die manuelle Auftragserstellung bleibt bei Bedarf weiterhin verfügbar.

Diese Konfiguration sorgt für eine zentralisierte und übersichtliche Auftragsverwaltung.

Auf der Seite des Shop Apotheke-Marktplatzes #

Wenn Sie Produkte und Angebote aus M2E Mirakl Connect exportieren, führt Shop Apotheke die abschließende Validierung auf seiner Seite durch. Alle Prüfungen laufen innerhalb von Mirakl ab. Diese Regeln gehören zum Marktplatz und können in M2E nicht geändert werden.

Funktionen des Shop Apotheke-Marktplatzes #

Shop Apotheke unterstützt einen bestimmten Satz von Mirakl-Funktionen.

Unterstützt

• Produktinhalte
• Produktangebote
• Bestellungen
• Stornierungen durch den Händler
• Rücksendungen durch den Händler
• Zuordnung von Versanddienstleistern
• HTML-Formatierung
• Mehrere Lagerorte
• Bundles
• Rechnungs-Uploads
• Abrechnungen

Nicht unterstützt

• Automatische Verknüpfungen
• Produktvarianten (Größe oder Farbe)
• Generalüberholte Produkte
• Preisanpassung
• Stornierungen durch den Marktplatz
• Rücksendungen durch den Marktplatz
• Vom Marktplatz verwaltete Sendungen
• Fulfillment-Services des Marktplatzes
• Vertriebskanäle

ℹ️ Alle Länderseiten folgen derselben Grundstruktur. Die Anforderungen für die Einbindung können jedoch je nach Land variieren.

Anforderungen an Produkte und Angebote #

Um Produkte erfolgreich zu veröffentlichen, müssen Sie sowohl die Validierungsregeln von Shop Apotheke als auch die von Mirakl erfüllen. Pflichtfelder müssen vollständig und korrekt formatiert sein.

Obligatorische Produktdaten

• EAN oder GTIN. Dies ist die primäre Produktkennung. Fehlende oder ungültige Codes verhindern die Veröffentlichung.
• Produkttitel. Nur reiner Text mit einer maximalen Länge von 100 Zeichen. Bitte keine Mengenangaben oder HTML-Tags einfügen.
• Hauptbild. Ein weißer Hintergrund und ein quadratisches Format sind erforderlich. Akzeptierte Formate: JPG, PNG, WEBP. Mindestauflösung: 450 × 450 px, die empfohlene Auflösung beträgt jedoch 1000 × 1000 px. Maximale Dateigröße: 5 MB.
• Marke muss die offizielle Produktmarke widerspiegeln.
• Menge und Einheit. Die Einheit muss aus vordefinierten Werten wie g, ml oder l ausgewählt werden. Die Menge darf bis zu drei durch „x“ getrennte Werte enthalten.
• Kategoriespezifische Attribute. Die erforderlichen Attribute hängen von der ausgewählten Kategorie ab. Alle Pflichtfelder müssen korrekt zugeordnet werden.

Optionale Produktdaten

• Zusätzliche Bilder
• Kurz- und Langbeschreibungen
• Produktmerkmale und Gebrauchsanweisungen
• Varianten, gruppiert nach einem gemeinsamen Code
• Regulatorische Attribute wie PZN oder WEEE, sofern zutreffend

Optionale Felder werden weiterhin überprüft. Falsche Werte können den Export verhindern.

Angebot, Preisgestaltung und Mehrwertsteuerkonfiguration #

Die Preisgestaltung muss den Mirakl-Regeln entsprechen. Eine falsche Konfiguration verhindert die Veröffentlichung des Angebots.

• Mehrwertsteuer. Für jedes Produkt ist ein gültiger Mehrwertsteuersatz erforderlich.
• Währung. Es wird nur EUR akzeptiert.
• Rabatte und Sonderangebote. Shop Apotheke unterstützt die Mirakl-Rabattlogik.
  • Preisgestaltung v1 verwendet Rabattpreis, Rabattbeginn und Rabattende. Der Rabattpreis muss immer niedriger sein als der Grundpreis.
  • Preisgestaltung v2 verwendet den „Ausgangspreis“ als Originalpreis und den „Preis“ als Rabattwert. Preis und Ausgangspreis dürfen nicht identisch sein.
• Mengenrabatte erfordern eine Mindestmenge von 1 oder mehr.
• Das Datumsformat muss den Mirakl-Regeln entsprechen: JJJJ-MM-TT HH:MM:SS, in UTC.

Sollten die Preisdaten ungültig sein, werden die Angebote nicht veröffentlicht.

Versand, Sendungsverfolgung und Mirakl-Attribute #

Mirakl-Marktplätze erfordern je nach Kategorie und Logistikeinstellungen zusätzliche Attribute.

Häufige Beispiele hierfür sind:

• Lieferzeit ist die Anzahl der Tage zwischen der Bestellung und dem Versand.
• Logistikklasse bestimmt die Abwicklung der Lieferung. Zulässige Codes: klein, mittel, groß, extragroß.
• Sendungsverfolgungsanforderungen. Eine Sendungsverfolgungsnummer und eine Sendungsverfolgungs-URL sind für alle Sendungen obligatorisch. Die Zuordnung zu einem Spediteur ist optional, wird jedoch empfohlen.
• Öko- und EPR-Attribute gelten für Produkte, die Umweltvorschriften unterliegen. Dazu können Öko-Gebühren oder Hersteller-Registrierungs-IDs gehören.

Alle erforderlichen Attribute müssen korrekt zugeordnet sein, damit der Export erfolgreich durchgeführt werden kann.

FAQ #

Warum wird mein Produkt nicht aufgeführt? #

Die meisten Probleme bei der Auflistung sind auf Validierungsfehler zurückzuführen. Häufige Ursachen sind:

• Fehlende oder ungültige EAN
• Bild, das nicht den Formatvorgaben entspricht
• Nicht zugeordnete Pflichtattribute
• Fehlende Umsatzsteuer
• Falsche Preisgestaltung

Unterstützt Shop Apotheke Rabatte? #

Rabatte werden über die Mirakl-Preislogik unterstützt. Sowohl „Pricing v1“ als auch „Pricing v2“ sind verfügbar.

✅ Sollten Sie Hilfe bei der Konfiguration benötigen oder Probleme bei der Validierung haben, wenden Sie sich bitte an das M2E-Supportteam.