Integracja Shop Apotheke Marketplace w M2E Cloud

Ten przewodnik przeprowadzi Cię przez konfigurację Shop Apotheke z M2E Cloud i codzienne uruchamianie integracji.

Najpierw wykonaj wymagane kroki po stronie Shop Apotheke, a następnie skonfiguruj kluczowe ustawienia w M2E Cloud, gdy połączenie będzie aktywne.

ℹ️ Shop Apotheke to marketplace oparty na Mirakl. Większość zasad opisanych poniżej dotyczy również innych marketplace'ów Mirakl obsługiwanych przez M2E Cloud.

Co dzieje się poza M2E Cloud? #

Shop Apotheke to europejska apteka internetowa i marketplace skoncentrowany na zdrowiu. Łączy marki i sprzedawców z klientami, którzy kupują produkty zdrowotne, wellness i codzienne produkty zdrowotne online.

Shop Apotheke działa za pośrednictwem kilku zlokalizowanych witryn sklepowych. Każda witryna sklepowa jest skierowana do określonego kraju:

• shop-apotheke.com (Niemcy)
• shop-apotheke.at (Austria)
• farmaline.be (Belgia)
• redcare.it (Włochy)

Shop Apotheke jest oparty na Mirakl. Oznacza to, że przestrzega standardów Mirakl dotyczących walidacji i przetwarzania danych marketplace. Zasady te są definiowane przez marketplace, a nie przez M2E Cloud.

Obejmuje to sposób obsługi Shop Apotheke:

• zawartość produktu (tytuły, obrazy, opisy, atrybuty)
• oferty i ceny (ceny, VAT, rabaty)
• zamówienia i wysyłki (import zamówień, potwierdzenie wysyłki, śledzenie)

ℹ️ Uwaga: Shop Apotheke nie obsługuje kanałów sprzedaży. Jeśli chcesz sprzedawać w więcej niż jednym kraju, musisz podpisać oddzielną umowę i ukończyć wdrożenie dla każdej witryny sklepu.

Dla kogo Shop Apotheke jest dobrym wyborem #

Shop Apotheke jest dobrym rozwiązaniem dla sprzedawców sprzedających produkty związane ze zdrowiem ze stabilnymi identyfikatorami i przejrzystymi danymi produktu.

Typowe dobrze dopasowane kategorie obejmują:

• Produkty dla zdrowia i dobrego samopoczucia
• Produkty OTC i suplementy
• Higiena i higiena osobista
• Urządzenia medyczne i optyka
• Produkty dla niemowląt, zwierząt domowych i gospodarstwa domowego

ℹ️ Produkty farmaceutyczne i regulowane mogą wymagać dodatkowych zatwierdzeń i dokumentacji. Dostęp do kategorii i uprawnienia do sprzedaży są definiowane przez Shop Apotheke, a nie przez M2E Cloud.

Żądanie utworzenia konta sprzedawcy Shop Apotheke #

Zanim będziesz mógł skonfigurować Shop Apotheke w M2E Cloud, musisz złożyć wniosek o konto sprzedawcy bezpośrednio w Shop Apotheke.

Onboarding można rozpocząć:

• Skontaktuj się z Shop Apotheke przez e-mail i poproś o wdrożenie

Podczas wdrażania Shop Apotheke może poprosić o:

• Dane firmy i informacje o podatku VAT
• Kategorie produktów, które planujesz sprzedawać
• Przykładowy plik produktowy do wglądu

W niektórych przypadkach Shop Apotheke sprawdza plik produktowy przed utworzeniem sklepu. Pomaga im to zweryfikować, czy Twój Katalog jest zgodny z ich zasadami i zakresem kategorii.

Zatwierdzenie konta jest obsługiwane przez Shop Apotheke. Terminy mogą się różnić.

Po zatwierdzeniu konta otrzymasz dostęp do panelu administracyjnego sprzedawcy Mirakl. Ten dostęp jest wymagany, aby kontynuować, ponieważ potrzebujesz poświadczeń Mirakl, aby połączyć Shop Apotheke z M2E Cloud.

