W niniejszym przewodniku wyjaśniono, jak połączyć się z platformą Shop Apotheke i zarządzać nią za pomocą M2E Mirakl Connect.
Shop Apotheke to internetowa apteka i marketplace skupiający się na produktach zdrowotnych, działający w Europie. Działa on na platformie Mirakl, co oznacza, że przestrzega standardów Mirakl dotyczących danych produktów, ofert, cen oraz obsługi zamówień.
M2E Mirakl Connect umożliwia zarządzanie Shop Apotheke bezpośrednio z poziomu Państwa sklepu. Po nawiązaniu połączenia mogą Państwo:
- synchronizować produkty i oferty,
- aktualizować ceny i stany magazynowe,
- importować i realizować zamówienia,
- wysyłać potwierdzenia śledzenia przesyłek i wysyłek,
- oraz monitorować status ofert i wyniki walidacji.
ℹ️ Większość kroków opisanych w niniejszym przewodniku ma również zastosowanie do innych marketplace’ów Mirakl obsługiwanych przez M2E Mirakl Connect.
Poza platformą M2E Mirakl Connect #
Shop Apotheke łączy marki i sprzedawców z klientami, którzy kupują online produkty z zakresu opieki zdrowotnej, wellness oraz codziennej higieny. Marketplace prowadzi kilka zlokalizowanych witryn, z których każda jest skierowana do konkretnego kraju:
- shop-apotheke.com (Niemcy)
- shop-apotheke.at (Austria)
- farmaline.be (Belgia)
- redcare.it (Włochy)
ℹ️ Platforma Shop Apotheke nie obsługuje kont wielokanałowych w ramach jednej umowy. Jeśli chcą Państwo prowadzić sprzedaż w wielu krajach, muszą Państwo podpisać oddzielną umowę i przejść proces wdrażania dla każdego sklepu.
Dla kogo przeznaczona jest platforma Shop Apotheke? #
Platforma Shop Apotheke najlepiej sprawdza się w przypadku sprzedawców oferujących produkty związane ze zdrowiem, charakteryzujące się jednoznacznymi identyfikatorami i uporządkowanymi danymi produktowymi.
Typowe kategorie obejmują:
- produkty związane ze zdrowiem i dobrym samopoczuciem,
- produkty dostępne bez recepty oraz suplementy,
- artykuły do pielęgnacji i higieny osobistej,
- urządzenia medyczne i artykuły optyczne,
- produkty dla niemowląt, zwierząt domowych oraz artykuły gospodarstwa domowego związane ze zdrowiem.
ℹ️ Pozycje farmaceutyczne i pozycje podlegające regulacjom mogą wymagać dodatkowych zezwoleń i dokumentacji. Uprawnienia dostępu do kategorii oraz zezwolenia na sprzedaż określa firma Shop Apotheke.
Koszty sprzedaży w serwisie Shop Apotheke #
Sprzedaż w serwisie Shop Apotheke obejmuje:
- Opłata miesięczna: 39,00 €
- Prowizja: różni się w zależności od kategorii produktu i umowy handlowej
- Opłata za uruchomienie: brak
Stawki prowizji są ustalane podczas rejestracji sprzedawcy i zależą od struktury kategorii marketplace.
Wymagania techniczne #
Przed rozpoczęciem konfiguracji upewnij się, że spełnione są następujące wymagania:
- Posiadasz numer identyfikacyjny VAT w krajach, w których planujesz prowadzić sprzedaż.
- Twoje produkty posiadają ważne kody EAN lub GTIN.
- Dane produktów są kompletne i zgodne z zasadami dotyczącymi treści obowiązującymi w Shop Apotheke.
- Ustawienia wysyłki są jasno określone.
- Posiadasz uprawnienia do sprzedaży w wybranych kategoriach.
Produkty, które nie spełniają standardów marketplace, mogą zostać odrzucone podczas procesu weryfikacji.
Zgłoś wniosek o konto sprzedawcy i dostęp #
Przed połączeniem Shop Apotheke z M2E Mirakl Connect należy złożyć wniosek o konto sprzedawcy bezpośrednio na marketplace.
W trakcie procesu weryfikacji Shop Apotheke może poprosić o:
- dane firmy i numer VAT,
- informacje na temat kategorii, w których planują Państwo prowadzić sprzedaż,
- przykładowy plik z ofertą produktów do wglądu.
W niektórych przypadkach Shop Apotheke dokonuje weryfikacji Państwa katalogu przed utworzeniem sklepu. Ma to na celu zapewnienie, że Państwa produkty są zgodne z zakresem kategorii oraz zasadami zgodności.
Proces zatwierdzania jest obsługiwany przez Shop Apotheke. Czas przetwarzania może się różnić.
Po zatwierdzeniu otrzymają Państwo dostęp do portalu Mirakl Seller Admin. Dostęp ten jest niezbędny do kontynuowania procesu. Będą Państwo potrzebować swoich danych logowania do Mirakl oraz klucza API, aby połączyć Shop Apotheke z M2E Mirakl Connect.
W M2E Mirakl Connect #
Aby zarządzać Shop Apotheke z poziomu M2E, proszę połączyć swoje konto sprzedawcy Mirakl za pomocą klucza API. Połączenie to umożliwia M2E wymianę danych dotyczących produktów, ofert i zamówień z marketplace w czasie rzeczywistym.
Po nawiązaniu połączenia M2E synchronizuje:
- Produkty i oferty
- Ceny i stany magazynowe
- Zamówienia i statusy zamówień
- Szczegóły śledzenia przesyłek i aktualizacje dotyczące wysyłek
Jak połączyć Shop Apotheke #
Może Pan/Pani zintegrować Shop Apotheke ze swoim sklepem Adobe Commerce (Magento) za pośrednictwem M2E Mirakl Connect. Konfiguracja przebiega zgodnie ze standardową procedurą stosowaną dla wszystkich marketplace’ów opartych na Mirakl.
Kroki konfiguracji:
- Zainstaluj rozszerzenie M2E Mirakl Connect i zatwierdź wymagane uprawnienia.
- Zaloguj się na swoje konto M2E lub utwórz nowe.
- Dodaj swoje konto na marketplace Shop Apotheke, korzystając z adresu URL API Mirakl i klucza API.
- Powiąż produkty Magento z odpowiednimi ofertami na marketplace Shop Apotheke.
- Włącz synchronizację stanów magazynowych, aby zapewnić dokładność informacji o dostępności produktów.
- Skonfiguruj import zamówień, aby zamówienia z marketplace Shop Apotheke pojawiały się w Magento i były automatycznie odliczane od stanów magazynowych.
Po zakończeniu konfiguracji Katalog produktów, stan magazynowy i zamówienia będą synchronizowane między platformami Magento i Shop Apotheke.
✅ Szczegółowe instrukcje można znaleźć w Podręczniku użytkownika M2E Mirakl Connect
Codzienne zarządzanie #
Po nawiązaniu połączenia większość czynności odbywa się automatycznie.
Zarządzają Państwo produktami w Magento. M2E przesyła aktualizacje stanów magazynowych i cen do Shop Apotheke. Zamówienia są synchronizowane z powrotem do Magento bez konieczności ręcznego wprowadzania danych.
Państwa zespół realizuje zamówienia z marketplace w taki sam sposób, jak zamówienia ze strony internetowej – bez dodatkowych procedur.
Konfiguracja synchronizacji produktów #
Mają Państwo dwie opcje:
- Utwórz nowe oferty (wkrótce). Wykorzystaj dane z Magento do publikacji produktów w Shop Apotheke. M2E na bieżąco aktualizuje ceny i ilości.
- Połącz istniejące oferty. Jeśli oferty już istnieją, proszę powiązać je z produktami w Magento. Powiązanie jest wymagane. Informuje ono M2E, która pozycja w Magento odpowiada za daną ofertę. Następnie stany magazynowe i ceny są automatycznie synchronizowane.
Zarządzanie produktami i zasady synchronizacji #
W M2E Mirakl Connect zarządzanie produktami w serwisie Shop Apotheke odbywa się za pomocą polityk.
Polityka pełni rolę zestawu reguł. Określa ona sposób stosowania aktualizacji cen, synchronizacji stanów magazynowych oraz ustawień zamówień.
Takie podejście upraszcza zarządzanie katalogiem. Zamiast konfigurować produkty pojedynczo, można przypisać jedną politykę do wielu pozycji. M2E zarządza nimi następnie zgodnie z tymi samymi regułami.
Codzienne wykorzystanie polityk:
- Polityki kontrolują sposób przekazywania informacji z Magento do Shop Apotheke, w tym ilości, cen i statusu oferty.
- Edycja polityki powoduje natychmiastową aktualizację wszystkich przypisanych produktów.
- Można utworzyć wiele polityk dostosowanych do różnych celów sprzedażowych lub grup produktów.
- Politykami zarządza się w sekcji Konfiguracja lub bezpośrednio w ramach ofert produktów.
Zarządzanie kategoriami #
Precyzyjne przypisanie kategorii ma kluczowe znaczenie dla widoczności produktów w serwisie Shop Apotheke.
M2E Mirakl Connect umożliwia sprawne przypisywanie i aktualizowanie kategorii. W dowolnym momencie można przejrzeć mapowanie kategorii, aby dostosować je do wymagań marketplace. Prawidłowe mapowanie ogranicza liczbę błędów walidacji i gwarantuje wyświetlanie produktów w odpowiednich sekcjach.
Zarządzanie zamówieniami #
Po uruchomieniu integracji przetwarzanie zamówień odbywa się automatycznie.
Zamówienia z serwisu Shop Apotheke są importowane do Magento bez konieczności ręcznego wprowadzania danych. Zarządza się nimi przy użyciu standardowego przepływu pracy w sklepie.
Automatyczne tworzenie zamówień można włączyć w ustawieniach konta. Po włączeniu tej funkcji zamówienia Magento są generowane dla każdej nowej transakcji Shop Apotheke. W razie potrzeby nadal dostępne jest ręczne tworzenie zamówień.
Taka konfiguracja zapewnia scentralizowane i uporządkowane zarządzanie zamówieniami.
Po stronie marketplace Shop Apotheke #
Podczas eksportowania produktów i ofert z M2E Mirakl Connect, Shop Apotheke przeprowadza końcową weryfikację po swojej stronie. Wszystkie kontrole odbywają się w systemie Mirakl. Zasady te należą do marketplace i nie można ich modyfikować w M2E.
Funkcje marketplace Shop Apotheke #
Shop Apotheke obsługuje określony zestaw funkcji Mirakl.
Obsługiwane
- Treści produktowe
- Oferty produktów
- Zamówienia
- Anulacje ze strony sprzedawcy
- Zwroty ze strony sprzedawcy
- Mapowanie przewoźników
- Formatowanie HTML
- Wiele lokalizacji magazynowych
- Zestawy produktów
- Przesyłanie faktur
- Rozliczenia
Nie jest obsługiwane
- Powiązania automatyczne
- Warianty produktów (rozmiar lub kolor)
- Produkty odnowione
- Zmiana cen
- Anulacje na marketplace’ach
- Zwroty na marketplace’ach
- Przesyłki obsługiwane przez marketplace’ę
- Usługi realizacji zamówień na marketplace’ach
- Kanały sprzedaży
ℹ️ Wszystkie witryny sklepów krajowych mają tę samą podstawową strukturę funkcji. Wymagania dotyczące rejestracji mogą się jednak różnić w zależności od kraju.
Wymagania dotyczące produktów i ofert #
Aby pomyślnie opublikować produkty, należy spełnić zasady walidacji zarówno Shop Apotheke, jak i Mirakl. Pola obowiązkowe muszą być wypełnione i poprawnie sformatowane.
Obowiązkowe dane produktu
- EAN lub GTIN. Jest to główny identyfikator produktu. Brak lub nieprawidłowość kodów uniemożliwia publikację.
- Nazwa produktu. Tylko zwykły tekst o maksymalnej długości 100 znaków. Proszę nie podawać ilości ani nie używać tagów HTML.
- Zdjęcie główne. Wymagane jest białe tło i format kwadratowy. Akceptowane formaty: JPG, PNG, WEBP. Minimalna rozdzielczość: 450 × 450 px, ale zalecana rozdzielczość to 1000 × 1000 px. Maksymalny rozmiar pliku: 5 MB.
- Marka musi odzwierciedlać oficjalną markę produktu.
- Ilość i jednostka miary. Jednostkę miary należy wybrać spośród predefiniowanych wartości, takich jak g, ml lub l. Ilość może obejmować maksymalnie trzy wartości oddzielone znakiem „x”.
- Atrybuty specyficzne dla kategorii. Wymagane atrybuty zależą od wybranej kategorii. Wszystkie pola obowiązkowe muszą być poprawnie przypisane.
Dane dotyczące produktu (opcjonalne)
- Dodatkowe zdjęcia
- Krótki i długi opis
- Cechy produktu i instrukcja użytkowania
- Warianty pogrupowane według wspólnego kodu
- Atrybuty regulacyjne, takie jak PZN lub WEEE, jeśli mają zastosowanie
Pola opcjonalne są nadal sprawdzane pod kątem poprawności. Nieprawidłowe wartości mogą uniemożliwić eksport.
Konfiguracja oferty, cen i podatku VAT #
Ceny muszą być zgodne z zasadami Mirakl. Nieprawidłowa konfiguracja blokuje publikację oferty.
- Podatek VAT. Dla każdego produktu wymagana jest prawidłowa stawka podatku VAT.
- Waluta. Akceptowana jest wyłącznie waluta EUR.
- Rabaty i promocje. Sklep Apotheke obsługuje logikę rabatów Mirakl.
- Ceny v1 wykorzystują cenę z rabatem, datę rozpoczęcia rabatu oraz datę zakończenia rabatu. Cena z rabatem musi zawsze być niższa od ceny podstawowej.
- Ceny v2 wykorzystują cenę pierwotną jako cenę bazową oraz cenę jako wartość po rabacie. Cena i cena pierwotna nie mogą być identyczne.
- Rabaty hurtowe wymagają progu ilościowego wynoszącego co najmniej 1 sztukę.
- Format daty musi być zgodny z zasadami Mirakl: RRRR-MM-DD GG:MM:SS, w strefie czasowej UTC.
Jeśli dane dotyczące cen są nieprawidłowe, oferty nie zostaną opublikowane.
Wysyłka, śledzenie przesyłek i atrybuty Mirakl #
Marketplaces Mirakl wymagają podania dodatkowych atrybutów w zależności od kategorii i ustawień logistycznych.
Typowe przykłady obejmują:
- Czas realizacji do wysyłki to liczba dni między złożeniem zamówienia a wysyłką.
- Klasa logistyczna określa sposób obsługi dostawy. Dopuszczalne kody: klein, mittel, groß, extragroß.
- Wymagania dotyczące śledzenia przesyłek. Numer śledzenia i adres URL śledzenia są obowiązkowe dla wszystkich przesyłek. Przypisanie przewoźnika jest opcjonalne, ale zalecane.
- Atrybuty ekologiczne i EPR mają zastosowanie do produktów podlegających przepisom środowiskowym. Mogą one obejmować opłaty ekologiczne lub identyfikatory rejestracyjne producenta.
Aby eksport przebiegł pomyślnie, wszystkie wymagane atrybuty muszą być poprawnie przypisane.
FAQ #
Dlaczego mój produkt nie jest wyświetlany w ofercie? #
Większość problemów z ofertą wynika z błędów walidacji. Najczęstsze przyczyny to:
- Brakujący lub nieprawidłowy kod EAN
- Zdjęcie niezgodne z regułami formatowania
- Brak przypisania wymaganych atrybutów
- Brak numeru VAT
- Nieprawidłowa konfiguracja cen
Czy Shop Apotheke obsługuje rabaty? #
Rabaty są obsługiwane poprzez logikę cenową Mirakl. Dostępne są zarówno wersje Pricing v1, jak i Pricing v2.
✅ Jeśli potrzebują Państwo pomocy w zakresie konfiguracji lub napotykają problemy z weryfikacją twarzy, prosimy o kontakt z zespołem pomocy technicznej M2E.
