Mirakl Connect - integracja krok po kroku

Mirakl Connect - integracja krok po kroku

⏱️ Ten artykuł przeczytasz w 10 minut


Dowiedz się jak poprawnie założyć konto w Mirakl Connect i połączyć ze swoim sklepem na empik.com 

Mirakl Connect to platforma, która łączy Sprzedawców, partnerów i platformy Marketplace zasilane technologią Mirakl. 
Ułatwia ona wszystkim członkom promowanie swoich firm, nawiązywanie kontaktów i przyspieszanie działalności na platformach Marketplace. 

Dzięki Mirakl Connect Sprzedawcy mogą szybko i sprawnie dołączać do platform i nimi zarządzać, korzystając z narzędzi self-service do integracji swoich katalogów produktowych. Mogą również monitorować i zarządzać swoimi postępami z poziomu własnego pulpitu nawigacyjnego Mirakl.

Rejestracja w Mirakl Connect

  1. Wejdź na stronę Mirakl.com i wybierz Sign Up.
    Zobacz zrzut ekranu

  2. Następnie uzupełniamy zgodnie z danymi użytymi w koncie empik.com. Po zalogowaniu klikamy kontynuuj. 
    Zobacz zrzut ekranu

  3. W kolejnym kroku uzupełniamy dane użytkownika (jeżleli ich nie ma) oraz dane rejestracyjne firmy (te same co w empik.com).
    Zobacz zrzut ekranu


  4. W ostatnim kroku wybieramy, które sklepy powiązane z danym kontem chcemy połączyć z Mirakl Connect oraz zaznaczamy opcję „Potwierdzam, że te konta sklepu należą do mnie.” 
    Zobacz zrzut ekranu

  5. Po zakończeniu rejestracji, zostaniemy przeniesieni do Mirakl Connect. Przejdź do Seetings -> My profile i uzupełnij wszystkie informacje o sklepie: Public profile, contact details, Business documents,Payment information
    Zobacz zrzut ekranu

  6.  W zakładce My channels wyświetli się komunikat o podłączonym sklepie. Jeżeli nie wyświetla się tam żaden sklep, należy kliknąć w przycisk Add channel i z listy wybrać swoje konto Empik.
    Zobacz zrzut ekranu

  7. Opcjonalnym krokiem jest wybranie z menu głównego Channels > Business opportunities i uzupełniamy Company Profiles. 
    Weryfikacja tej części może zająć do kilku dni. Po pozytywnej weryfikacji, udostępniony zostanie dostęp do zasobów Integracyjnych Mirakl Connect.
     

Dodawanie produków

Po wykonaniu formalności, kolejnym krokiem jest zasilenie Mirakl Connect w katalog produktów, który jest niezbędny do zarządzania ofertami w marketplace. Przejdź do menu Catalog i wybierz przycisk Import products. Zasielenie w produkty można wykonać na 4 sposoby: 

Plik (CSV/XLSX) - Manual import
Wybierz opcję Manual import. Przeciągnij plik do pola “Drop file here” albo kliknij Select file i wskaż plik. Kliknij Continue.

Następnie Mirakl Connect będzie procesował Twój plik. 
W kolejnym kroku dopasuj atrybuty (Attribute matching) – najważniejszy krok przy pierwszym imporcie
  1. Sprawdź automatyczne dopasowanie kolumn z pliku do standardowych atrybutów Connect.
  2. Koniecznie zweryfikuj, że pole Product ID jest poprawnie zmapowane na Twoje ID (SKU, EAN) produktu (błędne mapowanie powoduje problemy z importem). Upewnij się też, że pole GTIN też jest uzupełnione.
  3. Jeśli coś jest źle dopasowane, popraw mapowanie ręcznie. Uzupełnij pola Main attributes, Prices, Other attributes
  4. Zapisz i uruchom import


Wrócisz do “Main catalog”, a Mirakl Connect pokaże komunikat, że import trwa (kilka minut zależnie od rozmiaru).

Po zakończeniu zobaczysz podsumowanie: liczba zaimportowanych produktów oraz ewentualne błędy/ostrzeżenia.
Kolejne importy z tymi samymi nagłówkami zwykle nie pokazują już “Attribute matching” (Connect pamięta mapowanie). Jeśli zmienisz nagłówki, matching pojawi się ponownie.

Info
Wymagania pliku (żeby import przeszedł bez blokad):
  1. Format: CSV lub XLSX, max 100 MB, plik nie może być pusty.
  2. Pierwszy wiersz musi zawierać nazwy atrybutów (nagłówki).
  3. Brak zduplikowanych nagłówków, brak pustych kolumn “pomiędzy” danymi.
  4. 1 produkt = 1 wiersz.
  5. Product ID jest obowiązkowe (nie da się go później zmienić).
Więcej informacji znajduje się na stronie pomocy Mirakl Connect.
SFTP Connector
Żeby zasilić katalog w Mirakl Connect przez SFTP connector, sprzedawca musi skonfigurować połączenie do swojego serwera SFTP i przetestować, czy Mirakl Connect widzi plik oraz ma do niego prawa odczytu.

