Naar hoofdinhoud
Mirakl

Een Mirakl-order in Odoo, van aankoop tot uitbetaling

Een order van een marketplace die op Mirakl draait, komt in Odoo langs zeven haltes: hij komt binnen, wordt geaccepteerd, klaargemaakt, verzonden met tracking, gefactureerd, uitbetaald in de afrekening en komt soms terug als retour. Deze tijdlijn vertelt je wat de connector bij elke halte doet en hoe vaak.

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

In het kort

Module
Mirakl
Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de connector, versie 20.0 · in de bronnen onderaan
Leestijd
3 min

Leroy Merlin, Decathlon of Bricodepot draaien onder de motorkap op Mirakl. Voor Odoo maakt de operator niet uit: de connector, gepubliceerd voor Odoo 17, 18, 19 en 20, praat met de Mirakl-API van elke marketplace die je instelt en volgt altijd hetzelfde schema.

De route

  1. Als de klant koopt De order ontstaat op de marketplace en wacht op acceptatie. Odoo weet nog van niets.
  2. Binnen de volgende 10 minuten De taak Mirakl - Sync Orders haalt hem naar Odoo. Hij verschijnt onder Mirakl › Operations › Orders met acceptatiestatus in afwachting.
  3. Bij de volgende acceptatieronde Mirakl - Accept Orders draait ook elke 10 minuten en accepteert wat je automatisch wilt laten accepteren. Vereist de marketplace geen acceptatie, dan wordt de status niet vereist; mislukt er iets, dan fout, in het zicht.
  4. Bij acceptatie De verkooporder in Odoo wordt aangemaakt met zijn regels en de klant. De voorraad wordt vastgelegd voor de andere kanalen.
  5. Als de levering is klaargemaakt en gevalideerd De tracking van de vervoerder gaat naar de marketplace. De trackingstatus van de order gaat van in afwachting naar gesynchroniseerd, of naar fout als Mirakl hem afwijst.
  6. Bij facturering De klantfactuur wordt in Odoo geboekt en daarna naar Mirakl verstuurd. De volgorde telt: een conceptfactuur wordt niet verstuurd.
  7. Als de afrekening binnenkomt Settlements & Invoices verzamelt de betalingen van de operator met hun status: in afwachting, in verwerking, overgemaakt of betaald. Elk document heeft ook zijn boekhoudstatus: niet geboekt, geboekt of afgeletterd.
  8. Als er een retour is Retouren worden elke 30 minuten gesynchroniseerd en verschijnen onder Operations › Returns. De terugbetaling heeft een eigen status: in afwachting, gedeeltelijk, terugbetaald of fout.
Lijst van Mirakl-orders in Odoo met acceptatie- en verzendstatus
Orders van een Mirakl-marketplace in Odoo, elk met zijn status. Schermafbeelding van Odoo met demogegevens.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (video in het Engels)

Ondertussen: voorraad en prijs

Terwijl de order vordert, houden drie andere taken de etalage actueel. Aanbiedingen gaan elke 5 minuten de deur uit. Voorraad gaat elke 10 minuten via de STO01-flow en prijzen elke 15 via PRI01. Reserveert een geaccepteerde order dus eenheden, dan zien de andere marketplaces dat binnen enkele minuten.

Odoo-verkooporder aangemaakt vanuit een Mirakl-order
De verkooporder die de connector bij acceptatie aanmaakt. Al het andere begint hier: levering, factuur en retour. Schermafbeelding van Odoo met demogegevens.

De twee waarschuwingen die je het vaakst ziet

Bij het versturen van de factuur kunnen twee meldingen verschijnen. Post the invoice before sending it to Mirakl. betekent dat de factuur nog een concept is: boek hem en verstuur hem opnieuw. This invoice is not linked to a Mirakl order. verschijnt als de factuur niet uit een marketplace-order komt, bijvoorbeeld als je hem met de hand hebt aangemaakt. De oplossing is factureren vanuit de verkooporder zelf.

Gevalideerde levering van een Mirakl-order met de tracking al verstuurd
Gevalideerde levering: de tracking is al naar de marketplace gegaan. Schermafbeelding van Odoo met demogegevens.

Wat niet vanzelf draait

De factuursynchronisatie vanuit Mirakl, die één keer per dag draait, staat na de installatie uit: je zet hem aan als je operator hem gebruikt. Ook klantberichten worden niet automatisch ingeschakeld. Zo komt er in Odoo geen informatie terecht waar niemand naar kijkt.

Bekijk de video op YouTube
Demovideo van de Mirakl-connector in Odoo, met de Mirakl-API gesimuleerd.

Wil je weten waarom een order vastzit, kijk dan eerst naar zijn acceptatiestatus en zijn trackingstatus in de lijst. Bijna altijd staat een van de twee op fout, en de melding vertelt je waarom.

Lees verder

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.Voorbeeld: een fabrikant die met spreadsheets op meerdere Mirakl-marketplaces verkooptVoorbeeldcasus van een fabrikant die met spreadsheets op meerdere Mirakl-marketplaces verkoopt, en wat er verandert als alles met de connector naar Odoo gaat.
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen

Bronnen

  • Broncode van de module: flexigobe_mirakl_connector 20.0 (83e54909): data/ir_cron_data.xml
  • Broncode van de module: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_finance.py
  • Broncode van de module: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_invoice.py
  • Broncode van de module: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_order.py
  • Broncode van de module: flexigobe_mirakl_connector 20.0 (83e54909): models/stock_picking.py
  • Broncode van de module: flexigobe_mirakl_connector 20.0 (83e54909): models/account_move.py
  • Broncode van de module: flexigobe_mirakl_connector 20.0 (83e54909): views/menu_views.xml
  • apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
  • youtube.com/shorts/nbJU8l2bbCM