Naar hoofdinhoud
Mirakl

Checklist Mirakl Connector-instantie, veld voor veld

Het instantieformulier van Mirakl bundelt de verbinding, de afrekeningsrekeningen en een aantal opties; hier lees je veld voor veld wat elk veld volgens de helptekst betekent en wat je het best invult.

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

De formulieren open je via het menu Mirakl › Configuratie › Marktplaatsen, in de lijst Mirakl instanties.

Schema met het menu Mirakl, Configuratie, Marktplaatsen en de velden van het instantieformulier
Schema gemaakt met code op basis van de gepubliceerde code van de module (geen schermafbeelding van Odoo): het menu en de velden van het formulier.

Voordat je het formulier aanpast

  • Toestemming. Om de sleutel te zien moet je Mirakl Manager zijn: de helptekst van API-sleutel zegt dat alleen Mirakl Managers hem kunnen zien of wijzigen, en de Mirakl-API-sleutel (FlexigoTech Cloud) zien alleen gebruikers met die toestemming.
  • Verkopersaccount van de marktplaats. Open het in een ander tabblad: daar komen de host van de operator en de API-sleutel vandaan, volgens de helptekst van die velden.
  • Abonnement. De module heeft het abonnement op FlexigoTech Cloud (plan Connector) nodig. De prijs staat onderaan.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (video in het Engels)

Profiel van de marktplaats

  • Providercode. Zichtbaar in het formulier en ook in de lijst Mirakl instanties. Het is het marktplaats-/providerprofiel dat de instantie gebruikt; volgens de helptekst verschijnen bij het installeren van de provider-add-ons specifieke operatorprofielen, zoals Leroy Merlin. De standaardwaarde is Generiek Mirakl.

Tabblad Verbinding, groep Toegang

Deze velden staan in het tabblad Verbinding, groep Toegang.

  • Mirakl-verbinding. Alleen-lezen en standaard FlexigoTech Cloud. De helptekst zegt dat nieuwe marktplaatsen via FlexigoTech Cloud worden verbonden en dat Direct (API-sleutel opgeslagen in Odoo) alleen behouden blijft voor de marktplaatsen die al bestonden vóór deze versie en blijven werken zoals ze zijn gekocht. Je hoeft niets in te vullen: controleer alleen welke route je instantie heeft.
  • Mirakl-API-sleutel (FlexigoTech Cloud). Staat in de groep FlexigoTech Cloud. Met de standaardwaarden is hij zichtbaar en wordt hij verborgen als de verbinding niet die van FlexigoTech Cloud is. De helptekst zegt dat hij eenmalig, versleuteld, naar FlexigoTech Cloud wordt gestuurd en nooit in Odoo wordt opgeslagen.
  • Basis-URL. Dit is de echte host van de operator. De helptekst waarschuwt dat Mirakl geen universele host levert die alle marktplaatsen delen. Voor bekende operators wordt hij automatisch ingevuld; anders voer je hem in vanuit je verkopersaccount. Voorbeeld uit de helptekst: https://adeo-marketplace.mirakl.net. Verplicht voordat je de verbinding kunt testen of synchroniseren.
  • API-basis-URL. De echte basis-URL van de API voor de gekozen operator. De helptekst zegt dat dit normaal de basis-URL plus /api is, met dit voorbeeld: https://adeo-marketplace.mirakl.net/api.
  • API-sleutel. Met de standaardwaarden niet zichtbaar: hij wordt verborgen als de verbinding FlexigoTech Cloud is, dus hij verschijnt bij instanties met een Directa-verbinding. Het is de API-sleutel van de verkoper (Settings > API key in je verkopersaccount) en is nodig voordat je Verbinding testen kunt gebruiken of synchroniseren.
  • Winkel. Zichtbaar in het formulier en in deze groep. Een optionele identificatie voor omgevingen met meerdere winkels. Volgens de helptekst vult Verbinding testen hem automatisch in wanneer Mirakl de winkel van de verkoper beschikbaar stelt.

Tabblad Financiën

