Wat de module aanraakt in Verkoop
De module breidt de standaard verkooporder van de app Verkoop (Sales) in Odoo uit. Het gaat om velden op het formulier, waarvan één ook in de orderlijst staat, en om aanpassingen in het gedrag van de order in de code. Dit is wat je best weet voordat je de eerste order opent die van een marktplaats binnenkomt.


Details die je niet op het formulier ziet
De velden verschijnen pas als de order een Mirakl order heeft
De velden van de module staan op het formulier van de verkooporder, in het tabblad Mirakl, verdeeld over twee groepen: Marktplaats en Verzending & contact (Shipping & Contact). Ze zijn allemaal verborgen zolang Mirakl order (Mirakl Order) leeg is, dus bij een order zonder die waarde zie je hier niets van.
In de groep Marktplaats staan Mirakl instantie (Mirakl Instance), Mirakl order, Mirakl orderstatus (Mirakl Order State) en Mirakl laatste synchronisatie op (Mirakl Last Sync At). Alle vier zijn alleen-lezen: je kunt ze raadplegen, niet bewerken.

Het e-mailadres van de klant kan een geanonimiseerd relay-adres zijn
E-mail klant Mirakl (Mirakl Customer Email) staat in de groep Verzending & contact en is alleen-lezen. Volgens de help bevat het niet altijd het echte e-mailadres van de koper: als het bestaat, bewaart het veld het geanonimiseerde relay-adres dat Mirakl voor elke order aanmaakt, en wat je daarheen stuurt, komt bij de koper aan. Als er geen relay is, bewaart het veld het e-mailadres van de klant dat de order meebrengt.
Het telefoonnummer en de contactpersoon hebben hun eigen logica
Telefoon Mirakl-klant (Mirakl Customer Phone) bevat het telefoonnummer dat de koper op de marktplaats heeft opgegeven, zodat je het direct vanuit de order bij de hand hebt. Volgens de help wordt het ook opgeslagen in het afleveradrescontact. Het is alleen-lezen.
Mirakl-contactpersoon (Mirakl Contact Person) heeft nog een extra voorwaarde. Je ziet het alleen als de order een Mirakl order heeft en het veld zelf ook een waarde heeft. De help zegt dat het de persoon bevat die de order heeft geplaatst wanneer de marktplaats daarnaast een bedrijfsnaam meestuurt, en dat het bedrijf in dat geval als naam van het afleveradrescontact wordt gebruikt. Zie je het veld niet, dan is het bij die order leeg.
De verzendmethode staat ook in de orderlijst
Mirakl-verzendmethode (Mirakl Shipping Method) staat in Verzending & contact en verschijnt, anders dan de rest, ook in de lijst met verkooporders. De help zegt dat het de verzendmethode is die de koper op de marktplaats heeft gekozen (bijvoorbeeld Standaard of Volgende dag) en dat het leeg blijft wanneer de operator die niet meestuurt.
Een leeg veld hier wijst dus niet op een fout: het gebeurt wanneer de operator dat gegeven niet meestuurt.
Een Mirakl-order verwijderen laat hem verwijderd
De module verandert wat er gebeurt als je een verkooporder verwijdert. Volgens de code van Odoo 20 zoekt hij vóór het verwijderen de eraan gekoppelde Mirakl-orders op. Heeft de verkooporder een Mirakl order, dan zoekt hij ook de Mirakl-order met die identificatie in dezelfde instantie, wat een offerte dekt die nooit is gekoppeld. Na het verwijderen markeert hij die Mirakl-orders als verwijderd.
De reden staat in een opmerking in de code zelf: een verwijderde verkooporder moet verwijderd blijven, omdat de Mirakl-order hem onthoudt en een nieuwe synchronisatie hem niet automatisch opnieuw aanmaakt of bevestigt.
Klant of adressen wijzigen in een Mirakl-order
In Odoo 20 slaat de module wijzigingen in de klant, het afleveradres of het factuuradres van een order met Mirakl order anders op dan de standaard. Bij orders zonder Mirakl order is het opslaan het standaardgedrag.
De factuur kan vereenvoudigd of volledig zijn, afhankelijk van de instantie
Bij het voorbereiden van de factuur vanuit de order kijkt de module naar de instelling voor het Spaanse factuurtype van de Mirakl-instantie van de order (code van Odoo 20). Die instelling hoort bij de instantie, niet bij de order; ze wordt behandeld in De velden van Mirakl-instantie in Mirakl Connector.
- Heeft de order geen instantie, of staat de instelling op automatisch, dan wordt de factuur voorbereid zoals in standaard Odoo.
- Is de Spaanse lokalisatie van Odoo niet geïnstalleerd (de facturen hebben het veld voor vereenvoudigde factuur niet), dan wordt er ook niets aangepast.
- Staat de instelling op vereenvoudigd, dan wordt de factuur als vereenvoudigd gemarkeerd. Staat ze op volledig, dan wordt ze als niet-vereenvoudigd gemarkeerd.
Hoe het aansluit op de rest en wat het kost
De module is een eenmalige aankoop per versie en vereist het abonnement op FlexigoTech Cloud: plan Connector, € 49 per maand of € 490 per jaar excl. btw. De verbinding loopt via FlexigoTech Cloud, dat de inloggegevens versleuteld bewaart, de synchronisatie bewaakt en per e-mail waarschuwt als die faalt. Ze is gepubliceerd voor Odoo 17, 18, 19 en 20; in de Odoo App Store koop je elke versie daar. Meer details in de Odoo Apps-pagina en op de pagina van de module.
Wil je dat we nakijken hoe de orderflow in jouw Odoo eruitziet, dan implementeert FlexigoTech Odoo 17, 18, 19 en 20 en ontwikkelt het 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/sale_order.py
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- flexigotech.com/en/services.html
- flexigotech.com/precios.html
