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


Importvensters en limieten
Deze velden begrenzen wat wordt geïmporteerd, geanalyseerd of opgevraagd. Allemaal hebben ze een standaardwaarde in de code.
| Veld | Waar het staat | Wat de help zegt | Standaard |
|---|---|---|---|
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).
| Veld | Wanneer zichtbaar | Standaard |
|---|---|---|
Klantmodus voor orders | In de groep Klant & privacy | Eén klant per koper (standaard) |
Standaard marketplace-klant (Default Marketplace Customer) | Alleen met de modus met één klant; met de standaardwaarden is het niet zichtbaar | Verborgen in de standaardmodus |
Leveringscontacten als bedrijven (Delivery Contacts as Companies) | Alleen met de modus met één klant; met de standaardwaarden is het niet zichtbaar | Uitgeschakeld |
Mirakl-notificatie-e-mail gebruiken (Use Mirakl Notification Email) | In de groep Klant & privacy | Uitgeschakeld |
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.
| Veld | Als je het leeg laat | Als je het invult |
|---|---|---|
Verzendproduct (Shipping Product). Op het scherm staat het zonder label: alleen de inhoud is zichtbaar | Er wordt geen verzendregel aan de verkooporder toegevoegd | Dat serviceproduct wordt gebruikt voor de regel met verzendkosten |
Verkooporders aanmaken vanaf (Create Sales Orders From) | Geen limiet | De 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 verzendmethode | Die 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.

Wat je invult, per situatie
- Je verkocht al op de marktplaats voordat je de connector installeerde: vul
Verkooporders aanmaken vanafin; 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-klantop; 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 validatiein en controleer de vervoerder in het tabbladVervoerders. - Je wilt geen regel met verzendkosten: laat
Verzendproductleeg. - Je hebt geen vaste verkoper voor deze orders: laat
Verkoper op ordersleeg 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
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen
Bronnen
- Broncode van de module: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
- Broncode van de module: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_ai.py
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- flexigotech.com/en/services.html
- flexigotech.com/precios.html
