Naar hoofdinhoud
Mirakl

Wat de knop Facturen importeren in Mirakl Connector doet

De knop Facturen importeren vraagt Mirakl om de facturen uit het dagenvenster van het instantieformulier, verwerkt ze stuk voor stuk en laat weten hoeveel hij er heeft geteld. Het is de handmatige route: de dagelijkse import doet een geplande taak die bij installatie uitgeschakeld staat.

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

Waar hij staat en wanneer je hem ziet

Open Mirakl › Configuratie › Marktplaatsen en ga naar het formulier van een instantie, in het scherm Mirakl instanties. Daar staat de knop Facturen importeren. Er is geen zichtbaarheidsvoorwaarde: je ziet hem in Odoo 17, 18, 19 en 20.

Schema van de route: menu Mirakl, Configuration, Marketplaces, en de knop Import Invoices
Schema gemaakt met code, geen Odoo-scherm: de menuroute en de knop, met de Engelse labels uit de code van de module, voor Odoo 17, 18, 19 en 20.

Het label verandert met de taal van je Odoo. Met Odoo in het Nederlands is het Facturen importeren; het schema toont ook het label in andere talen.

Schema van het label van de knop Import Invoices naargelang de taal van Odoo
Schema gemaakt met code op basis van de gepubliceerde vertalingen van de module, geen Odoo-scherm: Nederlands Facturen importeren, Duits Rechnungen importieren, Frans Importer les factures, Italiaans Importa fatture en Portugees Importar Faturas.

Heb je de verbinding van de instantie nog niet gecontroleerd? Lees dan eerst wat de knop Verbinding testen doet.

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

Zes misverstanden over de knop

«Op de knop drukken is de normale manier om de facturen op te halen»

Werkelijkheid: de module bevat een geplande taak, Mirakl - Facturen synchroniseren, die één keer per dag draait en bij installatie uitgeschakeld staat. Als je haar activeert, doorloopt ze de actieve instanties waarvoor factuursynchronisatie aanstaat en vraagt bij elk de facturen op. Alleen een beheerder kan die geplande actie uitvoeren.

Op die route zijn er twee filters. Instanties die via FlexigoTech Cloud lopen en de opgeslagen sleutel missen, worden niet aangeroepen. En als de opgeslagen machtiging de dienst niet omvat, wordt geen enkele instantie die via FlexigoTech Cloud loopt aangeroepen. Faalt een instantie, dan laat de module een foutregel achter in het logboek en gaat door met de volgende.

De knop is de handmatige weg: je drukt erop als je nu wilt importeren, zonder op de taak te wachten.

«Hij haalt alle facturen van de operator op»

Werkelijkheid: de knop gebruikt als venster de dagen van het veld Initiële factuursynchronisatiedagen. Je ziet het op het formulier van de instantie, tabblad Facturen en berichten, groep Facturen (Afrekeningen). De help zegt: «Historisch venster (dagen) voor handmatige factuursynchronisatie.» De standaardwaarde in de code is 90.

Het verzoek verloopt per pagina. De module stopt wanneer een pagina minder facturen bevat dan de paginagrootte, wanneer het totaal uit het antwoord is bereikt of wanneer er niets meer binnenkomt. Daarnaast geldt een maximum aantal pagina's per ronde.

«Als de operator geen facturen aanbiedt, geeft de knop een fout»

Werkelijkheid: als het platform met HTTP 404 antwoordt op de factuuraanvraag, geeft de module geen enkele fout. Hij vinkt het vakje Facturen-endpoint niet beschikbaar aan, laat een waarschuwing achter in het logboek, noteert de datum van de laatste factuursynchronisatie en sluit af met de telling die hij had. Komt de 404 op de eerste pagina, dan is die telling nul.

Het vakje is alleen-lezen en staat op hetzelfde tabblad en in dezelfde groep als het dagenvenster. De help zegt: «Automatisch ingesteld wanneer /invoices 404 retourneert, zodat de geplande synchronisatie het eindpunt overslaat tot het handmatig opnieuw wordt geprobeerd.»

Dat is het verschil tussen de twee routes. De dagelijkse taak slaat de instantie over zolang het vakje aangevinkt is. De knop past die controle niet toe en probeert opnieuw. Als het verzoek lukt, leegt de module het vakje.

«Als één factuur mislukt, wordt er niets geïmporteerd»

Werkelijkheid: elke ontvangen factuur wordt apart verwerkt. Mislukt er een, dan laat de module een foutregel achter in het logboek en gaat door met de rest; de mislukte factuur telt niet mee.

Iets anders is een mislukt verzoek aan het platform met een andere fout dan 404, bijvoorbeeld een netwerkfout. Dan noteert de module de fout in het logboek en vraagt hij geen pagina's meer op. De facturen van de voorgaande pagina's zijn dan al verwerkt.

«Nul records betekent dat er geen facturen zijn»

Werkelijkheid: na afloop publiceert de knop het resultaat als bericht op het formulier van de instantie en toont een melding met de titel Mirakl die niet vast op het scherm blijft staan. Is de telling groter dan nul, dan is de melding een succes:

Facturen importeren voltooid: … facturen verwerkt., met het aantal op de plaats van de puntjes.

Is de telling nul, dan is de melding een waarschuwing:

Facturen importeren voltooid: 0 records. Controleer de logs of vergroot het synchronisatievenster.

De nul kan komen van een venster zonder facturen, van een 404 of van facturen die bij de verwerking mislukten. De laatste twee gevallen laten een regel achter in het logboek, en dat is wat de melding je laat controleren. Is er niets te zien, vergroot dan de dagen van het veld Initiële factuursynchronisatiedagen en druk opnieuw.

«De knop eindigt altijd met de melding dat het voltooid is»

Werkelijkheid: als FlexigoTech Cloud de aanroep niet doorlaat (geen abonnement of pauze van de relay), wordt de import onderbroken zonder iets te markeren en komt de voltooiingsmelding niet. Zonder abonnement, of met de dienst opgeschort, stopt wat het abonnement levert; de gegevens blijven in je Odoo.

Wat je na het indrukken controleert

  • Het bericht met het resultaat op het formulier van de instantie.
  • Het vakje Facturen-endpoint niet beschikbaar, op het tabblad Facturen en berichten, groep Facturen (Afrekeningen).
  • De foutregels in het logboek van de module, als de melding nul records gaf.

Hoe het past bij FlexigoTech

Mirakl Connector is een module met eenmalige betaling per versie, gepubliceerd voor Odoo 17, 18, 19 en 20, en vereist het abonnement op FlexigoTech Cloud, plan Connector: € 49 per maand of € 490 per jaar, excl. btw. De prijs van elke versie staat op de Odoo Apps-pagina en voor de overige op de pagina van de module. Als je Odoo wilt implementeren of de integratie op je operator wilt afstemmen: FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt 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