EN
Kreator integracji Mirakl umożliwia dodanie w xSale integracji z marketplace opartym na systemie Mirakl. W zależności od konfiguracji integracja może pobierać zamówienia i płatności, wysyłać oferty, ceny i stany magazynowe oraz przekazywać numery listów przewozowych.
Ten wpis opisuje konfigurację ogólnego kreatora Mirakl. Dla części marketplace dostępne są też osobne kafelki, na przykład Empik, Modivo, Mountain Warehouse, Super-Pharm czy Zooplus. Takie kafelki korzystają z mechanizmu Mirakl, ale mają automatycznie uzupełnione pola właściwe dla danego marketplace.
W tym artykule znajdziesz:
- gdzie uruchomić kreator Mirakl,
- jak uzupełnić dane autoryzacyjne,
- jak wybrać zakres integracji,
- jak ustawić synchronizację ofert,
- jak ustawić pobieranie zamówień,
- jak uzupełnić mapowania dostaw i płatności,
- jak aktywować integrację,
- jak uruchomić import ofert,
- co można zmienić po dodaniu integracji.
Gdzie uruchomić kreator Mirakl?
Przejdź w panelu xSale do Integracje → Integracje. W tym miejscu widoczne są integracje już dodane do xSale oraz kafelki integracji, które można skonfigurować.
Aby dodać integrację Mirakl, w sekcji Integracje z platformami Marketplace odszukaj kafelek Mirakl, najedź na niego kursorem i kliknij Dodaj.
Krok 1. Automatyzacja Mirakl
W pierwszym kroku uzupełnij dane wymagane do połączenia xSale z marketplace działającym na Mirakl.
- Nazwa integracji – wpisz nazwę, pod którą integracja będzie widoczna w xSale. Nazwy integracji nie można później edytować.
- Rynek – wpisz nazwę marketplace, na przykład CASTORAMA albo EMPIK. W dedykowanych kafelkach Mirakl to pole może być uzupełnione automatycznie.
- Klucz dostępu – wklej indywidualny klucz API z panelu sprzedawcy danego marketplace.
- ID magazynu – wpisz ID magazynu widoczne w panelu marketplace.
- Adres sklepu – wpisz adres API sklepu. Formularz zawiera już prefiks https://, dlatego nie wpisuj go drugi raz.
Gdzie sprawdzić klucz dostępu?
W panelu marketplace kliknij ikonę użytkownika w prawym górnym rogu i przejdź do Ustawienia osobiste. Następnie wybierz zakładkę Klucz API. Skopiuj widoczny klucz i wklej go w polu Klucz dostępu w kreatorze xSale.
Gdzie sprawdzić ID magazynu?
ID magazynu znajdziesz na głównym widoku dashboardu marketplace. W kreatorze xSale wpisz numer z pola ID.
Kreator Mirakl jest uniwersalny, ale w poszczególnych implementacjach może różnić się od widoków pokazanych na przykładach.
Krok 2. Zakres integracji
W kroku Zakres integracji zdecyduj, które obszary ma obsługiwać integracja. Możesz zaznaczyć pobieranie zamówień oraz wystawianie ofert. Zaznaczona opcja oznacza, że dany obszar zostanie włączony i pojawią się kolejne kroki potrzebne do jego konfiguracji.
W dalszej części wpisu opisane są wszystkie kroki kreatora, czyli konfiguracja dla integracji obsługującej zarówno zamówienia, jak i oferty.
Krok 3. Synchronizacja ofert
W tym kroku ustawiasz, jakie dane z xSale mają być wykorzystywane przy synchronizacji ofert do marketplace. Ustawienia dotyczą między innymi cen, opisów i stanów magazynowych.
W zależności od konfiguracji możesz wskazać między innymi:
- czy ceny mają być liczone jako brutto,
- domyślny typ ceny i typ ceny źródłowej,
- zmianę ceny domyślnej procentowo albo kwotowo,
- zasadę zaokrąglania ceny,
- offset,
- domyślną zakładkę opisu,
- magazyny, z których mają być pobierane stany,
- ograniczenie stanu magazynowego.
Uwaga: przy synchronizacji cen i stanów z xSale do marketplace Mirakl odświeżenie danych może potrwać do około 10 minut. Dane nie muszą zmienić się natychmiast po stronie marketplace, ponieważ Mirakl ma ograniczenia związane z obsługą zapytań przez API.
Krok 4. Synchronizacja zamówień
W tym kroku ustawiasz pobieranie zamówień i płatności oraz sposób dalszej obsługi zamówień w procesach xSale i ERP.
W sekcji zamówień zwróć uwagę szczególnie na pole Synchronizacja od. Domyślnie data jest ustawiana na 7 dni wstecz, aby można było pobrać wcześniejsze zamówienia i sprawdzić działanie integracji na rzeczywistych danych. Pole jest edytowalne, więc możesz ustawić bieżącą datę, jeżeli xSale ma pobierać tylko nowe zamówienia od momentu uruchomienia integracji.
W tym kroku można też ustawić obsługę płatności oraz dane potrzebne przy eksporcie zamówień do ERP, na przykład serię dokumentu albo dodanie pozycji transportowej dla zamówień z darmową dostawą.
Krok 5. Mapowania dostaw i płatności
W tym kroku uzupełnij mapowania dostaw i płatności. Mapowania pozwalają powiązać wartości przekazywane przez marketplace z formami dostawy i płatności zdefiniowanymi w xSale.
Więcej informacji znajdziesz we wpisach:
Uwaga dotycząca Empik i kodów dostawy
Marketplace Empik, przekazując zamówienia, zamiast pełnej nazwy dostawy może udostępniać kod w języku angielskim. Aby poprawnie zmapować te dane z dostawami w xSale, uwzględnij frazy z kolumny Kod.
Kolumna Etykieta pokazuje opisową nazwę dostawy, która pomaga rozpoznać właściwy kod.
| Etykieta | Kod |
|---|---|
| KURIER | COURIER |
| Paczkomaty InPost | PACKSTATION |
| Pocztex | POST |
| Poczta Polska – odbiór w punkcie | POST_OFFICE |
| Kurier – płatność za pobraniem | COURIER_POD |
| Paczkomaty InPost – płatność za pobraniem | PACKSTATION_POD |
| Pocztex – płatność za pobraniem | POST_POD |
| Poczta Polska – odbiór w punkcie – płatność za pobraniem | POST_OFFICE_POD |
| Żabka | ZABKA |
| Żabka – płatność za pobraniem | ZABKA_POD |
| Kurier z wniesieniem | COURIER_HOME_DELIVERY |
| Kurier z wniesieniem – płatność przy odbiorze | COURIER_HOME_DELIVERY_POD |
| Stacja Orlen – odbiór w punkcie – płatność z góry | ORLEN_STATION |
| Stacja Orlen – odbiór w punkcie – płatność przy odbiorze | ORLEN_STATION_POD |
Krok 6. Aktywacja
W kroku Aktywacja zdecyduj, czy integracja ma być aktywna od razu po zakończeniu kreatora. Jeżeli integracja ma zacząć działać, ustaw suwak aktywności na TAK. Jeżeli chcesz najpierw zapisać konfigurację i wrócić do niej później, możesz pozostawić integrację nieaktywną.
Krok 7. Import ofert
W kroku Importuj oferty możesz uruchomić pobieranie ofert z kanału sprzedaży do xSale. Kliknięcie przycisku Importuj oferty rozpoczyna proces importu. Postęp jest widoczny w kreatorze, a sam proces może działać w tle.
Jeżeli ofert jest dużo, import może potrwać dłużej. Po zakończeniu albo po zamknięciu kreatora możesz zweryfikować pobrane oferty na liście ofert w xSale.
Zakończenie kreatora
Po przejściu wszystkich kroków integracja będzie widoczna w sekcji Twoje integracje. Jeżeli została ustawiona jako aktywna, xSale rozpocznie wykonywanie procesów zgodnie z wybranym zakresem i harmonogramem działania integracji.
Co można zmienić po dodaniu integracji?
Po zapisaniu integracji możesz wejść w tryb Edytuj. W edycji integracji sprawdzisz jej status, dane połączenia oraz ustawienia skonfigurowane w kreatorze.
Status integracji
Ta sekcja pokazuje status integracji oraz ewentualne błędy związane z jej działaniem.
Połączenia
W tej sekcji sprawdzisz, czy połączenie jest aktywne. Możesz też wyłączyć integrację, ustawiając suwak aktywności na NIE. Poniżej widoczne są dane użyte w pierwszym kroku kreatora. Jeżeli wymagają poprawy, możesz zmienić je w tym miejscu.
Synchronizacja ofert
W tej sekcji możesz zmienić ustawienia uzupełnione wcześniej w kroku dotyczącym synchronizacji ofert.
Synchronizacja zamówień
W tej sekcji możesz zmienić ustawienia uzupełnione wcześniej w kroku dotyczącym synchronizacji zamówień.
Mapowania dostaw i płatności
Jeżeli mapowania nie zostały uzupełnione podczas dodawania integracji albo wymagają zmiany, możesz uzupełnić je później w trybie edycji integracji.
Import ofert
Jeżeli import ofert nie został uruchomiony w kreatorze, możesz wrócić do tej opcji w edycji integracji i uruchomić pobieranie ofert z kanału sprzedaży.
