Shop Apotheke Marketplace-integratie in M2E Cloud

Deze handleiding helpt u bij het instellen van Shop Apotheke met M2E Cloud en het dagelijks uitvoeren van de integratie.

Voer eerst de vereiste stappen uit aan de kant van Shop Apotheke en configureer vervolgens de belangrijkste instellingen in M2E Cloud zodra de verbinding actief is.

ℹ️ Shop Apotheke is een op Mirakl gebaseerde marktplaats. De meeste hieronder beschreven regels zijn ook van toepassing op andere Mirakl-marktplaatsen die door M2E Cloud worden ondersteund.

Wat gebeurt er buiten M2E Cloud #

Shop Apotheke is een Europese online apotheek en een op gezondheid gerichte marktplaats. Het verbindt merken en verkopers met klanten die online gezondheids-, wellness- en alledaagse gezondheidsproducten kopen.

Shop Apotheke opereert via verschillende gelokaliseerde winkelpuien. Elke winkelpui richt zich op een specifiek land:

• shop-apotheke.com (Duitsland)
• shop-apotheke.at (Oostenrijk)
• farmaline.be (België)
• redcare.it (Italië)

Shop Apotheke is gebouwd op Mirakl. Dat betekent dat het voldoet aan de Mirakl-normen voor het valideren en verwerken van marktplaatsgegevens. Deze regels worden bepaald door de marktplaats, niet door M2E Cloud.

Dit omvat hoe Shop Apotheke omgaat met:

• productinhoud (titels, afbeeldingen, beschrijvingen, kenmerken)
• aanbiedingen en prijzen (prijzen, VAT, kortingen)
• bestellingen en verzendingen (import van bestellingen, verzendbevestiging, tracking)

ℹ️ Opmerking: Shop Apotheke ondersteunt geen verkoopkanalen. Als u in meer dan één land wilt verkopen, moet u voor elke winkel een afzonderlijk contract ondertekenen en het onboardingproces doorlopen.

Voor wie is Shop Apotheke geschikt? #

Shop Apotheke is geschikt voor verkopers van gezondheidsgerelateerde producten met stabiele identificatiegegevens en duidelijke productgegevens.

Typische geschikte categorieën zijn onder meer:

• Gezondheids- en welzijnsproducten
• OTC-producten en supplementen
• Persoonlijke verzorging en hygiëne
• Medische hulpmiddelen en optica
• Gezondheidsgerelateerde producten voor baby's, huisdieren en huishoudens

ℹ️ Voor farmaceutische en gereguleerde producten kunnen extra goedkeuringen en documentatie vereist zijn. Toegang tot categorieën en verkoopvergunningen worden bepaald door Shop Apotheke, niet door M2E Cloud.

Een Shop Apotheke-verkopersaccount aanvragen #

Voordat u Shop Apotheke in M2E Cloud kunt instellen, moet u rechtstreeks bij Shop Apotheke een verkopersaccount aanvragen.

Er is één manier om het aanpassingsproces te starten:

• Neem per e-mail contact op met Shop Apotheke en vraag om onboarding

Tijdens het onboardingproces kan Shop Apotheke vragen om:

• Bedrijfsgegevens en informatie over de VAT
• Productcategorieën die u van plan bent te verkopen
• Een voorbeeldproductfeed ter beoordeling

In sommige gevallen controleert Shop Apotheke uw productfeed voordat uw winkel wordt aangemaakt. Zo kunnen zij controleren of uw catalogus voldoet aan hun regels en categorieën.

De goedkeuring van uw account wordt afgehandeld door Shop Apotheke. De doorlooptijd kan variëren.

Zodra uw account is goedgekeurd, krijgt u toegang tot de Mirakl Seller Admin. Deze toegang is nodig om verder te kunnen gaan, omdat u Mirakl-inloggegevens nodig hebt om Shop Apotheke te koppelen aan M2E Cloud.

