Integracja sklepu z marketplace Media Expert – jakie są możliwości

Klucz API – integracja z własnym systemem

Jeśli masz własny sklep na platformie bez gotowej integracji, system ERP albo rozbudowany program magazynowy, możesz połączyć go bezpośrednio z panelem przez API. Klucz generujesz w panelu Mirakl: profil → Ustawienia osobiste → Klucz API. Według Centrum Pomocy wygenerowanie nowego klucza unieważnia poprzedni, co ma znaczenie, jeśli z panelem łączy się kilka systemów – po zmianie klucza trzeba go zaktualizować wszędzie.

Bezpośrednia integracja daje pełną kontrolę nad logiką: kiedy i jak aktualizować stany, jak reagować na zwroty, jak tworzyć dokumenty. Wymaga jednak pracy programisty i utrzymania kodu. Centrum Pomocy informuje, że dokumentacja API dla sprzedawców Media Expert jest w przygotowaniu – programista będzie korzystał z ogólnej dokumentacji Seller API platformy Mirakl. Szczegóły omawiamy w tekście o API Media Expert.

[#wazne] Niezależnie od wybranej drogi wybierz jedno źródło prawdy dla cen i stanów. Jeśli integrator synchronizuje oferty, a ktoś równolegle zmienia ceny ręcznie w panelu lub plikiem, integrator nadpisze te zmiany przy najbliższej synchronizacji. Dwa systemy aktualizujące te same oferty to prosta droga do sprzedaży bez towaru.

Praca bez integracji: panel i pliki XLSX

Integracja nie jest obowiązkowa. Panel Mirakl pozwala obsłużyć cały proces ręcznie: produkty dodajesz pojedynczo lub szablonem XLSX, ceny i stany aktualizujesz plikiem inwentarzowym, zamówienia obsługujesz w zakładce Zamówienia, a numery przesyłek wpisujesz ręcznie. Taki model ma sens na etapie testów lub przy małej skali. Jak sprawnie pracować na plikach, opisujemy w poradniku o imporcie produktów na Media Expert, a o dodawaniu pojedynczych kart – w tekście jak wystawić produkt na Media Expert.

Wykres – kiedy integracja się opłaca, a kiedy wystarczy praca w panelu. [#chart:me13b]

Jak wybrać integrację – porównanie możliwości

Z naszej praktyki wynika prosta zasada: im więcej kanałów i im szybciej rotuje towar, tym szybciej zwraca się automatyzacja. Sklep, który testuje Media Expert na kilkunastu produktach o stabilnych stanach, może przez pierwsze tygodnie pracować w panelu i dopiero po potwierdzeniu, że kanał sprzedaje, inwestować w integrację. Firma, która już dziś obsługuje kilka marketplace’ów z jednego magazynu, powinna od początku podłączyć Media Expert do istniejącego systemu – ręczne przepisywanie stanów w takim modelu prędzej czy później kończy się anulowanymi zamówieniami, a te według Centrum Pomocy nie mogą wynikać z błędnych stanów czy wadliwej integracji. Warto też pamiętać, że koszt integratora rozkłada się na wszystkie kanały, a nie tylko na Media Expert.

Przy wyborze zadaj sobie cztery pytania: ile kanałów obsługujesz z jednego magazynu, jak często zmieniają się ceny i stany, ile zamówień dziennie spodziewasz się z Media Expert i czy masz już system, który obsługuje inne marketplace’y. Jeśli korzystasz z integratora na innych platformach, dodanie Media Expert jako kolejnego kanału jest zwykle najprostsze – podobnie jak w przypadku sprzedaży na Empiku przez Base, który również działa w technologii Mirakl.

Najczęstsze problemy po podłączeniu integracji

1. Duplikaty ofert – oferty dodane wcześniej ręcznie i ponownie przez integrator. Rozwiązanie: usunięcie starych ofert przed importem z integratora.

2. Zamówienia „wiszące” w statusie oczekującym na wysyłkę – brak mapowania statusu „Wysłane” lub kuriera. Numery przesyłek nie docierają do Mirakl.

3. Sprzedaż bez towaru – stany aktualizowane zbyt rzadko albo z dwóch źródeł. Ustaw częstszą synchronizację i jedno źródło prawdy.

4. Odrzucone karty produktów – brak wymaganych atrybutów w danych przekazywanych przez integrator. Uzupełnij reguły przypisywania parametrów.

5. Połączenie przestało działać – nowy klucz API wygenerowany w panelu unieważnił stary. Zaktualizuj klucz w integratorze.

6. Zwroty bez zwrotu prowizji – zwrot środków zrobiony poza panelem. Prowizja wraca tylko przy zwrocie zleconym w Mirakl lub przez integrację, która to obsługuje.

[#tip] Po podłączeniu integracji przetestuj cały proces na jednym zamówieniu: pobranie zamówienia, utworzenie etykiety, przekazanie numeru przesyłki, zmianę statusu na „Wysłano” i doręczenie. Dopiero gdy ten cykl działa bez ręcznych poprawek, uruchom pełną ofertę.

Wdrożenie integracji krok po kroku

Niezależnie od wybranego integratora wdrożenie przebiega według podobnego schematu. Najwięcej problemów pojawia się wtedy, gdy kroki są wykonywane w złej kolejności – np. oferty zostają wystawione, zanim zmapowano kurierów i statusy.

1. Uporządkuj katalog w systemie źródłowym – EAN, SKU, marki, kategorie i parametry. Integrator przeniesie na marketplace dokładnie to, co ma w danych, łącznie z błędami.

2. Skonfiguruj konto w panelu Mirakl – dane firmy, politykę zwrotów i reklamacji, konto bankowe oraz metody wysyłki. Bez konfiguracji wysyłki oferty nie będą widoczne.

3. Wyłącz inne synchronizacje i usuń oferty dodane wcześniej ręcznie, jeśli integrator ma je przejąć.

4. Połącz konto – przez MiraklConnect w Base albo kluczem API w Apilo i Sellasist – i sprawdź status połączenia.

5. Zmapuj statusy, kurierów i zwroty – szczególnie status „Wysłane” i metody wysyłki, od których zależy przekazywanie numerów przesyłek.

6. Wystaw oferty do istniejących kart, a potem twórz nowe karty partiami, kontrolując statusy weryfikacji w panelu.

7. Przetestuj pełny cykl zamówienia i dopiero wtedy włącz automatyczną synchronizację cen i stanów dla całego katalogu.

Jeśli prowadzisz sprzedaż także na innych platformach, przed startem sprawdź, jak integrator rozdziela stany między kanały. W systemach wielokanałowych zwykle wszystkie kanały korzystają z jednego magazynu, a o tym, jak uniknąć sprzedaży bez towaru, piszemy w tekście o synchronizacji stanów.

Przykład: dystrybutor akcesoriów z trzema kanałami

[#przyklad] Dystrybutor akcesoriów GSM sprzedaje we własnym sklepie, na dwóch innych marketplace’ach i chce dodać Media Expert. Ma około 800 produktów, a stany zmieniają się kilka razy dziennie, bo towar schodzi równolegle w hurcie. Praca na plikach odpada już na etapie planowania – aktualizacja stanów raz dziennie oznaczałaby ryzyko sprzedaży produktów, których nie ma w magazynie. Firma korzysta już z integratora w pozostałych kanałach, więc dodaje Media Expert jako kolejny kanał.

Najpierw sprawdza, ile produktów ma karty w katalogu – w akcesoriach popularnych marek to zwykle spora część. Do nich wystawia oferty od razu. Pozostałe produkty, głównie marka własna, wymagają utworzenia kart: dystrybutor mapuje kategorie, uzupełnia atrybuty kompatybilności i dane podmiotu odpowiedzialnego. Mapuje statusy i kurierów, testuje jedno zamówienie od pobrania do doręczenia i dopiero wtedy włącza automatyczną aktualizację cen i stanów. Efekt: zamówienia z Media Expert trafiają do tego samego procesu pakowania co pozostałe, a numery przesyłek wracają do panelu bez udziału pracowników.

Najczęściej zadawane pytania

Czy integracja z Media Expert jest obowiązkowa?

Nie. Cały proces możesz obsługiwać w panelu Mirakl i przez pliki XLSX. Integracja oszczędza czas przy większej liczbie ofert i zamówień oraz przy sprzedaży w kilku kanałach, a także zmniejsza ryzyko błędów przy ręcznym przepisywaniu danych, zwłaszcza numerów przesyłek.

Jakie integratory wskazuje Media Expert?

Centrum Pomocy dla Sprzedawców opisuje integracje z Base, Apilo i Sellasist oraz generowanie klucza API do połączeń z własnymi systemami.

Czy za integrację płacę Media Expert?

Regulamin przewiduje, że integracje z zewnętrznymi podmiotami działają na podstawie odrębnej umowy z ich dostawcą. Koszt zależy więc od cennika wybranego integratora, a nie od opłat marketplace’u.

Czy mogę zmieniać ceny w panelu, jeśli mam integrator?

Technicznie tak, ale przy aktywnej synchronizacji integrator nadpisze ręczne zmiany cen i stanów. Zmiany wprowadzaj w systemie źródłowym.

Czy w panelu Mirakl wygeneruję etykietę przewozową?

Nie. Etykiety tworzysz w zewnętrznym systemie, u brokera lub przewoźnika, a numer przesyłki przekazujesz do zamówienia – ręcznie lub automatycznie przez integrację.

Co się stanie po wygenerowaniu nowego klucza API?

Poprzedni klucz zostaje unieważniony. Wszystkie systemy, które z niego korzystały, trzeba zaktualizować nowym kluczem, inaczej przestaną się łączyć z panelem. Dlatego zapisz, które narzędzia korzystają z klucza.

Czy jedna integracja obsłuży Media Expert i inne marketplace’y działające na Mirakl?

Integratory wielokanałowe obsługują wiele platform, w tym kilka marketplace’ów działających w technologii Mirakl, ale każdy z nich podłączasz jako osobny kanał z własnymi mapowaniami kategorii, parametrów i statusów. Sprawdź listę obsługiwanych kanałów w dokumentacji wybranego integratora.

Podsumowanie

Integracja z Media Expert może przybrać trzy formy: gotowy integrator (Base, Apilo, Sellasist), własne połączenie przez API albo pracę w panelu i na plikach. Przy małej skali wystarczy panel, przy sprzedaży wielokanałowej i setkach ofert integrator szybko się zwraca, a własne API wybierają firmy z rozbudowanym ERP. Kluczowe są poprawne mapowania statusów i kurierów oraz jedno źródło prawdy dla cen i stanów. Aktualne instrukcje znajdziesz w Centrum Pomocy dla Sprzedawców.

Wdrażamy i obsługujemy sprzedaż na marketplace’ach, w tym na Media Expert – pomożemy wybrać sposób integracji, skonfigurować mapowania i przetestować obsługę zamówień, np. w ramach wdrożenia Base. Umów bezpłatną konsultację, a zaproponujemy rozwiązanie dopasowane do Twojej skali sprzedaży.