Naar hoofdinhoud
Mirakl

Mirakl-verkopers die nog niet op Odoo zitten: wat er verandert met Odoo als ERP

Verkoop je op een of meer marktplaatsen die op Mirakl draaien en beheer je ze nu vanuit het paneel van elke operator of met spreadsheets, dan geeft het onderbrengen ervan in Odoo met Mirakl-connector Odoo je één verbinding per operator, met zijn API-adres en jouw winkelsleutel. Orders, aanbiedingen en retouren staan onder één menu, de geplande actie Mirakl - Orders accepteren draait elke 10 minuten en de afrekeningen en facturen van de operator hebben een eigen menu.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 10 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
6 min

Wat Odoo als ERP verandert voor je Mirakl-marktplaatsen

Volgens de documentatie van Mirakl heeft elke marktplaats een eigen adres, dat je vervangt door de URL van jouw Mirakl-instantie, en wordt de verkopers-API geauthenticeerd met de winkelsleutel, die in de Authorization-header wordt meegestuurd. Elke operator waarop je verkoopt heeft dus zijn eigen adres en zijn eigen sleutel.

Met Mirakl-connector Odoo wordt elke operator een Mirakl-instantie binnen Odoo, aangemaakt met de echte basis-URL van de operator, de API-basis-URL en de API-sleutel. Volgens de vermelding koppelt de module Odoo aan elke Mirakl-marktplaats: je publiceert producten, prijzen en voorraad en haalt orders, retouren, afrekeningen en berichten op. Alles hangt aan één menu Mirakl, met Dashboard, Bewerkingen, Catalogus, Financiën en Configuratie.

Elke winkelsleutel blijft bij zijn operator: de module stuurt hem alleen naar de API-basis-URL van zijn instantie. Als er contact met een ander adres wordt gevraagd, stopt de module met dit bericht: Contact met … geweigerd: de Mirakl-API-sleutel van … gaat alleen naar de API-basis-URL ervan (…). Vul het endpoint in als pad, bijvoorbeeld /orders.

Een Mirakl-marktplaatsrecord in Odoo 20 met het API-adres van de operator en de FlexigoTech Cloud-verbinding
Een marktplaatsrecord in Odoo 20, met democases en nog niet verbonden: het API-adres van de operator, de FlexigoTech Cloud-verbinding en de importknoppen.
How to stop copy-pasting between apps (Odoo)
Video: How to stop copy-pasting between apps (Odoo) (video in het Engels)

Operator per operator nu versus Mirakl in Odoo

Dit is de vergelijking per taak van wat je met elke marktplaats doet en waar het in Odoo terechtkomt met de connector.

TaakNu, operator per operatorIn Odoo met Mirakl-connector Odoo
Elke marktplaats koppelenElke marktplaats heeft een eigen adres en je logt in met de winkelsleutelEén instantie per operator, met de basis-URL van de operator, de API-basis-URL en de API-sleutel
Nieuwe orders lezenMirakl raadt aan de orderlijst (OR11) elke 5 minuten te controleren en hoogstens één keer per minuutGeplande actie Mirakl - Orders synchroniseren, elke 10 minuten; lijst onder Mirakl › Bewerkingen › Orders
Orders accepterenRegels in WAITING_ACCEPTANCE worden met OR21 geaccepteerd of geweigerdGeplande actie Mirakl - Orders accepteren, elke 10 minuten
Aanbiedingen en voorraadOp elke marktplaats, op zijn eigen adresMirakl › Bewerkingen › Aanbiedingen; geplande acties Mirakl - Aanbiedingen exporteren (elke 5 minuten), Mirakl - Prijzen exporteren (PRI01) (elke 15 minuten) en Mirakl - Voorraad exporteren (STO01) (elke 10 minuten)
RetourenOp elke marktplaats, op zijn eigen adresMirakl › Bewerkingen › Retouren; geplande actie Mirakl - Retouren synchroniseren, elke 30 minuten
Afrekeningen van de operatorOp elke marktplaats, op zijn eigen adresMirakl › Financiën › Afrekeningen & Facturen en, in hetzelfde menu, Financiële analyse (P&L)