Uzupełnij dane konektora SFTP. W panelu SFTP wpisz:
  1. Host (np. sftp.twojadomena.com)
  2. Port (zwykle 22)
  3. Path (pełna ścieżka katalogu, np. /etc/home/catalog)
  4. File name (np. connect_catalog.xlsx lub .csv)
  5. Username i Password (konto, które ma prawo odczytu pliku)

Info
Ważne: Mirakl Connect musi mieć uprawnienia do odczytu pliku na Twoim serwerze (Mirakl Connect nie przenosi, nie nadpisuje i nie usuwa plików).
Przetestuj połączenie klikając w Test connector.
Info
Test sprawdza: połączenie, obecność pliku w katalogu, uprawnienia odczytu oraz analizę pliku.
Jeśli test jest “Failed”, wróć do pól i popraw dane (błąd z testu zwykle wskazuje, co jest nie tak).
Przy pierwszym imporcie pojawi się Attribute matching — zweryfikuj mapowanie, szczególnie Product ID (szerzej opisane w poprzednim punkcie). Kliknij Save.

Synchronizacja jest aktywowana automatycznie: Mirakl Connect będzie co godzinę pobierał plik z SFTP i aktualizował katalog.
Jeśli na w menu Catalog zobaczysz komunikat “SFTP import failed”, wróć do konfiguracji SFTP i uruchom ponownie Test connector (da więcej szczegółów).

API integration
Aby sprzedawca mógł zasilać Mirakl Connect przez API, musi najpierw utworzyć API integration w Connect, skopiować client_id / client_secret / company_id, a potem generować token OAuth2 i wywoływać Connect APIs.

Utwórz API integration w Mirakl Connect:
  1. Wejdź w Settings -> API integrations.
  2. Kliknij Create API integration.
  3. Nadaj nazwę (np. “Catalog sync”).
  4. Kliknij Create.
  5. Skopiuj i bezpiecznie zapisz: Seller company ID (company_id), Client ID, Client secret (pokazywany tylko raz)
Wygeneruj access token (OAuth2 Client Credentials). Wyślij żądanie:
  1. POST https://auth.mirakl.net/oauth/token
  2. Content-Type: application/x-www-form-urlencoded

  4. grant_type=client_credentials
  5. &client_id=<your-client-id>
  6. &client_secret=<your-client-secret>
  7. &audience=<your-company-id>
Token jest ważny 1 godzinę, więc integracja powinna go odnawiać cyklicznie. Do każdego requestu dodaj nagłówek: Authorization: Bearer <access-token>
Jeśli zgubisz client secret:
  1. Settings -> API integrations → View na integracji
  2. Actions -> Reset → wpisz RESET → Reset
  3. Kliknij Copy client secret i zapisz (stary secret przestanie działać po ok. godzinie)
Aby obsłużyć katalog produktów w Mirakl Connect przez API, używaj tych endpointów Connect:
  1. POST /products (upsertProducts) – import/aktualizacja produktów (ceny, stany, atrybuty) w Main catalog
    Doc: https://developer.mirakl.com/content/product/connect/rest/connect/openapi3/catalog/upsertproducts
  2. GET /products (listProducts) – pobranie listy produktów z Main catalog (paginacja page_token, limit do 1000)
    Doc: https://developer.mirakl.com/content/product/connect/rest/connect/openapi3/catalog/listproducts
  3. DELETE /products (deleteProducts) – usuwanie produktów z katalogu Connect (i powiązanych danych/diagnostyki)
    Doc: https://developer.mirakl.com/content/product/connect/rest/connect/openapi3/catalog/deleteproducts
W praktyce: cyklicznie wysyłasz zmiany przez upsertProducts, a listProducts używasz do kontroli/porównań; deleteProducts tylko gdy chcesz wycofać SKU z Connect.

Apps
Dodanie katalogu przez Apps w Mirakl Connect polega na podłączeniu konektora (np. Shopify/Magento/WooCommerce), który automatycznie zasila katalog.
  1. W menu bocznym wejdź w Apps.
  2. Znajdź aplikację (konektor) dla systemu sprzedawcy i kliknij Add na karcie aplikacji.
  3. Przejdź przez kreator połączenia (autoryzacja w zewnętrznym systemie + wybór ustawień synchronizacji).
  4. Po zakończeniu wejdź w Catalog i sprawdź, czy produkty pojawiają się w catalog (pierwsza synchronizacja może chwilę potrwać).
  5. Do zarządzania ustawieniami wracaj przez Apps -> [App name] -> View.

Dodawanie ofert

Dodanie ofert do Empik z perspektywy Mirakl Connect polega na posiadaniu produktów w menu Catalog, otworzyć kanał, a potem włączyć synchronizacje katalogu (zwłaszcza ceny i stany), bo to tworzy/aktualizuje oferty na platformie.
Upewnij się, że masz produkty w Mirakl Connect
Wejdź w Catalog i sprawdź, czy produkty są dostępne (import plik/SFTP/API/Apps).

