Aller au contenu principal
Mirakl

Champs d'Instance Mirakl dans Mirakl Connector : sens et valeurs à saisir

La fiche Instances Mirakl répartit ses champs sur plusieurs onglets, et chacun a sa propre aide. Nous les comparons ici : ce que dit l'aide, la valeur par défaut et ce qui change si vous les laissez vides ou les remplissez.

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
7 min

Où se trouvent les champs

Les fiches s'ouvrent depuis le menu Mirakl › Configuration › Marketplaces. Dans la fiche Instances Mirakl (Mirakl Instances), les champs de ce guide sont répartis sur trois onglets : Transporteurs (Carriers), Commandes et retours (Orders and Returns) et Opérations manuelles (Manual Operations).

Schéma réalisé en code du menu Mirakl, Configuration, Marketplaces et de la fiche Mirakl Instance avec les champs comparés ici
Schéma réalisé en code à partir du code publié du module, ce n'est pas une capture d'Odoo : le menu et les champs de la fiche avec leurs libellés d'origine.
Same stock on every Mirakl marketplace, sent from Odoo
Vidéo : Same stock on every Mirakl marketplace, sent from Odoo (vidéo en anglais)

Fenêtres d'import et limites

Ces champs bornent ce qui est importé, analysé ou consulté. Tous ont une valeur par défaut dans le code.

ChampOù il se trouveCe que dit l'aidePar défaut
Jours de synchronisation initiale des commandes (Initial Order Sync Days)Commandes et retours, groupe Windows«Fenêtre historique utilisée lorsqu'il n'y a pas de synchronisation de commande précédente. L'import manuel utilise également cette plage.»30
Jours de synchronisation initiale des retours (Initial Return Sync Days)Commandes et retours, groupe Windows«Fenêtre historique utilisée lorsqu'il n'y a pas de synchronisation de retour précédente. L'import manuel utilise également cette plage.»30
Pages de synchronisation maximales (Max Sync Pages)Commandes et retours, groupe Windows«Limite de sécurité pour les imports paginés de commandes/retours.»40
Limite de génération de liaison d'offre (Offer Binding Generate Limit)Opérations manuelles, groupe Offres (Offers)«Nombre maximal de produits analysés lors de la génération automatique des liaisons d'offre manquantes.»500
Point de terminaison Transporteurs d'expédition (Endpoint Shipping Carriers)Transporteurs, groupe Synchronisation des transporteurs (Carrier Sync)«Point de terminaison Mirakl SH21 utilisé pour récupérer les transporteurs disponibles lorsque pris en charge par l'opérateur.»/shipping/carriers

Les deux champs de jours définissent la fenêtre utilisée quand il n'existe pas encore de synchronisation préalable des commandes ou des retours, et l'aide ajoute que l'import manuel utilise la même plage. Pages de synchronisation maximales est, selon son aide, une limite de sécurité pour les imports paginés.

Client de la commande : deux modes et deux cases

Le champ Mode client des commandes (Order Customer Mode) se trouve dans Commandes et retours, groupe Client et confidentialité (Customer & Privacy). Il a deux valeurs : Un client par acheteur (standard) (One customer per shopper (standard)), celle par défaut, et Client unique par défaut avec contacts enfants de livraison (Single default customer with delivery child contacts).

ChampQuand il est visiblePar défaut
Mode client des commandesDans le groupe Client et confidentialitéUn client par acheteur (standard)
Client par défaut de la marketplace (Default Marketplace Customer)Uniquement avec le mode client unique ; avec les valeurs par défaut, il n'est pas visibleMasqué avec le mode standard
Contacts de livraison en tant que sociétés (Delivery Contacts as Companies)Uniquement avec le mode client unique ; avec les valeurs par défaut, il n'est pas visibleDésactivée
Utiliser l'e-mail de notification Mirakl (Use Mirakl Notification Email)Dans le groupe Client et confidentialitéDésactivée

Ce que dit l'aide de chaque option :

  • Mode standard : chaque acheteur devient son propre client dans Odoo.
  • Client unique par défaut : toutes les commandes de la marketplace sont affectées à un client fixe, celui que vous choisissez dans Client par défaut de la marketplace. L'adresse de livraison de l'acheteur est enregistrée comme contact enfant de ce client (type Livraison, marqué comme acheteur de la marketplace) ; ainsi les données personnelles restent circonscrites et peuvent être masquées par une règle d'enregistrement. Les factures sont émises au client par défaut et ne contiennent aucune donnée de l'acheteur.
  • Contacts de livraison en tant que sociétés : uniquement avec le client unique. Chaque adresse de livraison devient un contact de société propre au lieu d'un contact enfant du client par défaut, de sorte que la commande de vente, la livraison et le bon de livraison affichent la société du client final et jamais le nom du client par défaut. L'aide indique que la personne va dans Personne de contact, et que l'e-mail que Mirakl envoie du client n'est pas enregistré : dans les marketplaces où l'opérateur vous achète (GACD, par exemple), c'est une adresse de l'opérateur, pas du client.
  • E-mail de notification : Mirakl anonymise l'acheteur derrière une adresse relais par commande, qui change à chaque commande. Avec la case activée, le relais est utilisé comme e-mail du contact de livraison de la commande (jamais dans une fiche client permanente), ainsi les réponses parviennent à l'acheteur via Mirakl. En mode client unique, le contact enfant de l'acheteur porte toujours le relais quand Mirakl le fournit. La valeur de chaque commande est aussi enregistrée dans la commande de vente.

