Créez votre site WordPress avec Elementor.Découvrir Elementor Lien partenaire

LANGUES DE BLOGPASCHER

Langues de ce guide

Ouvrez une autre édition du guide ou consultez une archive.

Éditions de ce guide

Archives disponibles

Traductions prévues (32)
  • Englishanglais
  • Españolespagnol
  • Deutschallemand
  • Portuguêsportugais
  • Italianoitalien
  • Nederlandsnéerlandais
  • Polskipolonais
  • Українськаukrainien
  • Češtinatchèque
  • Slovenčinaslovaque
  • Hrvatskicroate
  • Românăroumain
  • Magyarhongrois
  • Ελληνικάgrec
  • Türkçeturc
  • العربيةarabe
  • עבריתhébreu
  • हिन्दीhindi
  • বাংলাbengali
  • ไทยthaï
  • Tiếng Việtvietnamien
  • Bahasa Indonesiaindonésien
  • 简体中文chinois simplifié
  • 日本語japonais
  • 한국어coréen
  • Danskdanois
  • Svenskasuédois
  • Norsknorvégien
  • Suomifinnois
  • Eestiestonien
  • Latviešuletton
  • Lietuviųlituanien

Apparence du site

Boutique WooCommerce et parcours de commande · Intermédiaire

Retrouver le stock d’une variation WooCommerce après un remboursement partiel

Vérifiez le retour en stock d’une variation WooCommerce après un remboursement partiel, retrouvez le compteur concerné et corrigez l’écart sans doubler le remboursement.

Publié le · Mis à jour le · Méthode éditoriale

Séparer le remboursement du mouvement de stock

Ouvrez WooCommerce > Commandes, puis la commande concernée. Relevez son état, le ou les remboursements déjà enregistrés, le montant remboursé et la quantité remboursée à côté de la ligne de produit. Une remise de 5 € peut correspondre à un geste commercial sans aucun article retourné. Un remboursement d’une unité décrit une ligne et une quantité. La présence d’un montant ne permet donc pas de déduire que WooCommerce devait augmenter le stock. Notez aussi si l’article est effectivement revenu et s’il peut être revendu.

Dans les notes de la commande, repérez la baisse de stock de départ et l’éventuelle augmentation au moment du remboursement. Notez le SKU de la variation, son nom et la combinaison de ses attributs. La note contient un identifiant et des quantités. Pour interpréter ces chiffres, vous devez savoir quelle fiche porte le compteur. Une variation Bleue peut être vendue sous son propre SKU tout en consommant le stock commun du produit variable.

Un remboursement partiel peut laisser la commande en cours ou terminée. Cet état ne constitue pas une preuve sur le stock. Comparez la somme remboursée, la quantité retournée et le compteur d’inventaire. Ces trois éléments évoluent séparément. Gardez les valeurs avant et après dans le même relevé. Si une extension traite les retours ou un logiciel de stock synchronise la boutique, relevez également l’heure du dernier mouvement et l’outil qui l’a écrit.

Identifier le compteur de la variation

Dans Produits > Tous les produits, ouvrez le produit variable mentionné sur la commande. Dans Données produit > Variations, développez la combinaison exacte et recherchez la gestion du stock de cette variation. Si elle porte son propre stock, relevez sa quantité et celle d’une variation voisine. Vérifiez également l’onglet Inventaire du produit parent. Lorsque le parent gère un stock partagé et que la variation n’a pas de gestion individuelle, le compteur à contrôler se trouve sur le parent.

Si la gestion des quantités n’est active ni au niveau pertinent ni globalement dans WooCommerce > Réglages > Produits > Inventaire, une disponibilité affichée « En stock » peut être un état choisi sans compteur. Recherchez plutôt comment l’équipe décompte réellement les ventes. Ne changez pas ces réglages pour obtenir un mouvement sur une ancienne commande. Si le mode de gestion a changé depuis la vente, rapprochez le mouvement d’origine et la fiche actuelle avant de décider où remettre une unité.

