Jak podłączyć ERP albo sklep do marketplace'ów na Mirakl i do Kauflandu

Decathlon, home24, Douglas, MediaMarkt, Castorama czy Modivo działają na technologii Mirakl. Dane przesyłasz do nich tym samym schematem: osobno produkt, osobno oferta z ceną i stanem, osobno zamówienia.

Autor: Borys Terlecki · Global Business Development, Marketing w Commercraft · aktualizacja: 07.11.2026

W skrócie

Decathlon, home24, Douglas, MediaMarkt, Castorama czy Modivo działają na technologii Mirakl [1] [2] [3] [4] [5] [7]. Dane przesyłasz do nich tym samym schematem: osobno produkt, osobno oferta z ceną i stanem, osobno zamówienia [9] [11] [12].

Kaufland Global Marketplace ma własne Seller API oraz jedną rejestrację i jeden panel sprzedawcy dla dziewięciu krajów [8] [34].

Masz cztery opcje: pliki w panelu operatora, własna integracja przez API, integrator wielokanałowy albo Mirakl Connect, który w najtańszym planie kosztuje 699 USD miesięcznie [19]. Dla Business Central, Odoo i Shopify są gotowe konektory do Mirakl i Kauflandu [20] [25] [30].

Zastrzeżenia prawne

Stawki z cennika Mirakl Connect i opisów aplikacji w sklepach z aplikacjami z dnia 06.11.2026. Ten tekst to informacja, nie porada prawna ani podatkowa; Commercraft nie jest kancelarią ani biurem doradztwa podatkowego. Przed decyzją sprawdź źródła wymienione na końcu albo zapytaj swojego doradcy.

Które marketplace'y działają na Mirakl

Mirakl dostarcza technologię, na której sieci handlowe budują własne marketplace’y. Operator decyduje, kogo przyjmie i jakich danych wymaga, ale sposób wymiany danych jest wspólny.

  • Decathlon, home24 i Douglas: potwierdzają to komunikaty Mirakla [1] [2] [3]. Decathlona jako marketplace Mirakl wymieniają też Channable i Lengow [16] [6].
  • MediaMarktSaturn: oficjalny portal sprzedawcy opisuje import przez kreator mapowania Mirakl [4].
  • Castorama Polska: według mediów branżowych platforma Kingfishera zbudowana we współpracy z Mirakl [5].
  • Leroy Merlin: na liście marketplace’ów Mirakl prowadzonej przez integratora Lengow [6].
  • Modivo: panel sprzedawcy w domenie modivo.mirakl.net według przewodnika dla partnerów Modivo [7].

Kaufland Global Marketplace działa na własnym Seller API [8].

Produkt, oferta, zamówienie: trzy strumienie danych w Mirakl

W Mirakl produkt i oferta to dwa osobne rekordy. Produkt to karta w katalogu operatora: nazwa, atrybuty, zdjęcia, kategoria. Oferta to Twoja propozycja sprzedaży tego produktu: cena, ilość, stan, czas wysyłki i Twój SKU, powiązana z produktem np. przez EAN.

StrumieńWywołania Seller APICo przesyłasz
ProduktyP41 (import), P42 (status), P51 (lista importów), P44 (raport błędów) [11]karty produktów do katalogu operatora
OfertyOF01 (plik), OF24 (API), PRI01 (ceny), STO01 (stany) [9]cena, ilość, warunki sprzedaży
ZamówieniaOR11 (lista), OR21 (akceptacja), OR23 (przewoźnik i numer), OR24 (wysyłka) [12]obsługa zamówienia od przyjęcia do nadania

Przy OF24 trzeba wysłać komplet pól oferty, bo pola pominięte wracają do wartości domyślnych. Mirakl zaleca aktualizację co 5 minut, nie częściej niż raz na minutę [10].

Cztery drogi podłączenia

1. Pliki w panelu operatora. Na przykładzie MediaMarktSaturn: formularz ręczny, szablon Excel operatora, własny plik Excel, CSV albo XML z kreatorem mapowania Mirakl (mapowanie robisz raz), cykliczny import z FTP albo HTTP co godzinę [4]. Pola obowiązkowe są w szablonie oznaczone na czerwono. Excel potrafi zamienić EAN na zapis naukowy, więc kolumnie z kodami trzeba nadać format niestandardowy z trzynastu zer [4].

2. Własna integracja przez API. Twój ERP rozmawia bezpośrednio z Seller API każdego operatora. Klucz API przekazujesz w nagłówku Authorization [40].

