Aller au contenu principal
Mirakl

Ce que Mirakl Connector ajoute à la commande client d'Odoo (Ventes)

Mirakl Connector ajoute à la commande client un onglet Mirakl avec l'instance, la commande, son état, la dernière synchronisation et les données d'expédition et de contact, et il ne s'affiche que lorsque la commande porte une Commande Mirakl. Il modifie aussi ce qui se passe à la suppression de la commande, à l'enregistrement de ses adresses et à sa facturation.

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

Ce que le module touche dans Ventes

Le module étend la commande client standard de l'application Ventes (Sales) d'Odoo. Il ajoute des champs sur la fiche, dont l'un apparaît aussi dans la liste des commandes, et des ajustements de comportement dans le code de la commande. Voici ce qu'il vaut mieux savoir avant d'ouvrir la première commande qui arrive d'une place de marché.

Schéma réalisé avec du code : l'application Ventes en haut et, en dessous, les champs que Mirakl Connector lui ajoute
Schéma généré à partir du code du module, ce n'est pas un écran d'Odoo. Les libellés sont en anglais, le texte d'origine du code.
Same stock on every Mirakl marketplace, sent from Odoo
Vidéo : Same stock on every Mirakl marketplace, sent from Odoo (vidéo en anglais)

Détails qu'on ne voit pas sur la fiche

Les champs n'apparaissent que lorsque la commande a une Commande Mirakl

Les champs du module se trouvent sur la fiche de la commande client, dans l'onglet Mirakl, répartis en deux groupes : Place de marché et Expédition et contact (Shipping & Contact). Ils sont tous masqués tant que Commande Mirakl (Mirakl Order) est vide ; sur une commande sans cette valeur, vous ne verrez donc rien de tout cela.

Dans le groupe Place de marché se trouvent Instance Mirakl (Mirakl Instance), Commande Mirakl, État de commande Mirakl (Mirakl Order State) et Dernière synchronisation Mirakl le (Mirakl Last Sync At). Les quatre sont en lecture seule : on les consulte, on ne les modifie pas.

Schéma réalisé avec du code avec le texte du groupe Place de marché dans d'autres langues : Marktplatz, Place de marché et Marktplaats
Schéma généré à partir des traductions du module, ce n'est pas un écran d'Odoo. Avec Odoo en allemand, le groupe s'affiche comme Marktplatz, en français comme Place de marché et en néerlandais comme Marktplaats.

L'e-mail du client peut être un relais anonymisé

E-mail client Mirakl (Mirakl Customer Email) se trouve dans le groupe Expédition et contact et est en lecture seule. D'après son aide, il ne conserve pas toujours l'e-mail réel de l'acheteur : lorsqu'il existe, il conserve le relais anonymisé que Mirakl crée pour chaque commande, et ce qui y est envoyé parvient à l'acheteur. S'il n'y a pas de relais, il conserve l'e-mail du client fourni avec la commande.

Le téléphone et la personne de contact ont leur propre logique

Téléphone du client Mirakl (Mirakl Customer Phone) reprend le téléphone que l'acheteur a indiqué sur la place de marché, pour l'avoir sous la main depuis la commande elle-même. D'après son aide, il est également enregistré dans le contact de livraison. Il est en lecture seule.

Personne de contact Mirakl (Mirakl Contact Person) a une condition de plus. Il ne s'affiche que si la commande a une Commande Mirakl et que le champ lui-même a une valeur. Son aide indique qu'il contient la personne qui a passé la commande lorsque la place de marché envoie aussi un nom d'entreprise, et que, dans ce cas, l'entreprise sert de nom au contact de livraison. Si vous ne le voyez pas, le champ est vide sur cette commande.

La méthode d'expédition apparaît aussi dans la liste des commandes

Méthode d'expédition Mirakl (Mirakl Shipping Method) se trouve dans Expédition et contact et, contrairement aux autres, apparaît aussi dans la liste des commandes client. Son aide indique qu'il s'agit de la méthode d'expédition choisie par l'acheteur sur la place de marché (par exemple, Standard ou Lendemain) et qu'elle reste vide lorsque l'opérateur ne l'envoie pas.

Un champ vide ici n'indique donc pas une erreur : c'est ce qui se produit quand l'opérateur n'envoie pas cette donnée.

Supprimer une commande Mirakl la laisse supprimée

Le module modifie ce qui se passe lors de la suppression d'une commande client. D'après le code d'Odoo 20, avant de la supprimer, il recherche les commandes Mirakl qui lui sont liées. Si la commande client a une Commande Mirakl, il recherche aussi la commande Mirakl portant cet identifiant dans la même instance, ce qui couvre un devis qui n'a jamais été lié. Après la suppression, il marque ces commandes Mirakl comme supprimées.

La raison figure dans un commentaire du code lui-même : une commande client supprimée doit rester supprimée, car la commande Mirakl s'en souvient et une nouvelle synchronisation ne la recrée ni ne la confirme à nouveau automatiquement.

Modifier le client ou les adresses sur une commande Mirakl

Dans Odoo 20, lorsque vous enregistrez des modifications du client, de l'adresse de livraison ou de l'adresse de facturation d'une commande avec Commande Mirakl, le module effectue cet enregistrement différemment du standard. Sur les commandes sans Commande Mirakl, l'enregistrement est celui du standard.

La facture peut être simplifiée ou complète selon l'instance

Lors de la préparation de la facture depuis la commande, le module consulte le paramètre de type de facture espagnole de l'instance Mirakl de la commande (code d'Odoo 20). Ce paramètre se trouve dans l'instance, pas dans la commande ; il est passé en revue dans Les champs de Instance Mirakl dans Mirakl Connector.

  • Si la commande n'a pas d'instance, ou si le paramètre est sur automatique, la facture est préparée comme dans Odoo standard.
  • Si la localisation espagnole d'Odoo n'est pas installée (les factures n'ont pas le champ de facture simplifiée), rien n'est modifié non plus.
  • Si le paramètre est simplifiée, la facture est marquée comme simplifiée. S'il est complète, elle est marquée comme non simplifiée.

Comment cela s'articule avec le reste et ce que cela coûte

Le module est à paiement unique par version et nécessite l'abonnement à FlexigoTech Cloud : plan Connecteur, 49 €/mois ou 490 €/an HT. La connexion passe par FlexigoTech Cloud, qui conserve les identifiants chiffrés, surveille la synchronisation et prévient par e-mail en cas d'échec. Il est publié pour Odoo 17, 18, 19 et 20 ; sur l'Odoo App Store, chaque version s'y achète. Plus de détails dans la fiche Odoo Apps et sur la page du module.

Si vous voulez que nous examinions ce que devient le flux de commandes dans votre Odoo, 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