Aller au contenu principal
Mirakl

Ce que fait le bouton « Récupérer les motifs de remboursement » de Mirakl Connector

Le bouton Récupérer les motifs de remboursement (Fetch Refund Reasons) demande à Mirakl la liste des codes de motif de l'opérateur et l'écrit dans le chatter de l'instance. Il est toujours visible sur l'écran de l'instance, dans Odoo 17, 18, 19 et 20. Voici ce qu'il vérifie, ce qui change et quels messages il peut afficher.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 5 novembre 2026

L'essentiel

Module
Mirakl
Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du connecteur, version 20.0 · dans les sources citées à la fin
Lecture
5 min

Où se trouve le bouton et quand il est visible

Où se trouve le bouton et comment s'appelle-t-il ?

On y accède depuis le menu Mirakl › Configuration › Marketplaces, qui ouvre l'écran Instances Mirakl (Mirakl Instances). Le menu Mirakl n'est visible que pour les utilisateurs internes d'Odoo : si vous n'en êtes pas un, vous ne voyez pas cette section. Avec Odoo en français, le bouton s'appelle Récupérer les motifs de remboursement ; dans les autres langues, le libellé change, comme le montre le second schéma.

Schéma réalisé avec du code du menu Mirakl › Configuration › Marketplaces et du bouton Fetch Refund Reasons, avec les messages qui peuvent l'arrêter sur le côté
Schéma réalisé avec du code à partir du code publié du module (ce n'est pas un écran d'Odoo) : le menu, le bouton dans Odoo 17, 18, 19 et 20, et les messages sur le côté, avec les libellés en anglais du code d'origine.
Schéma réalisé avec du code avec le texte du bouton en espagnol, allemand, français, italien et portugais
Schéma réalisé avec du code à partir des traductions publiées du module (ce n'est pas un écran d'Odoo) : en espagnol, Obtener motivos de reembolso ; en allemand Erstattungsgründe abrufen, en français Récupérer les motifs de remboursement, en italien Recupera motivi di rimborso et en portugais Obter motivos de reembolso.

Quand apparaît-il ?

Le bouton est toujours visible sur l'écran Instances Mirakl, et il existe dans Odoo 17, 18, 19 et 20. Il ne dépend d'aucun statut ni d'aucune case de la fiche.

À quoi sert-il ?

Selon le code même du module, il liste les codes de motif de remboursement de l'opérateur et les publie dans le chatter de l'instance, pour savoir quoi saisir dans Code motif de remboursement. Le même code rappelle que Mirakl rejette les remboursements qui ne comportent pas de code valide de l'opérateur.

Same stock on every Mirakl marketplace, sent from Odoo
Vidéo : Same stock on every Mirakl marketplace, sent from Odoo (vidéo en anglais)

Ce qu'il fait quand on clique

Que fait-il étape par étape ?

Il travaille avec l'instance que vous avez ouverte. Il demande d'abord à Mirakl les motifs de l'opérateur. Ensuite, il garde les motifs reçus et les transforme en une ligne par motif : code, libellé et, entre parenthèses, le type (un tiret si le motif n'a pas de type). Enfin, il écrit une note dans le chatter et affiche un avis.

Quels motifs la liste inclut-elle ?

Il filtre d'abord les motifs dont le type contient le mot REFUND, sans distinguer majuscules et minuscules. Si aucun ne le contient, il publie tous les motifs reçus. S'il ne reste aucun motif à publier, le bouton s'arrête avec une erreur (plus bas).

Qu'est-ce qui change dans Odoo à la fin ?

Dans le chatter de l'instance apparaît une note qui commence par Códigos de motivo del operador (usa el CÓDIGO en 'Código de motivo de reembolso'): (Operator reason codes (use the CODE in 'Refund Reason Code'):) et se poursuit avec les lignes, une par motif. En outre, un avis intitulé Mirakl s'affiche avec le texte … codes de motif publiés dans le chatter. (… reason codes posted to the chatter.), où les points de suspension correspondent au nombre de lignes publiées ; l'avis ne reste pas affiché à l'écran. Chaque clic fait une nouvelle requête et ajoute une autre note, vous pouvez donc recliquer quand vous voulez rafraîchir la liste.

Comment vérifier que ça a fonctionné ?

Ouvrez le chatter de l'instance : la note s'y trouve, avec une ligne par motif. Cette ligne contient le code, que le code même du module indique d'utiliser dans Code motif de remboursement.

Erreurs et prérequis

Que se passe-t-il si l'opérateur ne renvoie aucun code ?

L'action s'arrête avec le message L'opérateur n'a renvoyé aucun code de motif. Consultez plutôt les codes dans votre portail vendeur du marketplace. (The operator returned no reason codes. Check the codes in your marketplace seller portal instead.) Aucune note n'est publiée. Il suffit de faire ce que dit le message : consulter les codes dans votre portail vendeur du marketplace.

Et si la connexion à Mirakl échoue ?

En cliquant sur le bouton, vous pouvez voir Erreur de connexion lors de l'appel à Mirakl : … (Connection error calling Mirakl: …) et Échec de la requête Mirakl après plusieurs tentatives. (Mirakl request failed after retries.) Ces messages viennent de la requête envoyée à Mirakl, que le module répète face à certaines réponses temporaires du serveur avant d'abandonner. Dans ce cas, l'action s'arrête avant d'écrire la note dans le chatter. Comme chaque clic fait une nouvelle requête, vous pouvez recliquer sur le bouton.

Quel est le coût et que faut-il ?

Mirakl Connector est un module à paiement unique par version, publié sur Odoo Apps pour Odoo 17, 18, 19 et 20 ; le prix de chaque version figure sur sa fiche et l'achat direct sur la page du module. Il nécessite en plus l'abonnement à FlexigoTech Cloud, plan Connecteur : 49 €/mois ou 490 €/an HT, jusqu'à 3 comptes de la plateforme (le plan Pro, 98 €/mois ou 980 €/an, jusqu'à 10). La connexion passe par FlexigoTech Cloud, qui conserve les identifiants chiffrés et prévient par e-mail si la synchronisation échoue. Sans abonnement, ou avec le service suspendu, ce que fournit l'abonnement s'arrête ; les données restent dans votre Odoo.

Autres appels à Mirakl et comment nous vous aidons

Ce bouton est la requête des motifs de remboursement. Le module appelle aussi Mirakl à d'autres moments, avec d'autres requêtes : lors de la validation d'un bon de livraison, il peut appeler Mirakl pour lire la commande ou envoyer le suivi, et la tâche planifiée Mirakl - Synchroniser les commandes (Mirakl - Sync Orders) s'exécute toutes les dix minutes et est active dès l'installation.

Si vous mettez en place Odoo et souhaitez connecter une marketplace Mirakl, FlexigoTech déploie Odoo 17, 18, 19 et 20 et développe des connecteurs et des intégrations sur mesure.

À lire aussi

Checklist de l'instance Mirakl Connector, champ par champChecklist pour remplir l'instance Mirakl Connector dans Odoo : connexion, comptes de règlement et options, avec ce que dit l'aide de chaque champ.Champs d'Instance Mirakl dans Mirakl Connector : sens et valeurs à saisirGuide comparatif des champs de la fiche Instances Mirakl dans Mirakl Connector pour Odoo : ce que dit chaque aide, sa valeur par défaut et que saisir.
Vérifié dans le code du connecteur (version 20.0) et dans les sources citées

Sources