Remboursement WooCommerce avec l'IA : partiel, remise en stock, retours

Un client a gardé l'une des deux chemises et a renvoyé l'autre. Dans WooCommerce, cela veut dire ouvrir la commande, trouver la ligne, saisir la quantité, vérifier le montant, cocher la case de remise en stock et choisir entre les deux boutons de remboursement. Un remboursement WooCommerce avec l'IA tient en une phrase : vous indiquez quelle commande et ce qui est revenu, BEAR calcule le montant, vous montre exactement ce qu'il s'apprête à faire, et rien ne se passe tant que vous n'avez pas confirmé. La même connexion vous dit ensuite quels produits et quelles variations reviennent le plus souvent. Ce guide explique ce que l'assistant peut rembourser, comment le montant est calculé, quand le stock est réapprovisionné, quand l'argent bouge réellement, et ce qui ne peut pas être annulé.

Exemple : rembourser un article et le remettre en rayon

Rembourse la chemise en lin taille M de la commande 2318 et remets-la en stock. Enregistre simplement le remboursement, j'enverrai l'argent par virement bancaire.

1. L'assistant ouvre la commande. Il lit la fiche de la commande : chaque ligne avec sa quantité et son montant, ce qui a déjà été remboursé, et les totaux. C'est ainsi qu'il sait quelle ligne correspond à la chemise taille M.
2. Il demande le remboursement à BEAR sans le confirmer. BEAR calcule le montant : la part de la chemise dans ce que le client a réellement payé pour cette ligne, taxes comprises, de sorte qu'une chemise achetée avec une remise est remboursée à son prix remisé. Rien n'est écrit. La réponse est un aperçu qui nomme la commande et son total, le montant à rembourser, indique si le remboursement passe par la passerelle de paiement ou s'il est seulement enregistré dans la boutique, les articles qui reviennent avec leur quantité, ceux qui seront remis en stock et ceux qui ne gèrent pas de stock, ainsi que le fait que BEAR ne peut pas annuler un remboursement.
3. Il vous relit les chiffres. Les instructions de l'outil interdisent à l'assistant d'arrondir, d'estimer ou de deviner un montant que vous n'avez pas donné, et lui demandent d'obtenir un oui clair. Disons 29,75 taxes comprises : vous le comparez à ce que vous attendiez.
4. Vous confirmez, et WooCommerce effectue le remboursement. BEAR appelle la fonction de remboursement propre à WooCommerce avec la chemise comme ligne de remboursement, si bien que le remboursement apparaît sur la commande exactement comme s'il avait été fait à la main. Si la commande a retiré la chemise du stock lors du paiement, comme le fait une commande payée normale, WooCommerce la remet en stock et écrit une note de commande telle que « Le stock de l'article n° 412 a augmenté de 4 à 5 ».
5. Vous obtenez le résultat. Le montant remboursé à l'instant, le total remboursé sur la commande jusqu'ici, le statut de la commande, si l'argent est passé par la passerelle (ici : non, simple enregistrement), et les éventuels articles pour lesquels rien n'a été remis en stock parce qu'ils ne gèrent pas de stock.

Les chiffres sont donnés à titre d'illustration. Les étapes, non : lire la commande, aperçu, confirmation, remboursement, compte rendu.

Avant de commencer

Il vous faut le serveur MCP de BEAR activé dans les réglages de l'extension et un assistant IA connecté à celui-ci, par exemple Claude dans le navigateur, l'application de bureau ou Claude Code ; les étapes de connexion se trouvent dans la documentation du serveur MCP. Les remboursements fonctionnent sur toute commande WooCommerce et ne demandent aucune configuration supplémentaire. Le rapport sur les retours lit WooCommerce Analytics, qui doit donc être activé, avec son import historique terminé. Un gestionnaire de boutique connecté avec une clé personnelle a besoin, pour les deux, de la capacité WooCommerce edit_shop_orders.

Comment BEAR calcule le montant du remboursement

Ce que vous dites décide de deux choses : la somme remboursée, et les lignes de commande que le remboursement désigne. Les lignes comptent, car seules les lignes désignées peuvent être remises en stock et apparaître dans le rapport sur les retours.

L'assistant identifie les articles par leur ID de produit sur la fiche de la commande. Une variation peut être transmise par son propre ID ou par celui de son produit parent, ce qui est pratique jusqu'à ce qu'une commande contienne deux tailles de la même chemise : « la chemise » désigne alors la première ligne correspondante. Précisez la taille ou la couleur dès qu'une commande contient plus d'un article du même type.