Préparer une commande de comparaison

Sur une installation locale, créez deux produits variables fictifs, l’un avec un stock propre à la variation et l’autre avec un stock géré au parent. Préparez un témoin à dix unités. Ajoutez deux unités à une commande de recette avec un prix simple et sans passerelle active. Passez la commande en cours de traitement, puis relisez le compteur avant d’ouvrir le remboursement. Le témoin doit d’abord montrer la sortie de deux unités. Si le stock reste à dix, vérifiez la ligne et la configuration de la recette avant de tester le retour.

Créez une nouvelle commande témoin pour chaque comparaison. Gardez la même ligne, la même quantité initiale et le même état de départ. Modifiez un seul paramètre à la fois. Comparez un montant seul, puis une quantité d’une unité avec la case cochée, puis la même quantité avec la case décochée. Le remboursement manuel est un enregistrement dans la boutique. En recette sans paiement, il n’implique aucun transfert d’argent.

Comparer les effets sur la même ligne de recette

Dans WooCommerce > Commandes, ouvrez la commande fictive, puis cliquez sur Rembourser sous le tableau des articles. Dans un premier essai, saisissez seulement 5 € dans le champ du montant, sans modifier la quantité de la ligne. Dans les deux autres essais, saisissez une unité sur la ligne bleue. Laissez WooCommerce reprendre le montant correspondant à la ligne. Notez la position de la case de remise en stock avant de choisir Rembourser manuellement. Sur la copie, relevez le nouveau compteur aussitôt et relisez le détail du remboursement. Le libellé exact de la case dépend de la traduction.

Exemple de résultats attendus avec une variation bleue à dix unités et une rouge à quinze : la commande de deux bleues doit réduire le compteur bleu à huit. Le remboursement d’une unité avec remise en stock doit le ramener à neuf, sans changer le rouge. Sans remise en stock, le bleu doit rester à huit ; avec un montant seul et aucune quantité remboursée, il doit également rester à huit. Vérifiez ces états sur des commandes de recette distinctes et consignez tout écart. Ces nombres illustrent le protocole ; aucun résultat exécuté n’est fourni ici.

Avec un stock partagé, relevez le compteur du parent avant la commande, après la sortie de deux unités et après le retour d’une unité. Pour un départ à dix, les valeurs attendues sont huit puis neuf. La ligne de commande désigne la variation, tandis que le compteur appartient au parent. Comparez aussi une variation voisine utilisant ce même stock : sa disponibilité peut refléter la même quantité sans avoir été remboursée.

Reproduisez d’abord ces comparaisons avec le moteur natif, sans paiement ni appel à une passerelle. Si une extension de retours remplace le bouton ou si un entrepôt externe pilote les quantités, préparez ensuite une comparaison distincte avec ce composant. Notez les versions et paramètres réellement utilisés ; le parcours natif est une référence de diagnostic, pas la preuve du comportement de toutes les intégrations.

Exemple fictif des valeurs attendues pour une unité remboursée et remise en stock.

Variation bleue   avant commande : 10 | après commande : 8 | après retour : 9
Variation rouge   avant commande : 15 | après commande : 15 | après retour : 15

Lire les états de commande sans les utiliser pour réparer le stock

Les transitions de commande et les remboursements sont deux mécanismes distincts. Comparez sur des commandes fictives une sortie de stock en état En cours ou En attente et une commande restée En attente de paiement. Relevez d’abord le mouvement d’origine, puis observez un remboursement partiel avec quantité et remise en stock. Si aucune unité n’avait été déduite de la ligne, n’attendez pas automatiquement une augmentation. Une réservation temporaire du panier est encore un autre mécanisme.

Après un remboursement partiel, une commande peut conserver son état En cours ou Terminé. Lisez les montants et quantités de tous les remboursements existants avant d’interpréter son statut. Un état inchangé ne justifie pas un nouvel essai. Modifier le statut à la main ne produit pas la même opération qu’un remboursement enregistré sur une ligne.