Elke geplande actie in de tabel is actief zodra de module is geïnstalleerd. Elke actie werkt echter alleen met instanties waarin het bijbehorende selectievakje is aangevinkt, en die selectievakjes staan standaard uit. Nu doe je elke rij op elke marktplaats, op zijn eigen adres; in Odoo is elke rij een menu of een geplande actie van de module. Wat de module per veld aan de Odoo-verkooporder toevoegt, lees je in wat Mirakl-connector Odoo aan Verkoop toevoegt.

Catalogus en berichten vallen buiten de tabel. Onder Mirakl › Catalogus vind je Categorieën, Attributen, Waardelijsten, Categoriekoppeling en Vervoerderskoppeling, met de geplande acties Mirakl - Catalogus exporteren (elke 30 minuten) en Mirakl - Cataloguswoordenboek synchroniseren (elke 60 minuten). Berichten hebben een eigen menu onder Mirakl › Bewerkingen › Berichten.

Lijst met Mirakl-orders in Odoo 20 met status, acceptatie, bedrag en verkooporder
De lijst met Mirakl-orders in Odoo 20, met democases en een gesimuleerde Mirakl-API: acht orders met hun status, hun acceptatie, het bedrag en hun verkooporder.
Een Mirakl-order in WAITING_ACCEPTANCE binnen Odoo 20 met het acceptatieblok
Een order in WAITING_ACCEPTANCE binnen Odoo 20, met democases en een gesimuleerde API: status in afwachting en het acceptatieblok van de order.

Mirakl Connect-prijzen en wat de connector nodig heeft

Mirakl publiceert prijzen voor zijn verkopersplatform, Mirakl Connect, waarmee volgens Mirakl tienduizenden verkopers de toonaangevende marktplaatsen ter wereld bereiken. De prijzen op de website staan in dollars en zijn gestaffeld naar maandelijks verkoopvolume (GMV):

  • Growth: $ 699 per maand, tot $ 50.000 GMV per maand.
  • Pro: $ 2.299 per maand, tot $ 200.000 GMV per maand.
  • Enterprise: op maat, voor wie meer dan $ 200.000 GMV per maand verwerkt.

Om je Mirakl-marktplaatsen met Mirakl-connector Odoo in Odoo onder te brengen, heb je het volgende nodig:

  • Odoo op versie 17, 18, 19 of 20.
  • Mirakl-connector Odoo geïnstalleerd op die versie.
  • Een FlexigoTech Cloud-abonnement op het Connector-plan, dat de module volgens de vermelding nodig heeft.
  • Per operator zijn echte basis-URL, zijn API-basis-URL en jouw winkelsleutel.

Met die gegevens staat elke operator in een eigen instantie binnen Odoo en gaat elke winkelsleutel alleen naar het API-adres van zijn operator.

Van Odoo-implementatie tot je eerste Mirakl-afrekening, op volgorde

Zit je nog niet op Odoo, dan is de volgorde belangrijk: eerst Odoo, dan de connector, dan elke operator.

  1. Implementeer Odoo. FlexigoTech implementeert Odoo 17, 18, 19 en 20; je kunt beginnen met een Odoo-implementatie voordat je een marktplaats koppelt.
  2. Installeer Mirakl-connector Odoo op jouw versie en koppel hem aan je FlexigoTech Cloud-abonnement op het Connector-plan.
  3. Maak per operator één Mirakl-instantie aan met de echte basis-URL van de operator, de API-basis-URL en de API-sleutel van je winkel. Onder Mirakl › Configuratie vind je Marktplaatsen en Logs. Wat elk veld van de instantie betekent, lees je in de velden van de Mirakl-instantie.
  4. Wacht op de eerste order. De geplande actie Mirakl - Orders synchroniseren draait elke 10 minuten en de orders verschijnen onder Mirakl › Bewerkingen › Orders. De actie haalt alleen orders op uit instanties waarin het selectievakje Ordersynchronisatie ingeschakeld (Sync Orders Enabled) is aangevinkt, en dat staat standaard uit. In Mirakl zijn de nieuwe regels die met OR21 worden geaccepteerd of geweigerd, de regels in WAITING_ACCEPTANCE.
  5. Controleer je orders onder Mirakl › Bewerkingen › Orders: de lijst toont hun status en hun acceptatie. De geplande actie Mirakl - Orders accepteren draait elke 10 minuten en is bij installatie actief. Ze accepteert alleen orders in instanties waarin het selectievakje Orders automatisch accepteren (Auto Accept Orders) is aangevinkt, en dat staat standaard uit.
  6. Loop je aanbiedingen door onder Mirakl › Bewerkingen › Aanbiedingen. De geplande acties die aanbiedingen, prijzen en voorraad exporteren zijn bij installatie ook actief. Ze exporteren echter alleen vanuit instanties waarin het bijbehorende selectievakje is aangevinkt: aanbiedingen met Aanbodsynchronisatie ingeschakeld (Sync Offers Enabled), prijzen met Automatische prijsexport ingeschakeld (Auto Export Prices Enabled) en voorraad met Automatische voorraadexport ingeschakeld (Auto Export Stock Enabled). Alle drie staan standaard uit.
  7. Open de eerste afrekening onder Mirakl › Financiën › Afrekeningen & Facturen en bekijk Financiële analyse (P&L) in hetzelfde menu.

