Naar hoofdinhoud
Mirakl

Wat de knop «Factuur uploaden naar Mirakl» van Mirakl Connector doet

De knop Factuur uploaden naar Mirakl (Upload Invoice to Mirakl) verschijnt op de levering van een Mirakl-order die al de status Voltooid (Afgehandeld in Odoo 17.0) heeft en uploadt de factuur handmatig naar Mirakl. Gaat de upload goed, dan bewaart de levering de datum en het tijdstip; mislukt hij, dan zie je de fout en stopt de actie.

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

Wanneer de knop zichtbaar is en wat Odoo doet zonder dat je klikt

Moet ik op de knop klikken om de factuur naar Mirakl te krijgen?

Niet altijd. De module breidt de standaardknop voor het valideren van de levering uit en kan bij het valideren van de levering de factuur ook zelf uploaden, mits de instantie facturen in automatische modus verstuurt en de levering nog geen uploaddatum heeft. De knop dient om de factuur handmatig te uploaden. Daarnaast zorgt het selectievakje Automatisch factuur aanmaken bij validatie levering (Auto-create invoice on delivery validation) ervoor dat bij het valideren van een levering van een Mirakl-order de klantfactuur wordt aangemaakt op basis van de bijbehorende verkooporder. Je vindt het op het formulier van Mirakl instanties (Mirakl Instances), tabblad Orders en retouren (Orders and Returns), groep Verkoopbrug (Sales Bridge), en het staat standaard uit. Volgens de hulptekst volgt het het facturatiebeleid (op bestelling of op levering) en blokkeert het de levering nooit als de facturatie mislukt.

Wanneer verschijnt de knop en waarom kan hij op een levering ontbreken?

Hij staat op het formulier van de levering (verplaatsing van Voorraad). Hij is verborgen als de levering niet bij een Mirakl-order hoort of als de status niet Voltooid is. Omgekeerd gezegd: je ziet hem alleen als de levering bij een Mirakl-order hoort en de status Voltooid heeft. Het gegeven Is Mirakl-order (Is Mirakl Order) staat in geen enkele weergave, dus er is geen vakje om te controleren; wat je wel kunt nakijken is de status van de levering. De voorwaarde is hetzelfde in Odoo 17, 18, 19 en 20.

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

Wat hij doet als je erop klikt, stap voor stap

Wat doet de knop precies?

De code loopt de leveringen af waarop hij werkt en houdt degene over die bij een Mirakl-order horen. Voor elk daarvan zoekt hij de Mirakl-instantie van de verkooporder waaraan de levering gekoppeld is. Heeft de levering geen verkooporder, dan is er geen instantie en gaat de knop er zonder iets te doen aan voorbij. Is die er wel, dan vraagt hij de instantie de factuur te uploaden; volgens de code van de module is wat wordt geüpload de pdf van de geboekte factuur. Gaat de upload goed, dan bewaart de module de datum en het tijdstip van de upload op de levering en laat er een notitie op achter.

Schema met de knop Upload Invoice to Mirakl
Schema gemaakt met code, geen scherm van Odoo: de knop «Upload Invoice to Mirakl» (in het Nederlands Factuur uploaden naar Mirakl), aanwezig in Odoo 17, 18, 19 en 20.

Wat verandert er op de levering als het goed gaat?

Twee dingen: de datum en het tijdstip van de upload worden bewaard, en op de levering verschijnt de notitie Mirakl: factuur geüpload naar de marktplaats. De automatische weg uploadt alleen als die datum leeg is.

Wat gebeurt er als de upload mislukt?

Bij de knop wordt de fout opnieuw opgegooid: je ziet hem op het scherm, de actie stopt en wat er zou wijzigen wordt niet bewaard, dus er komt geen uploaddatum. Laat FlexigoTech Cloud de bewerking niet door, dan wordt er niets geüpload en niets gemarkeerd, zodat je hem later kunt versturen, en de knop toont ook de fout. Bij de automatische weg wordt de fout daarentegen niet opnieuw opgegooid: bij een gewone fout laat de module een notitie met de fout op de levering achter en wordt de datum niet gemarkeerd; laat FlexigoTech Cloud de bewerking niet door, dan wordt er ook niets gemarkeerd. De concrete tekst van de fout hangt af van wat de upload terugmeldt en wordt niet door de knop bepaald.

Mag ik klikken als de factuur al is geüpload?

Bij het klikken controleert de knop zelf niet of er al een uploaddatum is, terwijl de automatische weg wel eist dat die leeg is. Kijk, voordat je hem handmatig herhaalt, in de notities van de levering of Mirakl: factuur geüpload naar de marktplaats. er al staat.

Versies, abonnement en hulp

Zit de knop in mijn versie van Odoo?

Ja: de module is gepubliceerd in Odoo Apps voor Odoo 17, 18, 19 en 20, en de knop staat op de levering in alle vier de takken. Het stap-voor-stap-overzicht hierboven komt uit de code van Odoo 20.0. Met Odoo in het Nederlands heet de knop Factuur uploaden naar Mirakl.

Schema met de tekst van de knop in meerdere talen
Schema gemaakt met code op basis van de vertalingen van de module, geen scherm van Odoo: in het Nederlands «Factuur uploaden naar Mirakl»; in het Duits «Rechnung zu Mirakl hochladen»; in het Frans «Téléverser la facture vers Mirakl»; in het Italiaans «Carica fattura su Mirakl»; in het Portugees «Carregar Fatura para o Mirakl».

Wat is er nodig om te werken en wat kost het?

De module is een eenmalige aankoop per Odoo-versie (de prijs per versie staat op de pagina in Odoo Apps en op de pagina van de module) en vereist het abonnement op FlexigoTech Cloud, plan Connector: € 49 per maand of € 490 per jaar excl. btw, met maximaal 3 accounts van het platform. De verbinding loopt via FlexigoTech Cloud, dat de inloggegevens versleuteld bewaart, de synchronisatie bewaakt en per e-mail waarschuwt als die mislukt. Zonder abonnement, of met opgeschorte dienst, stopt wat het abonnement levert; de gegevens blijven in jouw Odoo. Met het abonnement is de module voor nieuwe Odoo-versies inbegrepen als je hem op flexigotech.com hebt gekocht; in de Odoo App Store koop je elke versie daar apart.

Helpen jullie met de ingebruikname?

FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt 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 20.0) en in de gelinkte bronnen

Bronnen