ℹ️ Shop Apotheke rekent geen opstartkosten. Je betaalt een vast maandelijks bedrag van € 39,00. Daarnaast betaal je een commissie die afhankelijk is van je productcategorie. Het exacte tarief wordt bij de registratie als verkoper met de marktplaats overeengekomen.

Wat gebeurt er binnen M2E Cloud #

Zodra uw Shop Apotheke-verkopersaccount is goedgekeurd, wordt M2E Cloud het systeem voor het beheer van uw dagelijkse marktplaatsactiviteiten. Het fungeert als de controlelaag tussen uw winkel en de Shop Apotheke-marktplaats.

Met M2E Cloud beheert u Shop Apotheke vanaf één plek. Het platform zorgt voor de gegevensuitwisseling, validatie en synchronisatie, zodat u voor routinetaken niet rechtstreeks in de Mirakl-backend hoeft te werken.

Met M2E Cloud kunt u:

• Verbind Shop Apotheke via de Mirakl API
• Exporteer productinhoud van uw winkel naar de marktplaats
• Koppel categorieën en vereiste attributen
• Beheer prijzen, VAT en kortingen
• Synchroniseer bestellingen, voorraadniveaus en verzendingen

Alle updates volgen vooraf gedefinieerde regels en worden automatisch uitgevoerd. Dit vermindert handmatig werk en houdt uw winkel en de marktplaats synchroon.

Vereisten voordat u begint #

Voordat u Shop Apotheke verbindt met M2E Cloud, moet u ervoor zorgen dat aan alle onderstaande vereisten is voldaan. Als een van deze vereisten ontbreekt, wordt de export geblokkeerd of wordt de synchronisatie stopgezet.

ℹ️ Zorg ervoor dat uw winkel draait op een ondersteund platform, zoals Shopify, BigCommerce, PrestaShop, enz. Alle M2E-apps zijn beschikbaar in de officiële app-overzichten. Voor de integratie van Hygi.de met Shopify door M2E moet u bijvoorbeeld eerst de Shopify-app installeren.

U moet beschikken over:

• Een goedgekeurd Shop Apotheke-verkopersaccount
• Geldige Mirakl API-inloggegevens
• VAT-registratie
• Productprijzen beschikbaar in EUR
• Geldige EAN- of GTIN-codes voor alle producten

Er gelden ook taalvereisten. Productinhoud moet in het Duits of Italiaans worden verstrekt, afhankelijk van de winkel waar u verkoopt.

In specifieke gevallen kunnen aanvullende vereisten van toepassing zijn:

• Elektrische en elektronische producten vereisen WEEE- of EPR-gegevens
• Gereguleerde en apotheekgerelateerde producten kunnen aanvullende identificatiegegevens en goedkeuringen vereisen

Shop Apotheke koppelen aan M2E Cloud #

Shop Apotheke is een op Mirakl gebaseerde marktplaats die via een API verbinding maakt met M2E Cloud.

Om de koppeling tot stand te brengen, heb je toegang nodig tot je Mirakl Seller Admin en een geldige API-sleutel.

Stappen voor het koppelen:

1. Open in M2E Cloud Mirakl-account koppelen.
2. Kies in het gedeelte Marktplaats selecteren de optie Shop Apotheke (gebruik het veld Marktplaatsen zoeken om deze snel te vinden).
3. Log in op je Mirakl Seller Admin en genereer of kopieer je API-sleutel.
4. Ga terug naar M2E Cloud en plak de sleutel in het veld API-sleutel.
5. Voer je Shop-ID in als je meerdere winkels beheert.
6. Klik op Connect.

Na het verzenden controleert M2E Cloud automatisch de inloggegevens. Zodra de validatie is geslaagd, kunnen productgegevens, aanbiedingen, bestellingen en verzendingen worden gesynchroniseerd.

ℹ️ Bekijk de volledige instructies voor het instellen van M2E Mirakl in deze handleiding.

