Agent de synchronisation de stock

Qu'est-ce que l'agent de synchronisation de stock ?

Vendre les mêmes produits sur une boutique Shopify, un site WooCommerce et eBay, c'est tenir plusieurs stocks à jour à la main — et le jour où l'un dérive, on survend. L'agent de synchronisation de stock prend une boutique comme vérité, maintient les autres à ses quantités toutes les heures, et vous parle de chaque SKU qu'il n'a pas pu régler.

Vous choisissez une boutique maître et une ou plusieurs boutiques cibles. Pour chaque SKU du maître, l'agent calcule la quantité que chaque cible devrait détenir, la compare à ce que la cible détient réellement, et — selon le mode — signale la différence, enregistre le changement qu'il ferait, ou fixe la quantité de la cible et la relit pour la confirmer.

La règle est volontairement simple :

quantité cible = quantité maître − stock de sécurité (jamais en dessous de zéro)

Le stock de sécurité est un nombre d'unités conservées par cible, zéro par défaut. Pas de moteur de règles, pas de répartition en pourcentage, pas d'allocation par canal : cet agent réplique un stock de référence, rien de plus.

Ce qu'il est, et ce qu'il n'est pas

Ce n'est pas un moteur de stock omnicanal. Le maître est la seule source de vérité. Une cible n'influence jamais le maître, et deux cibles ne s'influencent jamais. Si une cible vend de son côté, son stock diverge du maître jusqu'au passage suivant — l'agent la remet alors à la quantité du maître ; il ne soustrait pas la vente au maître.

Si votre système d'entrepôt, votre ERP ou l'une de vos boutiques est l'endroit où le stock est réellement géré, faites-en le maître. Si aucun endroit ne détient la vérité, cet agent n'est pas encore le bon outil.

Quelles boutiques sont prises en charge ?

Le maître et les cibles peuvent chacun être :

• Shopify — le stock est lu et écrit à un emplacement que vous choisissez.
• WooCommerce — les produits simples, et les variations des produits variables qui gèrent leur propre stock.
• eBay — les articles d'inventaire de votre compte vendeur, par SKU.

Le même fournisseur peut servir de maître et de cible (deux boutiques Shopify, par exemple), et deux cibles peuvent être du même fournisseur — ou deux emplacements d'une même boutique Shopify. Une boutique ne peut pas être sa propre cible au même emplacement, et la même destination ne peut pas être listée deux fois.

Deux agents qui écrivent ne peuvent pas cibler le même stock, et deux agents qui écrivent ne peuvent pas cibler chacun le maître de l'autre : la seconde configuration est refusée, en nommant la première. Un agent en mode Monitor n'écrit rien : autant d'agents que vous voulez peuvent surveiller les mêmes boutiques.

Trois modes

Chaque agent démarre en Monitor. Passer en Auto est le seul réglage qui autorise l'agent à modifier de lui-même quelque chose dans une boutique, et l'écran le dit en rouge là où vous faites ce choix.

Le rapprochement se fait par SKU, exactement

Un SKU du maître est associé à un article de la cible par SKU exact et rien d'autre. Pas de rapprochement par titre, pas de « presque », et aucune IA nulle part. Quand le rapprochement n'est pas net, l'agent le signale et ne devine jamais :

• un SKU absent de la cible est SKU_NOT_FOUND ;
• un SKU qui désigne deux articles d'un côté est SKU_AMBIGUOUS — rien n'est écrit tant que le catalogue n'est pas corrigé ;
• un produit sans SKU sur le maître est compté et ignoré ;
• un produit variable WooCommerce n'est pas stockable lui-même : son stock vit sur ses variations, rapprochées par leurs propres SKU ;
• un produit archivé ou à la corbeille n'est pas en vente et est ignoré ;
• un article cible qui ne gère pas de stock est NOT_TRACKED — l'agent n'active jamais la gestion de stock à votre place.

Emplacements

Une boutique Shopify avec plusieurs emplacements détenant du stock doit se voir indiquer lequel l'agent lit ou écrit. L'agent n'additionne jamais les emplacements et n'en choisit jamais un à votre place : tant que vous n'avez pas choisi, il attend en « configuration requise » et le dit. Une boutique à un seul emplacement n'a rien à choisir.

Garde-fous

Une mauvaise lecture du maître — une connexion pointée sur la mauvaise boutique, un emplacement vidé à l'instant, un import qui a remis un catalogue à zéro — serait sinon répliquée sur toutes les cibles dans l'heure. Chaque écriture automatique passe donc des garde-fous, et chacun transforme l'écriture en dossier WRITE_BLOCKED au lieu de l'exécuter :

Les valeurs par défaut sont prudentes à dessein, et elles se modifient par agent.

Concurrence, honnêtement

