Integrace tržiště Shop Apotheke v M2E Cloud

Tento průvodce vás provede nastavením služby Shop Apotheke s M2E Cloud a každodenním provozem integrace.

Nejprve proveďte požadované kroky na straně Shop Apotheke a poté, jakmile je připojení aktivní, nakonfigurujte klíčová nastavení v M2E Cloud.

ℹ️ Shop Apotheke je tržiště založené na systému Mirakl. Většina níže popsaných pravidel platí i pro ostatní tržiště Mirakl podporovaná službou M2E Cloud.

Co se děje mimo M2E Cloud #

Shop Apotheke je evropská online lékárna a tržiště zaměřené na zdraví. Propojuje značky a obchodníky se zákazníky, kteří nakupují produkty pro zdravotní péči, wellness a každodenní zdraví online.

Shop Apotheke funguje prostřednictvím několika lokalizovaných prodejen. Každá prodejna se zaměřuje na určitou zemi:

• shop-apotheke.com (Německo)
• shop-apotheke.at (Rakousko)
• farmaline.be (Belgie)
• redcare.it (Itálie)

Obchod Apotheke je postaven na Mirakl. To znamená, že dodržuje standardy Mirakl pro ověřování a zpracování dat na trhu. Tato pravidla definuje tržiště, nikoli M2E Cloud.

To zahrnuje i způsob, jakým Shop Apotheke zpracovává:

• obsah produktu (názvy, obrázky, popisy, atributy).
• nabídky a ceny (ceny, DPH, slevy).
• objednávky a zásilky (import objednávek, potvrzení o odeslání, sledování).

ℹ️ Poznámka: Obchod Apotheke nepodporuje prodejní kanály. Pokud chcete prodávat ve více než jedné zemi, musíte podepsat samostatnou smlouvu a pro každou prodejnu dokončit onboarding.

Pro koho je Shop Apotheke vhodný #

Shop Apotheke je vhodný pro obchodníky prodávající produkty související se zdravím se stabilními identifikátory a jasnými údaji o produktech.

Mezi typické vhodné kategorie patří:

• Zdravotní a wellness produkty
• Volně prodejné produkty a doplňky stravy
• Osobní péče a hygiena
• Zdravotnické přístroje a optika
• Zdravotní produkty pro děti, domácí zvířata a domácnost

ℹ️ Farmaceutické a regulované výrobky mohou vyžadovat další schválení a dokumentaci. Přístup do kategorie a oprávnění k prodeji definuje společnost Shop Apotheke, nikoli M2E Cloud.

Žádost o účet prodejce Shop Apotheke #

Než si budete moci v M2E Cloud založit obchod Shop Apotheke, musíte požádat o účet prodejce přímo u společnosti Shop Apotheke.

Přihlašování můžete:

• Kontaktujte Shop Apotheke e-mailem a požádejte o onboarding

Společnost Shop Apotheke může během přijímání požádat o:

• Údaje o společnosti a informace o DPH
• Kategorie výrobků, které plánujete prodávat
• Ukázkový produktový feed k nahlédnutí

V některých případech Shop Apotheke přezkoumá váš produktový feed ještě před vytvořením obchodu. To jim pomáhá ověřit, zda váš katalog odpovídá jejich pravidlům a rozsahu kategorií.

Schválení účtu zajišťuje společnost Shop Apotheke. Časové lhůty se mohou lišit.

Jakmile je váš účet schválen, získáte přístup do administrace prodejců Mirakl. Tento přístup je nutný pro další pokračování, protože k připojení služby Shop Apotheke ke službě M2E Cloud potřebujete přihlašovací údaje Mirakl.

ℹ️ Obchod Apotheke nemá žádný poplatek za zřízení. Platíte fixní měsíční poplatek 39,00 € . Platíte také provizi, která závisí na kategorii produktů. Přesná sazba je dohodnuta s tržištěm při registraci prodejce.

Co se děje uvnitř M2E Cloud #

Jakmile je váš účet prodejce Shop Apotheke schválen, M2E Cloud se stane systémem pro správu vašich každodenních operací na trhu. Funguje jako řídicí vrstva mezi vaším obchodem a tržištěm Shop Apotheke.

S M2E Cloud spravujete Shop Apotheke z jednoho místa. Platforma se stará o výměnu, ověřování a synchronizaci dat, takže při rutinních úkonech nemusíte pracovat přímo v backendu Mirakl.

