Naar hoofdinhoud
Mirakl

De taak «Mirakl - Orders synchroniseren»: wat ze doet en wat je checkt als er niets gebeurt

Mirakl - Orders synchroniseren (Mirakl - Sync Orders) draait elke 10 minuten vanaf het moment dat je Mirakl Connector installeert en importeert bij elke run de bestellingen van elke marktplaats die aan de beurt is, en controleert de bestellingen die nog openstaan. Doet ze niets, dan zijn er maar een paar voorwaarden die haar buiten spel zetten: wie haar start, welke marktplaatsen meedoen, het eigen interval van elk ervan en de verbinding met FlexigoTech Cloud.

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

Wat de taak bij elke run doet

Met code gemaakt schema: bovenaan de geplande taak voor het synchroniseren van bestellingen, die elke 10 minuten draait en na installatie actief is, en eronder het menu van de marktplaatsen, met de labels in het Engels
Met code gemaakt schema op basis van de gepubliceerde code van de module, geen Odoo-scherm: de taak elke 10 minuten, actief na installatie (Odoo 17, 18, 19 en 20), en het menu van de marktplaatsen.

Wat doet Mirakl - Orders synchroniseren bij elke run?

Volgens de code van Odoo 20.0 verloopt een run in deze volgorde. Eerst controleert ze of wie haar uitvoert beheerder is. Daarna neemt ze de actieve marktplaatsen waarvoor de synchronisatie van bestellingen is ingeschakeld en houdt ze die over die ze kan aanroepen (hieronder lees je welke wegvallen). Voor elke marktplaats die volgens zijn interval aan de beurt is, importeert ze de bestellingen en controleert ze vervolgens de openstaande bestellingen die al in Odoo staan. Daarna gaat ze door naar de volgende marktplaats.

Hoe vaak draait ze en hoe heet ze in mijn Odoo?

Ze draait elke 10 minuten en is na installatie van de module actief. Ze zit in alle gepubliceerde versies (Odoo 17, 18, 19 en 20) en in Odoo 17.0 herhaalt ze zich eindeloos. Met Odoo in het Nederlands heet ze Mirakl - Orders synchroniseren; in het volgende schema zie je haar naam in andere talen.

Met code gemaakt schema met de naam van de taak per taal: in het Nederlands Mirakl - Orders synchroniseren, in het Duits Mirakl - Bestellungen synchronisieren, in het Frans Mirakl - Synchroniser les commandes, in het Italiaans Mirakl - Sincronizza ordini en in het Portugees Mirakl - Sincronizar Encomendas
Met code gemaakt schema op basis van de gepubliceerde vertalingen van de module, geen Odoo-scherm: de naam van de taak in het Nederlands, Duits, Frans, Italiaans en Portugees.

Importeert ze bij elke run alle marktplaatsen?

Niet noodzakelijk: het hangt af van het eigen interval van elke marktplaats. Heeft een marktplaats geen interval (de standaardwaarde), dan importeert ze bij elke run, dus elke 10 minuten. Heeft ze wel een interval en bestaat er al een eerdere synchronisatie van bestellingen, dan wacht de marktplaats tot die tijd sinds de laatste verstreken is; is er nog geen, dan importeert ze. De taak wordt nog steeds elke 10 minuten wakker, maar die marktplaats slaat de runs over tot hij aan de beurt is.

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

Wat ze bij Mirakl uitleest en wat ze daarna controleert

Wat vraagt ze aan Mirakl bij het importeren van bestellingen en wanneer stopt ze met vragen?

Ze vraagt de bestellingen per pagina op, met een paginagrootte en een maximum aantal pagina's per run, vanaf een tijdstip als startpunt. Elke bestelling wordt apart opgeslagen: faalt er één, dan blijft er een logregel van niveau fout met de referentie van de bestelling achter en gaat de run door met de andere. Ze stopt met vragen wanneer een pagina minder bestellingen bevat dan de paginagrootte of wanneer ze het totaal heeft gelezen dat het antwoord aangeeft; raakt het maximum aantal pagina's op, dan noteert ze een logregel van niveau waarschuwing. En komt er een pagina zonder bestellingen binnen en herkent de connector de vorm van het antwoord niet, dan behandelt ze die niet als een lege pagina: ze noteert een fout en stopt met pagina's opvragen.

Waar dient de controle van openstaande bestellingen voor?

