Naar hoofdinhoud

Mirakl

Berichten importeren in Mirakl Connector: wat de knop stap voor stap doet

De knop Berichten importeren vraagt de berichten van de instantie op bij de marktplaats, verwerkt ze en laat je met een succes- of waarschuwingsmelding weten hoe het ging. Hij staat altijd in het scherm Mirakl instanties, en de geplande taak doet elke 30 minuten een vergelijkbare import als je die activeert.

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

Wat de knop is en wanneer je hem ziet

De knop Berichten importeren staat in het scherm Mirakl instanties, dat je opent via het menu Mirakl › Configuratie › Marktplaatsen. Hij is altijd zichtbaar, in Odoo 17, 18, 19 en 20: geen enkele voorwaarde in de weergave verbergt hem. Hij werkt op de instantie die je open hebt staan.

Schema gemaakt met code van het menu Mirakl › Configuration › Marketplaces en van de knop Import Messages, met de labels in het Engels — Schema gemaakt met code (geen schermafbeelding van Odoo): het menu en de knop, met de Engelse labels van de oorspronkelijke tekst van de module. De knop zit in de vier gepubliceerde versies.

Het label van de knop verandert met de taal van je Odoo: met Odoo in het Nederlands is het Berichten importeren; in het Duits Nachrichten importieren; in het Frans Importer les messages; in het Italiaans Importa messaggi; in het Portugees Importar Mensagens.

Schema gemaakt met code op basis van de vertaalbestanden van de module, met het label van de knop in het Nederlands, Duits, Frans, Italiaans en Portugees — Schema gemaakt met code (geen schermafbeelding van Odoo): het label van de knop Import Messages volgens de taal van Odoo.

Als je nog niet hebt gecontroleerd of de verbinding met de marktplaats werkt, legt het artikel over de knop Verbinding testen uit wat die andere knop doet.

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

Stap voor stap

Laat Odoo het zelf doen. De geplande taak Mirakl - Berichten synchroniseren start de berichtenimport elke 30 minuten, maar staat bij de installatie uitgeschakeld. Ze loopt langs de actieve instanties waarbij berichtsynchronisatie is ingeschakeld, en alleen een beheerder kan haar uitvoeren. Dat is de normale route; de knop dient om de import handmatig te starten.
Open de instantie. Ga naar Mirakl › Configuratie › Marktplaatsen en open het dossier van de instantie.
Controleer het dagenvenster. In het tabblad Facturen en berichten, groep Berichten, staat Initiële berichtsynchronisatiedagen. De help zegt: «Historisch venster (dagen) voor handmatige berichtsynchronisatie.» De standaardwaarde is 30. De knop geeft die waarde door aan de import.
Klik op Berichten importeren. De module bevraagt de marktplaats (details in de volgende sectie) en laat na afloop een melding achter.
Lees de melding. Als er berichten zijn verwerkt, zie je een succesmelding: Berichten importeren voltooid: … berichten verwerkt. (op de plaats van de puntjes het aantal). Is er geen enkel bericht verwerkt, dan krijg je een waarschuwing: Berichten importeren voltooid: 0 records. De operator ondersteunt dit endpoint mogelijk niet.
Bij de waarschuwing: kijk naar het alleen-lezenveld. In hetzelfde tabblad en dezelfde groep zegt Berichten-endpoint niet beschikbaar of de module heeft gemarkeerd dat de marktplaats /messages niet aanbiedt.

Wat de knop intern doet, in volgorde

Negeert het veld Berichten-endpoint niet beschikbaar. Met de knop voert de module de opvraging uit, ook als dat veld is aangevinkt. De geplande taak daarentegen slaat het endpoint over tot het handmatig opnieuw wordt geprobeerd, zoals de help van het veld zegt.
Leest per pagina. Hij vraagt de berichten op met een leesverzoek aan het endpoint /messages (of aan het endpoint dat de instantie heeft opgegeven), pagina na pagina, met een maximum aantal pagina's dat de instantie zelf bepaalt.
Verwerkt elk bericht. Elk ontvangen bericht gaat via het Mirakl-berichtenmodel, en de module telt er één bij voor elk resulterend record. Dat totaal zie je in de melding.
Wist de markering als het lezen lukt. Als een verzoek slaagt en Berichten-endpoint niet beschikbaar was aangevinkt, maakt de module het leeg. Daarom is op de knop klikken de manier om het opnieuw te proberen.
Legt vast en meldt. Hij plaatst dezelfde meldingstekst als bericht op de instantie zelf en toont een melding met de titel Mirakl. Het is geen vaste melding op het scherm.