3. Integrator wielokanałowy. Według stron samych integratorów:

  • Base.com (dawniej Baselinker) obsługuje zamówienia, oferty i stany magazynowe. Każdy marketplace Mirakl wymaga osobnej integracji, a Leroy Merlin ma integrację dedykowaną [13] [14].
  • ChannelEngine: działa z każdym marketplace’em Mirakl, na który sprzedawca został przyjęty [15].
  • Channable: m.in. Castorama, Decathlon, Douglas, home24, Leroy Merlin i MediaMarkt [16].
  • PlentyONE: integracja oparta na konektorze Mirakl, np. dla voelkner.de [17].

4. Mirakl Connect. Jedna integracja sklepu i sprzedaż na wielu kanałach z jednego panelu. Gotowe konektory obejmują Shopify, Adobe Commerce, WooCommerce i BigCommerce, a inne systemy łączą się przez API, EDI albo SFTP [18]. Wśród narzędzi, z którymi Connect współpracuje, Mirakl pokazuje też m.in. Shopware, PlentyONE i JTL Software, bez opisu zakresu tych połączeń [18]. Cennik dla sprzedawców: plan Growth 699 USD miesięcznie (do 50 tys. USD sprzedaży miesięcznie i 10 tys. produktów), Pro 2 299 USD (do 200 tys. USD i 20 tys. produktów), Enterprise wycena indywidualna, bez limitu liczby kanałów [19].

Przykład. Marka ma w sklepie 12 000 produktów i sprzedaje przez Mirakl Connect za 30 000 USD miesięcznie. Obrót mieści się w limicie planu Growth, ale liczba produktów przekracza jego limit 10 000, więc marka płaci za plan Pro 2 299 USD miesięcznie [19]. Gdy do Connect trafi tylko 10 000 produktów, wystarczy plan Growth za 699 USD miesięcznie [19]. Różnica wynosi 1 600 USD miesięcznie, czyli 19 200 USD rocznie. Przeliczenie nasze, ceny planów bez dodatków i podatków.

Business Central, Odoo i Shopify: gotowe konektory

Poniżej konektory, które znaleźliśmy w oficjalnych sklepach z aplikacjami 29 października 2026. Lista nie jest rekomendacją, a zakres synchronizacji podajemy za opisami dostawców.

Microsoft Dynamics 365 Business Central

  • OmniConnect for Mirakl (Codeunit): zamówienia, stany magazynowe jako ilość w ofercie, akceptacja linii i wysyłki [20].
  • Commercium by ConstaCloud: ponad 200 marketplace’ów, w tym Mirakl i Kaufland: zamówienia, wysyłki, stany, zwroty, faktury, rozliczenia [22].
  • Tinx ChannelEngine Connector oraz Commerce 365 for ChannelEngine [23] [24]: połączenie Business Central z ChannelEngine, który obsługuje marketplace’y Mirakl i Kaufland [15] [21].

Odoo

  • Konektory Mirakl: Commercium (ConstaCloud) [25], FlexigoTech (dowolny marketplace Mirakl, wymaga subskrypcji FlexigoTech Cloud) [26], TeqStars (m.in. Decathlon, Leroy Merlin, MediaMarkt) [27].
  • Konektory Kaufland: Berens Solutions (rynki DE, AT, PL, CZ, SK, FR, IT) [28] i cube48 (tylko Kaufland.de) [29].

Shopify

  • Mirakl Connect, aplikacja Mirakla: produkty, stany, ceny i zamówienia. Instalacja jest bezpłatna, opłaty mogą być naliczane poza Shopify [30].
  • Kaufland: M2E Kaufland Global Connect (9 krajów, od 29 USD miesięcznie) [31], CedCommerce Kaufland Channel [32], Kaufland Sync [33].

Kaufland: jedno API dla dziewięciu krajów

Kaufland Global Marketplace działa w Austrii, Czechach, Francji, Niemczech, Włoszech, Polsce, na Słowacji, w Hiszpanii i w Holandii, z jedną rejestracją i jednym Seller Portalem [34]. Seller API 2.0 obsługuje dane produktów, oferty, zamówienia, faktury, zwroty, raporty, vouchery, kontakty GPSR i stawki prowizji [8]. Kraj wybierasz parametrem storefront, a język parametrem locale [35].

Oferta nazywa się w Kauflandzie „unit” i należy do produktu z katalogu [36]. Gdy produkt już jest w katalogu, wystarczy przesłać EAN i dane oferty [37]. Każde zapytanie podpisujesz kluczem klienta i kluczem tajnym (HMAC SHA-256) [35].

