Symptôme terrain : le comptage confirme douze unités disponibles dans l’entrepôt, mais la marketplace en affiche zéro. Une heure plus tard, elle en publie vingt. L’ERP paraît juste, pourtant le canal alterne rupture et survente. Les équipes corrigent manuellement sans savoir quelle valeur reviendra au prochain export.
En réalité, un stock physique juste ne garantit pas un flux juste. La quantité marketplace est une projection : elle applique réservations, sécurité, éligibilité, agrégation et plafonds, puis traverse des files et des APIs. Le diagnostic doit prouver chaque transformation avec sa version et son âge.
Une agence marketplace tournée vers la performance vendeur peut orchestrer cette enquête. Le service run et supervision marketplace suit fraîcheur, rejets et offres résiduelles ; Ciama Marketplace peut rapprocher les valeurs sans remplacer les systèmes qui font foi.
Contre-intuitivement, renvoyer immédiatement le stock physique brut aggrave souvent l’incident. Cette valeur oublie les commandes, le tampon et les contraintes de canal. Il faut d’abord réduire l’exposition, retrouver la dernière projection fiable et corriger la cause plutôt que forcer un nombre rassurant.
Distinguer le stock physique de sa projection vendable
Le physique décrit les unités réellement présentes et contrôlées. Le stock système représente ce que le WMS ou l’ERP connaît. Le disponible retranche les engagements. Le diffusable applique encore tampon, règles de canal, délai et plafond. La marketplace expose enfin une valeur qu’elle peut avoir transformée.
Nommez ces niveaux et interdisez le mot « stock » sans qualificatif dans les incidents. Une différence entre physique et canal peut être légitime si des réservations existent. L’écart anormal apparaît lorsque la valeur observée ne correspond pas au contrat attendu pour la même version.
Le registre de preuve conserve quantité, unité, SKU, entrepôt, canal, pays, date métier, date technique et version. Sans ces dimensions, deux équipes comparent des photos différentes et concluent à tort que l’autre source est fausse.
Pour qui ce diagnostic devient nécessaire
La méthode convient aux vendeurs qui passent par un agrégateur, un bus, des fichiers, plusieurs entrepôts ou plusieurs règles de publication. Elle devient urgente lorsque les canaux commandent plus vite que le cycle d’export ou lorsqu’une reprise peut rejouer une ancienne valeur.
Un flux direct et quotidien peut utiliser le même cadre avec moins d’outils. Un fichier horodaté, un accusé, une lecture du canal et un rapprochement suffisent pour une petite volumétrie. La preuve compte davantage que le niveau d’automatisation.
Le diagnostic ne remplace pas l’inventaire physique ni la politique de promesse. Si la source physique est douteuse, alors l’équipe traite d’abord cette incertitude. En revanche, quand le comptage et les mouvements convergent, elle suit la projection au lieu de recompter sans fin.
Repérer le moment où enquêter
Il devient particulièrement utile après une migration, l’ajout d’un entrepôt ou un changement de cadence. Ces moments modifient identifiants, ordres et responsabilités sans toujours faire tomber le flux. Les premiers signaux sont souvent discrets : quelques zéros inexpliqués, un âge qui augmente sur un canal ou une reprise plus fréquente. Par exemple, trois offres corrigées chaque matin peuvent révéler une règle de plafond oubliée sur toute une famille.
Avant de lancer l’enquête, le responsable choisit la priorité selon exposition client, rotation, marge et capacité de confinement. Une offre qui reçoit plusieurs commandes par heure passe devant un long catalogue dormant, même si le second compte davantage d’écarts. Cette décision protège le coût complet et donne une population terminable à l’équipe.
Écrire le contrat de disponibilité
Le contrat précise l’entrée : quantité contrôlée, réservations, commandes, sécurité, état produit, nœud et version. Il définit la sortie attendue par canal, son unité, sa date de validité et la responsabilité. Les valeurs négatives, inconnues ou trop anciennes ont un comportement explicite.
Pour chaque transformation, documentez règle, arrondi, plafond et exclusion. Une offre peut publier au maximum cinq unités pour limiter l’exposition, même si cinquante sont disponibles. Le contrôle doit alors comparer à cinq, pas au physique.
Définir la fraîcheur acceptable
Le seuil dépend de la rotation, de la fréquence des commandes et du coût d’annulation. Il s’exprime depuis la date métier, non depuis l’heure à laquelle un fichier a été relu. Une reprise récente d’une donnée vieille ne devient pas fraîche.
Au-delà du seuil, la règle réduit la quantité, bloque les SKU sensibles ou déclenche une lecture. Le mode choisi est testé. Une donnée trop vieille ne conserve pas silencieusement son dernier état si le risque exige un confinement.
Reconstituer la chronologie complète
Prélevez un SKU en écart et alignez événements physiques, mouvements WMS, calcul disponible, extraction, transformation agrégateur, envoi, accusé et observation distante. Pour chaque étape, notez date métier, date d’émission, réception et traitement.
La chronologie révèle les messages désordonnés : une projection calculée à 8 h peut être traitée après celle de 9 h. Elle montre aussi un lot partiel, un fichier resté en attente ou une tâche qui a continué après une correction.
Ne partez pas seulement du canal vers l’amont. Suivez aussi la valeur source vers toutes ses destinations. Si un seul canal diverge, alors la branche ou la règle locale devient prioritaire ; si tous divergent pareillement, la cause se situe plus tôt.
Conservez l’heure dans un fuseau et le sens des horloges. Les journaux dont les serveurs sont décalés peuvent produire une chronologie trompeuse. Une séquence métier versionnée reste plus fiable qu’un tri brut par timestamp.
Contrôler identifiants et périmètres
Rapprochez SKU interne, SKU vendeur, identifiant d’offre, EAN éventuel, marketplace, pays et mode logistique. Un même produit peut avoir plusieurs offres ; un identifiant réutilisé peut pointer vers une ancienne variante. La quantité juste appliquée au mauvais objet reste une erreur grave.
Vérifiez les jointures et valeurs par défaut. Un entrepôt absent peut être interprété comme total, zéro ou nœud principal. Un code pays vide peut envoyer la quantité française vers une offre allemande. Chaque défaut doit être rejeté ou transformé selon un contrat visible.
La population impactée se calcule avec la même jointure que le flux, puis se contredit avec une seconde méthode. Une recherche par offre distante peut retrouver des éléments ignorés par le référentiel local. Cette comparaison borne l’incident avant la correction.
Auditer calculs, filtres et plafonds
Rejouez la formule sur quelques SKU : physique contrôlé, moins réservations, moins commandes non expédiées, moins tampon, limité par plafond et éligibilité. Expliquez chaque écart avec une pièce. Une constante cachée ou une réservation orpheline devient immédiatement visible.
Contrôlez les unités. Carton, pièce, lot et pack ne sont pas interchangeables. Une conversion arrondie dans le mauvais sens peut multiplier le disponible. La règle doit définir division, arrondi et condition de vente par unité.
Analysez aussi la hiérarchie des règles. Une correction manuelle peut écraser le calcul, puis expirer sans restaurer la bonne valeur. Les overrides portent auteur, motif, portée et fin ; leur expiration repasse par le calcul courant plutôt que par une ancienne sauvegarde.
Faire varier les entrées
Construisez un jeu comprenant zéro, une unité, quantité négative, réservation totale, stock ancien et entrepôt exclu. Pour chaque cas, écrivez la sortie attendue avant d’exécuter. Le test révèle les hypothèses implicites.
Ajoutez une variation sur l’ordre : stock avant commande, commande avant stock, doublon et reprise. La même version métier doit produire le même résultat, quel que soit le chemin technique autorisé.
Localiser retard, rejet ou écrasement
Une extraction réussie ne prouve pas la livraison. Suivez nombre d’objets attendus, envoyés, acceptés, rejetés et observés. Les contrôles de somme ou de comptage par lot permettent de repérer une perte partielle sans lire chaque ligne.
Les rejets contiennent code, champ, valeur, canal et possibilité de reprise. Une erreur définitive rejoint une file métier ; une erreur temporaire utilise une reprise bornée et idempotente. Le poison message ne bloque pas les éléments suivants sans alerte.
Un accusé HTTP confirme parfois seulement la réception. La preuve finale vient d’une lecture de l’offre ou d’un rapport d’application. Le délai entre accusé et visibilité est mesuré par canal afin de ne pas déclencher de faux correctifs.
Lors d’un incident, choisissez entre suspendre, réduire ou republier. Si l’âge dépasse le seuil et le stock tourne vite, alors le confinement passe avant le maintien du chiffre d’affaires. Pour un produit stable à faible risque, une observation courte peut être préférable.
Résoudre deux scénarios contradictoires
Scénario 1, chiffres illustratifs : le physique et le WMS indiquent 12 unités à 9 h. Deux réservations et un tampon de deux donnent un diffusable de huit. Le canal affiche zéro. La chronologie retrouve un rejet d’identifiant sur le lot de 9 h ; l’ancien zéro reste visible.
L’équipe ne publie pas 12. Elle corrige le mapping sur une cohorte, renvoie la projection versionnée à huit et lit le canal. Si cinq offres comparables convergent et aucun ancien message ne les écrase pendant la fenêtre choisie, alors elle étend progressivement.
Scénario 2 : le canal affiche 20 alors que le diffusable vaut huit. Une reprise traitée à 9 h 10 transporte une projection calculée la veille. Le flux comparait l’heure de réception, pas la version métier. L’équipe confine, refuse désormais les versions inférieures et rapproche toutes les offres du lot.
Les quantités, heures et taille de cohorte montrent les décisions ; elles ne constituent pas des seuils universels. Le vendeur utilise rotation, latence et coût réel pour calibrer son protocole.
Éviter les erreurs fréquentes de diagnostic
Six raccourcis qui déplacent l’écart
Comparer au physique brut. Rejouez le diffusable. Se fier au dernier timestamp. Utilisez la version métier. Corriger toute la population. Commencez par une cohorte bornée.
Ignorer les rejets partiels. Comptez par lot. Confondre accusé et application. Lisez le canal. Laisser un override sans fin. Donnez-lui portée, propriétaire et règle de sortie.
Ne pas rendre vert un état inconnu
Une dépendance inaccessible ou un canal sans lecture reste inconnu. Le responsable choisit une mesure conservatoire et une échéance. Le tableau n’invente pas un succès à partir de l’absence d’erreur.
Cette distinction protège le support : il sait quels SKU peuvent être promis et lesquels nécessitent une vérification. L’incertitude devient une file à fermer, pas un bruit caché.
Plan d’action : fermer un flux en vingt jours
Séquence de mise en œuvre de bout en bout
Le premier lot choisit un canal, un entrepôt et une famille de SKU. Il couvre la source jusqu’à la lecture distante, avec erreur et repli.
- D’abord, rapprocher les valeurs et borner l’exposition.
- Ensuite, contracter calcul, fraîcheur et versions.
- Puis, instrumenter lots, rejets et preuve distante.
- Enfin, tester le désordre avant d’étendre.
Jours 1 à 4 : référence et population
Prélevez physique, WMS, engagements, diffusable et valeur distante. Reconstituez dix chronologies et deux méthodes de population. Mesurez âge, écarts et commandes exposées. Nommez le propriétaire de la source, de la projection, du transport et du canal. Confinez les SKU dont le risque ne peut attendre.
Jours 5 à 8 : contrat versionné
Écrivez entrées, sorties, responsabilités, dépendances, unités, seuils et règles d’éligibilité. Ajoutez version métier, date de calcul et identifiants par canal. Faites contredire les cas par stock, catalogue, technique, support et finance. Définissez réduction, suspension et repli.
Jours 9 à 14 : observation et reprise
Instrumentez journalisation, comptages de lot, rejets, file métier et lecture distante. Le contrat d’exécution associe entrée, sortie, responsabilité, seuil, dépendance et repli. Rendez la reprise idempotente et empêchez une version ancienne d’écraser la plus récente. Ajoutez une alerte sur la fraîcheur et les résidus.
Jours 15 à 20 : cohorte et décision
Jouez retard, doublon, rejet partiel, unité erronée, canal indisponible et override expiré. Publiez la cohorte avec plafond, puis comparez canal et diffusable sur plusieurs cycles. Étendez si les écarts sont expliqués et si les anciennes versions restent rejetées ; sinon, revenez au périmètre précédent.
Vingt jours sont un scénario de travail. La taille de l’écosystème peut imposer plus de temps. Le succès se mesure à la capacité de localiser, reprendre et expliquer un écart, pas à une date artificielle.
Piloter la fraîcheur et les résidus
Suivez âge de la valeur distante, écart absolu et relatif, offres à zéro inattendu, surpublication, rejets, ancienne version refusée et délai jusqu’à convergence. Segmentez par canal, lot, producteur et famille de rotation.
Un taux moyen de conformité peut masquer une offre à forte vente. La revue combine volume d’écarts, exposition de commandes, marge, risque d’annulation et durée. Elle priorise les SKU qui peuvent encore créer un dommage plutôt que ceux dont le nombre est le plus spectaculaire.
Chaque incident nourrit la carte de causes. Si les rejets d’identifiant se répètent, alors le mapping devient un chantier ; si la latence augmente, la cadence ou le plafond évolue. Le pilotage retire les causes au lieu d’empiler des republishes.
Relier réserve, concurrence et retrait
Calculer une disponibilité défendable
L’analyse de la réserve de stock marketplace approfondit engagements et tampon. Le dossier sur la remédiation de la donnée de stock diffusable traite propriété, qualité et preuve à l’échelle du portefeuille.
Ces contrôles sécurisent la valeur en amont. Le présent diagnostic ajoute le transport et la lecture distante afin de localiser où une bonne projection se déforme.
Protéger la promesse et l’extinction
Le mécanisme de réservation concurrente multi-entrepôts ferme l’engagement au moment de la commande. Le protocole du SKU inactif encore actif empêche une ancienne projection de rallumer l’offre.
Si l’écart touche des commandes acceptées, alors ces obligations disposent d’une file et d’un propriétaire distincts. La correction catalogue ne les efface pas.
Sources techniques et limites
La spécification Google Merchant Center décrit l’attribut officiel de disponibilité produit. Elle sert d’exemple de contrat de destination ; les marketplaces possèdent leurs propres valeurs et délais.
La documentation Apache Kafka explique les garanties de livraison et de traitement des messages. Les principes de doublon et d’ordre éclairent le diagnostic sans supposer que le vendeur utilise Kafka.
Quantités, fenêtres et cohortes restent illustratives. Les règles réelles se calibrent avec contrats, rotations, capacités et coûts observés. Vérifiez la documentation actuelle de chaque canal.
FAQ : cause, date et republication
Pourquoi le canal est-il faux si le physique est juste ?
Parce qu’une projection applique des engagements et traverse plusieurs systèmes. Retard, rejet, identifiant, ancienne version ou règle locale peuvent déformer la bonne valeur source.
Quelle date comparer ?
Comparez date métier, émission, réception, traitement et lecture distante. La version métier décide de l’ordre lorsque les horloges ou reprises rendent les timestamps ambigus.
Quand republier ?
Après correction de la cause sur une cohorte, preuve distante et test des messages anciens. L’extension garde un plafond et un repli jusqu’à la convergence observée.
Conclusion : prouver chaque transformation
Un stock physique juste ne devient fiable sur une marketplace que si chaque transformation reste nommée, versionnée et observable. Le diagnostic compare la même unité, le même objet et la même date métier au lieu d’opposer deux écrans.
Commencez par un SKU qui alterne rupture et surpublication. Reconstituez sa chronologie, rejouez sa formule et lisez le canal. Le premier trou de preuve indique où placer le contrat, la métrique ou le refus d’ancienne version.
Recontrôlez ce SKU après plusieurs cycles et une reprise volontaire. Une correction qui ne survit pas au désordre du flux reste provisoire ; elle ne justifie ni la clôture de l’incident ni l’extension au catalogue.
Si vos quantités traversent plusieurs outils et canaux, Dawap peut auditer votre flux de stock marketplace, réunir les responsables et accompagner une première cohorte jusqu’à une disponibilité fraîche, explicable et exploitable par le run.
