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
Co robimy w tym temacie
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ę.