Dla nowych produktów Kaufland zaleca zdjęcia co najmniej 2048 px, najlepiej na białym tle, tytuł od 50 do 80 znaków i opis od 150 do 5000 znaków [37]. W opisie produktu Kaufland nie dopuszcza tłumaczeń generowanych automatycznie [37].

Obserwacja z kont Commercraft: integracja Kauflandu ma jeden klucz API dla konta niezależnie od rynku, z którego przychodzi zamówienie. Po podłączeniu rynku niemieckiego oferty spływają z cenami już w euro.

Na co uważać przy wdrożeniu

  • Operator wybiera sprzedawców. Decathlon pisze, że starannie dobiera partnerów [38], a przewodnik ChannelEngine opisuje go jako marketplace zamknięty [39]. Integrację warto budować równolegle z wnioskiem o przyjęcie.
  • Wymagania operatora są twardsze niż schemat Mirakl. Przewodnik ChannelEngine dla Decathlonu wymienia m.in. EAN z 8, 13 albo 14 cyfr, kwadratowe zdjęcie główne do 3000 × 3000 px na tle przezroczystym albo #F2F3F4, bez tekstu oraz obowiązkowe pola: marka, EAN, zdjęcie, SKU [39].
  • Formaty plików. Obserwacja z kont Commercraft: Castorama odrzucała zdjęcia w formacie WebP. Po ponownym wgraniu w JPG część ofert przeszła, część wróciła do odrzucenia.
  • Błędy szukaj u źródła. Praktyka Commercraft: gdy stany w ofercie różnią się od integratora, najpierw ponawiamy import i powiązanie ofert. Przy cyklicznym imporcie nocnym przyczyny szukamy w danych sklepu i zgłaszamy ją z konkretnymi przykładami.

Jak pomagamy przy integracji ERP z marketplace'ami

Przy integracji najwięcej czasu zabiera dopasowanie danych z ERP do wymagań każdego operatora. Możemy dobrać drogę podłączenia do Twojego katalogu i liczby kanałów, ustawić integrację i obieg zamówień, a potem wystawić oferty z kartami produktów dopasowanymi do atrybutów kategorii.

Ceny i stany ustawiamy tak, żeby aktualizowały się w rytmie zalecanym przez platformę, i monitorujemy je po starcie. Jeśli import zwraca błędy, szukamy przyczyny w danych źródłowych, dzięki czemu poprawka działa też przy kolejnych importach. Przy wejściu na Decathlon, Castoramę, Leroy Merlin, home24 albo Kaufland możemy Cię przedstawić osobom po stronie platformy.

Zakres pracy opisaliśmy na stronie o integracji sklepu z marketplace’ami.

Najczęstsze pytania

Nie. Kaufland ma własne API dla sprzedawców [8], a rejestracja i panel są wspólne dla wszystkich dziewięciu rynków [34]. Kraj wybierasz w każdym zapytaniu, podając kod kraju, więc jedno połączenie z systemem ERP obsługuje sprzedaż w Niemczech, Polsce i pozostałych krajach [35].

Technicznie tak: ChannelEngine sprzedaje przez jedno połączenie na każdym marketplace Mirakl, na który Cię przyjęto [15], a Mirakl Connect podłącza sklep raz [18]. Każdy operator przyjmuje sprzedawców osobno i stawia własne wymagania co do danych, więc katalog i tak dopasujesz do każdego kanału.

Plan Growth to 699 USD miesięcznie przy obrocie do 50 000 USD i katalogu do 10 000 produktów, Pro to 2 299 USD przy obrocie do 200 000 USD i 20 000 produktów, a Enterprise wycenia się indywidualnie [19]. Liczba podłączonych kanałów nie zmienia ceny w żadnym planie [19]. Aplikację w Shopify zainstalujesz bezpłatnie, ale Mirakl może pobierać opłaty osobno [30].

Tak. OmniConnect for Mirakl tworzy z zamówień marketplace’u zamówienia sprzedaży w Business Central, a z powrotem wysyła stany, akceptację linii, przewoźnika i numer przesyłki [20]. Do Mirakl i Kauflandu możesz też podłączyć Business Central przez ChannelEngine, korzystając z aplikacji Tinx albo Commerce 365 [23] [24].

