Naar hoofdinhoud

Mirakl

Knop «Mirakl-vervoerders ophalen»: wat hij doet en welke fouten hij geeft

De knop Mirakl-vervoerders ophalen vraagt Mirakl om de lijst met vervoerders van je instantie, verwerkt die en zet het resultaat in de chatter. Je ziet hem altijd in het scherm Mirakl instanties. Bevat het antwoord minstens één vervoerder, dan krijg je een melding op het scherm en komt de volledige lijst in de chatter; zijn er geen vervoerders of reageert geen enkel endpoint, dan zet hij de reden in de chatter en toont hij een waarschuwing; faalt het verzoek met een andere fout, dan stopt hij met een foutmelding.

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

Voor je klikt: waar hij staat en waar je op moet letten

De instantiekaarten open je via het menu Mirakl › Configuratie › Marktplaatsen. De knop Mirakl-vervoerders ophalen staat in het scherm Mirakl instanties en hangt van geen enkele voorwaarde in de weergave af: hij is altijd zichtbaar, in Odoo 17, 18, 19 en 20.

Open de kaart van de instantie via Mirakl › Configuratie › Marktplaatsen. De knop werkt op één enkele instantie, de instantie die je open hebt.

Controleer of je Odoo versie 17, 18, 19 of 20 is: de module is voor die vier gepubliceerd in Odoo Apps en de knop zit in alle vier.

Bekijk het veld Endpoint verzendvervoerders op de kaart, tabblad Vervoerders, groep Vervoerderssynchronisatie. De hulptekst zegt: «Mirakl SH21-endpoint gebruikt om beschikbare verzendvervoerders op te halen wanneer ondersteund door de operator.» De standaardwaarde in de code is /shipping/carriers.

Controleer of het abonnement op FlexigoTech Cloud actief is. De verbinding loopt via die dienst en zonder abonnement of met een opgeschorte dienst stopt wat het abonnement biedt; de gegevens blijven in jouw Odoo.

Same stock on every Mirakl marketplace, sent from Odoo — Video: Same stock on every Mirakl marketplace, sent from Odoo (video in het Engels)

Wat de knop doet als je klikt, in volgorde

Hij raadpleegt Mirakl: hij stuurt een leesverzoek (GET) naar een vervoerders-endpoint. Zijn er meerdere kandidaat-endpoints, dan probeert hij ze een voor een.

Geeft een endpoint een 404-fout, dan gaat hij naar de volgende kandidaat.

Is de fout van een ander type, dan stopt de actie met Kon vervoerders niet ophalen uit Mirakl: …, waarbij de weglatingstekens de ontvangen fout zijn. Omdat de actie stopt, wordt niet opgeslagen wat er zou veranderen en komt er geen melding.

Laat FlexigoTech Cloud het verzoek niet door (zonder abonnement of met de dienst op pauze), dan stopt de actie en wordt niets gemarkeerd.

Geeft geen enkel endpoint een antwoord, dan zet hij in de chatter en in een waarschuwing Deze operator stelt geen generieke Mirakl-vervoerders beschikbaar via SH21. Geprobeerd: …. De weglatingstekens zijn de geprobeerde endpoints.

Verschilt het endpoint dat antwoordde van het endpoint in Endpoint verzendvervoerders, dan schrijft de module het endpoint dat antwoordde in dat veld.

Hij leest het antwoord. Kan hij het niet als lijst met vervoerders lezen, dan stopt de actie met Onverwacht responsformaat van het Mirakl-vervoerderseindpunt.

Hij verwerkt de lijst en haalt twee gegevens op: hoeveel vervoerders er zijn en hoeveel vervoerderskoppelingen zijn bijgewerkt.

Is er na het verwerken van het antwoord geen enkele vervoerder, dan zet hij in de chatter en in een waarschuwing De operator reageerde op … maar retourneerde geen vervoerders. Vervoerderskoppeling blijft optioneel voor deze instantie. De plaatshouder is het endpoint dat antwoordde.

Schema gemaakt met code, geen scherm van Odoo: het menu Marktplaatsen, de knop om Mirakl-vervoerders op te halen in Odoo 17, 18, 19 en 20, en ernaast de meldingen die hem kunnen stoppen — Schema gemaakt met code op basis van de gepubliceerde code van de module: menu, knop en twee van de meldingen die kunnen verschijnen als je klikt.

Wat je moet zien als het goed gaat

De succesmelding verschijnt alleen als er na het verwerken van het antwoord minstens één vervoerder is.

