Przejdź do głównej treści
Mirakl · Jeden konektor, wielu operatorów

Mirakl i Odoo: dlaczego jeden konektor otwiera Decathlon, Leroy Merlin i Bricodepot

Mirakl nie jest marketplace'em, na którym się sprzedaje: to oprogramowanie, na którym wiele sieci buduje własny. Oznacza to, że jedna integracja obsłuży kilka z nich, ale też że każdy operator dokłada swoje wymagania.

Formularz instancji konektora Mirakl w Odoo z poprawnym testem połączenia

Najczęstsza pomyłka w przypadku Mirakl to traktowanie go jak Amazon. To nie to samo. Mirakl to platforma, której Decathlon, Leroy Merlin, Bricodepot, GACD i dziesiątki innych sieci używają, by otworzyć własny marketplace dla zewnętrznych sprzedawców. Dla Ciebie oznacza to jedną bardzo dobrą konsekwencję i jedną przeciętną.

Dobra: API jest takie samo dla wszystkich. Dobrze zrobiona integracja z Mirakl sprawdzi się przy pierwszym operatorze i przy piątym, wystarczy zmienić adres URL operatora i klucz API. Przeciętna: na tej wspólnej bazie każdy operator dokłada własne reguły (swoje drzewo kategorii, obowiązkowe atrybuty, terminy, kary, a nawet to, które części API udostępnia) i te reguły nie są wspólne.

Co mają wspólne wszyscy

Cykl jest zawsze ten sam: publikujesz oferty (produkt, cena, stan magazynowy, termin), operator przysyła zamówienia, Ty je przyjmujesz lub odrzucasz, wysyłasz z numerem śledzenia, a pieniądze dostajesz w rozliczeniu. Konektor Mirakl przenosi ten cykl na zwykłe dokumenty Odoo w wersjach 17, 18 i 19: publikuje oferty z ceną, stanem i terminem wysyłki, importuje zamówienia jako zamówienia sprzedaży, przyjmuje je (ręcznie lub automatycznie, jeśli to włączysz), przekazuje do Mirakl przewoźnika i numer śledzenia z dokumentu dostawy oraz importuje rozliczenia, aby zaksięgować je w księgowości.

Szczegół, który zaskakuje: w Mirakl można odrzucać pozycje zamówienia. To nie błąd, tylko część protokołu. Nasz konektor nie odrzuca pojedynczych pozycji: przyjmuje całe zamówienie. Jeśli jakiejś pozycji nie możesz zrealizować, odrzuć ją w back office Mirakl przed przyjęciem i pamiętaj, że automatyczne przyjmowanie, które jest domyślnie wyłączone, przyjmuje wszystko, co wpływa.

Co zmienia się u każdego operatora

Drzewo kategorii i obowiązkowe atrybuty, które w sieci sportowej i w sieci z artykułami budowlanymi wyglądają zupełnie inaczej. Termin przyjęcia zamówienia, który u niektórych operatorów liczy się w godzinach. I wymagania dotyczące danych produktu: niektórzy operatorzy odrzucają ofertę, jeśli brakuje kodu EAN, a inni wymagają ponadto pełnej karty technicznej.

Dlatego oprócz strony konektora mamy osobną stronę dla każdego operatora: Decathlon, Leroy Merlin, Brico Depot i GACD. Konektor bazowy jest ten sam, a każdy operator to kolejna instancja z własnym adresem URL i kluczem; dla niektórych operatorów jest też profil uzupełniający, który ustawia adres URL i wartości domyślne. To, co naprawdę się zmienia, to przygotowanie katalogu.

Co przygotować przed złożeniem wniosku o dostęp

Trzy rzeczy, żadna nie jest techniczna. Kod EAN przy każdym produkcie, który zamierzasz publikować: niektórzy operatorzy bez niego nie przyjmą oferty. Termin przygotowania, który naprawdę możesz dotrzymać, a nie taki, jaki byś chciał; obietnica 24 godzin i wysyłka po 72 odbija się na Twoim koncie. Oraz zdjęcia zgodne z ich wymogami, zwykle ostrzejszymi niż na Twojej własnej stronie.

I ostrzeżenie z własnego doświadczenia

Zrobiliśmy audyt własnego konektora Mirakl w momencie, gdy jego zestaw testów przechodził na zielono w Odoo 19, 18 i 17, i znaleźliśmy 18 potwierdzonych błędów, wśród nich rejestr wywołań, który nigdy niczego nie zapisywał, oraz synchronizację patrzącą na złą datę. Całą historię opisujemy w artykule audyt odziedziczonego konektora. Jeśli ktoś sprzedaje Ci integrację z Mirakl, zapytaj, co się dzieje, gdy API zwraca błąd, a nie ile ma testów.

Najczęstsze pytania

Czy jedno konto w Mirakl otwiera wszystkich operatorów?

Nie. Każdy operator akceptuje Cię osobno, według własnego procesu handlowego. Wykorzystać ponownie można integrację techniczną, a nie relację handlową.

Czy mogę mieć różne ceny u różnych operatorów?

Tak i powinieneś: prowizje nie są takie same. W konektorze każdy operator to instancja, a każda instancja wylicza cenę według własnej strategii: cena sprzedaży produktu, cennik Odoo albo koszt plus marża.

Co z rozliczeniami?

Przychodzą osobno dla każdego operatora i trzeba je uzgodnić ze sprzedażą, po odliczeniu prowizji. To najczęściej zaniedbywana część i miejsce, w którym pieniądze znikają, zanim ktokolwiek to zauważy.

Przydatne linki w FlexigoTech

Konektor Mirakl dla OdooOferty, zamówienia, wysyłki i rozliczenia w wersjach 17, 18 i 19Sprzedaż w Decathlon MarketplaceCzego dokładnie wymaga ten operatorWiele marketplace'ów w jednym OdooJeden główny stan magazynowy dla Mirakl, Amazon i pozostałych

Co robimy w tym temacie

Konektor MiraklCo robi, zrzuty ekranu, wersje i cena.

Zaakceptowano Cię w marketplace'ie opartym na Mirakl?

Napisz, jaki to operator i ile produktów chcesz publikować. Sprawdzimy, czy Twój katalog spełnia to, czego od Ciebie zażądają, zanim go odrzucą. Napisz na comercial@flexigobe.com lub umów rozmowę.

Porozmawiaj z inżynierem