Naar hoofdinhoud
Mirakl

Velden van de Mirakl-instantie in Mirakl Connector: wat ze betekenen en wat je invult

Het formulier Mirakl instanties verdeelt zijn velden over meerdere tabbladen en elk veld heeft een eigen helptekst. Hier vergelijken we ze: wat de help zegt, welke standaardwaarde ze hebben en wat er verandert als je ze leeg laat of 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
6 min

Waar de velden staan

De formulieren open je via het menu Mirakl › Configuratie › Marktplaatsen. In het formulier Mirakl instanties (Mirakl Instances) staan de velden uit deze gids verdeeld over drie tabbladen: Vervoerders (Carriers), Orders en retouren (Orders and Returns) en Handmatige bewerkingen (Manual Operations).

Met code gemaakt schema van het menu Mirakl, Configuration, Marketplaces en van het formulier Mirakl Instance met de velden die hier worden vergeleken
Schema met code gemaakt op basis van de gepubliceerde code van de module, geen schermafbeelding van Odoo: het menu en de velden van het formulier met hun originele labels.
Same stock on every Mirakl marketplace, sent from Odoo
Video: Same stock on every Mirakl marketplace, sent from Odoo (video in het Engels)

Importvensters en limieten

Deze velden begrenzen wat wordt geïmporteerd, geanalyseerd of opgevraagd. Allemaal hebben ze een standaardwaarde in de code.

VeldWaar het staatWat de help zegtStandaard
Initiële ordersynchronisatiedagen (Initial Order Sync Days)Orders en retouren, groep Windows«Historisch venster dat wordt gebruikt wanneer er geen eerdere ordersynchronisatie is. Handmatige import gebruikt ook dit bereik.»30
Initiële retoursynchronisatiedagen (Initial Return Sync Days)Orders en retouren, groep Windows«Historisch venster dat wordt gebruikt wanneer er geen eerdere retoursynchronisatie is. Handmatige import gebruikt ook dit bereik.»30
Max. synchronisatiepagina's (Max Sync Pages)Orders en retouren, groep Windows«Veiligheidslimiet voor gepagineerde order-/retourimports.»40
Limiet aanbodkoppeling genereren (Offer Binding Generate Limit)Handmatige bewerkingen, groep Aanbiedingen (Offers)«Maximaal aantal producten dat wordt gescand bij het automatisch genereren van ontbrekende aanbodkoppelingen.»500
Endpoint verzendvervoerders (Endpoint Shipping Carriers)Vervoerders, groep Vervoerderssynchronisatie (Carrier Sync)«Mirakl SH21-endpoint gebruikt om beschikbare verzendvervoerders op te halen wanneer ondersteund door de operator.»/shipping/carriers

De twee dagenvelden bepalen het venster dat wordt gebruikt wanneer er nog geen eerdere synchronisatie van orders of retouren is, en de help voegt eraan toe dat de handmatige import hetzelfde bereik gebruikt. Max. synchronisatiepagina's is volgens de help een veiligheidslimiet voor de gepagineerde imports.

Klant van de order: twee modi en twee selectievakjes

Het veld Klantmodus voor orders (Order Customer Mode) staat in Orders en retouren, groep Klant & privacy (Customer & Privacy). Het heeft twee waarden: Eén klant per koper (standaard) (One customer per shopper (standard)), de standaardwaarde, en Eén standaardklant met leverings-subcontacten (Single default customer with delivery child contacts).

VeldWanneer zichtbaarStandaard
Klantmodus voor ordersIn de groep Klant & privacyEén klant per koper (standaard)
Standaard marketplace-klant (Default Marketplace Customer)Alleen met de modus met één klant; met de standaardwaarden is het niet zichtbaarVerborgen in de standaardmodus
Leveringscontacten als bedrijven (Delivery Contacts as Companies)Alleen met de modus met één klant; met de standaardwaarden is het niet zichtbaarUitgeschakeld
Mirakl-notificatie-e-mail gebruiken (Use Mirakl Notification Email)In de groep Klant & privacyUitgeschakeld

Wat de help van elke optie zegt:

  • Standaardmodus: elke koper wordt zijn eigen klant in Odoo.
  • Eén standaardklant: alle orders van de marktplaats worden toegewezen aan één vaste klant, die je kiest in Standaard marketplace-klant. Het afleveradres van de koper wordt opgeslagen als subcontact van die klant (type Aflevering, gemarkeerd als koper van de marktplaats), zodat de persoonsgegevens afgebakend blijven en met een recordregel kunnen worden verborgen. De facturen worden op de standaardklant uitgeschreven en bevatten geen gegevens van de koper.
  • Leveringscontacten als bedrijven: alleen met één klant. Elk afleveradres wordt een eigen bedrijfscontact in plaats van een subcontact van de standaardklant, zodat de verkooporder, de levering en de afleverbon het bedrijf van de eindklant tonen en nooit de naam van de standaardklant. De help geeft aan dat de persoon naar Contactpersoon gaat en dat de e-mail die Mirakl van de klant meestuurt niet wordt opgeslagen: bij marktplaatsen waar de operator bij jou koopt (bijvoorbeeld GACD) is dat een adres van de operator, niet van de klant.
  • Notificatie-e-mail: Mirakl anonimiseert de koper achter een relay-adres per order, dat bij elke order verandert. Met het vakje aan wordt het relay-adres gebruikt als e-mail van het leveringscontact van de order (nooit in een permanente klantkaart), zodat antwoorden de koper via Mirakl bereiken. In de modus met één klant draagt het subcontact van de koper altijd het relay-adres wanneer Mirakl dat levert. De waarde van elke order wordt ook opgeslagen in de verkooporder.