Hier staat de boekhouding van de afrekeningen. In het tabblad Financiën zijn er twee groepen.

Groep Afrekeningsboekhouding

  • Afrekeningsdagboek. Een van de dagboeken om de afrekeningsboekingen van Mirakl in te boeken. Laat je het leeg, dan wordt bij het eerste gebruik een eigen dagboek aangemaakt, Mirakl afrekeningen. Kies een eigen dagboek als je dat liever niet laat aanmaken.
  • Tussenrekening marktplaats. Een tussenrekening op de balans die weergeeft wat de marktplaats je verschuldigd is voor de bestellingen: de verkopen belasten haar en ze wordt gecrediteerd wanneer de afrekening de betaling uitvoert.
  • Kostenrekening commissie. De kostenrekening voor de commissie en de tarieven van de marktplaats.
  • Uitbetaling / Bank-tussenrekening. Wordt belast met de netto-uitbetaling die naar je wordt overgemaakt en daarna afgeletterd met de echte bankstorting: handmatig in Community, met banksynchronisatie in Enterprise, volgens de helptekst.

Groep Opties

  • Kostenplaats. Optioneel. Zorgt ervoor dat de afrekeningen van deze marktplaats een winst-en-verliesrekening per kanaal voeden in de analytische rapporten van Odoo. Vul haar in als je die kijk per kanaal wilt.
  • Afrekeningen automatisch boeken. Maakt automatisch de boeking aan wanneer een afrekening wordt geïmporteerd. Staat standaard uit: vink haar alleen aan als je die boeking bij het importeren wilt.

Tabblad AI (optioneel)

  • AI-inzichten inschakelen. Staat in het tabblad AI (optioneel) en staat standaard uit. Met Odoo in het Nederlands zegt de helptekst Optioneel. De connector werkt volledig zonder AI. Als je dit niet inschakelt / geen sleutel instelt, wordt er nooit een AI-aanroep gedaan en verandert er niets. Heb je het niet nodig, laat het dan zoals het is.
Schema met de helptekst van het veld voor AI-inzichten in vijf talen
Schema gemaakt met code op basis van de gepubliceerde vertalingen van de module (geen schermafbeelding van Odoo): de helptekst van AI-inzichten inschakelen in het Spaans, Duits, Frans, Italiaans en Portugees.

Controle voordat je de instantie goedkeurt

  • Controleer dat Basis-URL en API-basis-URL naar dezelfde operator wijzen; normaal is de tweede de eerste plus /api, zoals in de voorbeelden van de helptekst.
  • Gebruikt je instantie de Directa-verbinding, bevestig dan dat Basis-URL en API-sleutel zijn ingevuld voordat je de verbinding probeert te testen of te synchroniseren.
  • Kijk na het testen van de verbinding naar Winkel: volgens de helptekst wordt hij automatisch ingevuld wanneer Mirakl de winkel van de verkoper beschikbaar stelt.
  • Loop samen met je boekhouder de rekeningen van de groep Afrekeningsboekhouding na.

Prijs en hulp bij de opstart

De module is een eenmalige aankoop per Odoo-versie en is gepubliceerd in Odoo Apps voor 17, 18, 19 en 20 (zie de pagina in Odoo Apps of de pagina van de module). Hij heeft het abonnement op FlexigoTech Cloud nodig, plan Connector: € 49 per maand of € 490 per jaar, excl. btw, tot 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. 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 Odoo-versie daar.

FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat. Wil je dat we het formulier van je instantie samen met je nalopen, schrijf ons dan.

Lees verder

Velden van de Mirakl-instantie in Mirakl Connector: wat ze betekenen en wat je invultVergelijkende gids van de velden in het formulier Mirakl instanties van Mirakl Connector voor Odoo: wat de help zegt, de standaardwaarde en wat je invult.De velden van de Mirakl-instantie in Odoo: wat elk betekent en wat je invultGids bij de velden van de Mirakl Connector-instantie voor Odoo: verzending, korting, commissie, taal, facturen en synchronisatie, volgens hun eigen hulptekst.
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen

Bronnen