Naar hoofdinhoud
Mirakl

Velden van de Mirakl-instantie in Mirakl Connector: glossarium met wat je het best invult

De velden voor openstaande orders, retouren, facturen, berichten en acceptatie staan standaard uitgevinkt; van deze velden staat alleen Retouren terugvallen op orders standaard aangevinkt.

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 20.0 · in de bronnen onderaan
Leestijd
5 min

Op het formulier Mirakl instanties bepalen verschillende velden wat de Mirakl-connector naar Odoo ophaalt en wanneer. Je opent het formulier via Mirakl › Configuratie › Marktplaatsen. De velden en hun standaardwaarden zijn die uit de code van Odoo 20; de module is gepubliceerd voor Odoo 17, 18, 19 en 20.

Schema van het toegangsmenu en van het formulier van de Mirakl-instantie met zijn velden
Schema gemaakt met code op basis van de gepubliceerde code van de module (geen schermafbeelding van Odoo): het toegangsmenu en het formulier met de velden, met hun oorspronkelijke labels uit de code.

De velden staan op twee tabbladen: Orders en retouren (Orders and Returns) en Facturen en berichten.

Openstaande orders: opnieuw lezen wat al in Odoo staat

Status van openstaande bestellingen bijwerken
Selectievakje op het tabblad Orders en retouren, groep Windows. Staat standaard uitgevinkt. Volgens de hulptekst leest het na elke import elke order die al in Odoo staat en nog niet is afgerond (niet ontvangen, gesloten, geweigerd of geannuleerd) opnieuw in Mirakl uit en werkt het de status bij, ook als de order van vóór het importvenster is. Zonder dit vakje blijft een order waarvan de status op de marktplaats lang na aanmaak verandert, in Odoo met de oude status staan. Wat invullen: vink het aan als je wilt dat die late wijzigingen in Odoo aankomen.
Openstaande bestellingen bijgewerkt per run
Geheel getal in dezelfde groep Windows. Verschijnt alleen als het vorige vakje is aangevinkt, dus met de standaardwaarden zie je het niet. De standaardwaarde is 100. De hulptekst zegt dat dit het maximum aantal openstaande orders is dat per run opnieuw in Mirakl wordt gelezen, en dat eerst de orders worden gelezen die het langst niet zijn bijgewerkt, zodat alles wat openstaat in opeenvolgende runs wordt afgedekt. Wat invullen: je kunt beginnen met de standaardwaarde; de hulptekst zelf geeft aan dat wat openstaat niet in één run hoeft te passen.
Schema met de hulptekst van het veld Status van openstaande bestellingen bijwerken zoals de gebruiker die ziet, afhankelijk van de taal van zijn Odoo
Schema gemaakt met code op basis van de gepubliceerde vertalingen van de module (geen schermafbeelding van Odoo): dezelfde hulptekst in het Spaans, Duits, Frans, Italiaans en Portugees.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (video in het Engels)

Retouren: schakelaar, terugval en melding

Retoursynchronisatie ingeschakeld
Selectievakje in de groep Synchronisatiebeleid, tabblad Orders en retouren; het staat ook in de lijst van Mirakl instanties. Staat standaard uitgevinkt. De hulptekst: de generieke geplande import van Mirakl-retouren voor deze instantie inschakelen. De geplande taak Mirakl - Retouren synchroniseren draait elke 30 minuten en is actief na installatie. Wat invullen: vink het aan bij de instanties waarvan je retouren gepland wilt ophalen.
Retouren terugvallen op orders
Selectievakje in dezelfde groep; anders dan de vorige staat het standaard aangevinkt. De hulptekst zegt: als /returns niet beschikbaar is, worden generieke retourrecords opgebouwd uit de terugbetalingen die in de payloads van de orders staan. Wat invullen: laat het staan zoals het is als je die terugval wilt; vink het alleen uit als je dat niet wilt.
Retoureindpunt niet beschikbaar
Alleen-lezen selectievakje in dezelfde groep: je vult het niet zelf in. De hulptekst zegt dat het automatisch wordt ingesteld wanneer /returns een 404 teruggeeft, zodat de geplande synchronisatie het endpoint overslaat tot het handmatig opnieuw wordt geprobeerd. Wie het leegmaakt, is de code van de retoursynchronisatie, die je bereikt via de knop Retouren importeren en via de geplande taak. Waar op letten: als het is aangevinkt, slaat de geplande synchronisatie dat endpoint over.

