Se lancer sur une marketplace se présente souvent comme une formalité commerciale : on ouvre un compte, on dépose son catalogue, on encaisse. En pratique, le sujet est technique, et c'est là que les projets dérapent.

Nous intégrons les API de plateformes comme Mirakl et Shopify pour nos clients, et les difficultés se répètent d'un projet à l'autre. Les voici, pour que vous les anticipiez plutôt que de les découvrir en production.

Une marketplace est un second système, pas une vitrine de plus

Dès que vous vendez à deux endroits, vous avez deux vérités possibles pour chaque information : un prix, un stock, un délai, un statut de commande. Tout le travail d'intégration consiste à décider qui fait autorité, et à faire en sorte que l'autre s'y aligne automatiquement.

Sans cette décision explicite, la gestion se fait à la main. Cela tient quelques semaines, puis un écart apparaît : un produit vendu deux fois, un prix promotionnel resté en ligne. Ces incidents coûtent des pénalités et de la réputation sur des plateformes qui notent les vendeurs.

Le catalogue, premier point de friction

Chaque plateforme impose son propre référentiel : catégories, attributs obligatoires, formats d'images, unités. Votre catalogue interne ne s'y superpose jamais exactement. Il faut donc écrire une correspondance, la maintenir quand la plateforme fait évoluer son référentiel, et traiter les produits rejetés.

C'est un travail sans gloire mais déterminant : un produit refusé à l'import ne se vend pas, et le rejet est souvent silencieux si personne ne lit les retours d'erreur. Une intégration sérieuse rapporte ces rejets à un humain, elle ne se contente pas d'envoyer.

Stocks et commandes : le temps réel n'existe pas

Aucune synchronisation n'est instantanée. Entre le moment où un stock change chez vous et celui où la marketplace en tient compte, il s'écoule un délai. Sur des produits à faible rotation ce délai est sans conséquence ; sur des articles très demandés, il produit des survendus.

On traite cela par des marges de sécurité et par des priorités de mise à jour, pas en espérant du temps réel. Dans l'autre sens, les commandes venues de la marketplace doivent rejoindre exactement le même circuit que les autres, sinon votre préparation se dédouble et les erreurs suivent.

Ce que les API permettent réellement

Avant de promettre une fonctionnalité, nous vérifions ce que la plateforme expose. Les API de Mirakl et de Shopify sont riches, mais elles ont des limites : volumes d'appels plafonnés, champs non modifiables, événements non notifiés qu'il faut aller chercher. Ces contraintes dessinent le périmètre du possible.

C'est pour cela que nous étudions l'API avant de chiffrer. Une intégration qui fonctionne le premier jour n'est pas une intégration fiable : la fiabilité se joue dans la gestion des erreurs, des reprises après incident et des cas limites, et cela se conçoit dès le départ.

Questions fréquentes

Faut-il un site e-commerce pour vendre sur une marketplace ?

Pas nécessairement, mais il faut une source de vérité pour votre catalogue et vos stocks. Cela peut être votre gestion commerciale plutôt qu'une boutique. Vendre uniquement sur marketplace vous rend en revanche dépendant de leurs règles et de leur commission.

Combien de temps prend une intégration marketplace ?

Cela dépend entièrement de l'état de vos données et de ce que la plateforme expose. Un catalogue propre et structuré change tout ; un catalogue à normaliser représente souvent la majeure partie du travail. Nous l'évaluons après examen de vos données.

Peut-on synchroniser plusieurs marketplaces à la fois ?

Oui, et c'est fréquent. La difficulté croît moins avec le nombre de plateformes qu'avec le nombre de référentiels différents à maintenir. D'où l'importance de bâtir une correspondance centrale plutôt qu'une intégration isolée par plateforme.