Veelvoorkomende verbindingsproblemen zijn onder andere:

• Het gebruik van een onjuiste of verouderde API-sleutel
• Ontbrekende API-machtigingen in Mirakl
• Proberen verbinding te maken voordat het Shop Apotheke-account volledig is goedgekeurd

ℹ️ Als u uw API-sleutel later in Mirakl opnieuw genereert, moet u deze in M2E Cloud bijwerken. Anders wordt de synchronisatie stopgezet.

Eenmaal verbonden: wat gebeurt er vervolgens? #

Nadat de verbinding actief is, configureert u hoe Shop Apotheke zich binnen M2E Cloud gedraagt. In dit gedeelte worden de belangrijkste operationele stappen beschreven die u uitvoert om aanbiedingen voor te bereiden en de voortdurende synchronisatie te beheren.

1. Nieuwe producten aanbieden op Shop Apotheke #

Selecteer de producten die u wilt verkopen en exporteer ze naar Shop Apotheke als nieuwe Productvermeldingen op de marktplaats.

Tijdens het exporteren kan M2E Cloud het volgende verzenden:

• Productinhoud, zoals titels, afbeeldingen en kenmerken
• Productaanbiedingen, zoals prijs, VAT en beschikbaarheid

Dit gedrag wordt bepaald door het kenmerk Exportstrategie. Op hoog niveau bepaalt dit of M2E Cloud de volledige productinhoud exporteert of alleen gegevens aanbiedt.

✅ Gebruik M2E Cloud Policies om te bepalen welke gegevens worden gesynchroniseerd.

2. Koppel bestaande productvermeldingen op de marktplaats aan winkelproducten #

Als uw producten al op Shop Apotheke staan en dezelfde SKU's gebruiken als uw winkel, kan M2E Cloud ze automatisch koppelen.

Als SKU's niet overeenkomen, kunt u vermeldingen handmatig koppelen met behulp van een CSV-bestand. Koppelen is vereist voor synchronisatie. Het vertelt M2E Cloud welke winkel de prijs, voorraad en orderverwerking voor elke productvermelding controleert.

3. Kaartcategorieën en vereiste attributen #

Het toewijzen van categorieën is verplicht. Elk product moet aan een Shop Apotheke-categorie worden toegewezen voordat het kan worden geëxporteerd.

Deze stap omvat:

• De juiste Shop Apotheke-categorie kiezen
• Contentattributen kiezen, zoals productbeschrijvingen en kenmerken
• Attributen toewijzen, zoals VAT- en prijsgerelateerde velden

Zodra de toewijzingen zijn gemaakt, gebruikt M2E Cloud deze toewijzingen om gegevens te synchroniseren volgens het actieve beleid.

✅ Raadpleeg de gids Synchronisatiebeleid voor meer informatie over hoe gegevens tussen systemen worden uitgewisseld.

4. Configureer prijs- en valutaregels #

Alle prijzen die naar Shop Apotheke worden gestuurd, moeten in euro's zijn. VAT is verplicht en moet per product worden gedefinieerd.

Het prijsbeleid wordt beheerd via verkoopbeleid in M2E Cloud. Dit beleid bepaalt hoe basisprijzen, kortingen en hoeveelheidsregels worden toegepast.

U kunt meerdere verkoopbeleidsregels opstellen voor verschillende productgroepen, prijsregels of markten.

5. Configureer de bestelinstellingen en statusmapping #

Bestelbeleidsregels bepalen hoe Shop Apotheke-bestellingen worden verwerkt in M2E Cloud en uw winkel.

Dit omvat:

• Wanneer bestellingen worden geïmporteerd
• Hoe Shop Apotheke bestelstatussen koppelt aan winkelstatussen
• Hoe verzendbevestigingen worden teruggestuurd naar de marktplaats