Dla wywołania OF24 Mirakl zaleca aktualizację co 5 minut, ale nie częściej niż raz na minutę [10]. Import pliku z samymi ofertami (OF01) zalecany jest co 5 minut, a pliku z ofertami i produktami raz na godzinę [9]. Częstsze wywołania nie przyspieszą zmian, więc lepiej grupować aktualizacje cen i stanów.

Częsta przyczyna to kod EAN zamieniony przez Excel w zapis naukowy, np. 5.46548E+11, po którym produkt nie zostanie utworzony [4]. Druga to brak obowiązkowego atrybutu w mapowaniu, bo wtedy produkt też nie trafi do katalogu [4]. Raport błędów importu pobierzesz przez API wywołaniem P44 albo w panelu operatora [11] [4].

Źródła

  1. Decathlon Belgium opens its webstore to partners in sustainability, health and sport, komunikat z 22.10.2020, Mirakl, https://mirakl.com/news/decathlon-belgium-opens-its-webstore-to-partners-in-sustainability-health-and-sport, odczyt: 06.11.2026.
  2. home24 Mirakl-powered marketplace is now live, komunikat z 12.07.2022, Mirakl, https://www.mirakl.com/news/home24-mirakl-powered-marketplace-is-now-live/, odczyt: 06.11.2026.
  3. Mirakl celebrates rapidly growing marketplace of European premium beauty retailer Douglas, komunikat z 18.11.2020, Mirakl, https://www.mirakl.com/news/mirakl-celebrates-rapidly-growing-marketplace-of-european-premium-beauty-retailer-douglas, odczyt: 06.11.2026.
  4. 2. Choose your creation method, MediaMarktSaturn Marketplace, https://sell.mediamarktsaturn.com/en-DE/product-creation/2-choose-your-creation-method, odczyt: 06.11.2026.
  5. Kingfisher launches home improvement marketplace at Castorama Poland, Insight DIY, 23.01.2025, https://www.insightdiy.co.uk/news/kingfisher-launches-home-improvement-marketplace-at-castorama-poland/14655.htm, odczyt: 06.11.2026.
  6. List of Mirakl marketplaces, Lengow Help Center, https://help.lengow.com/hc/en-us/articles/17736327015196-List-of-Mirakl-marketplaces, odczyt: 06.11.2026.
  7. Przewodnik po Marketplace MODIVO (PDF), Modivo, https://partner.modivo.com/term/Przewodnik%20po%20Marketplace%20MODIVO.pdf, odczyt: 06.11.2026.
  8. Kaufland Seller API, dokumentacja, Kaufland, https://sellerapi.kaufland.com/, odczyt: 06.11.2026.
  9. Seller API, Offers (OF01, OF24, PRI01, STO01), Mirakl, https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/offers, odczyt: 06.11.2026.
  10. Seller API, OF24 Create, update, or delete offers, Mirakl, https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/offers/of24, odczyt: 06.11.2026.
  11. Seller API, Products (P41, P42, P44, P51), Mirakl, https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/products, odczyt: 06.11.2026.
  12. Seller API, Orders (OR11, OR21, OR23, OR24), Mirakl, https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3/orders, odczyt: 06.11.2026.
  13. Integracja Mirakl, Base.com, https://base.com/pl-PL/integracje/mirakl/, odczyt: 06.11.2026.
  14. Integration with Leroy Merlin, Base.com, https://base.com/en-GB/integrations/leroymerlin/, odczyt: 06.11.2026.
  15. Mirakl, ChannelEngine, https://www.channelengine.com/en/marketplaces/mirakl, odczyt: 06.11.2026.
  16. Mirakl marketplaces, Channable Help Center, https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/mirakl-marketplaces, odczyt: 06.11.2026.
  17. Released: migrate from the plugin to the new voelkner Mirakl integration now, PlentyONE, 17.05.2024, https://whatsnew.plentyone.com/en/product-updates/released-migrate-from-the-plugin-to-the-new-voelkner-mirakl-integration-now, odczyt: 06.11.2026.
  18. Mirakl Connect, strona produktu, Mirakl, https://www.mirakl.com/products/connect/, odczyt: 06.11.2026.
  19. Mirakl Connect, cennik, Mirakl, https://www.mirakl.com/products/connect/pricing/, odczyt: 06.11.2026.
  20. OmniConnect for Mirakl, Codeunit, https://www.codeunit.io/integrations/connect2mirakl, odczyt: 06.11.2026.
  21. Kaufland (née Real.de): marketplace guide, ChannelEngine Help Center, https://support.channelengine.com/hc/en-us/articles/4409502880157-Kaufland-n%C3%A9e-Real-de-marketplace-guide, odczyt: 06.11.2026.
  22. Commercium by ConstaCloud, Microsoft Marketplace, https://marketplace.microsoft.com/en-us/product/TYPE.connect%7CPUBID.constacloudllc%7CAID.commerciumbyconstacloud%7CPAPPID.eca8df46-92a7-4dbb-ad5d-b0504a7b3636, odczyt: 29.10.2026.
  23. Tinx ChannelEngine Connector, Microsoft AppSource, https://appsource.microsoft.com/en-us/product/dynamics-365-business-central/PUBID.tinx-it%7CAID.tinx-channelengine-connector%7CPAPPID.15473b79-394f-426f-aa3d-180c9b1fffae, odczyt: 29.10.2026.
  24. Commerce 365 for ChannelEngine, Microsoft AppSource, https://appsource.microsoft.com/en-us/product/dynamics-365-business-central/PUBID.nvisioncommercesolutions%7CAID.commerce-365-for-channelengine%7CPAPPID.5ab9b867-24df-48d6-bc82-ec57beffc8e7, odczyt: 29.10.2026.
  25. Odoo Mirakl Connector, Commercium by ConstaCloud, Odoo Apps, https://apps.odoo.com/apps/modules/18.0/odoo_mirakl_connector, odczyt: 06.11.2026.
  26. Mirakl Connector, FlexigoTech, Odoo Apps, https://apps.odoo.com/apps/modules/18.0/flexigobe_mirakl_connector, odczyt: 06.11.2026.
  27. Mirakl Connector, TeqStars, Odoo Apps, https://apps.odoo.com/apps/modules/19.0/mirakl, odczyt: 06.11.2026.
  28. Kaufland Connector, Berens Solutions, Odoo Apps, https://apps.odoo.com/apps/modules/18.0/kaufland_connector, odczyt: 06.11.2026.
  29. Kaufland.de Connector, cube48, Odoo Apps, https://apps.odoo.com/apps/modules/18.0/kaufland_de_connector, odczyt: 06.11.2026.
  30. Mirakl Connect, Shopify App Store, https://apps.shopify.com/mirakl-marketplaces-app, odczyt: 06.11.2026.
  31. M2E Kaufland Global Connect, Shopify App Store, https://apps.shopify.com/m2e-kaufland-connect, odczyt: 06.11.2026.
  32. CedCommerce Kaufland Channel, Shopify App Store, https://apps.shopify.com/real-de-integration, odczyt: 06.11.2026.
  33. Kaufland Sync, Shopify App Store, https://apps.shopify.com/kaufland-sync, odczyt: 06.11.2026.
  34. Kaufland Global Marketplace, strona dla sprzedawców, Kaufland, https://www.kauflandglobalmarketplace.com/en/, odczyt: 06.11.2026.
  35. Seller API, REST API (podpis HMAC, storefront, locale), Kaufland, https://sellerapi.kaufland.com/?page=rest-api, odczyt: 06.11.2026.
  36. Seller API, Inventory (units), Kaufland, https://sellerapi.kaufland.com/?page=inventory, odczyt: 06.11.2026.
  37. Product Data Guidelines, Kaufland Global Marketplace, https://www.kauflandglobalmarketplace.com/en/seller-university/selling/product-data/product-data-guideline/, odczyt: 06.11.2026.
  38. Become a Decathlon Marketplace partner, Decathlon, https://www.decathlon.co.uk/c/lp/landing-page-seller-become-a-decathlon-marketplace-partner_5c2340e0-8645-4cd4-adb3-45fca6e7ec81, odczyt: 06.11.2026.
  39. Decathlon: marketplace guide, ChannelEngine Help Center, https://support.channelengine.com/hc/en-us/articles/4412651192209-Decathlon-marketplace-guide, odczyt: 06.11.2026.
  40. Seller API, uwierzytelnianie (Shop-API-Key w nagłówku Authorization), Mirakl, https://developer.mirakl.com/content/product/mmp/rest/seller/openapi3, odczyt: 06.11.2026.
Borys Terlecki

O autorze

Borys Terlecki, Global Business Development, Marketing w Commercraft. Odpowiada za rozwój biznesu i marketing, w tym za współpracę z operatorami marketplace’ów. Wcześniej pracował w Mirakl w Monachium, po stronie operatorów.

Potrzebujesz wsparcia we wdrożeniu?

Wybór drogi integracji zależy od katalogu, ERP i liczby kanałów. Zobacz, jak prowadzimy integracje sklepu z marketplace’ami.