Les remboursements précédents sont pris en compte. Les unités déjà remboursées sur une ligne ne peuvent pas l'être à nouveau, et le montant ne peut jamais dépasser ce qui reste sur la commande. BEAR refuse, en indiquant la raison, lorsque :

• la commande a déjà été remboursée en totalité ;
• le montant dépasse ce qui reste sur la commande (la réponse indique combien peut encore être remboursé) ;
• le montant est nul ou négatif ;
• un produit ne figure pas dans la commande, ou plus d'unités sont demandées qu'il n'en reste ;
• vous demandez une remise en stock en ne donnant qu'un montant, qui ne dit pas ce qui est revenu. L'assistant reçoit pour consigne de vous demander quels produits et combien d'unités ont été retournés.

Remettre en stock les articles remboursés

Les articles ne retournent en stock que si vous le demandez. Dites « remets-le en stock » ou « réapprovisionne » ; un remboursement sans ces mots laisse le stock tel quel, ce qui convient aux articles abîmés ou à ceux que le client a gardés. Lorsque vous le demandez, trois conditions décident si une unité retourne vraiment en stock :

1. Le remboursement désigne l'article. Un remboursement total désigne chaque ligne. Un remboursement partiel désigne ce que vous avez listé ; un montant seul ne désigne rien, et BEAR refuse donc de remettre en stock.
2. Le produit gère le stock. Cela signifie que Gérer le stock (Manage stock) est activé pour le produit, ou pour le parent d'une variation lorsque c'est le parent qui tient le décompte. L'aperçu nomme les articles qui ne gèrent pas de stock, et le résultat les liste de nouveau : rien n'est remis en stock pour eux.
3. Cette commande a réellement prélevé le stock. WooCommerce ne remet en stock que les unités que la commande en a retirées lors de sa création ou de son paiement. Une commande encore en En attente de paiement (Pending payment), ou une commande manuelle créée sans prélever de stock, n'a rien retiré et ne récupère rien. L'aperçu ne peut pas le voir : il annonce que le stock sera réapprovisionné pour tout article qui gère le stock. Après une remise en stock, regardez donc les notes de la commande. WooCommerce écrit une ligne « Le stock de l'article n° … a augmenté de … à … » pour chaque article réellement réapprovisionné ; pas de ligne, pas de changement.

La remise en stock n'a lieu que dans le cadre du remboursement. Si vous avez remboursé sans remettre en stock et que les articles arrivent plus tard, corrigez directement la quantité en stock, par la discussion ou dans le gestionnaire de stock en masse.

Rembourser via la passerelle de paiement, ou seulement l'enregistrer

« Remboursé » a deux sens différents pour un commerçant, et BEAR les distingue.