Pomocí M2E Cloud můžete:

• Připojení Shop Apotheke prostřednictvím rozhraní Mirakl API
• Export obsahu produktů z vašeho obchodu na tržiště
• Mapování kategorií a požadovaných atributů
• Správa cen, DPH a slev
• Synchronizovat objednávky, stavy zásob a zásilky

Všechny aktualizace se řídí předdefinovanými pravidly a probíhají automaticky. To snižuje množství ruční práce a udržuje váš obchod a tržiště v synchronizaci.

Požadavky před zahájením #

Před připojením služby Shop Apotheke ke službě M2E Cloud se ujistěte, že jsou splněny všechny níže uvedené požadavky. Chybějící některý z nich zablokuje export nebo zastaví synchronizaci.

Musíte mít:

• Schválený účet prodejce Shop Apotheke
• Platné přihlašovací údaje Mirakl API
• Registrace k DPH
• Ceny produktů jsou k dispozici v EUR
• Platné kódy EAN nebo GTIN pro všechny produkty

Platí také jazykové požadavky. Obsah produktu musí být uveden v němčině nebo italštině, v závislosti na prodejní ploše, na které prodáváte.

Ve specifických případech mohou platit další požadavky:

• Elektrické a elektronické výrobky vyžadují údaje WEEE nebo EPR
• Regulované výrobky a výrobky související s léky mohou vyžadovat další identifikační údaje a schválení.

Připojení Shop Apotheke k M2E Cloud #

Shop Apotheke je tržiště založené na systému Mirakl. K M2E Cloud jej připojíte pomocí Mirakl Connect Single Sign-On.

Pro zahájení připojení potřebujete přístup k správci prodejce Mirakl a platný klíč API.

Kroky připojení:

1. Přihlaste se do administrace prodejce Mirakl.
2. Vygenerujte nebo zkopírujte svůj klíč API.
3. V M2E Cloud otevřete část Připojit účet Mirakl.
4. Vložte klíč API.
5. V rozevíracím seznamu tržišť Mirakl vyberte položku Shop Apotheke.
6. Pokud spravujete více obchodů, zadejte ID obchodu.
7. Potvrďte připojení.

Po odeslání M2E Cloud automaticky ověří pověření. Po úspěšném ověření lze synchronizovat údaje o produktech, nabídkách, objednávkách a zásilkách.

ℹ️ Úplné pokyny pro nastavení M2E Mirakl naleznete v této příručce.

Mezi běžné problémy s připojením patří:

• Použití nesprávného nebo zastaralého klíče API
• Chybějící oprávnění API v systému Mirakl
• Pokus o připojení před úplným schválením účtu Shop Apotheke

ℹ️ Pokud si klíč API v systému Mirakl přegenerujete později, musíte jej aktualizovat v M2E Cloud. Jinak se synchronizace zastaví.

Po připojení: Co se děje dál? #

Po aktivaci připojení nastavíte, jak se bude Shop Apotheke chovat v M2E Cloud. Tato část se zabývá hlavními provozními kroky, které provádíte při přípravě nabídek a správě probíhající synchronizace.

1. Seznam nových produktů v obchodě Shop Apotheke #

Vyberte produkty, které chcete prodávat, a exportujte je do služby Shop Apotheke jako nové nabídky na tržiště.

Během exportu může M2E Cloud odesílat:

• Obsah produktu, jako jsou názvy, obrázky a atributy.
• Nabídky produktů, jako je cena, DPH a dostupnost.

Toto chování je řízeno atributem Strategie exportu. Na vysoké úrovni určuje, zda M2E Cloud exportuje celý obsah produktu, nebo pouze data nabídky.

✅ Pravidla M2E Cloud slouží k řízení synchronizace dat.

2. Propojení stávajících seznamů nabídek na trhu s produkty v obchodě #

Pokud vaše produkty již existují na Shop Apotheke a používají stejné SKU jako váš obchod, M2E Cloud je může automaticky propojit.

Pokud se SKU neshodují, můžete propojit nabídky ručně pomocí souboru CSV. Pro synchronizaci je propojení nutné. Informuje M2E Cloud, který obchod řídí ceny, skladové zásoby a zpracování objednávek pro každou nabídku na trhu.

