Mirakl et Odoo : pourquoi un seul connecteur vous ouvre Decathlon, Leroy Merlin et Bricodepot

La confusion la plus courante avec Mirakl est de le traiter comme Amazon. Ce n'est pas le cas. Mirakl est la plateforme que Decathlon, Leroy Merlin, Bricodepot, GACD et des dizaines d'autres enseignes utilisent pour ouvrir leur propre marketplace à des vendeurs externes. Pour vous, cela a une très bonne conséquence et une moins bonne.

La bonne : l'API est la même pour tous. Une intégration bien faite avec Mirakl vaut pour le premier opérateur comme pour le cinquième, en changeant l'URL de l'opérateur et la clé d'API. La moins bonne : au-dessus de cette base commune, chaque opérateur impose ses règles (son arbre de catégories, ses attributs obligatoires, ses délais, ses pénalités, et même les parties de l'API qu'il ouvre) et celles-ci ne sont pas partagées.

Ce que tous partagent

Le cycle est toujours le même : vous publiez des offres (produit, prix, stock, délai), l'opérateur vous envoie des commandes, vous les acceptez ou les refusez, vous expédiez avec suivi et vous êtes payé par règlement. Le connecteur Mirakl transpose ce cycle en documents Odoo ordinaires dans les versions 17, 18 et 19 : il publie les offres avec prix, stock et délai d'expédition, importe les commandes comme des commandes clients, les accepte (à la main ou automatiquement si vous l'activez), envoie à Mirakl le transporteur et le numéro de suivi du bon de livraison et importe les règlements pour les comptabiliser.

Ce qui change avec chaque opérateur

L'arbre de catégories et les attributs obligatoires, qui n'ont rien à voir entre une enseigne de sport et une enseigne de bricolage. Le délai d'acceptation, qui se mesure en heures chez certains opérateurs. Et l'exigence de données produit : certains opérateurs refusent une offre s'il manque l'EAN, et d'autres demandent en plus une fiche technique complète.

C'est pourquoi nous avons une page par opérateur en plus de celle du connecteur : Decathlon, Leroy Merlin, Brico Depot et GACD. Le connecteur de base est le même et chaque opérateur est une instance de plus, avec son URL et sa clé ; pour certains opérateurs, il existe aussi un profil complémentaire qui préconfigure l'URL et ses valeurs par défaut. Ce qui change vraiment, c'est la préparation du catalogue.

Ce qu'il faut préparer avant de demander l'inscription

Trois choses, et aucune n'est technique. Un EAN sur toutes les références que vous allez publier : certains opérateurs n'acceptent pas l'offre sans lui. Un délai de préparation que vous pouvez vraiment tenir, pas celui que vous aimeriez ; promettre 24 heures et livrer en 72 se paie sur votre compte. Et des photos conformes à leur norme, souvent plus stricte que celle de votre propre site.

Et un avertissement tiré de notre expérience

Nous avons audité notre propre connecteur Mirakl alors que sa suite de tests passait au vert sur Odoo 19, 18 et 17, et nous avons trouvé 18 défauts confirmés, dont un journal d'appels qui n'écrivait jamais rien et une synchronisation qui regardait la mauvaise date. Nous le racontons en détail dans auditer un connecteur hérité. Si l'on veut vous vendre une intégration Mirakl, demandez ce qui se passe quand l'API renvoie une erreur, pas combien de tests elle compte.

Questions fréquentes

Liens utiles chez FlexigoTech

Ce que nous faisons à ce sujet