Naar hoofdinhoud
Mirakl

De velden van Mirakl orders in Mirakl Connector: glossarium

Wat elk veld van het formulier Mirakl orders in Mirakl Connector betekent volgens de eigen helptekst: commissie, verzending, terugbetaling, reden van het ontbreken van een verkooporder en payload, en wat je per veld invult of controleert.

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

Mirakl Connector is gepubliceerd in Odoo Apps voor 17.0, 18.0, 19.0 en 20.0. Wat hieronder staat, hoort bij de menu's en velden van Mirakl Connector voor Odoo 20.0.

Waar staan de velden

De formulieren open je via het menu Mirakl › Bewerkingen › Orders. Zie je het menu Mirakl niet, dan mist je het recht dat dat deel van het menu vereist.

Schema gemaakt met code, geen Odoo-scherm: het menu Mirakl › Operations › Orders en het formulier Mirakl Order met de velden voor commissie, verzendmethode, deadline, payload, terugbetaling en reden van het ontbreken van een verkooporder
Schema (geen schermafbeelding van Odoo) met het menu en het formulier van een Mirakl-order.
Mirakl orders
Het formulier en de lijst van Mirakl-orders. Sommige velden staan alleen in het formulier, andere ook in de lijst en één veld zien alleen gebruikers met een specifiek recht.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (video in het Engels)

Commissie en verzending

Bedrag commissie
Veld met een geldbedrag. Je ziet het in het formulier van Mirakl orders en ook in de pivotweergave van dat model. De helptekst zegt: «Marktplaatscommissie die door de operator op deze order in rekening wordt gebracht (verkoperskosten). Gelezen uit de Mirakl-payload (commission_fee / total_commission).». Wat je ermee doet: zie het als de verkoperskosten die de operator opgeeft en vergelijk een bedrag dat niet klopt met de Ruwe payload (hieronder).
Schema gemaakt met code op basis van de gepubliceerde vertalingen, geen Odoo-scherm: de helptekst van het veld Bedrag commissie in het Spaans, Duits, Frans, Italiaans en Portugees
Schema (geen schermafbeelding van Odoo): de helptekst van Bedrag commissie zoals die verschijnt, afhankelijk van de taal van Odoo.
Code verzendtype
Korte tekst die je in het formulier ziet, in de groep Verzendmethode. De helptekst zegt: «Mirakl-code van de verzendmethode die de koper koos (bijv. STD, EXPRESS).». Wat je ermee doet: lees het als de sleutel die Mirakl gebruikt; de tekst voor mensen staat in het volgende veld.
Verzendmethode
Korte tekst die je in het formulier ziet, in dezelfde groep Verzendmethode, en ook in de lijst van Mirakl orders. De helptekst zegt: «Verzendmethode die de koper koos, zoals de marktplaats die toont (bijv. 'Standaard thuislevering', 'Volgende dag').». Wat je ermee doet: gebruik het om te weten wat de koper koos, zonder de code te hoeven interpreteren.
Verzenden vóór
Datum en tijd die je in het formulier ziet, in de groep Verzenddatums, en ook in de lijst. De helptekst zegt: «Mirakl-deadline om het pakket aan de vervoerder over te dragen. Verzenden na deze datum schaadt uw kwaliteitsscore op de marktplaats.». Wat je ermee doet: houd deze datum in het oog bij het klaarmaken van de zending, want de helptekst waarschuwt dat te laat verzenden je score raakt.

Terugbetaling

De twee velden staan in de groep Terugbetaling van het formulier en lijken qua naam op elkaar, maar doen niet hetzelfde.

Reden terugbetaling
Korte tekst. De helptekst zegt: «Interne notitie over de terugbetaling. Wat Mirakl echt vereist, is de reden-CODE van de operator hieronder.». Wat je ermee doet: schrijf het als notitie voor je team, in de wetenschap dat het de code niet vervangt.
Code reden terugbetaling
Korte tekst. De helptekst zegt: «Door de operator gedefinieerde redencode die de Mirakl-terugbetalings-API (OR28) vereist; Decathlon publiceert bijv. codes als 'RET' of '11'. Gebruik 'Redenen voor terugbetaling ophalen' op de marktplaatsinstantie om de codes te zien die uw operator accepteert.». Wat je ermee doet: vul een code in die je operator accepteert, geen omschrijving; de helptekst geeft aan waar je ze opzoekt.

Wanneer er geen verkooporder is

Geen verkooporder omdat
Selectieveld dat uitlegt waarom de connector voor die Mirakl-order geen verkooporder aanmaakt. Het verschijnt alleen als de order geen verkooporder heeft en het veld een reden bevat; bij een gewone order zie je het niet. Het staat ook in de lijst, alleen-lezen. De module vult het in, niet de gebruiker, en het wordt leeggemaakt zodra je de verkooporder aanmaakt met de knop Verkooporder aanmaken. De helptekst zegt: «Waarom de connector voor deze Mirakl-order geen verkooporder aanmaakt. Gebruik de knop 'Verkooporder aanmaken' om hem toch aan te maken.». Wat je ermee doet: lees de reden voordat je beslist of je hem toch wilt aanmaken.

Dit zijn de mogelijke waarden:

De verkooporder is in Odoo verwijderd
De verkooporder van die Mirakl-order is in Odoo verwijderd.
Bij het importeren al verzonden, afgesloten of terugbetaald in Mirakl
Toen de order werd geïmporteerd, was hij in Mirakl al verzonden, afgesloten of terugbetaald.
Aangemaakt vóór 'Verkooporders aanmaken vanaf'
De Mirakl-order is aangemaakt vóór de datum van 'Verkooporders aanmaken vanaf'. Zie je dit en wil je de verkooporder wel, dan verwijst de helptekst van het veld naar de knop Verkooporder aanmaken.

Technische gegevens

Ruwe payload
Lange tekst in de groep Ruwe payload (technisch) van het formulier. Alleen gebruikers met een specifiek beheerdersrecht zien het, alleen-lezen. De helptekst zegt: «De gegevens van de marktplaats precies zoals ontvangen, leesbaar opgemaakt. Dit voegt u toe als u een importprobleem meldt.». Wat je ermee doet: bewerk het niet (het is alleen-lezen) en kopieer het helemaal wanneer je een importfout moet melden.

Zo helpt FlexigoTech

Als je Odoo implementeert en Mirakl wilt koppelen: FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat. De module kost eenmalig per versie 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 faalt. De prijs van de module per versie staat op de pagina in Odoo Apps en kopen kan op de pagina van de module.

Ben je het account nog aan het koppelen, dan helpt je voordat je naar orders kijkt wat de knop Verbinding testen doet, stap voor stap.

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