Empik Place (Mirakl): klucz API, adres instancji i synchronizacja

Do czego to służy

Konektor Empik Place łączy Zaksio z platformą Mirakl, na której działa marketplace Empiku. Pobiera zaakceptowane zamówienia, listę ofert, wysyła stany magazynowe i przekazuje numery przesyłek.

Czego konektor nie robi: nie wysyła cen, bo w Mirakl zmiana ceny to pełna aktualizacja oferty i brakujące pola są zerowane. Nie akceptuje też zamówień (akceptujesz je sam w panelu Empik) i nie tworzy produktów ani ofert.

Gdzie to znaleźć w aplikacji

Sprzedaż i logistyka, „Kanały sprzedaży”, „Dodaj kanał sprzedaży”, rodzaj „Empik Place”, a w kanale zakładka „Połączenie”. Pola konektora: „Adres instancji Empik Place”, „Klucz API” i opcjonalnie „ID sklepu (opcjonalnie)”.

Aplikacja oznacza ten rodzaj kanału jako „W przygotowaniu”: zakładka „Połączenie” pokazuje na razie uproszczony szkic formularza (z mniejszą liczbą pól i innymi nazwami), a przycisków „Sprawdź połączenie” i „Start” jeszcze w niej nie ma. Klucze zapisane w tym szkicu mogą nie trafić do pól konektora, więc po udostępnieniu pełnego ekranu wpisz je ponownie.

Skąd wziąć klucze

1. Podpisz umowę sprzedaży z Empik Place i odbierz dane dostępowe do panelu sprzedawcy (marketplace.empik.com).
2. Zaloguj się do panelu, kliknij ikonę użytkownika, wybierz „Ustawienia osobiste”, a potem zakładkę „Klucz API”.
3. Kliknij „Wygeneruj nowy klucz”, jeśli go jeszcze nie ma, i skopiuj. Na jeden sklep przypada jeden klucz, a ponowne wygenerowanie unieważnia poprzedni.
4. Wpisz adres instancji (zwykle https://marketplace.empik.com, bez końcowej ścieżki) i klucz. „ID sklepu” podaj tylko wtedy, gdy Twój użytkownik ma dostęp do kilku sklepów.
5. Oferty muszą być już powiązane z kartami produktów w katalogu Empik. Pobierz listę ofert i zmapuj ją po SKU oferty na towary.
6. Nowe zamówienia nadal akceptujesz w panelu Empik: do Zaksio trafiają po akceptacji. Przed oznaczeniem jako wysłane zamówienie musi mieć numer przesyłki.

Dokumentacja API Mirakl dla sprzedawców: developer.mirakl.com. Układ panelu Empik mógł się zmienić od czasu napisania tego artykułu.

Co synchronizuje

• Zamówienia: po akceptacji w panelu Empik, pobierane co 5 minut. Statusy oczekiwania (akceptacja, debet) są pomijane. Opłatę pobiera Empik, więc zaakceptowane zamówienie uznajemy za opłacone, poza płatnością przy odbiorze.
• Oferty: lista do zmapowania po SKU oferty.
• Stany: plikiem CSV (import STO01), nie częściej niż raz na minutę. Import jest asynchroniczny: wynik sprawdzamy krótko po wysłaniu, a gdy jeszcze trwa, uznajemy wsad za przyjęty.
• Numer przesyłki: przewoźnik przekazywany jako nazwa z adresem śledzenia. Jeśli Empik ma go zarejestrowanego pod kodem, wpisz kod w ustawieniu kanału „carrierCodes”. Wysyłkę potwierdzamy tylko dla zamówień w statusie „Do wysyłki”.

Czego jeszcze nie ma

• Ekranu połączenia dla tej platformy w aplikacji: backend konektora istnieje i jest przetestowany na atrapach serwera, ale interfejs jest w przygotowaniu (patrz wyżej).
• Automatycznej akceptacji zamówień: akceptacja jest zobowiązaniem sprzedawcy, więc zostaje po Twojej stronie.
• Wysyłania cen, tworzenia produktów, zwrotów i wiadomości od kupujących.
• Weryfikacji na żywym koncie: adres API zakładamy według panelu (marketplace.empik.com) i dokumentacji Mirakl. Niepewne są też kody przewoźników, limity zapytań i format raportu błędów importu stanów.