Aller au contenu principal
Mirakl

Checklist de l'instance Mirakl Connector, champ par champ

La fiche d'instance Mirakl réunit la connexion, les comptes de règlement et quelques options ; voici, champ par champ, ce que signifie chacun d'après son aide et ce qu'il convient d'y mettre.

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

Les fiches s'ouvrent depuis le menu Mirakl › Configuration › Marketplaces, dans la liste Instances Mirakl.

Schéma avec le menu Mirakl, Configuration, Marketplaces et les champs de la fiche d'instance
Schéma réalisé avec du code à partir du code publié du module (ce n'est pas une capture d'Odoo) : le menu et les champs de la fiche.

Avant de toucher à la fiche

  • Droit d'accès. Pour voir la clé, il faut être Mirakl Manager : l'aide de Clé API indique que seuls les Mirakl Managers peuvent la voir ou la modifier, et la Clé API Mirakl (FlexigoTech Cloud) n'est visible que des utilisateurs ayant ce droit.
  • Compte vendeur de la place de marché. Ouvrez-le dans un autre onglet : c'est de là que viennent l'hôte de l'opérateur et la clé API, d'après l'aide de ces champs.
  • Abonnement. Le module nécessite l'abonnement à FlexigoTech Cloud (plan Connecteur). Le prix figure à la fin.
Same stock on every Mirakl marketplace, sent from Odoo
Vidéo : Same stock on every Mirakl marketplace, sent from Odoo (vidéo en anglais)

Profil de la place de marché

  • Code du fournisseur. Il apparaît sur la fiche et aussi dans la liste des Instances Mirakl. C'est le profil de place de marché/fournisseur qu'utilise l'instance ; d'après son aide, quand vous installez les compléments fournisseur, des profils spécifiques à l'opérateur apparaissent, comme Leroy Merlin. La valeur par défaut est Mirakl générique.

Onglet Connexion, groupe Accès

Ces champs se trouvent dans l'onglet Connexion, groupe Accès.

  • Connexion Mirakl. Il est en lecture seule et vaut FlexigoTech Cloud par défaut. Son aide indique que les nouvelles places de marché se connectent via FlexigoTech Cloud et que Directe (clé API enregistrée dans Odoo) n'est conservé que pour celles qui existaient avant cette version, qui continuent de fonctionner telles qu'elles ont été achetées. Il n'y a rien à renseigner : vérifiez simplement quelle voie utilise votre instance.
  • Clé API Mirakl (FlexigoTech Cloud). Elle se trouve dans le groupe FlexigoTech Cloud. Avec les valeurs par défaut, elle est visible, et elle est masquée si la connexion n'est pas celle de FlexigoTech Cloud. Son aide indique qu'elle est envoyée une seule fois, chiffrée, à FlexigoTech Cloud et qu'elle n'est jamais enregistrée dans Odoo.
  • URL de base. C'est l'hôte réel de l'opérateur. Son aide prévient que Mirakl ne fournit pas d'hôte universel partagé par toutes les places de marché. Pour les opérateurs connus, elle se remplit toute seule ; sinon, saisissez-la depuis votre compte vendeur. Exemple de l'aide : https://adeo-marketplace.mirakl.net. Elle est obligatoire avant de pouvoir tester la connexion ou synchroniser.
  • URL de base de l'API. C'est l'URL de base réelle de l'API pour l'opérateur choisi. Son aide indique qu'il s'agit normalement de l'URL de base plus /api, avec cet exemple : https://adeo-marketplace.mirakl.net/api.
  • Clé API. Avec les valeurs par défaut, elle n'est pas visible : elle est masquée quand la connexion est FlexigoTech Cloud, donc elle apparaît dans les instances en connexion Directa. C'est la clé API vendeur (Settings > API key dans votre compte vendeur) et elle est nécessaire avant de pouvoir utiliser Tester la connexion ou synchroniser.
  • Boutique. Elle apparaît sur la fiche et dans ce groupe. C'est un identifiant facultatif pour les environnements multiboutiques. D'après son aide, Tester la connexion la remplit automatiquement lorsque Mirakl expose la boutique du vendeur.

Onglet Finances

C'est ici que se trouve la comptabilité des règlements. Dans l'onglet Finances, il y a deux groupes.

Groupe Comptabilité des règlements

  • Journal des règlements. Un journal parmi d'autres pour comptabiliser les écritures de règlement de Mirakl. Si vous le laissez vide, un journal dédié, Règlements Mirakl, est créé à la première utilisation. Choisissez le vôtre si vous préférez que celui-ci ne soit pas créé.
  • Compte d'attente de la place de marché. Un compte d'attente du bilan qui représente ce que la place de marché vous doit pour les commandes : il est débité par les ventes et crédité quand le règlement effectue le paiement.
  • Compte de charges de commission. Le compte de charges pour la commission et les frais de la place de marché.
  • Compte d'attente versement / banque. Il est débité du versement net qui vous est transféré, puis réconcilié avec l'encaissement bancaire réel : à la main en Community, avec la synchronisation bancaire en Enterprise, d'après son aide.

Groupe Options

  • Compte analytique. Facultatif. Il sert à ce que les règlements de cette place de marché alimentent un P&L par canal dans les rapports analytiques d'Odoo. Renseignez-le si vous souhaitez cette lecture par canal.
  • Comptabiliser automatiquement les règlements. Crée automatiquement la pièce comptable quand un règlement est importé. Elle est désactivée par défaut : cochez-la uniquement si vous voulez cette pièce à l'import.

Onglet IA (optionnel)

  • Activer les analyses IA. Elle se trouve dans l'onglet IA (optionnel) et elle est désactivée par défaut. Avec Odoo en français, son aide dit Facultatif. Le connecteur fonctionne pleinement sans IA. Si vous n'activez pas cette option / ne définissez pas de clé, aucun appel à l'IA n'est jamais effectué et rien ne change. Si vous n'en avez pas besoin, laissez-la telle quelle.
Schéma avec le texte d'aide du champ d'analyses IA en cinq langues
Schéma réalisé avec du code à partir des traductions publiées du module (ce n'est pas une capture d'Odoo) : l'aide de Activer les analyses IA en espagnol, allemand, français, italien et portugais.

Vérification avant de valider l'instance

  • Vérifiez que URL de base et URL de base de l'API pointent vers le même opérateur ; normalement la seconde est la première plus /api, comme dans les exemples de l'aide.
  • Si votre instance utilise la connexion Directa, confirmez que URL de base et Clé API sont renseignées avant d'essayer de tester la connexion ou de synchroniser.
  • Après avoir testé la connexion, regardez Boutique : son aide indique qu'elle se remplit toute seule quand Mirakl expose la boutique du vendeur.
  • Repassez avec votre comptable les comptes du groupe Comptabilité des règlements.

Prix et aide à la mise en route

Le module est en paiement unique par version d'Odoo et il est publié sur Odoo Apps pour 17, 18, 19 et 20 (consultez la fiche Odoo Apps ou la page du module). Il 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 prévient par e-mail en cas d'échec. Avec l'abonnement, le module pour les nouvelles versions d'Odoo est inclus si vous l'avez acheté sur flexigotech.com ; sur l'Odoo App Store, chaque version d'Odoo s'achète là-bas.

FlexigoTech met en place Odoo 17, 18, 19 et 20 et développe des connecteurs et des intégrations sur mesure. Si vous voulez que nous passions en revue avec vous la fiche de votre instance, écrivez-nous.

À lire aussi

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