Une vente peut tomber sur une cible entre le moment où l'agent la lit et celui où il écrit. Sur Shopify, l'écriture porte la quantité lue et Shopify la refuse si le niveau a bougé entre-temps. WooCommerce et eBay n'offrent pas ce contrôle : l'écriture passe et la relecture attrape la différence en WRITE_MISMATCH. La fenêtre dure quelques centaines de millisecondes. Si une cible vend à gros volume, préférez le mode Approval, ou acceptez qu'un écart soit réévalué une heure plus tard.

Comment l'agent tourne-t-il ?

• Automatiquement, toutes les heures. Tout le catalogue est comparé à chaque passage ; rien n'est supposé d'un passage précédent.
• À la demande aussi, depuis la page de l'agent ou depuis ChatGPT.
• Pas en temps réel. Pas de webhook : une vente à 10 h 05 est répliquée lors du passage de 11 h.

Un passage lit par défaut jusqu'à 100 000 articles stockables par connexion. Un catalogue plus grand est signalé comme tronqué plutôt que synchronisé en partie sans le dire, et un passage qui atteint son budget de temps s'arrête proprement et laisse le suivant finir.

Les anomalies sont des dossiers, pas des alertes

Tout résultat autre que SYNCED et UPDATED est un dossier sur un SKU d'une cible. La même différence vue chaque heure est un seul dossier avec un compteur ; quand un passage ultérieur trouve la cible de nouveau alignée — parce qu'elle a été écrite, ou corrigée à la main — le dossier se referme tout seul et le dit.

Chaque dossier porte le SKU, les deux boutiques, l'emplacement de la cible quand elle en a un, les deux quantités, la quantité voulue, l'action, le résultat et la raison en une phrase : de quoi comprendre sans ouvrir l'une ou l'autre boutique.

Approuver les changements proposés

En mode Approval, chaque différence devient une proposition. Vous approuvez ou rejetez chacune depuis ChatGPT ou par l'API, une par une ou jusqu'à 25 à la fois, avec une réponse par proposition.

Une approbation porte sur le changement exact qui vous a été montré. Avant d'écrire, l'agent relit le maître et la cible, recalcule la quantité avec votre stock de sécurité actuel et réapplique les garde-fous. Si un stock a bougé entre-temps, rien n'est écrit : la proposition est marquée périmée et une nouvelle la remplace. Approuver deux fois la même proposition n'écrit rien la seconde fois, et un rejet tient dans tous les modes jusqu'à ce que le stock du maître ou de la cible bouge.

Ce qu'un passage a fait, plus tard

Ce qu'un passage a décidé — chaque SKU, les deux quantités, la quantité voulue, la quantité relue après une écriture, le résultat et la raison — est conservé comme l'enregistrement propre de ce passage pendant 30 jours, et ne change plus ensuite. Après 30 jours, l'enregistrement le dit, plutôt que d'afficher une liste vide.

Consulter les résultats dans Excel et sur le web

La page de l'agent montre où en est chaque SKU et ce que chaque passage a fait. Quatre vues en direct sont disponibles, dans l'espace de travail web et dans un classeur Excel connecté :

• Synchronisation en cours — une ligne par SKU et par cible : quantités maître et cible, quantité voulue, quantité relue après écriture, action, résultat et raison.
• Anomalies ouvertes — les dossiers qui ont besoin de vous.
• Passages — une ligne par passage : SKU vérifiés, synchronisés, mis à jour, proposés, bloqués et en échec.
• Détail d'un passage — les lignes d'un passage précis, conservées 30 jours.

Le piloter depuis ChatGPT ou Claude

Avec LinkyFlow connecté à ChatGPT, Claude ou tout client MCP :

Configure ma synchro de stock : maître « EU boutique », cible « Outlet » avec un stock de sécurité de 2, en mode monitor.

Lance ma synchro de stock maintenant.

Quels SKU sont désynchronisés ?

Montre-moi les écritures bloquées et pourquoi.

Passe ma synchro de stock en mode auto.

La dernière est un vrai changement dans vos boutiques cibles, et l'assistant vous le dit avant de le faire.

Limites actuelles

• Un maître, une ou plusieurs cibles, un seul sens. Il réplique un stock de référence. Il ne fusionne pas les ventes de plusieurs canaux et ne soustrait pas les ventes d'une cible au maître.
• SKU exact uniquement. Pas de rapprochement par titre, code-barres ou similarité.
• Un emplacement par connexion. Les emplacements ne sont jamais additionnés.
• La seule écriture est une quantité de stock. Produits, prix, titres, annonces et commandes ne sont jamais touchés.
• Toutes les heures, sans webhook.
• Approuver et rejeter les propositions se fait depuis ChatGPT ou l'API pour l'instant, pas depuis des boutons sur la page de l'agent.
• Le détail des passages est conservé 30 jours. Les résumés et la synchronisation en cours restent.

Pour aller plus loin

• Connecter Shopify
• Connecter WooCommerce
• Connecter eBay