Naar hoofdinhoud
Mirakl

Zo zet je Leroy Merlin of Decathlon op in de Mirakl-connector

Leroy Merlin en Decathlon verkopen via Mirakl, en in Odoo zet je elk van beide op als een extra marktplaats van de Mirakl-connector. Wat verandert is het operatorprofiel: met de module van Leroy Merlin of die van Decathlon geïnstalleerd kies je het profiel in "Provider Code" en zet Odoo de vinkjes voor bestellingen en retouren die je nodig hebt, vult het adres van de operator in en stuurt bij het valideren van een afleveringsbon de tracking naar Mirakl, zonder dat je ergens op hoeft te klikken.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 5 november 2026

In het kort

Module
Mirakl
Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de connector, versie 17.0, 18.0, 19.0 en 20.0
Leestijd
5 min

De operator instellen

  1. Installeer de Mirakl-connector en de operatormodule: "Leroy Merlin for Mirakl" of "Decathlon for Mirakl". Zonder die module biedt "Provider Code" alleen "Generic Mirakl" aan.
  2. Ga naar Mirakl › Configuration › Marketplaces en maak een nieuwe marktplaats aan.
  3. Kies in "Provider Code" Leroy Merlin of Decathlon. Odoo vult op dat moment de vinkjes van het profiel die nog uit staan en de lege velden in.
  4. Controleer het adres. Voor Leroy Merlin is dat https://adeo-marketplace.mirakl.net, met de API op https://adeo-marketplace.mirakl.net/api; voor Decathlon marketplace-decathlon-eu.mirakl.net.
  5. Vul de verbinding aan met je accountgegevens van de operator, sla op en klik op "Test Connection".
Lijst van Mirakl-marktplaatsen in Odoo, één per operator, met hun providercode en de laatste verbindingstest
Eén marktplaats per operator onder Mirakl › Configuration › Marketplaces. De operatormodules zijn niet geïnstalleerd in deze demodatabase, dus alle drie gebruiken "Generic Mirakl". Odoo-schermafbeelding met demogegevens.

Als je met het generieke profiel begint en het adres van de operator intypt, herkent Odoo die aan de host: adeo-marketplace of leroymerlin voor Leroy Merlin; marketplace-decathlon, marketplace.decathlon, seller.decathlon, partner.decathlon, .decathlon.net of .decathlon.com voor Decathlon. En als je van de ene operator naar de andere overstapt, wordt het adres van de vorige operator vervangen door dat van de nieuwe. Een met de hand ingetypt adres dat bij geen enkele bekende operator hoort, blijft ongemoeid.

Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (video in het Engels)

Wat het profiel aanvinkt

VinkjeGeneriek profielLeroy Merlin en DecathlonWaarvoor het dient
Sync Orders EnabledUitAanDe taak "Mirakl - Sync Orders" importeert de bestellingen elke 10 minuten
Auto Accept OrdersUitAanDe taak "Mirakl - Accept Orders" accepteert elke 10 minuten de bestellingen die Mirakl op jouw acceptatie laat wachten
Accept Pending On ImportUitAanProbeert wachtende bestellingen direct na elke import te accepteren, handmatig of gepland
Auto Confirm SaleUitAanBevestigt de geïmporteerde verkooporders
Sync Returns EnabledUitAanDe taak "Mirakl - Sync Returns" haalt elke 30 minuten de retouren op
Returns Fallback To OrdersAanAanAls de operator via de API geen retouren aanbiedt, maakt Odoo ze aan op basis van de terugbetalingen in de bestellingen

Het profiel vult alleen in wat leeg is of uit staat. Een waarde die je al had ingesteld blijft staan. Dat speelt bij "Offer Price Tax Mode": het profiel bevat "Include Sales Taxes", maar het veld staat al op "As Computed", dus als je het profiel op het formulier kiest, verandert dat niet. Bepaal zelf hoe je de prijzen van je aanbiedingen opgeeft en zet dat vast voordat je exporteert.

Leroy Merlin: catalogus en aanbiedingen in het formaat van de operator

Het profiel van Leroy Merlin zet nog twee vinkjes aan, die standaard uit staan en die het profiel van Decathlon niet aanraakt:

  • De catalogus exporteren in het formaat van de operator. De help van het veld luidt zo: When enabled, catalog export defaults to Mirakl operator-format multipart CSV instead of raw JSON.
  • De aanbiedingen exporteren met de import van OF01-bestanden in het formaat van de operator: When enabled, offer export defaults to Mirakl OF01 operator-format multipart file import.

Als je exporteert vanuit een marktplaats zonder het profiel van Leroy Merlin, controleer dan deze twee vinkjes voordat je de catalogus de schuld geeft.

De verzending gaat uit bij het valideren van de afleveringsbon

Met deze twee profielen is het valideren van de aflevering van een Mirakl-bestelling in Odoo genoeg om de marktplaats te informeren, ook als het vinkje "Send Tracking to Mirakl on Validation" uit staat, zoals het standaard is. Bij het generieke profiel bepaalt dat vinkje het.

Voordat het valideert, werkt Odoo de verkooporder bij met die van Mirakl en zet het leveringscontact van de koper op de overdracht. Als bij dat contact de straat, de stad, de postcode of het telefoonnummer ontbreekt, vraagt Odoo de bestelling opnieuw op bij Mirakl en bouwt die opnieuw op.