Sprawdź czy masz podpiety kanał marketplace
Wejdź w Channels -> My channels.
Jeżeli logowałeś się kontem Empik, to konto Empik Marketplace powinno już być dodane
Jeżeli lista jest pusta, wybierz przycisk "Add channel", jeżeli konta nie będzie na liście wybierz przycisk "Add", na liście wszystkich dostępnych marketplace znajdź Empik, wpisz nazwę uzytkownika i podaj kod, który przyjdzie na adres email i otwórz kanał na marketplace.

Aktywuj synchronizację katalogu dla kanału (to uruchamia tworzenie ofert)
W menu My channels kliknij View channel.

W panelu “Finalize catalog setup” kliknij Activate price and stock synchronization albo w panelu “Catalog synchronization” kliknij Edit.

Zaznacz co najmniej Synchronize prices (wymagane do utworzenia oferty – oferta musi mieć cenę) oraz Synchronize quantities (żeby oferta była aktywna i miała stan magazynowy). Opcjonalnie możesz też zaznaczyć Synchronize discount prices (do przekazywania cen promocyjnych) oraz Product data (aktualizuje dane produktu, ale samo nie tworzy ofert). 
Poczekaj na pierwszą synchronizację i sprawdź statusy.
  1. Poczekaj na pierwszą synchronizację i sprawdź statusy. 
    Na dashboardzie w menu Catalog sprawdź jaki status mają importy:
    - Active (już istnieją na platformie)
    - Action required / Pending approval (wymagają akceptacji operatora marketplace, bo produkt nie istniał na platformie)
Info
Sama opcja Product data nie tworzy ofert. Do ofert potrzebujesz Synchronize prices (i praktycznie zawsze też Synchronize quantities).
Pierwsza synchronizacja może potrwać do ~10 minut, a aktualizacja statusu po walidacji operatora na platformie może zająć do 24h.

Zamówienia

Zarządzanie zamówieniami w Mirakl Connect to głównie monitoring i rozwiązywanie problemów z synchronizacją. Same akcje na zamówieniu wykonujesz w back office marketplace albo w swoim systemie (jeśli masz własny system lub łączysz się z zewnętrzną aplikacją typu Shopify).
Monitoruj zamówienia w Mirakl Connect
Wejdź w menu Orders. Użyj zakładek statusów (np. Awaiting acceptance, Awaiting shipment) oraz filtrów (kanał, data, deadline).

Przejdź do obsługi zamówienia (akcje)
Na liście zamówień kliknij View order. Mirakl Connect przekieruje Cię do strony zamówienia w back office marketplace Mirakl (Panel Sprzedawcy Empik).
Tam wykonujesz akcje: akceptacja/odmowa, wysyłka, refund/cancel (zgodnie z uprawnieniami i workflow).
Obsługuj zamówienia w swoim systemie (jeśli masz integrację)
Gdy masz aktywną synchronizację zamówień, możesz realizować zamówienia w ERP/Shopify/Magento, a Mirakl Connect zsynchronizuje statusy i tracking do marketplace.
Rozwiązuj błędy synchronizacji
W menu Orders kliknij Filters. Wybierz Sync errors i zakres czasu.
Kliknij zamówienie, aby otworzyć panel błędu (Details/Resolution/View original error) i zastosuj wskazówki.

 

    • Related Articles

    • Apilo - integracja krok po kroku

      ⏱️ Ten artykuł przeczytasz w 7 minuty Chcesz rozpocząć sprzedaż na empik.com i korzystasz z Apilo? Dowiedz się, jak przenieść swoje oferty automatycznie aktualizować stany magazynowe i ceny oraz wygodnie obsługiwać zamówienia z empik.com Zanim ...

    • PrestaShop - integracja krok po kroku

      ⏱️Ten artykuł przeczytasz w 15 minut Chcesz rozpocząć sprzedaż na empik.com i korzystasz z PrestaShop? Dowiedz się, jak zautomatyzować dodawanie produktów, synchronizację cen i stanów magazynowych oraz obsługę zamówień w empik.com Zanim zaczniesz ...

    • Sellasist - integracja krok po kroku

      ⏱️ Ten artykuł przeczytasz w 20 minut Chcesz rozpocząć sprzedaż na empik.com i korzystasz z SellAsist? Dowiedz się, jak przenieść swoje oferty, automatycznie aktualizować stany i ceny oraz wygodnie obsługiwać zamówienia z empik.com Stary moduł ...

    • WooCommerce - integracja krok po kroku

      ⏱️ Ten artykuł przeczytasz w 15 minut Chcesz rozpocząć sprzedaż na empik.com i korzystasz z WooCommerce? Dowiedz się, jak przenieść swoje oferty, automatycznie aktualizować stany i ceny oraz wygodnie obsługiwać zamówienia z empik.com Zanim zaczniesz ...

    • IdeaERP – integracja krok po kroku

      ⏱️ Ten artykuł przeczytasz w 11 minut Po przeczytaniu tego artykułu dowiesz się jak zintegrować aplikację IdeaERP z empik.com, jak pobierać i tworzyć zamówienia w integratorze. Pełna instrukcja, w której dowiesz się jak zintegrować aplikacje i co ...