Aller au contenu principal
Mirakl

Une commande Mirakl dans Odoo, de l'achat au versement

Une commande venant d'une marketplace qui tourne sur Mirakl passe par sept étapes dans Odoo : elle arrive, elle est acceptée, préparée, expédiée avec un suivi, facturée, payée dans le règlement et, parfois, elle revient en retour. Cette chronologie vous dit ce que fait le connecteur à chaque étape et à quelle fréquence.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 3 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
3 min

Leroy Merlin, Decathlon ou Bricodepot tournent sur Mirakl en coulisse. Pour Odoo, l'opérateur ne change rien : le connecteur, publié pour Odoo 17, 18, 19 et 20, dialogue avec l'API Mirakl de chaque marketplace que vous configurez et suit toujours le même calendrier.

Le parcours

  1. Quand le client achète La commande naît sur la marketplace, en attente d'acceptation. Odoo n'en sait encore rien.
  2. Dans les 10 minutes qui suivent La tâche Mirakl - Sync Orders l'amène dans Odoo. Elle apparaît dans Mirakl › Operations › Orders avec son état d'acceptation en attente.
  3. Au passage d'acceptation suivant Mirakl - Accept Orders tourne aussi toutes les 10 minutes et accepte ce que vous avez réglé en acceptation automatique. Si la marketplace n'exige pas d'acceptation, l'état devient non requis ; si quelque chose échoue, erreur, bien visible.
  4. À l'acceptation La commande client Odoo est créée avec ses lignes et le client. Le stock est engagé pour les autres canaux.
  5. Quand la livraison est préparée et validée Le suivi du transporteur part vers la marketplace. L'état de suivi de la commande passe de en attente à synchronisé, ou à erreur si Mirakl le refuse.
  6. À la facturation La facture client est comptabilisée dans Odoo puis envoyée à Mirakl. L'ordre compte : une facture en brouillon n'est pas envoyée.
  7. Quand le règlement arrive Settlements & Invoices rassemble les paiements de l'opérateur avec leur état : en attente, en cours, transféré ou payé. Chaque document porte aussi son état comptable : non comptabilisé, comptabilisé ou rapproché.
  8. En cas de retour Les retours se synchronisent toutes les 30 minutes et apparaissent dans Operations › Returns. Le remboursement a son propre état : en attente, partiel, remboursé ou erreur.
Liste des commandes Mirakl dans Odoo avec état d'acceptation et d'expédition
Les commandes d'une marketplace Mirakl dans Odoo, chacune avec son état. Capture d'écran d'Odoo avec des données de démonstration.
Same stock on every Mirakl marketplace, sent from Odoo
Vidéo : Same stock on every Mirakl marketplace, sent from Odoo (vidéo en anglais)

Pendant ce temps, stock et prix

Pendant que la commande avance, trois autres tâches tiennent la vitrine à jour. Les offres partent toutes les 5 minutes. Le stock passe par le flux STO01 toutes les 10 minutes et les prix par PRI01 toutes les 15. Ainsi, quand une commande acceptée réserve des unités, les autres marketplaces le voient en quelques minutes.

Commande client Odoo créée à partir d'une commande Mirakl
La commande client que le connecteur crée à l'acceptation. Tout le reste part d'ici : livraison, facture et retour. Capture d'écran d'Odoo avec des données de démonstration.

Les deux avertissements les plus fréquents

Deux messages peuvent apparaître à l'envoi de la facture. Post the invoice before sending it to Mirakl. signifie que la facture est encore en brouillon : comptabilisez-la et renvoyez-la. This invoice is not linked to a Mirakl order. apparaît quand la facture ne vient pas d'une commande de marketplace, par exemple si vous l'avez créée à la main. La solution est de facturer depuis la commande client elle-même.

Livraison validée d'une commande Mirakl avec le suivi déjà envoyé
Livraison validée : le suivi est déjà parti vers la marketplace. Capture d'écran d'Odoo avec des données de démonstration.

Ce qui ne tourne pas tout seul

La synchronisation des factures depuis Mirakl, qui tourne une fois par jour, est désactivée après l'installation : vous l'activez si votre opérateur l'utilise. Les messages des clients ne s'activent pas automatiquement non plus. Ainsi, aucune information n'arrive dans Odoo sans que quelqu'un la regarde.

Voir la vidéo sur YouTube
Vidéo de démonstration du connecteur Mirakl dans Odoo, avec l'API Mirakl simulée.

Si vous vous demandez pourquoi une commande est bloquée, regardez d'abord son état d'acceptation et son état de suivi dans la liste. Presque toujours, l'un des deux est en erreur, et le message dit pourquoi.

À lire aussi

Mapper les catégories et attributs Mirakl dans Odoo, étape par étapePréparer le catalogue d'une marketplace Mirakl dans Odoo : dictionnaire de catégories, attributs, listes de valeurs, mapping et export, et les erreurs courantes.Exemple : un fabricant qui vend sur plusieurs marketplaces Mirakl avec des tableursCas d'exemple d'un fabricant qui vend sur plusieurs marketplaces Mirakl avec des tableurs, et ce qui change quand tout passe dans Odoo avec le connecteur.
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 (83e54909): data/ir_cron_data.xml
  • Code du module : flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_finance.py
  • Code du module : flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_invoice.py
  • Code du module : flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_order.py
  • Code du module : flexigobe_mirakl_connector 20.0 (83e54909): models/stock_picking.py
  • Code du module : flexigobe_mirakl_connector 20.0 (83e54909): models/account_move.py
  • Code du module : flexigobe_mirakl_connector 20.0 (83e54909): views/menu_views.xml
  • apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
  • youtube.com/shorts/nbJU8l2bbCM