Correcte mapping voorkomt statusconflicten en houdt ordergegevens consistent.

6. Verzendregels, levering en factuurverwerking instellen #

Het verzendgedrag wordt geregeld via verzendbeleid.

Voor Shop Apotheke moet u voor alle zendingen een trackingcode en tracking-URL opgeven. Carrier mapping is optioneel, maar wordt aanbevolen, omdat het de zichtbaarheid van tracking op de marktplaats verbetert.

Hier stelt u het volgende in:

• Beschikbare vervoerders en verzendmethoden
• Hoe zendingen worden bevestigd
• Hoe trackingnummers worden gesynchroniseerd

7. Monitor aanbiedingen en los problemen op #

Na de installatie kunt u het gedrag van aanbiedingen rechtstreeks in M2E Cloud monitoren.

Via de pagina Aanbiedingen kunt u:

• Controleer de export- en validatiestatus
• Bekijk feedback en fouten van de marktplaats
• Los problemen met mapping, prijzen of inhoud op zonder het kanaal uit te schakelen

Hierdoor kunt u actieve advertenties onderhouden en problemen snel oplossen.

💡 Raadpleeg de M2E-documentatie voor meer informatie over het werken met aanbiedingen en orderbeheer.

Wat gebeurt er in de back-end van de marktplaats? #

Nadat producten en aanbiedingen zijn geëxporteerd vanuit M2E Cloud, vinden alle definitieve validaties en verwerkingen plaats aan de kant van Shop Apotheke. Deze regels worden door de marktplaats via Mirakl afgedwongen en kunnen niet worden gewijzigd in M2E Cloud.

Als u deze beperkingen begrijpt, kunt u stille afwijzingen en vertraagde productvermeldingen voorkomen.

Functies van de Shop Apotheke-marktplaats #

Shop Apotheke ondersteunt een gedefinieerde set Mirakl-marktplaatsfuncties.

Ondersteund

• Productinhoud
• Productaanbiedingen
• Bestellingen
• Annuleringen door verkopers
• Retourzendingen door verkopers
• Koppeling met vervoerders
• HTML-opmaak
• Meerdere voorraadlocaties
• Bundels
• Uploaden van facturen
• Afwikkelingen

Niet ondersteund

• Automatische relaties
• Productvarianten (maat of kleur)
• Refurbished producten
• Herprijzing
• Annuleringen op de marktplaats
• Retourzendingen op de marktplaats
• Zendingen
• Marktplaatsafhandelingsdiensten
• Verkoopkanalen

ℹ️ Elke landwinkel heeft dezelfde kernfuncties, maar de regels voor het aanmelden kunnen verschillen.

Product- en aanbiedingsvereisten #

Om producten succesvol te kunnen aanbieden, moeten alle verplichte velden voldoen aan de validatieregels van Shop Apotheke en Mirakl.

Productinhoud (verplicht)

Elk product moet de volgende gegevens bevatten:

• EAN of GTIN. Wordt gebruikt als de belangrijkste productidentificatie. Ongeldige of ontbrekende codes blokkeren de productvermelding.
• Producttitel
  • Alleen platte tekst
  • Maximale lengte: 100 tekens
  • Hoeveelheden en HTML-tags zijn niet toegestaan.
• Hoofdafbeelding
  • Witte achtergrond
  • Vierkant formaat
  • Ondersteunde formaten: JPG, PNG, WEBP
  • Minimale resolutie: 450 × 450 px. Aanbevolen resolutie: 1000 × 1000 px
  • Maximale bestandsgrootte: 5 MB.
• Merk. Moet overeenkomen met het daadwerkelijke productmerk.
• Hoeveelheid en eenheid
  • De eenheid moet worden geselecteerd uit vaste waarden zoals g, ml of l
  • De hoeveelheid ondersteunt maximaal drie waarden, gescheiden door een “x”.