De incrementele import kijkt alleen naar een recent tijdvenster. Daarom leest de taak na het importeren de bestellingen opnieuw uit die al in Odoo staan en nog niet zijn afgerond: zo komt een statuswijziging die lang na het aanmaken van de bestelling op de marktplaats is gedaan toch in Odoo terecht. Ze draait alleen als die controle voor de marktplaats is ingeschakeld; anders doet ze niets. Ze leest de bestellingen in batches: faalt een batch, dan noteert ze dat in het serverlog en probeert ze het bestelling voor bestelling. Na elke batch markeert ze alle bestellingen ervan met de datum van de controle, ook die de marktplaats niet heeft teruggegeven, zodat een ontbrekende bestelling de rotatie van de andere niet blokkeert.

Wat je checkt als ze niets doet

Waarom verschijnt Alleen een beheerder kan deze geplande actie uitvoeren. (Only an administrator can run this scheduled action.)?

Het eerste wat de taak doet, is controleren of wie haar uitvoert beheerder is. Is dat niet zo, dan stopt ze met die melding en verwerkt ze geen enkele marktplaats.

Welke marktplaatsen laat een run buiten beschouwing?

De marktplaatsen die niet actief zijn of waarvoor de synchronisatie van bestellingen niet is ingeschakeld. Van de overgebleven marktplaatsen komen eerst die die niet via FlexigoTech Cloud lopen; de marktplaatsen die er wel via lopen worden alleen aangeroepen als ze een opgeslagen sleutel hebben, want zonder sleutel zou de dienst ze weigeren, en als de in jouw Odoo opgeslagen toestemming de dienst van de module niet omvat, wordt geen enkele van de marktplaatsen die via FlexigoTech Cloud lopen aangeroepen (die controle gebruikt het netwerk niet). Tot slot slaan de marktplaatsen met een eigen interval de run over tot ze aan de beurt zijn. De kaarten van de marktplaatsen open je via Mirakl › Configuratie › Marktplaatsen (Mirakl › Configuration › Marketplaces).

Wat gebeurt er als een marktplaats een fout geeft of FlexigoTech Cloud de verbinding pauzeert?

Er zijn twee wegen. Als een marktplaats met een fout faalt, wordt die in het serverlog geschreven, wordt een logregel van niveau fout met de foutmelding opgeslagen en gaat de taak door met de volgende marktplaats; omdat de controle van openstaande bestellingen binnen hetzelfde blok na de import komt, bereikt die marktplaats haar in die run niet. Pauzeert FlexigoTech Cloud daarentegen de verbinding, dan stopt de taak in die run met het doorlopen van marktplaatsen en gaat de volgende run verder; de directe marktplaatsen komen eerst, zodat er geen achterblijft. De pauze telt alleen mee in het gezondheidsrapport van FlexigoTech Cloud, met codes en nooit tekst. Komt de pauze tijdens de controle van openstaande bestellingen, dan wordt de batch die werd gelezen niet gemarkeerd; de al afgeronde batches behouden hun controledatum.

Heb ik het abonnement op FlexigoTech Cloud nodig?

Ja. Mirakl Connector is een eenmalige betaling per versie en vereist het abonnement op FlexigoTech Cloud, plan Connector: € 49 per maand of € 490 per jaar, excl. btw, tot 3 accounts van het platform. Hij is gepubliceerd voor Odoo 17, 18, 19 en 20; de prijs per versie vind je op de productpagina en op de pagina van de module. De verbinding loopt via FlexigoTech Cloud: dat bewaart de inloggegevens versleuteld, bewaakt de synchronisatie en waarschuwt per e-mail als er iets misgaat. Zonder abonnement, of met de dienst opgeschort, stopt wat het abonnement levert; de gegevens blijven in je Odoo.

Als je Odoo aan het implementeren bent en met iemand wilt bekijken hoe deze synchronisatie eruitziet, implementeert FlexigoTech Odoo 17, 18, 19 en 20 en ontwikkelt het connectoren en integraties op maat.

Lees verder

De fout «Boek de factuur voordat je deze naar Mirakl verzendt.» in Mirakl ConnectorWanneer de fout «Boek de factuur voordat je deze naar Mirakl verzendt.» verschijnt in Mirakl Connector voor Odoo, wat de code controleert en hoe je het oplost.De taak «Mirakl - Orders accepteren», run voor runWat de geplande taak Mirakl - Orders accepteren van Mirakl Connector voor Odoo bij elke run doet, hoe vaak hij draait en wat je controleert als niets wordt…Wat de knop «Annuleren in Mirakl» van Mirakl Connector doet, stap voor stapWat doet de knop Annuleren in Mirakl van Mirakl Connector voor Odoo: wanneer je hem ziet, wat hij controleert, wat er in de order verandert en welke fouten er…
Gecontroleerd in de broncode van de connector (versie 17.0 en 20.0) en in de gelinkte bronnen

Bronnen