L’annulation mérite une vérification séparée sur une commande fictive. Après la sortie de deux unités puis le remboursement avec retour d’une unité, relevez l’effet d’une annulation sur l’unité encore déduite et sur la liste des remboursements. Sur une vraie commande dont une unité reste vendue, une annulation peut remettre à disposition du stock qui n’est plus à l’entrepôt. Gardez l’état qui décrit la transaction réelle et corrigez l’inventaire séparément si nécessaire.

Vérifier ce qu’un nouvel essai produirait

Si l’écran se ferme ou tarde à répondre, rouvrez la commande dans un nouvel onglet avant de soumettre le remboursement de nouveau. Cherchez une ligne négative ou un nouvel enregistrement de remboursement, puis relisez les notes et le solde restant. Si une passerelle a été utilisée, rapprochez son identifiant de remboursement avec la commande avant toute nouvelle opération. Un remboursement manuel et un remboursement via la passerelle peuvent avoir le même montant à l’écran tout en correspondant à des actions différentes. Choisissez le mode seulement après avoir établi ce qui a déjà été enregistré et ce qui reste réellement à faire.

Pour comprendre le risque de doublon, utilisez uniquement une commande fictive de 24 € pour deux unités. Un premier remboursement de 12 € avec retour d’une unité laisse encore un solde remboursable. Une seconde demande identique peut donc créer un deuxième remboursement et un second mouvement de stock. Ne considérez pas un premier succès comme une protection contre la relance. Relevez les remboursements existants avant toute nouvelle action ; aucune demande supplémentaire ne doit servir à vérifier une commande réelle.

Si la commande réelle présente déjà le bon montant et la bonne quantité, passez au rapprochement d’inventaire. Une autre ligne financière ne corrigerait pas la destination du premier mouvement. Si aucun remboursement n’est enregistré et qu’une opération financière est réellement attendue, traitez cette décision avec la personne habilitée à gérer la commande et vérifiez ensuite, une seule fois, le nouvel enregistrement et son mouvement de stock.

Corriger un écart établi sur le bon compteur

Cette approche convient lorsqu’un remboursement existe déjà et que l’équipe peut confirmer un article revenu, revendable et absent du stock courant. Il faut un compte habilité à modifier les produits, l’accès aux notes de la commande et une valeur d’inventaire vérifiée. Si le logiciel de stock externe fait foi, effectuez le mouvement dans celui-ci et observez sa répercussion dans WooCommerce. Sinon, relevez dans WooCommerce la valeur actuelle de la variation ou du parent qui gère le stock. Une quantité correcte au moment du remboursement peut avoir été remplacée depuis par un import ou une synchronisation. L’heure de cette écriture indique quel outil doit être corrigé.

Calculez l’écart à partir du stock observé maintenant. De nouvelles ventes, réceptions et corrections peuvent être intervenues depuis la vente. Appliquez l’écart au relevé actuel. Par exemple, si le compteur actif est à huit et qu’une seule unité retournée manque, le résultat attendu est neuf. Si une autre personne modifie l’inventaire en parallèle, coordonnez l’opération et relisez le compteur juste avant d’enregistrer. En cas de désaccord sur le nombre physique, conservez le relevé et rapprochez-le avec l’entrepôt avant de rendre l’article disponible.

Pour une variation avec son propre stock, ouvrez Produits > Tous les produits > le produit concerné > Données produit > Variations. Développez la combinaison exacte et appliquez l’écart à sa quantité. Enregistrez les variations puis mettez à jour le produit si l’interface le demande. Pour un compteur partagé, modifiez la quantité dans Données produit > Inventaire du parent et mettez à jour le produit. Gardez la règle de gestion du stock telle qu’elle était, puis rechargez les fiches. Vérifiez que la quantité a changé sur le compteur choisi et qu’aucune variation indépendante n’a reçu la même correction.