Passerelle de ventes : vide ou rempli

Dans l'onglet Commandes et retours, le groupe Passerelle de ventes (Sales Bridge) réunit des champs dont l'aide dit ce qui se passe si vous les laissez vides.

ChampSi vous le laissez videSi vous le remplissez
Produit d'expédition (Shipping Product). À l'écran il n'a pas de libellé : seul son contenu est visibleAucune ligne de livraison n'est ajoutée à la commande de venteCe produit de service est utilisé pour la ligne de frais d'expédition
Créer les commandes de vente à partir du (Create Sales Orders From)Sans limiteLes commandes Mirakl créées avant cette date sont importées mais ne deviennent jamais des commandes de vente
Vendeur des commandes (Salesperson on Orders)Odoo décide : le vendeur du client ou, à défaut, l'utilisateur qui a importé la commande (OdooBot lors de l'import automatique)Ce vendeur est placé sur chaque commande de vente importée de cette marketplace
Méthode de livraison des commandes (Shipping Method on Orders)Les commandes de vente n'ont pas de méthode de livraisonCette méthode est placée sur chaque commande de vente et, avec elle, sur sa livraison

Deux précisions de l'aide. Pour Créer les commandes de vente à partir du, la raison est que les commandes traitées avant l'utilisation du connecteur ne soient pas expédiées une seconde fois. Pour Méthode de livraison des commandes, l'aide demande de l'affecter dans Mirakl > Catálogo > Asignación de transportistas pour que le numéro de suivi parvienne à Mirakl avec le bon transporteur.

Envoyer le suivi à la validation

La case Envoyer le suivi à Mirakl à la validation (Send Tracking to Mirakl on Validation) est désactivée par défaut. Activée, à la validation de la livraison dans Odoo, l'expédition est envoyée à Mirakl (numéro de suivi, transporteur et confirmation d'expédition), afin que la marketplace marque la commande comme expédiée et que l'acheteur voie le suivi. L'aide pose deux conditions : la livraison doit avoir un numéro de suivi et son transporteur devrait être mappé dans l'onglet Transporteurs. S'il manque le numéro, le bon de livraison n'est pas modifié et une note explique pourquoi. Certains profils de marketplace, comme Leroy Merlin, l'envoient toujours parce que l'opérateur l'exige.

Le champ du point de terminaison des transporteurs

L'aide de Point de terminaison Transporteurs d'expédition se lit, avec Odoo en français, «Point de terminaison Mirakl SH21 utilisé pour récupérer les transporteurs disponibles lorsque pris en charge par l'opérateur.». Le schéma montre ce même texte en allemand, espagnol, italien et portugais.

Schéma avec l'aide du champ Endpoint Shipping Carriers en espagnol, allemand, français, italien et portugais
Schéma réalisé en code à partir des traductions publiées du module, ce n'est pas une capture d'Odoo.

Que saisir selon votre cas

  • Vous vendiez sur la marketplace avant d'installer le connecteur : remplissez Créer les commandes de vente à partir du ; selon l'aide, les commandes antérieures sont importées mais ne deviennent pas des commandes de vente.
  • Vous ne voulez pas un client Odoo par acheteur : choisissez le mode client unique et indiquez le Client par défaut de la marketplace ; l'aide suggère un contact générique par marketplace.
  • Vous voulez que l'acheteur voie le suivi à la validation : activez Envoyer le suivi à Mirakl à la validation et vérifiez le transporteur dans l'onglet Transporteurs.
  • Vous ne voulez pas de ligne de frais d'expédition : laissez Produit d'expédition vide.
  • Vous n'avez pas de vendeur fixe pour ces commandes : laissez Vendeur des commandes vide et Odoo décidera selon son aide.

Coût et aide de FlexigoTech

Mirakl Connector est un module à paiement unique par version d'Odoo (publié sur Odoo Apps pour 17, 18, 19 et 20) et nécessite l'abonnement à FlexigoTech Cloud : plan Connecteur, 49 €/mois ou 490 €/an HT, jusqu'à 3 comptes de la plateforme. La connexion passe par FlexigoTech Cloud, qui conserve les identifiants chiffrés, surveille la synchronisation et avertit par e-mail en cas d'échec. Vous avez la fiche Odoo Apps et la page du module. Si vous préférez que quelqu'un configure l'instance avec vous, 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.Les champs de l'instance Mirakl dans Odoo : ce que signifie chacun et que saisirGuide des champs de l'instance Mirakl Connector pour Odoo : livraison, remise, commission, langue, factures et synchronisation, d'après leur aide.
Vérifié dans le code du connecteur (version 20.0) et dans les sources citées

Sources