• Categorie-specifieke kenmerken. Verplichte velden zijn afhankelijk van de geselecteerde categorie en moeten correct worden toegewezen.

Productinhoud (optioneel)

U kunt de kwaliteit van uw productvermelding verbeteren door aanvullende gegevens te verstrekken:

• Extra afbeeldingen
• Lange en korte beschrijvingen
• Productkenmerken en gebruiksaanwijzingen
• Variaties met behulp van een groepcode
• Regelgevingsvelden zoals PZN of WEEE, indien van toepassing

Optionele velden worden nog steeds gevalideerd. Onjuiste waarden kunnen exporten blokkeren.

Aanbiedingen, prijzen en VAT-regels #

Prijzen en belastinggedrag volgen de regels van Mirakl en moeten correct worden geconfigureerd.

• VAT is verplicht. Elk product moet een geldig VAT-tarief bevatten.
• Valuta. Shop Apotheke accepteert alleen EUR.

Kortingen en promoties

Shop Apotheke ondersteunt de kortingslogica van Mirakl.

• Prijsbepaling v1 maakt gebruik van kortingsprijs, startdatum korting en einddatum korting. De kortingsprijs moet lager zijn dan de basisprijs.
• Prijsbepaling v2 maakt gebruik van de uitoefenprijs als normale prijs en de prijs als kortingswaarde. De prijs en de uitoefenprijs mogen niet hetzelfde zijn.
• Voor bulkkortingen geldt een minimumhoeveelheid van meer dan 1.
• De datumnotatie moet voldoen aan de Mirakl-notatie: JJJJ-MM-DD UU:MM:SS, in UTC.

Onjuiste prijsconfiguratie verhindert dat aanbiedingen worden gepubliceerd.

Verzending, tracking en Mirakl-specifieke kenmerken #

Mirakl-marktplaatsen zijn afhankelijk van vele andere kenmerken. U moet de vereiste kenmerken voor uw categorie in kaart brengen.

Typische voorbeelden zijn:

• Doorlooptijd tot verzending. Bepaalt hoeveel dagen er verstrijken voordat de verzending plaatsvindt.
• Logistieke klasse. Regelt de afhandeling van de levering. Geldige marktplaatscodes zijn: klein, mittel, groß, extragroß.
• Trackingvereisten. Voor alle zendingen zijn een trackingcode en een tracking-URL vereist. Het toewijzen van vervoerders is optioneel, maar wordt aanbevolen.
• Eco- en EPR-attributen. Optionele attributen zijn van toepassing op producten die onderworpen zijn aan milieuregelgeving. Deze omvatten eco-bijdragen en registratie-ID's van producenten.

FAQ #

Waarom staat mijn product niet in de lijst? #

De meeste problemen met productvermeldingen worden veroorzaakt door validatiefouten van de marktplaats. Veelvoorkomende redenen zijn ontbrekende EAN's, ongeldige afbeeldingen, niet-toegewezen vereiste kenmerken, ontbrekende VAT of onjuiste prijzen.

Waar kan ik validatiefouten van de marktplaats zien? #

Als er geen fouten worden weergegeven in M2E Cloud, controleer dan de Mirakl-backend.

Ga naar Catalogus → Productimporten en download het rapport Niet-geïntegreerde producten voor gedetailleerde feedback.

Ondersteunt Shop Apotheke kortingen en promoties? #

Kortingen worden ondersteund via Mirakl-prijsregels. Zowel Pricing v1 als Pricing v2 worden ondersteund.

Zijn facturen vereist voor bestellingen bij Shop Apotheke? #

De factuurvereisten zijn afhankelijk van uw configuratie. In sommige gevallen zijn facturen van verkopers optioneel. In andere gevallen moet een factuur worden bijgevoegd voordat de verzending wordt bevestigd.

✅ Als u hulp nodig hebt bij het instellen of problemen ondervindt met de validatie, neem dan contact op met het M2E Cloud-ondersteuningsteam.