Leroy Merlin for Mirakl in Odoo: wat het dekt, wat je vooraf nodig hebt en welke versie

Wat Leroy Merlin for Mirakl toevoegt aan de Mirakl-connector

Deze module leunt op een andere module. Volgens de README voegt hij Leroy Merlin toe als provideroptie binnen de generieke Mirakl-connector. De technische naam is flexigobe_mirakl_provider_leroy_merlin en in de technische notities staat flexigobe_mirakl_connector als vereiste. Dit levert hij op, volgens het onderdeel «Why This Module»:

• Laadt vooraf de Mirakl-URL's van ADEO en Leroy en de standaardwaarden van de provider.
• Verbetert de automatische herkenning van het platform tijdens de verbindingstests.
• Past de synchronisatie van catalogusattributen aan op CSV-stromen in Leroy-stijl.
• Stemt het gedrag van woordenlijsten en waardenlijsten af op de catalogusstructuren van Leroy.
• Vult bepaalde booleaanse Leroy-attributen met veilige standaardwaarden.
• Houdt de import van Leroy-retouren in stand en valt daarbij terug op de terugbetalingen van de order.
• Activeert de geavanceerde trackingstroom die de generieke Mirakl-kern gebruikt.

De waarden die hij kant-en-klaar instelt

De README beschrijft wat de module standaard meebrengt: de providerwaarde Leroy Merlin, de marketplace-profielcode leroy_merlin, de basis-URL https://adeo-marketplace.mirakl.net en de API-URL https://adeo-marketplace.mirakl.net/api. De btw-modus van de aanbiedingen staat op include_sales_taxes en catalogus en aanbiedingen gebruiken standaardwaarden in het formaat van de operator. Voor het herkennen van het platform gebruikt hij de handtekeningen adeo-marketplace en leroy merlin.

In het catalogusdeel zet de module de woordenlijsten in de modus voor attribuutsynchronisatie via CSV, gebruikt hij een grotere batchgrootte voor woordenlijsten bij Leroy-imports, schakelt hij de bulk-terugval van waardenlijsten en het vooraf laden uit waar de Leroy-stromen daarbij winnen, en past hij False/NO toe als standaard bij bepaalde catalogusattributen.

Bij orders, retouren en verzendingen doet de module bovendien het volgende:

• Laat de synchronisatie van retouren ingeschakeld, met terugval op de terugbetalingen die in de ordergegevens staan.
• Activeert de geavanceerde hooks voor het volgen van zendingen bovenop de generieke Mirakl-kern.
• Activeert het herstel van het afleveradres vóór de validatie in het magazijn wanneer dat nodig is.

Wat bij de generieke Mirakl-kern blijft

Om te beslissen is het goed te weten wat de generieke connector oplost waarop deze module leunt. De operationele notities van de README zeggen het zo:

• De echte vervoerderscatalogi van ADEO worden gedekt door de SH21-stroom van de generieke Mirakl-connector.
• De categoriebomen van Leroy worden beheerd met het hiërarchie-zoeken van de generieke connector.
• Als de operator /returns niet beschikbaar stelt, kan de generieke kern toch de retourrecords aanmaken op basis van de terugbetalingen in de geïmporteerde orders.

De README noemt ook de modellen mirakl.instance en mirakl.product.binding. De fundamentele beslissing is dus of je met de generieke Mirakl-connector gaat werken, want deze module geeft hem op als vereiste.

Wat je nodig hebt voordat je installeert

Twee onderdelen: de generieke Mirakl-connector en het abonnement op FlexigoTech Cloud dat die connector vraagt. Het manifest van Mirakl Connector zegt het letterlijk: «Needs FlexigoTech Cloud subscription (from 49 EUR/month, VAT excl.)». De verbinding loopt via FlexigoTech Cloud, dat de inloggegevens versleuteld bewaart, de synchronisatie bewaakt en per e-mail waarschuwt als die mislukt; als het platform zijn API wijzigt, worden de module en de dienst aangepast.