• Enregistré seulement (par défaut). Le remboursement est écrit sur la commande et compté dans les rapports de WooCommerce, mais aucun argent ne bouge. Vous payez le client vous-même, par virement bancaire, en espèces ou par un remboursement depuis le tableau de bord de votre prestataire de paiement. C'est la même chose que le bouton de remboursement manuel de WooCommerce.
• Via la passerelle. Seulement quand vous le dites clairement (« rembourse via la passerelle », « renvoie l'argent sur la carte du client »), l'assistant demande à WooCommerce de rembourser par la passerelle de paiement de la commande, comme le bouton de remboursement par passerelle de l'écran de la commande. La passerelle doit prendre en charge les remboursements automatiques. Si ce n'est pas le cas, ou si elle rejette le remboursement, WooCommerce supprime le remboursement qu'il venait de créer et l'assistant vous transmet l'erreur : rien n'est enregistré et aucun stock ne bouge.

Dans les deux cas, WooCommerce envoie au client son e-mail de commande remboursée (totale ou partielle) si cet e-mail est activé dans WooCommerce → Réglages → E-mails (WooCommerce → Settings → Emails). Lorsque le remboursement couvre tout ce qui reste sur la commande, WooCommerce passe la commande à Remboursée (Refunded) ; après un remboursement partiel, le statut reste inchangé. Pour les produits téléchargeables, WooCommerce retire les droits de téléchargement des articles remboursés. La réponse finale indique toujours si de l'argent a bougé, et l'assistant a pour consigne de vous dire lequel des deux cas s'est produit.

Remboursements partiels et livraison

Une commande peut être remboursée en plusieurs fois, par articles, par montant ou les deux, jusqu'à ce qu'il ne reste plus rien. Chaque remboursement est vérifié par rapport à ce qui reste.

La livraison est la seule chose que vous ne pouvez pas désigner comme une ligne. Les lignes de remboursement de BEAR sont des lignes de produits, donc les frais de livraison ne reviennent qu'à l'intérieur d'un montant : pour « rembourse la chemise et les 4,95 de livraison », l'assistant peut d'abord afficher l'aperçu de la chemise seule pour obtenir sa valeur, puis transmettre la chemise comme article et cette valeur plus 4,95 comme montant. Le deuxième aperçu affiche le total avant que vous ne confirmiez. Un remboursement total inclut automatiquement la livraison. Les taxes suivent la même logique : rembourser des articles inclut leurs taxes, tandis qu'un montant que vous donnez est remboursé exactement tel quel, sans rien y ajouter.

Les montants sont dans la devise propre à la commande. Dans une boutique qui vend en plusieurs devises, une commande payée en livres est remboursée en livres, et l'aperçu affiche la devise à côté de chaque chiffre.

Le rapport sur les retours : quelle variation revient le plus

Demandez « qu'est-ce qui a été remboursé le mois dernier ? » ou « qu'est-ce qui revient le plus ? » et l'assistant utilise le rapport de remboursements de BEAR. Pour une période, il liste par produit et par variation :

• les unités revenues et l'argent rendu, hors taxes et livraison (sur une boutique multidevise qui utilise FOX – WooCommerce Currency Switcher, converti dans votre devise principale ; chaque réponse précise comment ses montants ont été comptés) ;
• le nombre de remboursements distincts que cela représente ;
• les unités vendues sur la même période, et le taux de retour : unités revenues rapportées aux unités vendues.

La période est comptée à la date du remboursement : « les remboursements d'août » désigne donc les remboursements émis en août, quelle que soit la date de la commande. Sans période, le rapport couvre les 30 derniers jours. La liste peut être triée par unités, par montant ou par taux, affiche 50 lignes par défaut et jusqu'à 200, et peut être restreinte à un groupe de produits : « le taux de retour des vestes » amène l'assistant à trouver d'abord les vestes et à ne rendre compte que d'elles.

Lisez le taux en gardant ses limites à l'esprit. Il est vide lorsque rien de ce produit ne s'est vendu sur la période, et approximatif pour les produits qui se vendent peu ou pour les remboursements qui arrivent longtemps après la vente. Les commandes remboursées en totalité comptent toujours comme vendues : quatre vendues et deux retournées donnent donc 50 %, et non deux sur deux. Les remboursements faits sous forme de simple montant ne figurent pas du tout dans ce rapport, car ils ne désignent aucun produit.

Les variations sont rapportées séparément, et c'est voulu. Un taux de 8 % au niveau du produit cache la couleur qui revient six fois sur dix, et cette couleur indique généralement une photo ou un guide des tailles à corriger, pas un mauvais produit.

Questions toutes prêtes sur les retours

Demandez à l'assistant ce qu'il sait faire : parmi les questions préparées de BEAR, deux portent sur ce sujet, toutes deux en lecture seule :

• Ce qui revient (What comes back) : les remboursements des six derniers mois par produit et par variation, triés par taux de retour, 30 lignes.
• Ce qui s'est vendu et ce qui est revenu (What sold and what came back) : les 20 meilleures ventes en unités à côté des 20 produits les plus retournés et des 20 dont le taux de retour est le pire, sur six mois. Un produit en haut des deux listes est un best-seller qui pose problème.

Pour des totaux plutôt que des produits, demandez un récapitulatif des ventes (voir rapports de ventes WooCommerce avec l'IA) : il donne le nombre de remboursements et l'argent remboursé sur une période, taxes et livraison comprises, comptés au jour du remboursement, ainsi que le chiffre d'affaires net après remboursements.

Sécurité : confirmations et ce qui ne peut pas être annulé

• L'aperçu est dans le code, pas seulement dans les instructions. Une demande de remboursement sans confirmation ne rembourse rien et renvoie les chiffres. Le remboursement n'a lieu qu'à un second appel, confirmé.
• Les montants viennent de vous ou de la commande. L'assistant a pour consigne de ne jamais arrondir, estimer ou deviner un montant que vous n'avez pas donné, et de n'utiliser la passerelle que si vous l'avez dit clairement.
• Un remboursement est définitif en ce qui concerne BEAR. Il n'apparaît pas dans l'onglet Historique (History) de BEAR et il n'existe aucun retour en arrière. L'écran de commande de WooCommerce permet de supprimer l'enregistrement d'un remboursement, mais cela ne fait que supprimer l'enregistrement : les unités remises en stock y restent, l'argent envoyé par la passerelle reste envoyé, et un statut Remboursée (Refunded) le reste.
• Les remboursements ont leur propre permission. Pour chaque personne ayant une clé personnelle, les remboursements peuvent être fermés ou limités aux rapports avec le filtre woobe_mcp_permissions, séparément des commandes. Le code se trouve dans gérer les commandes WooCommerce avec l'IA.
• Ne remboursez pas par le statut. Passer une commande à Remboursée (Refunded) comme simple changement de statut enregistre un remboursement total sans aperçu, sans remise en stock et sans passerelle. Demandez toujours un remboursement.

Requêtes prêtes à l'emploi

• « Rembourse intégralement la commande 2318 et remets tout en stock. »
• « Rembourse une chemise en lin taille M de la commande 2318 et remets-la en stock. Enregistrement seulement. »
• « Le client de la commande 2405 a retourné 2 des 3 mugs. Rembourse-les via la passerelle de paiement et remets-les en stock. »
• « Rembourse la chemise de la commande 2318 plus les 4,95 de livraison, sans remise en stock, elle est arrivée abîmée. »
• « Rembourse 12,50 sur la commande 2318 en geste commercial. »
• « Combien peut encore être remboursé sur la commande 2318 ? »
• « Qu'avons-nous remboursé le mois dernier, par produit ? »
• « Quelles variations ont eu le taux de retour le plus élevé ces six derniers mois ? »
• « Montre-moi ce qui se vend le mieux à côté de ce qui est le plus retourné. »
• « Taux de retour des vestes depuis janvier, par couleur. »

Liste de contrôle

• Dites ce qui est revenu (produit, taille, quantité), pas seulement un montant, si quelque chose doit retourner en stock ou apparaître dans le rapport sur les retours.
• Dites « remets en stock » uniquement pour les articles revenus et revendables.
• Dites « via la passerelle » uniquement si l'argent doit bouger maintenant ; sinon, payez le client vous-même.
• Vérifiez l'aperçu : commande, montant, devise, articles, passerelle ou simple enregistrement, phrase sur le stock. Puis confirmez.
• Après une remise en stock, vérifiez dans les notes de la commande les lignes « stock augmenté ».
• La livraison ne revient qu'à l'intérieur d'un montant ; un remboursement total l'inclut.
• N'utilisez jamais le statut Remboursée (Refunded) comme raccourci.
• Pour le rapport sur les retours, assurez-vous que WooCommerce Analytics est activé et à jour.

Questions

Un remboursement WooCommerce fait avec l'IA renvoie-t-il l'argent au client ?

Seulement si vous demandez le remboursement via la passerelle de paiement et que celle-ci prend en charge les remboursements automatiques. Par défaut, le remboursement est enregistré dans WooCommerce et vous rendez l'argent vous-même. La réponse finale de l'assistant indique lequel des deux cas s'est produit.

Puis-je rembourser un seul article d'une commande ?

Oui. Nommez le produit et la quantité ; le remboursement correspond à la valeur de cet article telle que facturée, taxes comprises, et il peut retourner en stock. Ajoutez un montant si vous voulez rembourser une autre somme pour cet article.

Pourquoi le stock n'a-t-il pas augmenté après le remboursement ?

Soit la remise en stock n'a pas été demandée, soit le produit ne gère pas le stock, soit la commande n'a jamais prélevé le stock au départ (par exemple une commande encore en attente de paiement). Les notes de commande de WooCommerce montrent chaque article qu'il a remis en stock.

Pourquoi un remboursement manque-t-il dans le rapport sur les retours ?

Il a probablement été fait sous forme de simple montant, qui ne désigne aucun produit. Autres causes possibles : la date du remboursement est en dehors de la période demandée, ou WooCommerce Analytics ne l'a pas encore importé.

Si un remboursement ou un rapport se comporte différemment dans votre boutique, posez la question sur le forum d'assistance de BEAR.