De meest voorkomende vergissing met Mirakl is het te behandelen alsof het Amazon is. Dat is het niet. Mirakl is het platform waarmee Decathlon, Leroy Merlin, Bricodepot, GACD en tientallen andere ketens hun eigen marktplaats openstellen voor externe verkopers. Dat heeft voor jou één erg goed en één matig gevolg.
Het goede: de API is voor iedereen dezelfde. Een goed gebouwde Mirakl-integratie werkt voor je eerste operator en voor je vijfde, door de URL van de operator en de API-sleutel te wijzigen. Het matige: bovenop die gemeenschappelijke basis stelt elke operator zijn eigen regels (zijn categorieboom, zijn verplichte attributen, zijn termijnen, zijn boetes en zelfs welke onderdelen van de API hij openstelt) en die worden niet gedeeld.
Wat ze allemaal delen
De cyclus is altijd dezelfde: je publiceert aanbiedingen (product, prijs, voorraad, levertijd), de operator stuurt je bestellingen, jij accepteert of weigert ze, je verzendt met tracking en je wordt betaald via afrekening. De Mirakl-connector brengt die cyclus naar gewone Odoo-documenten in 17, 18 en 19: hij publiceert aanbiedingen met prijs, voorraad en verzendtermijn, importeert de bestellingen als verkooporders, accepteert ze (handmatig of automatisch als je dat inschakelt), stuurt de vervoerder en het trackingnummer van de levering naar Mirakl en importeert de afrekeningen om ze in de boekhouding te boeken.
Een detail dat verrast: in Mirakl kun je orderregels weigeren. Dat is geen fout, het hoort bij het protocol. Onze connector weigert geen losse regels: hij accepteert de hele bestelling. Als er een regel is die je niet kunt leveren, weiger die dan in de back office van Mirakl voordat je accepteert, en houd er rekening mee dat automatische acceptatie, die standaard uitstaat, alles accepteert wat binnenkomt.
Wat per operator verschilt
De categorieboom en de verplichte attributen, die bij een sportketen en een doe-het-zelfketen totaal niet op elkaar lijken. De acceptatietermijn, die bij sommige operators in uren wordt gemeten. En de eisen aan productgegevens: sommige operators weigeren een aanbieding zonder EAN, andere vragen daarnaast een volledig technisch blad.
Daarom hebben we naast de pagina van de connector ook een pagina per operator: Decathlon, Leroy Merlin, Brico Depot en GACD. De basisconnector is dezelfde en elke operator is een extra instantie, met eigen URL en sleutel; voor sommige operators is er ook een aanvullend profiel dat de URL en de standaardwaarden vooraf instelt. Wat echt verschilt, is de voorbereiding van de catalogus.
Wat je moet voorbereiden voordat je je aanmeldt
Drie dingen, en geen enkele is technisch. Een EAN bij elke referentie die je gaat publiceren: sommige operators accepteren de aanbieding anders niet. Een voorbereidingstermijn die je echt kunt halen, niet degene die je graag zou willen; 24 uur beloven en in 72 uur leveren betaal je op je account. En foto's die aan hun norm voldoen, die vaak strenger is dan die van je eigen website.
En een waarschuwing uit eigen ervaring
We hebben onze eigen Mirakl-connector geaudit terwijl de testsuite groen doorliep op Odoo 19, 18 en 17, en vonden 18 bevestigde fouten, waaronder een oproeplog die nooit iets wegschreef en een synchronisatie die naar de verkeerde datum keek. Het hele verhaal staat in een geërfde connector auditen. Als iemand je een Mirakl-integratie verkoopt, vraag dan wat er gebeurt als de API een fout teruggeeft, niet hoeveel tests hij heeft.
Veelgestelde vragen
Geeft een aanmelding bij Mirakl toegang tot alle operators?
Nee. Elke operator accepteert je afzonderlijk, met zijn eigen commerciële proces. Wat hergebruikt wordt is de technische integratie, niet de commerciële relatie.
Kan ik per operator andere prijzen hanteren?
Ja, en dat zou je moeten doen: de commissies zijn niet gelijk. In de connector is elke operator een instantie en elke instantie berekent zijn prijs met een eigen strategie: de verkoopprijs van het product, een Odoo-prijslijst of kostprijs plus marge.
Wat gebeurt er met de afrekeningen?
Ze komen per operator binnen en moeten worden afgestemd op de verkopen, na aftrek van commissie. Dit is het onderdeel dat het vaakst wordt verwaarloosd en waar het meeste geld wegvloeit zonder dat iemand het merkt.
Nuttige links binnen FlexigoTech
Wat wij hieraan doen
Ben je geaccepteerd op een Mirakl-marktplaats?
Vertel ons welke operator en hoeveel referenties je wilt publiceren. We controleren of je catalogus voldoet aan wat ze gaan vragen voordat ze hem afwijzen. Schrijf naar comercial@flexigobe.com of plan een gesprek.