Zonder het abonnement, of met een opgeschorte dienst, stopt wat het abonnement levert; de gegevens blijven in je Odoo.

Voor welke Odoo-versies het is gepubliceerd en wat het kost

Leroy Merlin for Mirakl is een gratis aanvulling: de € 9 excl. btw die op de vermelding staan, zijn de prijs van Mirakl Connector, waarvan hij afhangt, als eenmalige betaling per Odoo-versie, gelijk voor 17, 18, 19 en 20. Daar komt het abonnement op het plan Connector van FlexigoTech Cloud bij: € 49 per maand of € 490 per jaar excl. btw, met maximaal 3 accounts van het platform (Pro: € 98 per maand of € 980 per jaar, maximaal 10).

Wat verandert er als je naar een nieuwere Odoo-versie gaat

Als je de module op flexigotech.com hebt gekocht en het abonnement hebt, is de module voor de nieuwe Odoo-versies inbegrepen. Als je hem in de Odoo App Store hebt gekocht, koop je daar elke Odoo-versie apart. Controleer vóór de migratie dat je in de doelversie ook flexigobe_mirakl_connector hebt, want dat is zijn vereiste.

Criteria om te beslissen of het bij je past

• Als je op Leroy Merlin verkoopt via Mirakl en de generieke connector al met zijn abonnement hebt, is het een goede keuze: de module voegt het profiel leroy_merlin toe met zijn URL's en standaardwaarden.
• Als je de generieke Mirakl-connector nog niet hebt, heb je eerst die en het abonnement op FlexigoTech Cloud nodig.
• Als je werk met Leroy via catalogus-woordenlijsten en waardenlijsten loopt, zijn de instellingen voor CSV, batchgrootte en False/NO het deel van de module dat daarop werkt.
• Als je Leroy-retouren importeert, laat de module de synchronisatie ingeschakeld, met terugval op de terugbetalingen van de orders.
• Als je ADEO-vervoerders of categoriebomen van Leroy nodig hebt, houd er dan rekening mee dat ze vanuit de generieke kern worden beheerd (SH21-stroom en hiërarchie-zoeken).
• Als je verkoopt op marketplaces buiten Mirakl, is deze module daar niet voor bedoeld. Als dat jouw geval is met Shopee, lees dan hoe de Shopee-connector van binnen werkt.

Hoe je het test voordat je live gaat

Een testdatabase in jouw Odoo-versie volstaat om te zien of het bij je past:

1. Activeer het abonnement op FlexigoTech Cloud dat Mirakl Connector vraagt.
2. Installeer de generieke connector flexigobe_mirakl_connector.
3. Installeer flexigobe_mirakl_provider_leroy_merlin.
4. Maak de Mirakl-instantie aan, kies Leroy Merlin als provider en controleer of de basis-URL en de API-URL die zijn die de module vooraf laadt.
5. Start de verbindingstest, want daar past de module zijn automatische platformherkenning toe.
6. Controleer de attributen, de categoriemapping en de Mirakl-categorieën met jouw gegevens.

Zo helpt FlexigoTech je

FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat. De details van de module vind je op zijn pagina op flexigotech.com en in de vermelding in Odoo Apps. Als jouw situatie met Leroy Merlin of een andere Mirakl-operator meer vraagt, bekijken we dat als maatwerk.

Lees verder

Gecontroleerd in de broncode van de module (versie 20.0) en in de gelinkte bronnen

Bronnen

• Broncode van de module: flexigobe_mirakl_provider_leroy_merlin 20.0 (f3f10df8): README.md
• Broncode van de module: flexigobe_mirakl_provider_leroy_merlin 20.0 (f3f10df8): README.md:45-46
• apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_provider_leroy_merlin
• apps.odoo.com/apps/modules/17.0/flexigobe_mirakl_provider_leroy_merlin
• apps.odoo.com/apps/modules/18.0/flexigobe_mirakl_provider_leroy_merlin
• apps.odoo.com/apps/modules/19.0/flexigobe_mirakl_provider_leroy_merlin
• flexigotech.com/en/services.html
• flexigotech.com/precios.html