Een melding op het scherm met de titel Mirakl vervoerders en de tekst … vervoerders beschikbaar via …. … koppeling(en) bijgewerkt. Zie chatter voor de volledige lijst. De plaatshouders zijn, in volgorde, het aantal vervoerders, het endpoint dat antwoordde en het aantal bijgewerkte koppelingen. De melding blijft niet vastzitten op het scherm.

Open de chatter van de instantie: de module plaatst daar een bericht met het endpoint, hoeveel vervoerders beschikbaar zijn, de lijst met de code van elk en de naam tussen haakjes, en hoeveel vervoerderskoppelingen zijn bijgewerkt.

Kijk nog eens naar Endpoint verzendvervoerders: antwoordde een ander endpoint dan het ingestelde, dan heeft het veld nu de waarde van het endpoint dat antwoordde.

Als het niet goed gaat: wat je in elk geval controleert

Kon vervoerders niet ophalen uit Mirakl: … komt als je op de knop klikt en een verzoek faalt met een fout die geen 404 is. Wat te doen: lees de details na de dubbele punt, dat is de ontvangen fout. Twijfel je aan de verbinding met Mirakl, kijk dan wat de knop Verbinding testen doet.

Onverwacht responsformaat van het Mirakl-vervoerderseindpunt. komt als je op de knop klikt en het antwoord binnenkomt, maar de module het niet als lijst met vervoerders kan lezen. Wat te doen: controleer de waarde van Endpoint verzendvervoerders en onthoud wat de hulptekst zegt: het is het SH21-endpoint om verzendvervoerders op te halen wanneer de operator dat ondersteunt.

Deze operator stelt geen generieke Mirakl-vervoerders beschikbaar via SH21. Geprobeerd: …. verschijnt in de chatter en in een waarschuwing wanneer geen enkel endpoint een antwoord geeft. Wat te doen: kijk welke endpoints na «Geprobeerd:» staan en vergelijk ze met Endpoint verzendvervoerders.

De operator reageerde op … maar retourneerde geen vervoerders. Vervoerderskoppeling blijft optioneel voor deze instantie. verschijnt in de chatter en in een waarschuwing wanneer er na het verwerken van het antwoord geen vervoerder overblijft. Wat te doen: de tekst zelf zegt dat de vervoerderskoppeling optioneel blijft voor die instantie.

Laat FlexigoTech Cloud het verzoek niet door (zonder abonnement of met de dienst op pauze), dan stopt de actie en wordt niets gemarkeerd: controleer of het abonnement actief is.

De naam van de knop in elke taal

Taal van Odoo	Naam van de knop
Spaans	`Mirakl-vervoerders ophalen`
Duits	`Mirakl-Versanddienstleister abrufen`
Frans	`Récupérer les transporteurs Mirakl`
Italiaans	`Recupera corrieri Mirakl`
Portugees	`Obter Transportadoras Mirakl`

Schema gemaakt met code, geen scherm van Odoo: de naam van de knop in het Spaans, Duits, Frans, Italiaans en Portugees — Schema gemaakt met code op basis van de gepubliceerde vertalingen van de module: hoe de knop heet naargelang de taal van Odoo.

Wat je nodig hebt en hoe FlexigoTech je helpt

Mirakl Connector is een module met eenmalige betaling per versie en heeft het abonnement op FlexigoTech Cloud nodig: plan Connector, € 49 per maand of € 490 per jaar excl. btw, met maximaal 3 accounts van het platform. De prijs van elke Odoo-versie staat op de pagina in Odoo Apps.

FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat. Wil je dat we je Mirakl-instantie nakijken, dan vind je de pagina van de module.

Lees verder

Mirakl Connector: «Stel de Mirakl API-sleutel in voordat u de verbinding test»Wanneer de fout over een lege API-sleutel verschijnt in Mirakl Connector voor Odoo, welke voorwaarde die veroorzaakt en hoe je haar oplost bij Verbinding…Mirakl Connector: «Voor deze koppeling is geen Mirakl-instantie geconfigureerd.»Wanneer Mirakl Connector meldt dat een koppeling geen Mirakl-instantie heeft, welke voorwaarde dat veroorzaakt en wat je doet als de melding verschijnt.Wat de knop Verbinding testen van Mirakl Connector doet, stap voor stapWat doet de knop Verbinding testen van Mirakl Connector in Odoo: wanneer hij verschijnt, wat hij controleert, wat hij opslaat en welke fouten kunnen optreden.

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): views/mirakl_instance_views.xml
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/precios.html
flexigotech.com/en/services.html