WooCommerce B2B : commandes et rapprochement des stocks ERP

Cadrez les commandes B2B et comparez les stocks de la boutique et de l’ERP avec les bonnes références, réservations et périodes.

Deux femmes consultent une planchette à pince devant des rayonnages; l’une porte un gilet de sécurité.

Contenu de l’article

Pour rapprocher les stocks de WooCommerce et de votre ERP, comparez le même article, la même unité et le même périmètre d’entrepôt, à une période comparable. Définissez ensuite ce que chaque quantité inclut déjà : réservations, commandes engagées et marge de sécurité. Une différence entre deux écrans ne justifie pas de remplacer automatiquement le stock de l’un par celui de l’autre.

Dans une boutique B2B, ce contrôle dépend aussi du parcours de commande : prix par compte, devis, bon de commande et modalités de paiement. Voici comment cadrer ces besoins, puis établir une fiche de rapprochement utilisable. L’exemple est fictif; aucun résultat d’une boutique cliente n’est revendiqué.

Partir des règles de commande B2B

Pour un distributeur, une boutique utile ne se résume pas à afficher un catalogue. Écrivez les décisions que le parcours doit respecter avant de sélectionner des extensions ou un développement :

  • Comptes et prix : qui peut consulter chaque catalogue, obtenir un prix négocié et commander pour une entreprise? Testez aussi le compte sans droit et l’utilisateur déconnecté.
  • Commande : faut-il saisir un numéro de bon de commande, acheter par caisse ou respecter un minimum? Précisez l’unité vendue et la règle d’arrondi des quantités.
  • Devis et paiement : à quel moment un devis devient-il une commande acceptée? Qui approuve les modalités et à quelle étape la quantité est-elle engagée?
  • Service : qui reçoit les exceptions, peut modifier une commande et confirme une date de livraison?

Ces exigences ne sont pas une liste de fonctions garanties par toute installation WooCommerce. Faites démontrer votre parcours sur la combinaison exacte d’extensions et de connecteur retenue. Un connecteur existant peut convenir si ses règles sont vérifiables; le sur mesure se justifie par un besoin précis non couvert, pas par une préférence automatique.

Les prérequis avant de comparer les stocks

Obtenez un export autorisé en lecture seule des produits ou variantes concernés, la correspondance vers les articles ERP, les règles de réservation et les traces récentes de synchronisation. Notez les versions de WooCommerce, du connecteur et des extensions qui interviennent dans le stock. Limitez les données aux références, quantités, états et horodatages nécessaires; un contrôle de stock n’a pas besoin d’un export des coordonnées des clients.

Commencez par quelques références représentatives dans un environnement de test ou avec des exports figés. Il faut un responsable métier capable d’expliquer les quantités et une personne qui connaît l’intégration. Un tableur peut suffire à une première lecture. Hébergement, extensions, accès API, connecteur, nettoyage des données, essais et soutien peuvent entraîner des coûts; faites chiffrer ce périmètre plutôt qu’adopter un tarif ou un délai générique.

Si vous partez d’un incident, examinez d’abord les journaux du connecteur, les erreurs, les notes de commande et les heures des événements. Sans ces preuves, un retard de synchronisation reste une hypothèse.

Définir les champs et le stock réellement géré

La documentation de l’API REST WooCommerce v3 pour les produits distingue manage_stock, stock_quantity, stock_status et backorders. Relevez-les séparément : un statut « en stock » n’est pas un décompte, et autoriser les commandes en rupture est une politique différente d’une quantité.

Créez une fiche par référence avec : identifiant ERP, identifiants produit et variante WooCommerce, SKU, unité, entrepôt couvert, niveau qui détient le stock, sens de la quantité, période du relevé et règle de commande en rupture. Ajoutez la preuve consultée et le responsable de la décision. Ne comparez pas des caisses à des unités, ni tous les entrepôts à un seul emplacement.

Pour les variantes, le stock peut être propre à la variante ou partagé au parent. L’API des variations prévoit notamment la valeur parent pour manage_stock; le guide des produits variables décrit les modes de gestion. Un SKU ressemblant ne suffit donc pas à prouver la correspondance. Vérifiez les identifiants et ne comptez pas plusieurs fois le même stock partagé au parent.

Rapprocher des relevés qui parlent du même moment

Deux exports réalisés à trente minutes d’intervalle peuvent encadrer des ventes ou des réceptions. Notez le début et la fin de l’extraction, le fuseau, la période couverte et les événements déjà traités. Un export paginé d’un catalogue actif n’est pas nécessairement un instantané unique.

Le champ date_modified_gmt documenté dans l’API produit correspond à la modification du produit. À lui seul, il ne démontre pas que les deux systèmes ont intégré les mêmes mouvements. Si vous ne pouvez pas reconstruire une période comparable, classez le cas « non comparable » et reprenez le relevé; ne transformez pas cette incertitude en écart de stock confirmé.

Pour votre pilote, choisissez une méthode reproductible : jeu figé, période calme avec mouvements tracés, ou export cohérent fourni par chaque système. Une limite de fraîcheur acceptable doit venir de vos opérations. Les heures fictives de l’exemple ci-dessous ne définissent pas une norme de synchronisation.

Déduire les réservations une seule fois

Demandez ce que signifie exactement « disponible » dans votre ERP et ce que le connecteur envoie à WooCommerce. Une quantité peut déjà être nette de certaines commandes. Avant tout calcul, établissez quelles réservations ont déjà réduit chaque valeur et lesquelles restent temporaires.

WooCommerce distingue les états Pending payment, On hold et Processing. Sa documentation des commandes indique un stock réduit pour les deux derniers. Le réglage Hold Stock concerne les commandes en attente de paiement, pas celles à l’état On hold. Vérifiez également les règles de vos extensions et les notes des commandes; une traduction similaire ne rend pas ces états équivalents.