Wil je de connector eerst zien voordat je beslist, dan staat zijn pagina op flexigotech.com. Naast het implementeren van Odoo bouwt FlexigoTech connectors en integraties op maat, voor het geval de manier waarop je met een bepaalde operator werkt iets extra's vraagt.

Wat Mirakl in Odoo kost: module en Connector-plan

Mirakl-connector Odoo kost € 9 per Odoo-versie, excl. btw, voor 17, 18, 19 en 20. Volgens de vermelding heeft hij het FlexigoTech Cloud-abonnement nodig: het Connector-plan kost € 49 per maand of € 490 per jaar excl. btw, met maximaal 3 platformaccounts, en Pro kost € 98 per maand of € 980 per jaar excl. btw, met maximaal 10. Het abonnement is gratis uit te proberen, zonder creditcard.

Daar komt de Odoo-implementatie bovenop, die apart werk is. De module en het abonnement staan op de pagina van de Mirakl-connector voor Odoo.

Mirakl met Odoo als ERP: veelgestelde vragen

Kan ik meerdere Mirakl-operators in dezelfde Odoo onderbrengen?

Elke operator komt in een eigen Mirakl-instantie, met zijn basis-URL, zijn API-basis-URL en zijn sleutel. Het Connector-plan bevat maximaal 3 platformaccounts en Pro maximaal 10.

Hoe vaak komen orders in Odoo binnen?

De geplande actie Mirakl - Orders synchroniseren draait elke 10 minuten en is bij installatie actief. Ze haalt alleen orders op uit instanties waarin het selectievakje Ordersynchronisatie ingeschakeld (Sync Orders Enabled) is aangevinkt, en dat staat standaard uit. Mirakl zelf raadt aan de orderlijst elke 5 minuten te lezen en hoogstens één keer per minuut.

Kan een winkelsleutel bij een andere operator terechtkomen?

De module stuurt de sleutel van elke instantie alleen naar zijn API-basis-URL. Als er contact met een ander adres wordt gevraagd, stopt hij met het bericht Contact met … geweigerd: de Mirakl-API-sleutel van … gaat alleen naar de API-basis-URL ervan (…). Vul het endpoint in als pad, bijvoorbeeld /orders.

Op welke Odoo-versies werkt het?

Mirakl-connector Odoo is gepubliceerd op Odoo Apps voor Odoo 17, 18, 19 en 20.

Lees verder

Wat Mirakl Connector toevoegt aan de verkooporder in Odoo (Verkoop)De velden die Mirakl Connector aan de verkooporder in Odoo toevoegt, wanneer je ze ziet en wat de module doet bij verwijderen, adreswijzigingen en facturatie.Checklist Mirakl Connector-instantie, veld voor veldChecklist om de Mirakl Connector-instantie in Odoo in te vullen: verbinding, afrekeningsrekeningen en opties, met wat de helptekst van elk veld zegt.
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen

Bronnen