Le client paie un produit indiqué disponible, puis le service client découvre qu'il a déjà été vendu en magasin. Cette survente est visible, mais d'autres écarts restent silencieux : retours non réintégrés, commandes annulées encore réservées, lots mal rapprochés ou flux interrompu depuis plusieurs heures.
Il faut distinguer quantité physique, réservée, disponible à la vente, en transfert et en attente de contrôle. Une seule valeur ne suffit pas à tous les canaux.
01 — Écarts
Pourquoi les stocks divergent entre les canaux
La première cause est le délai. Une vente en caisse doit atteindre la boutique avant qu'un second client commande la dernière pièce. La seconde est l'échec invisible : l'API refuse une référence, un mot de passe expire ou un traitement planifié s'arrête sans alerte.
Les identifiants créent aussi des écarts. Le même article peut porter un SKU dans l'ERP, une référence dans PrestaShop et un identifiant de déclinaison sur une marketplace. Une couleur ou une taille mal associée met à jour le mauvais produit. Enfin, chaque canal ne traite pas les événements au même moment : commande créée, paiement accepté, préparation, annulation et remboursement.
- Ventes simultanées sur plusieurs canaux.
- Réservations abandonnées qui ne sont jamais libérées.
- Retours ou annulations traités manuellement.
- Déclinaisons, lots ou packs sans correspondance unique.
- Import nocturne insuffisant pour le rythme des commandes.
- Erreur API enregistrée mais non signalée.
02 — Règles
Choisir le système maître et la formule du stock vendable
L'ERP, le logiciel de caisse ou le WMS tient généralement le stock physique. La boutique conserve parfois des réservations utiles au paiement. Il faut définir quel outil fait foi et dans quels cas un canal peut modifier la quantité.
Le stock disponible peut être calculé comme le physique moins les réservations, le seuil de sécurité et les commandes en préparation. Pour un produit fabriqué ou composé, il dépend parfois des composants. Ces règles doivent être explicites avant de choisir la fréquence technique.
Temps réel
Webhooks et API transmettent rapidement les ventes. Adapté aux volumes soutenus et aux faibles quantités.
Synchronisation courte
Un traitement toutes les quelques minutes regroupe les mises à jour et facilite certains systèmes anciens.
Recalcul complet
Un rapprochement périodique détecte les écarts que les événements unitaires n'ont pas corrigés.
03 — Connecteur
Une synchronisation robuste combine événements et contrôles
Lorsqu'une commande est payée, la boutique envoie un événement. Le connecteur vérifie son identité, associe chaque ligne à la bonne référence et transmet la réservation ou la sortie. Il enregistre la réponse du système maître, puis met à jour les autres canaux. Si un service ne répond pas, le traitement est placé dans une file et repris sans créer de doublon.
Un recalcul régulier compare ensuite les quantités attendues. Cette « réconciliation » est indispensable : même un bon flux temps réel peut manquer un événement lors d'une maintenance, d'un changement de module ou d'une intervention manuelle.
La supervision doit afficher l'heure de la dernière synchronisation, les références en erreur et l'écart constaté. Une alerte exploitable indique le produit, le canal et l'action à mener. C'est une partie centrale d'une intégration API e-commerce, pas une option réservée aux grands sites.
04 — Recette
Tester les scénarios qui provoquent les surventes
- Dernière unité vendue en ligne
Vérifier le paiement, la réservation, le passage à zéro et le retrait des autres canaux.
- Deux commandes simultanées
S'assurer qu'une transaction réserve atomiquement la quantité et que l'autre reçoit une réponse maîtrisée.
- Paiement refusé ou abandonné
La réservation doit être libérée selon une règle claire, sans remettre en vente une pièce déjà confirmée ailleurs.
- Annulation partielle et retour
Tester chaque statut : un remboursement financier ne signifie pas toujours que le produit est immédiatement revendable.
- API indisponible
Couper volontairement le service de test, vérifier l'alerte puis la reprise sans double mouvement.
Développeur e-commerce à Toulouse
Votre stock diverge entre boutique, caisse, ERP ou marketplace ?
J'analyse les flux existants, les API et les règles de réservation, puis je développe ou reprends le connecteur avec journaux, alertes et procédure de reprise. J'interviens à Toulouse, dans le Grand Sud et à distance partout en France.
- Cartographie des systèmes et références
- Synchronisation stock et commandes
- Gestion des erreurs et des doublons
- Tableau de supervision et maintenance
Un premier audit permet d'identifier si l'écart vient des règles métier, des correspondances produit ou du transport technique.
Faire auditer ma synchronisation de stockPour une boutique existante devenue fragile, consultez aussi mon accompagnement de reprise de site e-commerce.
05 — Préparation
Les données à réunir pour trouver l'origine d'un écart
Préparez la liste des canaux, le système supposé maître, un exemple de référence touchée et la chronologie complète : stock initial, commandes, annulations, retours et corrections manuelles. Ajoutez les heures de dernière exécution, journaux disponibles et versions des modules.
Ne corrigez pas seulement la quantité finale avant d'avoir conservé les preuves. L'objectif est de comprendre quel événement manque ou a été appliqué deux fois. Une fois la cause établie, on peut corriger le stock, rejouer le flux et ajouter le contrôle qui empêchera la récidive.
06 — Supervision
Les indicateurs à surveiller après la mise en ligne
Un tableau de bord utile ne montre pas seulement que le service est « en ligne ». Il affiche l'heure du dernier événement reçu et du dernier rapprochement complet, le nombre de références en erreur, l'âge de la plus ancienne anomalie et les canaux concernés. Un statut vert ne doit apparaître que si les échanges avancent réellement.
Définissez des seuils liés au métier. Dix minutes de retard peuvent être acceptables pour un catalogue abondant, mais dangereuses lorsque les quantités sont faibles et les ventes simultanées. Une alerte critique doit joindre l'identifiant de la référence et le motif, tout en évitant d'envoyer des données sensibles.
Analysez régulièrement les corrections manuelles. Si l'équipe ajuste chaque semaine les mêmes packs ou retours, la règle mérite d'être intégrée au connecteur. Cette boucle d'amélioration transforme la surveillance en outil opérationnel et empêche que les contournements deviennent un second système de stock.