ℹ️ Shop Apotheke nie ma opłaty instalacyjnej. Płacisz stałą miesięczną opłatę w wysokości 39,00 €. Płacisz również prowizję, która zależy od kategorii produktu. Dokładna stawka jest uzgadniana z marketplace podczas rejestracji sprzedawcy.

Co dzieje się wewnątrz M2E Cloud? #

Po zatwierdzeniu konta sprzedawcy Shop Apotheke, M2E Cloud staje się systemem do zarządzania codziennymi operacjami na marketplace. Działa jako warstwa kontrolna między sklepem a marketplace Shop Apotheke.

Dzięki M2E Cloud zarządzasz Shop Apotheke z jednego miejsca. Platforma obsługuje wymianę danych, walidację i synchronizację, więc nie musisz pracować bezpośrednio w back-endzie Mirakl dla rutynowych zadań.

Korzystając z M2E Cloud, możesz:

• Połącz Shop Apotheke za pomocą interfejsu API Mirakl
• Eksportuj zawartość produktu ze swojego sklepu do marketplace
• Mapowanie kategorii i wymaganych atrybutów
• Zarządzanie cenami, podatkiem VAT i rabatami
• Synchronizacja zamówień, stanów magazynowych i wysyłek

Wszystkie aktualizacje są zgodne z predefiniowanymi regułami i uruchamiane automatycznie. Ogranicza to pracę ręczną i zapewnia synchronizację między sklepem a marketplace.

Wymagania przed rozpoczęciem #

Przed podłączeniem Shop Apotheke do M2E Cloud upewnij się, że wszystkie poniższe wymagania są spełnione. Brak któregokolwiek z nich zablokuje eksport lub zatrzyma synchronizację.

ℹ️ Proszę upewnić się, że Państwa sklep działa na obsługiwanej platformie, takiej jak Shopify, BigCommerce, PrestaShop itp. Wszystkie aplikacje M2E są dostępne w oficjalnej ofercie aplikacji. Na przykład integracja Shopify Hygi.de firmy M2E wymaga uprzedniej instalacji aplikacji Shopify.

Musisz mieć:

• Zatwierdzone konto sprzedawcy Shop Apotheke
• Ważne dane uwierzytelniające API Mirakl
• Rejestracja VAT
• Ceny produktów dostępne w EUR
• Ważne kody EAN lub GTIN dla wszystkich produktów

Obowiązują również wymagania językowe. Zawartość produktu musi być dostarczona w języku niemieckim lub włoskim, w zależności od sprzedawanej witryny sklepu.

W szczególnych przypadkach mogą obowiązywać dodatkowe wymagania:

• Produkty elektryczne i elektroniczne wymagają danych WEEE lub EPR
• Produkty regulowane i związane z farmacją mogą wymagać dodatkowych identyfikatorów i zatwierdzeń.

Łączenie Shop Apotheke z M2E Cloud #

Shop Apotheke to marketplace oparty na Mirakl, który łączy się z M2E Cloud za pośrednictwem API.

Aby nawiązać połączenie, potrzebujesz dostępu do panelu administracyjnego sprzedawcy Mirakl oraz ważnego klucza API.

Kroki połączenia:

1. W M2E Cloud otwórz opcję Połącz konto Mirakl.
2. W sekcji Wybierz marketplace wybierz Shop Apotheke (użyj pola Wyszukaj marketplace, aby szybko ją znaleźć).
3. Zaloguj się do panelu Mirakl Seller Admin i wygeneruj lub skopiuj swój klucz API.
4. Wróć do M2E Cloud i wklej klucz w polu Klucz API.
5. Wprowadź swój identyfikator sklepu, jeśli zarządzasz wieloma sklepami.
6. Kliknij „Połącz”.

Po przesłaniu danych M2E Cloud automatycznie weryfikuje dane uwierzytelniające. Po pomyślnej weryfikacji można zsynchronizować dane produktów, oferty, zamówienia i wysyłki.