3. Mapování kategorií a požadovaných atributů #

Mapování kategorií je povinné. Každý produkt musí být přiřazen ke kategorii Shop Apotheke, než může být exportován.

Tento krok zahrnuje:

• Výběr správné kategorie Shop Apotheke
• Výběr atributů obsahu, jako jsou popisy a charakteristiky produktů
• Mapování atributů, například polí souvisejících s DPH a cenami

Po namapování používá M2E Cloud tato mapování k synchronizaci dat podle aktivních pravidel.

✅ Informace o tom, jak se data přesouvají mezi systémy, naleznete v příručce Pravidla synchronizace.

4. Konfigurace cenových a měnových pravidel #

Všechny ceny odesílané do služby Shop Apotheke musí být v EUR. DPH je povinná a musí být definována pro každý produkt.

Cenové chování je řízeno prostřednictvím pravidel prodeje v M2E Cloud. Tyto pravidla řídí, jak se uplatňují základní ceny, slevy a pravidla pro množství.

Můžete vytvořit více pravidel prodeje pro různé skupiny produktů, cenová pravidla nebo trhy.

5. Konfigurace nastavení objednávek a mapování stavu #

Pravidla prodeje objednávek definují, jak se s objednávkami Shop Apotheke zachází v rámci M2E Cloud a vašeho obchodu.

To zahrnuje:

• Při importu objednávek
• Jak Shop Apotheke mapuje stavy objednávek na stavy skladu
• Jak se potvrzení o odeslání zásilky odesílají zpět na tržiště

Správné mapování zabraňuje konfliktům stavů a udržuje konzistentní data objednávek.

6. Nastavení pravidel přepravy, doručování a zpracování faktur #

Chování při přepravě je řízeno prostřednictvím pravidel přepravy.

V případě služby Shop Apotheke musíte u všech zásilek zadat sledovací kód a sledovací adresu URL. Mapování dopravce je volitelné, ale doporučuje se, protože zlepšuje viditelnost sledování na trhu.

Zde se nastavuje:

• Dostupní dopravci a způsoby přepravy
• Způsob potvrzování zásilek
• Jak se synchronizují čísla pro sledování zásilek

7. Sledování nabídek a řešení problémů #

Po nastavení můžete sledovat chování nabídek přímo v M2E Cloud.

Na stránce Seznam nabídek můžete :

• Kontrola stavu exportu a validace
• Kontrola zpětné vazby a chyb na trhu
• Oprava problémů s mapováním, cenami nebo obsahem bez vypnutí kanálu.

To vám umožní udržovat aktivní nabídky a rychle řešit problémy.

💡 Podívejte se do dokumentace M2E a zjistěte, jak funguje správa nabídek a objednávek.

Co se děje v zadní části tržiště? #

Po exportu produktů a nabídek z M2E Cloud probíhá veškerá finální validace a zpracování na straně Shop Apotheke. Tato pravidla jsou vynucována tržištěm prostřednictvím Mirakl a nelze je měnit v M2E Cloud.

Pochopení těchto omezení pomáhá vyhnout se tichému odmítnutí a zpožděným nabídkám.

Funkce tržiště Shop Apotheke #

Shop Apotheke podporuje definovanou sadu funkcí tržiště Mirakl.

Podporované stránky

• Obsah produktu
• Nabídky produktů
• Objednávky
• Zrušení obchodníka
• Vrácení zboží obchodníkem
• Mapování dopravců
• Formátování HTML
• Více skladových míst
• Balíčky
• Nahrávání faktur
• Zúčtování

Není podporováno

• Automatické vztahy
• Varianty produktu (velikost nebo barva)
• Repasované produkty
• Přecenění
• Zrušení prodeje na trhu
• Vrácení zboží na tržiště
• Zásilky
• Služby plnění na tržištích
• Prodejní kanály

ℹ️ Každá pobočka v dané zemi se řídí stejným základním souborem funkcí, ale pravidla pro vstup na trh se mohou lišit.

Požadavky na produkt a nabídku #

Pro úspěšné zařazení produktů do seznamu musí všechna povinná pole splňovat pravidla validace Shop Apotheke a Mirakl.

Obsah produktu (povinné)

Každý výrobek musí obsahovat následující údaje:

