1. Strona główna
  2. Dokumentacja
  3. Integracje z marketplace
  4. Mirakl
  5. Kreator integracji Mirakl

Kreator integracji Mirakl

Kreator integracji jest narzędziem umożliwiającym dodanie nowej integracji w xSale z platformą marketplace opartą na systemie Mirakl. Umożliwia on pobieranie zamówień i płatności, a także przesyłanie numerów listów przewozowych.

Poniżej znajduje się instrukcja dodawania integracji z Mirakl w xSale.

Kreator integracji dostępny jest w menu Integracje, w zakładce Integracje, gdzie widoczne są wszystkie dostępne integracje, które zostały utworzone w xSale oraz inne, które mogą do xSale zostać dodane.

W celu dodania nowej integracji Mirakl należy przejść do sekcji Integracje z platformami Marketplace, kliknąć na logo MIRAKL (pojawi się tekst „Dodaj”), następnie uruchomi się kreator nowej integracji.

KROK 1. Automatyzacja Mirakl
W otworzonym kreatorze integracji Mirakl należy uzupełnić wymagane pola oznaczone symbolem *, na tym etapie należy uzupełnić:
Nazwa integracji – wpisać nazwę ustawianej integracjih
Rynek – nazwa marketplace (np. CASTORAMA, EMPIK)
Klucz dostępu – indywidualny klucz API dostępu do danego marketplace
ID magazynu – wskazać ID odpowiedniego magazynu, zgodny z numerem ID widocznym na dashboardzie marketpace
Adres sklepu – warto zwrócić uwagę czy adres jest wpisany prawidłowo, ponieważ formularz zawiera już https://

Gdzie sprawdzić klucz dostępu?
W prawym górnym rogu znajduje się logo użytkownika, należy je kliknąć i przejść w Ustawienia osobiste. Następnie wybrać zakładkę Klucz API. Wyświetli się pole z właściwym kluczem API, który należy skopiować i wkleić do pola w kreatorze.

Gdzie sprawdzić ID magazynu?
Należy wejść na główny widok dashboardu marketplace i odszukać pole ID – jest to ID magazynu, który należy uzupełnić w kreatorze.

Kreator Mirakl jest uniwersalny, ale w poszczególnych implementacjach może się on różnić od tego pokazanego na przykładach. 

KROK 2. Zakres integracji
Należy wskazać czy chcemy pobierać zamówienia oraz wystawiać oferty. W zależności od wyboru, będą dostępne kolejne kroki. Zaklikany ptaszek oznacza wybór tej opcji.
Kolejne punkty w tej instrukcji pokazują wszystkie kroki, dla integracji opartej zarówno o pobieranie zamówień jak i wystawianie ofert.

KROK 3. Synchronizacja ofert
Wybrane ustawienia dotyczą synchronizacji ofert – ustawienia, które definiują jakie dane będą przesyłane z xSale do sklepu.
Przy synchronizacji ofert istnieje możliwość ustawienia parametrów, które dotyczą cen, opisu i stanów:
włączenie cen brutto
Domyślny typ ceny
Typ ceny źródłowej
Zmiana ceny domyślnej o (%)
Zmiana ceny domyślnej o (+/-)
Zaokrąglij cenę do
Offset
Domyślna zakładka opisu
Pobieraj stany z magazynów
Ogranicz stan magazynu do

KROK 4. Synchronizacja zamówień
Ustawienia w tej zakładce dotyczą nowych zamówień (czy należy je pobierać i od kiedy) oraz płatności związanych z tą integracją (czy pobierać, z jakim statusem).
A także eksportu zamówień do systemu ERP – czy zamówienia mają być oznaczone konkretną serią i czy mają mieć pozycję transport w przypadku zamówień z darmową dostawą.

KROK 5. Mapowania dostaw i płatności
Więcej informacji na temat prawidłowej konfiguracji mapowań:
– dostaw Mapowania dostaw | xSale: Automatyzacja omnichannel
– płatności Mapowania płatności | xSale: Automatyzacja omnichannel

KROK 6. Mapowanie statusów zamówień
Więcej informacji na temat mapowania statusów zamówień – Mapowania statusów | xSale: Automatyzacja omnichannel

KROK 7. Zakończ
Ostatni krok, w którym ustawiamy czy skonfigurowana integracja powinna być od razu włączona = aktywna, czy nie. W tym celu należy przesunąć suwak w widocznym polu.

Po przejściu wszystkich kroków nastąpi aktywacja integracji z wybranym marketplace Mirakl. Stanie się ona widoczna w sekcji Twoje integracje.

Po prawidłowej integracji, istnieje możliwość wejścia w tryb „Edytuj” na integracji z Mirakl, gdzie można sprawdzić i ustawić następujące parametry:

  •  Status integracji
    Sekcja, która informuje o statusie i ewentualnych błędach związanych z integracją.

  • Połączenia
    W tej sekcji istnieje możliwość sprawdzenia czy połączenie jest aktywne. To tutaj można przesunąć suwak na NIE i sprawić, że dana integracja stanie się nie aktywna.
    Poniżej widoczne są dane użyte w pierwszym kroku kreatora integracji. Gdyby wymagały poprawy czy edycji, to w tym oknie można dokonać zmian samodzielnie.

  • Synchronizacja ofert – możliwość edycji danych, które były uzupełnianie w 3 kroku integracji.

  • Synchronizacja zamówień – możliwość edycji danych, które były uzupełnianie w 4 kroku integracji.

  • Mapowania dostaw i płatności
    Jeżeli nie zostało to w pełni uzupełnione na etapie dodawania nowej integracji, w kroku 5, to w trybie edycji, w późniejszym czasie, jest możliwość uzupełnienia Sposobów dostawy i Mapowania płatności.