ℹ️ Pełną instrukcję konfiguracji M2E Mirakl znajdziesz w tym przewodniku.

Typowe problemy z połączeniem to:

• Użycie nieprawidłowego lub nieaktualnego klucza API
• Brak uprawnień API w Mirakl
• Próba połączenia przed pełnym zatwierdzeniem konta Shop Apotheke

ℹ️ Jeśli później wygenerujesz ponownie klucz API w Mirakl, musisz go zaktualizować w M2E Cloud. W przeciwnym razie synchronizacja zostanie zatrzymana.

Po podłączeniu: Co dalej? #

Po aktywowaniu połączenia konfigurujesz zachowanie Shop Apotheke w M2E Cloud. Ta sekcja obejmuje główne kroki operacyjne, które należy wykonać, aby przygotować oferty i zarządzać bieżącą synchronizacją.

1. Lista nowych produktów w Shop Apotheke #

Wybierz produkty, które chcesz sprzedawać i wyeksportuj je do Shop Apotheke jako nowe oferty na marketplace.

Podczas eksportu, M2E Cloud może wysłać:

• Zawartość produktu, taka jak tytuły, obrazy i atrybuty
• Oferty produktów, takie jak cena, VAT i dostępność

To zachowanie jest kontrolowane przez atrybut strategii eksportu. Na wysokim poziomie określa on, czy M2E Cloud eksportuje pełną zawartość produktu, czy tylko oferuje dane.

✅ Użyj Polityki M2E Cloud, aby kontrolować, jakie dane są synchronizowane.

2. Powiązanie istniejących ofert na marketplace z produktami w sklepie. #

Jeśli Twoje produkty istnieją już w Shop Apotheke i używają tych samych jednostek SKU co Twój sklep, M2E Cloud może je automatycznie połączyć.

Jeśli jednostki SKU nie są zgodne, można połączyć oferty ręcznie za pomocą pliku CSV. Łączenie jest wymagane do synchronizacji. Informuje ono M2E Cloud, który produkt sklepu kontroluje cenę, zapasy i przetwarzanie zamówień dla każdej oferty marketplace.

3. Kategorie map i wymagane atrybuty #

Mapowanie kategorii jest obowiązkowe. Każdy produkt musi zostać przypisany do kategorii Shop Apotheke, zanim będzie można go wyeksportować.

Ten krok obejmuje:

• Wybór właściwej kategorii Shop Apotheke
• Wybór atrybutów treści, takich jak opisy i cechy produktów
• Mapowanie atrybutów, takich jak VAT i pola związane z cenami

Po zmapowaniu, M2E Cloud używa tych mapowań do synchronizacji danych zgodnie z aktywnymi politykami.

✅ Aby dowiedzieć się, w jaki sposób dane są przenoszone między systemami, zapoznaj się z przewodnikiem Polityka synchronizacji.

4. Konfiguracja reguł cenowych i walutowych #

Wszystkie ceny wysyłane do Shop Apotheke muszą być w EUR. Podatek VAT jest obowiązkowy i musi być zdefiniowany dla każdego produktu.

Zachowanie cenowe jest zarządzane przez Polityki Sprzedaży w M2E Cloud. Polityki te kontrolują sposób stosowania cen bazowych, rabatów i reguł ilościowych.

Można utworzyć wiele Polityk Sprzedaży, aby obsługiwać różne grupy produktów, zasady ustalania cen lub rynki.

5. Konfiguracja ustawień zamówień i mapowania statusu #

Polityki zamówień definiują sposób obsługi zamówień Shop Apotheke w M2E Cloud i w sklepie.

Obejmuje to:

• Kiedy zamówienia są importowane
• Jak Shop Apotheke mapuje statusy zamówień do statusów sklepu
• Jak potwierdzenia wysyłki są wysyłane z powrotem do marketplace

