Naar hoofdinhoud
Mirakl

De taak «Mirakl - Retouren synchroniseren» van Mirakl Connector: wat ze doet en waar je op let

De geplande taak Mirakl - Retouren synchroniseren (Mirakl - Sync Returns) draait elke 30 minuten en staat standaard actief na installatie: bij elke ronde vraagt ze pagina per pagina de retouren op bij de actieve marktplaatsen waarvoor die synchronisatie is ingeschakeld. Lijkt ze niets te doen, kijk dan welke marktplaatsen buiten de ronde vallen, of FlexigoTech Cloud een pauze heeft ingelast en of de marktplaats met een 404 op de retouren heeft geantwoord.

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 ronde doet

De geplande taak Mirakl - Retouren synchroniseren zit in alle gepubliceerde versies van Mirakl Connector (Odoo 17, 18, 19 en 20), draait elke 30 minuten en staat standaard actief na installatie.

In Odoo 20.0 controleert de taak bij elke ronde of degene die haar uitvoert beheerder is, zoekt ze de actieve marktplaatsen waarvoor de synchronisatie van retouren is ingeschakeld, houdt ze de marktplaatsen over die ze kan aanroepen en vraagt ze per marktplaats de retouren pagina per pagina op en verwerkt ze die één voor één. De kaarten van de marktplaatsen open je via het menu Mirakl › Configuratie › Marktplaatsen; om het menu Mirakl te zien, volstaat het een interne Odoo-gebruiker te zijn.

Met code gemaakt schema: de geplande retourentaak, die elke 30 minuten draait, en het menu van de marktplaatsen
Schema gemaakt met code op basis van de gepubliceerde code van de module, geen schermafbeelding van Odoo: de taak, die elke 30 minuten draait en standaard actief staat na installatie (Odoo 17.0, 18.0, 19.0 en 20.0), en het menu van de marktplaatsen.

Met Odoo in het Nederlands heet de taak Mirakl - Retouren synchroniseren; het volgende schema toont haar naam in andere talen.

Schema met de naam van de taak in het Spaans, Duits, Frans, Italiaans en Portugees
Schema gemaakt met code op basis van de gepubliceerde vertalingen van de module, geen schermafbeelding van Odoo: de naam van de taak volgens de taal van Odoo.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (video in het Engels)

Hoe de taak zich gedraagt

Draait elke 30 minuten en vereist een beheerder

De frequentie is elke 30 minuten. In Odoo 17.0 herhaalt de taak zich eindeloos. In Odoo 20.0 controleert elke ronde als eerste de gebruiker: wordt ze gestart door iemand die geen beheerder is, dan stopt ze met Alleen een beheerder kan deze geplande actie uitvoeren. (Only an administrator can run this scheduled action.) en wordt geen enkele marktplaats verwerkt.

Niet alle marktplaatsen doen mee aan de ronde

In Odoo 20.0 vertrekt de zoekopdracht van de actieve marktplaatsen met ingeschakelde synchronisatie van retouren; de rest wordt niet aangeraakt. Daarna filtert de module de marktplaatsen die ze kan aanroepen: eerst die met directe verbinding en dan die via FlexigoTech Cloud, en van die laatste alleen die een opgeslagen sleutel hebben. Bovendien wordt, als de opgeslagen machtiging de dienst van de module niet omvat (dit wordt gecontroleerd zonder het netwerk op te gaan), geen enkele marktplaats via FlexigoTech Cloud aangeroepen in die ronde. De marktplaatsen met directe verbinding gaan gewoon door.

Een pauze van FlexigoTech Cloud kapt de rest van de ronde af

Laat FlexigoTech Cloud het verzoek niet door (omdat er geen abonnement is of de dienst gepauzeerd is), dan wordt niets gemarkeerd of gewist en stopt de ronde daar: de resterende marktplaatsen wachten op de volgende, die gewoon doorgaat. Daarom komen die met directe verbinding eerst: een pauze laat er geen enkele onverzorgd. De pauze telt alleen mee voor het gezondheidsrapport van FlexigoTech Cloud, met codes en nooit tekst. Zonder abonnement, of met opgeschorte dienst, stopt wat het abonnement biedt; de gegevens blijven in jouw Odoo.

Een fout bij één marktplaats houdt de andere niet tegen

Elke andere fout bij een marktplaats wordt genoteerd in het serverlog van Odoo en de module probeert een logregel van het type fout achter te laten met de tekst van de fout; daarna gaat ze naar de volgende marktplaats. Kan zelfs die regel niet worden geschreven, dan laat de module een waarschuwing achter in het serverlog, en die logfout vervangt de oorspronkelijke fout niet.

Als de marktplaats met een 404 op de retouren antwoordt

Antwoordt de marktplaats met een 404 (HTTP 404) op het verzoek om retouren, dan laat de module een logregel van het type waarschuwing achter met de tekst Retoureindpunt niet beschikbaar (HTTP 404). (Returns endpoint not available (HTTP 404).). Daarna schakelt de module, als de marktplaats de terugval via orders heeft ingeschakeld, over op een andere synchronisatiemethode; zo niet, dan schuift ze het tijdstip van de laatste synchronisatie van retouren naar dit moment op en eindigt ze zonder iets te verwerken.

Een antwoord dat de connector niet herkent is geen lege pagina

Komt er een pagina zonder retouren, dan eindigt de ronde van die marktplaats. Maar heeft het antwoord een vorm die de connector niet herkent, dan laat de module een logregel van het type fout achter en schuift ze het synchronisatievenster niet op, om geen retouren over te slaan die ze niet heeft gelezen.

Pagina's, limiet en wanneer ze stopt

De taak vraagt pagina's van een vaste grootte op, verwerkt elke retour en telt ze. Ze stopt wanneer een pagina minder retouren bevat dan de paginagrootte, wanneer ze al het totaal heeft gelezen dat de marktplaats aankondigt of wanneer ze de limiet van pagina's per ronde bereikt (minstens één pagina).

Wat je controleert als ze niets lijkt te doen

  • De taak staat tussen de geplande acties van Odoo met de naam Mirakl - Retouren synchroniseren en is actief.
  • De marktplaats is actief en de synchronisatie van retouren is ingeschakeld; anders valt ze buiten de zoekopdracht (haar kaarten open je via Mirakl › Configuratie › Marktplaatsen).
  • Verbindt ze via FlexigoTech Cloud, dan heeft ze een opgeslagen sleutel en is de dienst van kracht. FlexigoTech Cloud bewaakt de synchronisatie en waarschuwt per e-mail als ze mislukt.
  • Gaf een andere marktplaats in dezelfde ronde een pauze van FlexigoTech Cloud, dan is de ronde afgekapt en wachten de resterende op de volgende.
  • Antwoordde de marktplaats met een 404, zoek dan een logregel van het type waarschuwing met de tekst Retoureindpunt niet beschikbaar (HTTP 404).
  • Is er een logregel van het type fout, lees dan de tekst ervan: dat is de fout van die marktplaats.

Hoe FlexigoTech helpt

FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat. Mirakl Connector is een module met eenmalige betaling per versie en vereist het abonnement op FlexigoTech Cloud (plan Connector: € 49 per maand of € 490 per jaar, excl. btw). Je kunt de module bekijken op haar pagina of op de vermelding in Odoo Apps.

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