Inscrivez dans une note privée de commande le SKU, le compteur modifié, la quantité ajoutée ou retirée, la date et le motif. Ne créez pas une note visible du client pour ce relevé interne. Dans une recette sans autre mouvement simultané, un ajustement de plus une unité doit porter huit à neuf sans modifier la liste des remboursements. Vérifiez ensuite que l’opération inverse retrouve le relevé initial. Si l’ajustement réel s’avère erroné, appliquez uniquement son inverse sur le même compteur après avoir relevé les mouvements intervenus depuis. Le stock peut ainsi être corrigé sans effacer une trace du remboursement ou annuler une vente encore valable.

Confirmer le résultat à trois endroits

Retournez à la commande et contrôlez que les montants et quantités remboursés correspondent toujours au retour attendu. Ouvrez la fiche du compteur et relisez la quantité enregistrée, puis vérifiez la disponibilité de la combinaison en boutique à partir d’une page fraîche, sans passer de commande. Si le compteur parent est partagé, vérifiez une autre combinaison utilisant ce même compteur. Si le stock est propre à la variation, vérifiez au contraire que la combinaison voisine a conservé sa quantité. La disponibilité publique peut aussi dépendre des commandes en réapprovisionnement, de la visibilité et d’un cache, ce qui justifie ce dernier contrôle à part.

Si les notes et le compteur se contredisent encore, reprenez une seule commande sur la copie avec l’extension de retours ou de stock réellement utilisée. Notez la quantité immédiatement après le remboursement, puis après le prochain cycle de synchronisation. Si le compteur change au deuxième relevé, comparez les journaux de l’intégration à l’heure relevée. Si aucun mouvement n’apparaît dès le premier relevé, revérifiez la quantité remboursée, la case et la sortie d’origine avant de chercher un conflit. Gardez les deux relevés et le numéro de commande pour reproduire l’écart sans toucher une seconde fois à la commande réelle.

Lire le compteur géré par WooCommerce sans refaire le remboursement

Le contrôle de l’interface reste gratuit dans WooCommerce. Pour lever une ambiguïté entre parent et variation, un mainteneur peut aussi enregistrer cette sonde PHP hors de la racine web et l’exécuter avec wp eval-file sur la copie, en passant l’ID de la variation comme unique argument. Gardez WooCommerce chargé ; le code ne modifie ni stock ni commande.

Comparez l’ID compteur à l’ID du parent et à celui de la variation. Une quantité nulle avec gestion inactive ne signifie pas nécessairement zéro article : il peut s’agir d’une disponibilité sans compteur. La sonde lit l’état actuel, sans reconstituer les mouvements depuis la commande. Rapprochez donc le résultat des notes et du stock physique avant toute correction. Retirez le fichier de diagnostic après l’essai ; aucun retour financier ni annulation de remboursement n’est nécessaire pour cette lecture.

<?php
if (!function_exists('wc_get_product')) {
    WP_CLI::error('WooCommerce doit etre charge.');
}
$id = filter_var($args[0] ?? null, FILTER_VALIDATE_INT, ['options' => ['min_range' => 1]]);
if (count($args) !== 1 || $id === false) {
    WP_CLI::error('Indiquez un ID positif de variation.');
}
$variation = wc_get_product($id);
if (!$variation || !$variation->is_type('variation')) {
    WP_CLI::error('Variation introuvable.');
}
$compteur = wc_get_product($variation->get_stock_managed_by_id());
if (!$compteur) {
    WP_CLI::error('Produit portant le compteur introuvable.');
}
WP_CLI::log(wp_json_encode([
    'variation' => $id,
    'compteur' => $compteur->get_id(),
    'gestion_active' => $compteur->managing_stock(),
    'quantite' => $compteur->get_stock_quantity(),
]));

Sources et références

Ces références permettent de vérifier les fonctions, les prérequis et les limites décrits. Une documentation consultée ne constitue pas un essai pratique.

Consulter les 6 références

Ces guides peuvent aussi vous aider