Bouton « Récupérer les transporteurs Mirakl » : ce qu'il fait et les erreurs possibles

Avant de cliquer : où il se trouve et quoi vérifier

Les fiches d'instance s'ouvrent depuis le menu Mirakl › Configuration › Marketplaces. Le bouton Récupérer les transporteurs Mirakl se trouve sur l'écran Instances Mirakl (Mirakl Instances) et ne dépend d'aucune condition de la vue : il est toujours visible, dans Odoo 17, 18, 19 et 20.

• Ouvrez la fiche de l'instance depuis Mirakl › Configuration › Marketplaces. Le bouton agit sur une seule instance, celle que vous avez ouverte.

• Vérifiez que votre Odoo est en version 17, 18, 19 ou 20 : le module est publié sur Odoo Apps pour ces quatre versions et le bouton est présent dans toutes.

• Contrôlez le champ Point de terminaison Transporteurs d'expédition (Endpoint Shipping Carriers), sur la fiche, onglet Transporteurs, groupe Synchronisation des transporteurs. Son aide indique : « Point de terminaison Mirakl SH21 utilisé pour récupérer les transporteurs disponibles lorsque pris en charge par l'opérateur. » La valeur par défaut fournie par le code est /shipping/carriers.

• Confirmez que l'abonnement à FlexigoTech Cloud est actif. La connexion passe par ce service et, sans abonnement ou avec le service suspendu, ce que couvre l'abonnement s'arrête ; les données restent dans votre Odoo.

Ce que fait le bouton quand on clique, dans l'ordre

• Il interroge Mirakl : il lance une requête de lecture (GET) vers un point de terminaison de transporteurs. S'il y a plusieurs points de terminaison candidats, il les essaie les uns après les autres.

• Si un point de terminaison répond par une erreur 404, il passe au candidat suivant.

• Si l'erreur est d'un autre type, l'action s'arrête avec Impossible de récupérer les transporteurs depuis Mirakl : … (Could not fetch carriers from Mirakl: …), où les points de suspension correspondent à l'erreur reçue. Comme l'action s'arrête, ce qui allait changer n'est pas enregistré et aucun avis ne s'affiche.

• Si FlexigoTech Cloud ne laisse pas passer la requête (sans abonnement ou avec le service en pause), l'action s'arrête et rien n'est marqué.

• Si aucun point de terminaison ne renvoie de réponse, il publie dans le chatter et dans un avis d'avertissement Cet opérateur n'expose pas les transporteurs Mirakl génériques via SH21. Tenté : …. (This operator does not expose generic Mirakl carriers via SH21. Tried: ….). Les points de suspension correspondent aux points de terminaison essayés.

• Si le point de terminaison qui a répondu est différent de celui qui figurait dans Point de terminaison Transporteurs d'expédition, le module écrit dans ce champ celui qui a répondu.

• Il lit la réponse. S'il ne peut pas l'interpréter comme une liste de transporteurs, l'action s'arrête avec Format de réponse inattendu du point de terminaison des transporteurs Mirakl. (Unexpected response format from Mirakl carriers endpoint.)

• Il traite la liste et obtient deux données : combien de transporteurs il y a et combien d'associations de transporteur ont été mises à jour.

• Si, après traitement de la réponse, il n'y a aucun transporteur, il publie dans le chatter et dans un avis d'avertissement L'opérateur a répondu à … mais n'a renvoyé aucun transporteur. Le mappage des transporteurs reste facultatif pour cette instance. (The operator responded to … but returned no carriers. Carrier mapping remains optional for this instance.) Les points de suspension correspondent au point de terminaison qui a répondu.

Ce que vous devez voir quand tout va bien

L'avis de succès n'apparaît que lorsque, après traitement de la réponse, il y a au moins un transporteur.

• Un avis à l'écran avec le titre Transporteurs Mirakl (Mirakl Carriers) et le texte … transporteurs disponibles depuis …. … correspondance(s) mise(s) à jour. Voir le chatter pour la liste complète. (… carriers available from …. … map(s) updated. See chatter for full list.) Les trous correspondent, dans l'ordre, au nombre de transporteurs, au point de terminaison qui a répondu et au nombre d'associations mises à jour. L'avis ne reste pas affiché à l'écran.

• Ouvrez le chatter de l'instance : le module y publie un message avec le point de terminaison, le nombre de transporteurs disponibles, la liste avec le code de chacun et son nom entre parenthèses, et le nombre d'associations de transporteur mises à jour.

• Regardez à nouveau Point de terminaison Transporteurs d'expédition : si un point de terminaison différent de celui configuré a répondu, le champ contient désormais la valeur de celui qui a répondu.

Quand ça ne va pas : que vérifier dans chaque cas

• Impossible de récupérer les transporteurs depuis Mirakl : … apparaît au clic sur le bouton lorsqu'une requête échoue avec une erreur qui n'est pas un 404. Que faire : lisez le détail qui suit les deux-points, c'est l'erreur reçue. Si vous doutez de la connexion avec Mirakl, voyez ce que fait le bouton Tester la connexion.

• Format de réponse inattendu du point de terminaison des transporteurs Mirakl. apparaît au clic sur le bouton lorsque la réponse arrive, mais que le module ne peut pas la lire comme une liste de transporteurs. Que faire : vérifiez la valeur de Point de terminaison Transporteurs d'expédition et rappelez-vous ce que dit son aide : c'est le point de terminaison SH21 pour récupérer les transporteurs lorsque l'opérateur le prend en charge.

• Cet opérateur n'expose pas les transporteurs Mirakl génériques via SH21. Tenté : …. apparaît dans le chatter et dans un avis d'avertissement lorsqu'aucun point de terminaison ne renvoie de réponse. Que faire : regardez quels points de terminaison figurent après « Tenté : » et comparez-les avec Point de terminaison Transporteurs d'expédition.

• L'opérateur a répondu à … mais n'a renvoyé aucun transporteur. Le mappage des transporteurs reste facultatif pour cette instance. apparaît dans le chatter et dans un avis d'avertissement lorsqu'il ne reste aucun transporteur après traitement de la réponse. Que faire : le texte lui-même indique que le mappage des transporteurs reste facultatif pour cette instance.

• Si FlexigoTech Cloud ne laisse pas passer la requête (sans abonnement ou avec le service en pause), l'action s'arrête et rien n'est marqué : vérifiez que l'abonnement est actif.

L'intitulé du bouton dans chaque langue

Ce dont vous avez besoin et comment FlexigoTech vous aide

Mirakl Connector est un module à paiement unique par version et nécessite l'abonnement à FlexigoTech Cloud : plan Connecteur, 49 €/mois ou 490 €/an HT, avec jusqu'à 3 comptes de la plateforme. Le prix de chaque version d'Odoo figure sur la fiche Odoo Apps.

FlexigoTech met en place Odoo 17, 18, 19 et 20 et développe des connecteurs et des intégrations sur mesure. Si vous souhaitez que nous examinions votre instance Mirakl, consultez la page du module.

À lire aussi

Vérifié dans le code du connecteur (version 20.0) et dans les sources citées

Sources

• Code du module : flexigobe_mirakl_connector 20.0 (aa05e537): views/mirakl_instance_views.xml
• Code du module : flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
• Code du 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