Prawidłowe mapowanie zapobiega konfliktom statusów i zapewnia spójność danych zamówienia.

6. Konfiguracja reguł wysyłki, dostawy i obsługi faktur #

Zachowanie wysyłki jest kontrolowane przez politykę wysyłki.

W przypadku Shop Apotheke musisz podać kod śledzenia i adres URL śledzenia dla wszystkich przesyłek. Mapowanie przewoźników jest opcjonalne, ale zalecane, ponieważ poprawia widoczność śledzenia na marketplace.

Tutaj można skonfigurować:

• Dostępni przewoźnicy i metody wysyłki
• Sposób potwierdzania przesyłek
• Jak synchronizowane są numery śledzenia

7. Monitorowanie oferty i rozwiązywanie problemów #

Po skonfigurowaniu można monitorować zachowanie oferty bezpośrednio w M2E Cloud.

Za pomocą strony Oferty można:

• Sprawdzanie statusu eksportu i walidacji
• Przeglądanie opinii i błędów marketplace
• Naprawianie problemów z mapowaniem, cenami lub zawartością bez wyłączania kanału

Pozwala to na utrzymanie aktywnych ofert i szybkie rozwiązywanie problemów.

💡 Sprawdź dokumenty M2E, aby zrozumieć, jak działa zarządzanie ofertami i zamówieniami.

Co dzieje się na zapleczu marketplace? #

Po wyeksportowaniu produktów i ofert z M2E Cloud, cała ostateczna walidacja i przetwarzanie odbywa się po stronie Shop Apotheke. Reguły te są egzekwowane przez marketplace za pośrednictwem Mirakl i nie można ich zmienić w M2E Cloud.

Zrozumienie tych ograniczeń pomaga uniknąć cichych odrzuceń i opóźnionych ofert.

Funkcje marketplace'u Shop Apotheke #

Shop Apotheke obsługuje zdefiniowany zestaw funkcji marketplace Mirakl.

Obsługiwane

• Zawartość produktu
• Oferty produktów
• Zamówienia
• Anulowanie zamówienia przez sprzedawcę
• Zwroty od sprzedawców
• Mapowanie przewoźników
• Formatowanie HTML
• Wiele lokalizacji magazynowych
• Pakiety
• Przesyłanie faktur
• Rozliczenia

Nieobsługiwane

• Automatyczne relacje
• Warianty produktu (rozmiar lub kolor)
• Produkty odnowione
• Zmiana ceny
• Rezygnacje z marketplace
• Zwroty z marketplace
• Przesyłki
• Usługi realizacji marketplace
• Kanały sprzedaży

ℹ️ Każda krajowa witryna sklepowa ma ten sam podstawowy zestaw funkcji, ale zasady wdrażania mogą się różnić.

Wymagania dotyczące produktu i oferty #

Aby lista produktów zakończyła się sukcesem, wszystkie wymagane pola muszą być zgodne z zasadami walidacji Shop Apotheke i Mirakl.

Zawartość produktu (obowiązkowa)

Każdy produkt musi zawierać następujące dane:

• EAN lub GTIN. Używany jako główny identyfikator produktu. Nieprawidłowa lub brakująca lista bloków kodów.
• Tytuł produktu
  • Tylko zwykły tekst
  • Maksymalna długość: 100 znaków
  • Ilości i znaczniki HTML nie są dozwolone.
• Obraz główny
  • Białe tło
  • Format kwadratowy
  • Obsługiwane formaty: JPG, PNG, WEBP
  • Minimalna rozdzielczość: 450 × 450 px. Zalecana rozdzielczość: 1000 × 1000 px
  • Maksymalny rozmiar pliku: 5 MB.
• Marka. Musi odpowiadać rzeczywistej marce produktu.
• Ilość i jednostka
  • Jednostka musi być wybrana spośród stałych wartości, takich jak g, ml lub l
  • Ilość obsługuje do trzech wartości oddzielonych znakiem „x”..