Daarna gaat de verzending in twee stappen. Eerst de tracking (OR23). Als Mirakl de bestelling nog niet als verzonden toont, markeert Odoo die als verzonden (OR24). Als de operator de eerste stap weigert, bijvoorbeeld met een 404 of omdat hij de transportcode niet herkent, gaat Odoo meteen naar de tweede. En als je transporteur in Odoo alleen naar OTHER wordt vertaald, gebruikt Odoo de transporteur die bij de Mirakl-bestelling zat.

Gevalideerde aflevering van een Mirakl-bestelling met de knop Push Mirakl Tracking en de tracking in status Synced
Een gevalideerde aflevering: de knop "Push Mirakl Tracking", de tracking in status Synced, het laatste verzoek naar Mirakl en, in de historiek, "Mirakl tracking pushed successfully.". Odoo-schermafbeelding met demogegevens.

Als de afleveringsbon geen trackingnummer heeft

Er wordt niets verstuurd. Odoo schrijft dat op de overdracht: Shipment not sent to Mirakl: this transfer has no tracking reference. Add the carrier's tracking number to the delivery and click Push Mirakl Tracking to notify the marketplace. Vul het nummer van de transporteur in en klik op "Push Mirakl Tracking", dat de tracking handmatig verstuurt.

Als de orderregels ontbreken

Met deze twee profielen heeft de verzending de orderregels van de Mirakl-bestelling nodig. Als Odoo die noch in de Mirakl-bestelling noch in de verkooporder vindt, stopt het met Missing Mirakl order lines to push tracking.

Kan ik Leroy Merlin en Decathlon in dezelfde Odoo hebben?

Ja. Elke operator is een aparte marktplaats onder Mirakl › Configuration › Marketplaces, met een eigen profiel, eigen sleutel en eigen shop.

En als ik niet wil dat bestellingen vanzelf worden geaccepteerd?

Zet "Auto Accept Orders" en "Accept Pending On Import" uit nadat je het profiel hebt gekozen en sla op: wat je met de hand instelt, wint het van het profiel. Als je later opnieuw het profiel kiest in "Provider Code", zet het ze weer aan.

Lees verder

Een Mirakl-order in Odoo, van aankoop tot uitbetalingTijdlijn van een order van een Mirakl-marketplace in Odoo 17, 18, 19 en 20: acceptatie, verzending, tracking, retour, factuur en afrekening.Zo koppel je Mirakl-categorieën en -attributen in Odoo, stap voor stapZo bereid je in Odoo de catalogus voor een Mirakl-marketplace voor: categoriewoordenboek, attributen, waardelijsten, mapping en export, met de gebruikelijke fouten.Leroy Merlin Connector in Odoo instellen: vragen en antwoordenWelke velden je invult in Leroy Merlin Connector voor Odoo, welke statussen de tracking doorloopt en wat je de eerste week na het koppelen controleert.
Gecontroleerd in de broncode van de connector (versie 17.0, 18.0, 19.0 en 20.0)

Bronnen

  • Broncode van de module: flexigobe_mirakl_connector · 17.0 f10058e · 18.0 0d42567 · 19.0 9939dcd · 20.0 5c53911: models/mirakl_instance.py (_onchange_provider_code, _apply_provider_defaults_to_record, _should_apply_provider_default), views/menu_views.xml, views/mirakl_instance_views.xml; flexigobe_mirakl_provider_leroy_merlin · 17.0 e4e5b5d · 18.0 01707b8 · 19.0 6e605bb · 20.0 f3f10df y flexigobe_mirakl_provider_decathlon · 17.0 d6944fe · 18.0 8b78e2d · 19.0 c0c6021 · 20.0 80e11d3: models/mirakl_instance.py (_mirakl_provider_default_values)
  • Broncode van de module: flexigobe_mirakl_connector · 17.0 f10058e · 18.0 0d42567 · 19.0 9939dcd · 20.0 5c53911: models/mirakl_instance.py (cron_sync_orders, cron_accept_orders, cron_sync_returns), data/ir_cron_data.xml
  • Broncode van de module: flexigobe_mirakl_connector · 17.0 f10058e · 18.0 0d42567 · 19.0 9939dcd · 20.0 5c53911: models/mirakl_instance.py (_mirakl_provider_known_hosts, _onchange_connection_urls, _mirakl_detect_provider_from_urls); proveedores Leroy Merlin y Decathlon (mismos commits que mir.prov.perfil): _mirakl_provider_detection_signatures
  • Broncode van de module: flexigobe_mirakl_provider_leroy_merlin · 17.0 e4e5b5d · 18.0 01707b8 · 19.0 6e605bb · 20.0 f3f10df: models/mirakl_instance.py; flexigobe_mirakl_provider_decathlon (commits de mir.prov.perfil): models/mirakl_instance.py; flexigobe_mirakl_connector (commits de mir.prov.perfil): models/mirakl_marketplace_profile_mixin.py
  • Broncode van de module: flexigobe_mirakl_connector · 17.0 f10058e · 18.0 0d42567 · 19.0 9939dcd · 20.0 5c53911: models/stock_picking.py (button_validate, _mirakl_sync_sale_shipping_contacts, action_mirakl_push_tracking), models/mirakl_instance.py (_mirakl_auto_push_tracking_on_validate), views/stock_picking_views.xml; proveedores Leroy Merlin y Decathlon: _mirakl_auto_push_tracking_on_validate y _mirakl_repair_shipping_before_validate devuelven True
  • Broncode van de module: flexigobe_mirakl_connector · 17.0 f10058e · 18.0 0d42567 · 19.0 9939dcd · 20.0 5c53911: models/mirakl_instance.py (push de seguimiento con _mirakl_supports_advanced_tracking_flow)