Exemple illustratif : le contrat d’un pilote prévoit 12 unités physiques, moins 3 réservées, moins une unité de sécurité, soit 8 unités à transmettre. Les trois unités réservées sont comptées une seule fois, aucune autre retenue temporaire n’existe dans ce jeu, et la valeur boutique est définie comme déjà nette de ces déductions. Si elle vaut 8, ne retirez pas encore 3. Cette formule appartient à l’exemple : le nom stock_quantity ne prouve pas à lui seul cette signification dans votre installation.

Classer les résultats avant de corriger

Calculez une différence seulement après avoir confirmé référence, unité, lieu, période et sens des valeurs. Dans l’exemple, boutique 10 moins quantité attendue 8 donne un écart de +2. Cela prouve une différence dans ce périmètre, pas sa cause ni le bon système à écraser.

  • Concordance : les quantités comparables correspondent. Un zéro explicite est une valeur vérifiable.
  • Écart de quantité : les mêmes références et règles produisent des nombres différents; recherchez le mouvement ou la règle qui explique l’écart.
  • Non comparable : quantité manquante, variante incorrecte, période incompatible ou périmètre non confirmé. Ne remplacez jamais une valeur absente par zéro.
  • Politique à revoir : les quantités peuvent être égales alors que la boutique accepte des commandes en rupture contrairement à la règle prévue.

Pour chaque exception, conservez les valeurs initiales, la preuve, la cause confirmée ou encore hypothétique et l’action proposée. Avant une correction réelle, validez la source faisant autorité, les mouvements intervenus depuis le relevé et les conséquences sur les commandes. Corrigez un petit périmètre autorisé, relisez le résultat dans les deux systèmes, puis vérifiez qu’une prochaine synchronisation ne réintroduit pas l’écart. Une remise à jour globale à partir d’un vieux fichier peut écraser des mouvements récents.

Ce que notre démonstration locale a vérifié

Le 28 octobre 2026, un test Python 3.9.6 a comparé dix cas entièrement synthétiques selon le contrat ci-dessus. Les dix résultats attendus ont été vérifiés : deux concordances, un écart numérique, six cas non comparables et une politique à revoir. Le 10 novembre 2026, un nouveau contrôle des dix mêmes cas, avec un script reconstruit à partir du contrat documenté, a confirmé ces résultats.

  • La quantité attendue 8 concorde avec la boutique; 10 produit l’écart de +2.
  • Une quantité absente est rejetée comme non comparable; un zéro explicite de chaque côté concorde.
  • Un décalage de trente minutes, une mauvaise variante malgré un SKU identique et un mauvais périmètre d’entrepôts sont signalés.
  • Un stock partagé au parent et un sens de quantité non confirmé restent hors de la comparaison.
  • Des commandes en rupture autorisées malgré la règle « non » déclenchent une revue, même avec des quantités identiques.

Les références, lieux et heures sont inventés. Les métadonnées snapshot_at et location_scope de ce jeu décrivent nos exports fictifs; ce ne sont pas des champs natifs revendiqués de l’API produit. Le cas concordant représente le même instant en UTC et avec un décalage de fuseau. Aucun WooCommerce, ERP, connecteur ou appel API réel n’a été exécuté. Le test ne valide ni commandes concurrentes, réservations réelles, annulations, retours, performances ou correction automatique.

Intégrer le contrôle au projet de boutique

Définissez qui possède chaque donnée : catalogue et prix, stock, commande acceptée, paiement et suivi commercial. L’ERP et le CRM peuvent avoir des responsabilités différentes. Documentez les correspondances, les erreurs et les reprises; une commande rejouée doit pouvoir être reconnue sans créer une seconde écriture métier. Notre guide sur l’intégration API entre ERP et CRM développe ce cadrage.

Pour les parcours offerts en français et en anglais, vérifiez les descriptions, unités, messages de rupture, comptes, devis et courriels dans les deux langues. Gardez les mêmes identifiants métier derrière les libellés traduits. Une quantité juste ne compense pas une unité ambiguë ou un prix d’un autre compte.

Avant la mise en ligne, faites une recette sur un environnement séparé : droits et prix par compte, commande avec bon de commande, minimums et multiples, transformation d’un devis, changement d’état, stock épuisé et exception de synchronisation. Préparez le retour arrière et le traitement des commandes créées entre-temps. Demandez des preuves de test, une procédure de reprise et un responsable de soutien; ne présumez ni une durée de projet ni une compatibilité parfaite à partir d’une liste de logos. La grille de recette utilisateur aide à formaliser ces critères.

Checklist de rapprochement

  • Le parcours B2B et le moment où le stock est engagé sont définis.
  • Article, variante, unité, entrepôt et détenteur du stock sont confirmés.
  • Les relevés couvrent une période comparable et leurs mouvements sont traçables.
  • Les réservations ne sont déduites qu’une fois; les quantités absentes restent inconnues.
  • Quantité, statut et politique de commande en rupture sont examinés séparément.
  • Chaque écart a une preuve, un responsable et une validation après correction autorisée.

Si ces règles doivent relier votre boutique à vos systèmes, notre offre d’applications et d’intégrations sur mesure au Québec et au Canada permet de cadrer le pilote et ses critères de réception.

Documentation technique revérifiée le 10 novembre 2026. Démonstration initiale du 28 octobre; nouveau contrôle des mêmes cas le 10 novembre 2026.

Découvrez plus d’articles

Discutons de votre projet.

Expliquez-nous ce que vous souhaitez améliorer. Nous vous aiderons à choisir les prochaines étapes.

Démarrer la discussion