• EAN nebo GTIN . Používá se jako hlavní identifikátor výrobku. Neplatný nebo chybějící seznam bloků kódů.
• Název výrobku
  • Pouze prostý text
  • Maximální délka: 100 znaků
  • Množství a značky HTML nejsou povoleny.
• Hlavní obrázek
  • Bílé pozadí
  • Čtvercový formát
  • Podporované formáty: JPG, PNG, WEBP
  • Minimální rozlišení: 450 × 450 px. Doporučené rozlišení: 1000 × 1000 px
  • Maximální velikost souboru: 5 MB.
• Značka. Musí odpovídat skutečné značce výrobku.
• Množství a jednotka
  • Jednotka musí být vybrána z pevných hodnot, jako jsou g, ml nebo l.
  • Množství podporuje až tři hodnoty oddělené znakem „x“.
• Atributy specifické pro danou kategorii. Povinná pole závisí na vybrané kategorii a musí být správně namapována.

Obsah produktu (nepovinné)

Kvalitu nabídky můžete zlepšit poskytnutím dalších údajů:

• Další obrázky
• Dlouhé a krátké popisy
• Vlastnosti výrobku a návod k použití
• Varianty s použitím skupinového kódu
• případně regulační pole, jako je PZN nebo WEEE

Nepovinná pole se stále ověřují. Nesprávné hodnoty mohou zablokovat export.

Pravidla pro nabídku, ceny a DPH #

Cenové a daňové chování se řídí pravidly Mirakl a musí být správně nakonfigurováno.

• DPH je povinná. U každého výrobku musí být uvedena platná sazba DPH.
• Měna. Obchod Apotheke přijímá pouze EUR.

Slevy a propagační akce

Obchod Apotheke podporuje slevovou logiku Mirakl.

• Cenotvorba v1 používá slevovou cenu, datum zahájení slevy a datum ukončení slevy. Slevová cena musí být nižší než základní cena.
• Cenotvorba v2 používá jako běžnou cenu Strike price a jako hodnotu slevy Price. Cena a Strike cena nemohou být stejné.
• Hromadné slevy vyžadují množstevní práh vyšší než 1.
• Formátování data musí odpovídat formátu Mirakl: RRRR-MM-DD HH:MM:SS, v UTC.

Nesprávná konfigurace cen brání zveřejnění nabídek.

Doprava, sledování a atributy specifické pro Mirakl #

Tržiště Mirakl se spoléhají na mnoho dalších atributů. Je třeba namapovat ty, které jsou pro vaši kategorii vyžadovány.

Mezi typické příklady patří:

• Doba dodání. Určuje, kolik dní uplyne do odeslání.
• Logistická třída. Řídí manipulaci s dodávkami. Platné kódy tržišť jsou: klein , mittel, groß, extragroß.
• Požadavky na sledování. U všech zásilek je vyžadován sledovací kód a sledovací URL. Mapování dopravce je nepovinné, ale doporučuje se.
• Ekologické a EPR atributy. Volitelné atributy se vztahují na produkty, které podléhají ekologickým předpisům. Patří mezi ně ekologické příspěvky a registrační ID výrobce.

FAQ #

Proč není můj produkt uveden v nabídce? #

Většina problémů s nabídkou je způsobena chybami při ověřování na trhu. Mezi nejčastější příčiny patří chybějící EAN, neplatné obrázky, nepřipojené povinné atributy, chybějící DPH nebo nesprávné ceny.

Kde mohu vidět chyby validace na straně tržiště? #

Pokud se v M2E Cloud nezobrazují žádné chyby, zkontrolujte back end Mirakl.

Přejděte do Katalog → Import produktů a stáhněte si zprávu Neintegrované produkty, kde najdete podrobnou zpětnou vazbu.

Podporuje Shop Apotheke slevy a akce? #

Slevy jsou podporovány prostřednictvím cenových pravidel Mirakl. Podporovány jsou jak ceny v1, tak ceny v2.

Jsou u objednávek Shop Apotheke vyžadovány faktury? #

Požadavky na faktury závisí na vaší konfiguraci. V některých případech jsou faktury pro obchodníky nepovinné. V jiných musí být faktura přiložena před potvrzením odeslání.

✅ Pokud potřebujete pomoci s nastavením nebo narazíte na problémy s validací, obraťte se na tým podpory M2E Cloud.