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.


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.
| Taak | Nu, operator per operator | In Odoo met Mirakl-connector Odoo |
|---|---|---|
| Elke marktplaats koppelen | Elke marktplaats heeft een eigen adres en je logt in met de winkelsleutel | Eén instantie per operator, met de basis-URL van de operator, de API-basis-URL en de API-sleutel |
| Nieuwe orders lezen | Mirakl raadt aan de orderlijst (OR11) elke 5 minuten te controleren en hoogstens één keer per minuut | Geplande actie Mirakl - Orders synchroniseren, elke 10 minuten; lijst onder Mirakl › Bewerkingen › Orders |
| Orders accepteren | Regels in WAITING_ACCEPTANCE worden met OR21 geaccepteerd of geweigerd | Geplande actie Mirakl - Orders accepteren, elke 10 minuten |
| Aanbiedingen en voorraad | Op elke marktplaats, op zijn eigen adres | Mirakl › 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) |
| Retouren | Op elke marktplaats, op zijn eigen adres | Mirakl › Bewerkingen › Retouren; geplande actie Mirakl - Retouren synchroniseren, elke 30 minuten |
| Afrekeningen van de operator | Op elke marktplaats, op zijn eigen adres | Mirakl › 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.


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.
- Implementeer Odoo. FlexigoTech implementeert Odoo 17, 18, 19 en 20; je kunt beginnen met een Odoo-implementatie voordat je een marktplaats koppelt.
- Installeer Mirakl-connector Odoo op jouw versie en koppel hem aan je FlexigoTech Cloud-abonnement op het Connector-plan.
- Maak per operator één Mirakl-instantie aan met de echte basis-URL van de operator, de
API-basis-URLen de API-sleutel van je winkel. OnderMirakl › Configuratievind jeMarktplaatsenenLogs. Wat elk veld van de instantie betekent, lees je in de velden van de Mirakl-instantie. - Wacht op de eerste order. De geplande actie
Mirakl - Orders synchroniserendraait elke 10 minuten en de orders verschijnen onderMirakl › Bewerkingen › Orders. De actie haalt alleen orders op uit instanties waarin het selectievakjeOrdersynchronisatie 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 inWAITING_ACCEPTANCE. - Controleer je orders onder
Mirakl › Bewerkingen › Orders: de lijst toont hun status en hun acceptatie. De geplande actieMirakl - Orders accepterendraait elke 10 minuten en is bij installatie actief. Ze accepteert alleen orders in instanties waarin het selectievakjeOrders automatisch accepteren(Auto Accept Orders) is aangevinkt, en dat staat standaard uit. - 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 metAanbodsynchronisatie ingeschakeld(Sync Offers Enabled), prijzen metAutomatische prijsexport ingeschakeld(Auto Export Prices Enabled) en voorraad metAutomatische voorraadexport ingeschakeld(Auto Export Stock Enabled). Alle drie staan standaard uit. - Open de eerste afrekening onder
Mirakl › Financiën › Afrekeningen & Facturenen bekijkFinancië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
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen
Bronnen
- developer.mirakl.com/content/product/mmp/rest/seller/openapi3.md
- developer.mirakl.com/content/product/mmp/rest/seller/openapi3/orders/or11.md
- developer.mirakl.com/content/product/mmp/rest/seller/openapi3/orders/or21.md
- www.mirakl.com/products/connect/pricing/
- www.mirakl.com/
- apps.odoo.com/apps/modules/17.0/flexigobe_mirakl_connector
- apps.odoo.com/apps/modules/18.0/flexigobe_mirakl_connector
- apps.odoo.com/apps/modules/19.0/flexigobe_mirakl_connector
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- Broncode van de module: flexigobe_mirakl_connector 20.0 (2766034c): __manifest__.py
- Broncode van de module: flexigobe_mirakl_connector 20.0 (2766034c): views/menu_views.xml
- Broncode van de module: flexigobe_mirakl_connector 20.0 (2766034c): data/ir_cron_data.xml
- flexigotech.com/nl/mirakl-koppeling-odoo.html
- flexigotech.com/nl/precios.html
- Broncode van de module: flexigobe_mirakl_connector 20.0 (2766034c): models/mirakl_api_mixin.py
- Broncode van de module: flexigobe_mirakl_connector 20.0 (2766034c): README.md