Fouten en meldingen die kunnen verschijnen

De knop toont leesfouten niet als foutmelding: hij noteert ze in het log van de Mirakl-API en eindigt met de melding «0 records» als er niets is verwerkt. Daarom bewijst die waarschuwing op zich niet dat er iets misgaat: ze verschijnt ook als de marktplaats geen berichten had om terug te geven.

Situatie	Wat er gebeurt	Wat te doen
Er worden berichten verwerkt	Succesmelding met het aantal	Niets: controleer de geïmporteerde berichten
De marktplaats antwoordt 410 of 404	De module markeert `Berichten-endpoint niet beschikbaar`, noteert een waarschuwing in het log en stopt; de melding op het scherm toont wat tot dat moment is verwerkt	Bij 0 biedt de operator `/messages` mogelijk niet aan; controleer het veld en klik pas opnieuw als er iets is veranderd
Andere fout bij het verzoek	Er wordt een fout in het log genoteerd en het lezen stopt; wat al is verwerkt wordt geteld	Controleer het API-log en klik opnieuw
Antwoord met een vorm die de connector niet herkent	Het wordt niet als lege pagina beschouwd: er wordt een fout genoteerd en het lezen stopt	Bewaar de inhoud die in het log staat en raadpleeg FlexigoTech
FlexigoTech Cloud laat de aanroep niet door (geen abonnement of onderbroken dienst)	De import wordt afgebroken, er wordt niets gemarkeerd en de voltooidmelding komt niet	Controleer je abonnement op het plan Connector

Knop of geplande taak

	Knop `Berichten importeren`	Taak `Mirakl - Berichten synchroniseren`
Wanneer hij draait	Wanneer je erop klikt	Elke 30 minuten, als je hem activeert (staat standaard uit)
Met het endpoint gemarkeerd als niet beschikbaar	Vraagt het toch op	Slaat het over tot het handmatig opnieuw wordt geprobeerd

Wat je nodig hebt en hoe FlexigoTech je helpt

Mirakl Connector is een module met eenmalige betaling per versie, gepubliceerd in Odoo Apps voor 17, 18, 19 en 20 (product, modulepagina), en vereist het abonnement op FlexigoTech Cloud met het plan Connector: € 49 per maand of € 490 per jaar excl. btw, tot 3 accounts van het platform. Zonder abonnement, of met opgeschorte dienst, stopt wat het abonnement levert; de gegevens blijven in je Odoo.

Als je Odoo aan het implementeren bent en wilt dat de connector goed is afgesteld op je marktplaatsen, implementeert FlexigoTech Odoo 17, 18, 19 en 20 en ontwikkelt het connectoren en integraties op maat.

Lees verder

Mirakl Connector: «Stel de Mirakl API-sleutel in voordat u de verbinding test»Wanneer de fout over een lege API-sleutel verschijnt in Mirakl Connector voor Odoo, welke voorwaarde die veroorzaakt en hoe je haar oplost bij Verbinding…Mirakl Connector: «Voor deze koppeling is geen Mirakl-instantie geconfigureerd.»Wanneer Mirakl Connector meldt dat een koppeling geen Mirakl-instantie heeft, welke voorwaarde dat veroorzaakt en wat je doet als de melding verschijnt.Wat de knop Verbinding testen van Mirakl Connector doet, stap voor stapWat doet de knop Verbinding testen van Mirakl Connector in Odoo: wanneer hij verschijnt, wat hij controleert, wat hij opslaat en welke fouten kunnen optreden.

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 (aa05e537): views/mirakl_instance_views.xml
Broncode van de module: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
Broncode van de module: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_ai.py
apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
flexigotech.com/precios.html
flexigotech.com/en/services.html