Orders accepteren en bevestigen

De drie volgende velden staan in Synchronisatiebeleid en staan standaard uitgevinkt. Hun hulpteksten beschrijven verschillende dingen, dus lees ze een voor een.

Orders automatisch accepteren
De hulptekst: geïmporteerde orders waarvoor acceptatie door de verkoper in Mirakl nodig is, automatisch accepteren. Wat invullen: vink het aan als je wilt dat die acceptatie vanzelf gebeurt.
In behandeling accepteren bij import
De hulptekst: proberen de wachtende orders te accepteren direct na elke order-import, handmatig of gepland.
Verkoop automatisch bevestigen
De hulptekst: de geïmporteerde verkooporders na de synchronisatie automatisch bevestigen. Wat invullen: vink het alleen aan als je wilt dat die verkooporders zonder tussenkomst van een persoon worden bevestigd.

Facturen (afrekeningen)

Ze staan op het tabblad Facturen en berichten, groep Facturen (Afrekeningen).

Factuursynchronisatie ingeschakeld
Staat standaard uitgevinkt. De hulptekst: de geplande synchronisatie van facturen voor deze instantie inschakelen. De taak Mirakl - Facturen synchroniseren draait één keer per dag en is na installatie uitgeschakeld.
Initiële factuursynchronisatiedagen
Geheel getal met standaardwaarde 90. De hulptekst definieert het als het historische venster, in dagen, voor de handmatige synchronisatie van facturen. Wat invullen: het aantal dagen historie dat je wilt ophalen als je de synchronisatie handmatig start.
Facturen-endpoint niet beschikbaar
Alleen-lezen selectievakje. Het wordt automatisch ingesteld wanneer /invoices een 404 teruggeeft, zodat de geplande synchronisatie het endpoint overslaat tot het handmatig opnieuw wordt geprobeerd. De code van de factuursynchronisatie maakt het leeg; die bereik je via de knop Facturen importeren en via de geplande taak.

Berichten

Op hetzelfde tabblad, groep Berichten.

Berichtensynchronisatie ingeschakeld
Staat standaard uitgevinkt. De hulptekst: de geplande synchronisatie van berichten voor deze instantie inschakelen. De taak Mirakl - Berichten synchroniseren draait elke 30 minuten en is na installatie uitgeschakeld.
Initiële berichtsynchronisatiedagen
Geheel getal met standaardwaarde 30. Volgens de hulptekst is het het historische venster, in dagen, voor de handmatige synchronisatie van berichten.
Berichten-endpoint niet beschikbaar
Alleen-lezen selectievakje. Het wordt automatisch ingesteld wanneer /messages 410 Gone of 404 teruggeeft (niet beschikbaar gesteld door deze operator), en de geplande synchronisatie slaat het endpoint over tot het handmatig opnieuw wordt geprobeerd. De code van de berichtensynchronisatie maakt het leeg; die bereik je via de knop Berichten importeren en via de geplande taak.

Hoe het past bij FlexigoTech

De verbinding met Mirakl loopt via FlexigoTech Cloud: het bewaart de inloggegevens versleuteld, bewaakt de synchronisatie en waarschuwt per e-mail als er iets misgaat. De module heeft dat abonnement nodig, plan Connector: € 49 per maand of € 490 per jaar, excl. btw. Zonder abonnement, of met de dienst opgeschort, stopt wat het abonnement levert en blijven de gegevens in je Odoo staan. Je vindt de module op zijn Odoo Apps-pagina en op de pagina van FlexigoTech.

Als je Odoo implementeert en met hulp wilt bepalen welk synchronisatiebeleid bij elke marktplaats past: FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectors en integraties op maat.

Lees verder

Checklist Mirakl Connector-instantie, veld voor veldChecklist om de Mirakl Connector-instantie in Odoo in te vullen: verbinding, afrekeningsrekeningen en opties, met wat de helptekst van elk veld zegt.Velden van de Mirakl-instantie in Mirakl Connector: wat ze betekenen en wat je invultVergelijkende gids van de velden in het formulier Mirakl instanties van Mirakl Connector voor Odoo: wat de help zegt, de standaardwaarde en wat je invult.
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen

Bronnen