Verkoopbrug: leeg versus ingevuld

In het tabblad Orders en retouren bundelt de groep Verkoopbrug (Sales Bridge) velden waarvan de help zegt wat er gebeurt als je ze leeg laat.

VeldAls je het leeg laatAls je het invult
Verzendproduct (Shipping Product). Op het scherm staat het zonder label: alleen de inhoud is zichtbaarEr wordt geen verzendregel aan de verkooporder toegevoegdDat serviceproduct wordt gebruikt voor de regel met verzendkosten
Verkooporders aanmaken vanaf (Create Sales Orders From)Geen limietDe Mirakl-orders die vóór die datum zijn aangemaakt, worden geïmporteerd maar worden nooit verkooporders
Verkoper op orders (Salesperson on Orders)Odoo beslist: de verkoper van de klant of, als die er niet is, de gebruiker die de order heeft geïmporteerd (OdooBot bij de automatische import)Die verkoper wordt gezet op elke verkooporder die uit deze marktplaats wordt geïmporteerd
Verzendmethode op orders (Shipping Method on Orders)De verkooporders hebben geen verzendmethodeDie methode wordt gezet op elke verkooporder en daarmee ook op de levering ervan

Twee nuances uit de help. Bij Verkooporders aanmaken vanaf is de reden dat orders die al werden afgehandeld voordat je de connector gebruikte, niet opnieuw worden verzonden. Bij Verzendmethode op orders vraagt de help om de methode toe te wijzen in Mirakl > Catálogo > Asignación de transportistas, zodat het trackingnummer met de juiste vervoerder bij Mirakl aankomt.

De tracking versturen bij validatie

Het vakje Tracking naar Mirakl sturen bij validatie (Send Tracking to Mirakl on Validation) staat standaard uit. Als je het inschakelt, wordt bij het valideren van de levering in Odoo de zending naar Mirakl gestuurd (trackingnummer, vervoerder en verzendbevestiging), zodat de marktplaats de order als verzonden markeert en de koper de tracking ziet. De help stelt twee voorwaarden: de levering moet een trackingnummer hebben en de vervoerder ervan zou gekoppeld moeten zijn in het tabblad Vervoerders. Ontbreekt het nummer, dan blijft de afleverbon ongemoeid en legt een notitie uit waarom. Sommige marktplaatsprofielen, zoals Leroy Merlin, sturen het altijd omdat de operator dat eist.

Het endpointveld voor vervoerders

De help van Endpoint verzendvervoerders luidt, met Odoo in het Nederlands: «Mirakl SH21-endpoint gebruikt om beschikbare verzendvervoerders op te halen wanneer ondersteund door de operator.». Het schema toont diezelfde tekst in het Duits, Frans, Italiaans en Portugees.

Schema met de help van het veld Endpoint Shipping Carriers in het Spaans, Duits, Frans, Italiaans en Portugees
Schema met code gemaakt op basis van de gepubliceerde vertalingen van de module, geen schermafbeelding van Odoo.

Wat je invult, per situatie

  • Je verkocht al op de marktplaats voordat je de connector installeerde: vul Verkooporders aanmaken vanaf in; volgens de help worden eerdere orders geïmporteerd maar worden het geen verkooporders.
  • Je wilt niet één Odoo-klant per koper: kies de modus met één klant en geef de Standaard marketplace-klant op; de help stelt een generiek contact per marktplaats voor.
  • Je wilt dat de koper de tracking ziet bij validatie: schakel Tracking naar Mirakl sturen bij validatie in en controleer de vervoerder in het tabblad Vervoerders.
  • Je wilt geen regel met verzendkosten: laat Verzendproduct leeg.
  • Je hebt geen vaste verkoper voor deze orders: laat Verkoper op orders leeg en Odoo beslist volgens de help.

Kosten en hulp van FlexigoTech

Mirakl Connector is een module met eenmalige betaling per Odoo-versie (gepubliceerd in Odoo Apps voor 17, 18, 19 en 20) en vereist het abonnement op FlexigoTech Cloud: 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. Je vindt de pagina in Odoo Apps en de modulepagina. Als je liever hebt dat iemand de instantie samen met jou configureert: FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat.

Lees verder

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.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