• Atrybuty specyficzne dla kategorii. Wymagane pola zależą od wybranej kategorii i muszą być poprawnie zmapowane.

Zawartość produktu (opcjonalnie)

Możesz poprawić jakość oferty, podając dodatkowe dane:

• Dodatkowe obrazy
• Długie i krótkie opisy
• Charakterystyka produktu i instrukcje użytkowania
• Warianty wykorzystujące kod grupy
• Pola regulacyjne, takie jak PZN lub WEEE, w stosownych przypadkach

Pola opcjonalne są nadal weryfikowane. Nieprawidłowe wartości mogą zablokować eksport.

Zasady dotyczące ofert, cen i podatku VAT #

Zachowanie cen i podatków jest zgodne z zasadami Mirakl i musi być poprawnie skonfigurowane.

• Podatek VAT jest obowiązkowy. Każdy produkt musi zawierać ważną stawkę VAT.
• Waluta. Sklep Apotheke akceptuje tylko EUR.

Rabaty i promocje

Sklep Apotheke wspiera logowanie ze zniżkami Mirakl.

• Cennik v1 wykorzystuje cenę rabatową, datę rozpoczęcia rabatu i datę zakończenia rabatu. Cena rabatowa musi być niższa niż cena podstawowa.
• Pricing v2 wykorzystuje cenę Strike jako cenę regularną i Cenę jako wartość zdyskontowaną. Cena i cena wykonania nie mogą być takie same.
• Rabaty hurtowe wymagają progu ilości większego niż 1.
• Formatowanie daty musi być zgodne z formatem Mirakl: RRRR-MM-DD GG:MM:SS, w UTC.

Nieprawidłowa konfiguracja cen uniemożliwia publikację ofert.

Wysyłka, śledzenie i atrybuty specyficzne dla Mirakl #

Marketplace'y Mirakl opierają się na wielu innych atrybutach. Musisz zmapować te wymagane dla Twojej kategorii.

Typowe przykłady obejmują:

• Czas oczekiwania na wysyłkę. Określa, ile dni upłynie przed wysyłką.
• Klasa logistyczna. Kontroluje obsługę dostawy. Ważne kody marketplace to: klein, mittel, groß, extragroß.
• Wymagania dotyczące śledzenia. Kod śledzenia i adres URL śledzenia są wymagane dla wszystkich przesyłek. Mapowanie przewoźnika jest opcjonalne, ale zalecane.
• Atrybuty ekologiczne i EPR. Opcjonalne atrybuty mają zastosowanie do produktów podlegających przepisom dotyczącym ochrony środowiska. Obejmują one wkłady ekologiczne i identyfikatory rejestracyjne producentów.

FAQ #

Dlaczego mojego produktu nie ma na liście? #

Większość problemów z ofertą jest spowodowana błędami walidacji marketplace. Najczęstsze przyczyny to brakujące kody EAN, nieprawidłowe obrazy, niezamapowane wymagane atrybuty, brakujący podatek VAT lub nieprawidłowe ceny.

Gdzie mogę zobaczyć błędy walidacji po stronie marketplace? #

Jeśli żadne błędy nie pojawiają się w M2E Cloud, sprawdź backend Mirakl.

Przejdź do Katalog → Import produktów i pobierz raport Niezintegrowane produkty, aby uzyskać szczegółowe informacje zwrotne.

Czy Shop Apotheke obsługuje rabaty i promocje? #

Rabaty są obsługiwane przez reguły cenowe Mirakl. Obsługiwane są zarówno Pricing v1, jak i Pricing v2.

Czy faktury są wymagane dla zamówień Shop Apotheke? #

Wymagania dotyczące faktur zależą od konfiguracji. W niektórych przypadkach faktury sprzedawcy są opcjonalne. W innych przypadkach faktura musi zostać dołączona przed potwierdzeniem wysyłki.

✅ Jeśli potrzebujesz pomocy w konfiguracji lub napotkasz problemy z walidacją, skontaktuj się z zespołem wsparcia M2E Cloud.