Rapport de ventes WooCommerce avec l'IA : interrogez votre boutique

Un rapport de ventes WooCommerce avec l'IA commence par une question, pas par un sélecteur de dates : "comment s'est passé le mois dernier", "qu'est-ce qui se vend le mieux depuis le printemps", "qui sont mes meilleurs clients cette année", "quelqu'un paie-t-il encore par virement bancaire". Avec le serveur MCP de BEAR connecté, vous posez cette question à votre assistant IA et il répond avec les chiffres de votre propre boutique, sous forme de tableau ou de graphique dessiné directement dans la conversation. Vous trouverez ci-dessous ce que vous pouvez demander, quelles commandes les chiffres incluent, comment sont traités les remboursements, les taxes, la livraison et les autres devises, qui peut voir les noms des clients, et pourquoi un rapport revient parfois vide.

Avant de commencer

Il vous faut BEAR avec son serveur MCP activé dans les réglages de l'extension, et un assistant IA compatible MCP qui y est connecté : Claude dans le navigateur, dans l'application de bureau ou dans Claude Code, un assistant de programmation comme Cursor, ou un agent de votre conception. Les chiffres de ventes sont lus dans WooCommerce Analytics ; Analytics doit donc être activé et l'import des commandes passées terminé. La connexion elle-même prend quelques minutes et est décrite pas à pas dans la documentation du serveur MCP.

Une question, du début à la fin

Voici une première question typique :

Montrez-moi les ventes par mois depuis janvier, avec le nombre de commandes et la commande moyenne, sous forme de graphique en colonnes.

1. L'assistant transforme des mots en période. "Depuis janvier" devient une date de début au 1er janvier et une date de fin à aujourd'hui. Les dates sont lues dans le fuseau horaire de votre boutique, la même horloge que celle sur laquelle WooCommerce range ses commandes, et le jour de fin est inclus en entier.
2. Il demande à BEAR un récapitulatif mensuel. La requête va au rapport de synthèse des ventes (woobe_sales_summary) avec une ventilation mensuelle. BEAR lit les tables WooCommerce Analytics, que WooCommerce tient justement pour ce genre de question, et renvoie une ligne par mois avec les remboursements de ce mois à côté des ventes.
3. La réponse s'explique d'elle-même. Avec les lignes, BEAR envoie la période et les statuts de commande comptés, une ligne sur la devise (si les montants ont dû être convertis et comment), et une ligne sur l'actualité des données d'Analytics. Un bon assistant les reprend, pour que vous sachiez exactement ce que couvrent les chiffres.
4. L'assistant dessine le graphique. S'il sait afficher du HTML, les colonnes apparaissent dans la conversation ; sinon vous obtenez les mêmes chiffres sous forme de tableau.
5. Vous allez plus loin. "Quels produits ont porté mars ?" est une nouvelle question : l'assistant demande au rapport des ventes par produit les chiffres de mars et liste les meilleures ventes de ce mois.

Chaque ligne mensuelle de ce récapitulatif contient ces chiffres :

Le chiffre d'affaires à côté du nombre de commandes et de la commande moyenne est ce qui rend la vue mensuelle utile : un meilleur mois peut venir d'un plus grand nombre d'acheteurs ou de paniers plus gros, et les trois colonnes montrent lequel.

Ce que vous pouvez demander dans un rapport de ventes WooCommerce avec l'IA

BEAR propose cinq rapports de ventes. L'assistant choisit le bon d'après vos mots ; vous n'avez jamais besoin de le nommer.

Meilleures ventes sur toute la boutique ou pour un groupe de produits

Pour "qu'est-ce qui se vend le mieux", le rapport examine tout le catalogue et renvoie les meilleures ventes de la période, 50 par défaut et jusqu'à 200, chaque variation formant sa propre ligne. C'est important : une taille qui se vend quatre fois mieux que ses voisines disparaît dès que le produit parent l'absorbe.

Pour un groupe, par exemple "comment se sont vendues les vestes d'hiver", l'assistant commence par trouver ces produits avec un filtre BEAR, comme avant une modification en masse, puis demande leurs ventes. Un groupe peut compter jusqu'à 500 produits ; pour un groupe plus grand, restreignez le filtre ou demandez les meilleures ventes de toute la boutique. Demander "y compris ceux qui n'ont rien vendu" ajoute les produits du groupe sans vente, ce qui transforme le rapport en liste rapide de stock dormant.

Classer deux fois la même période, par unités et par chiffre d'affaires, vaut la peine. Quand votre meilleure vente en unités se trouve près du bas du classement en chiffre d'affaires, vous vendez du volume à bas prix.

Vues d'ensemble toutes prêtes

Demandez à votre assistant "que pouvez-vous me dire sur ma boutique" et il propose les questions préparées de BEAR. Trois d'entre elles concernent les ventes :

• Où en est la boutique couvre les trois derniers mois : le chiffre d'affaires par mois avec les commandes et la commande moyenne, plus les dix meilleures ventes en unités.
• Montrez-moi les chiffres couvre six mois : la série mensuelle et deux classements de la même période, les 15 premiers en unités et les 15 premiers en chiffre d'affaires, réunis pour être dessinés et alternés.
• Comment on paie et comment on est livré couvre six mois : la part des commandes par mode de livraison et par passerelle de paiement. Elle révèle souvent une option que personne n'a choisie depuis des mois, qui peut être retirée pour raccourcir le paiement.

Ces vues d'ensemble se terminent toujours aujourd'hui. Vous pouvez déplacer leur début ("pareil, mais depuis janvier") ; pour une période close comme "mars dernier uniquement", formulez-la avec vos propres mots et les deux dates, et l'assistant interroge directement les rapports.

Quelles commandes un rapport de ventes compte

Les chiffres suivent quelques règles fixes, identiques dans tous les rapports, de sorte que deux réponses sur le même mois ne se contredisent jamais.

• Statuts. Par défaut, une commande est comptée lorsqu'elle est Terminée (Completed), En cours (Processing) ou En attente (On hold). En attente de paiement (Pending payment), Échec (Failed), Annulée (Cancelled), Remboursée (Refunded) et les brouillons sont exclus. Vous pouvez nommer d'autres statuts : "ne comptez que les commandes terminées" vous donne les ventes achevées et expédiées.
• Dates. Une commande appartient au jour où elle a été passée. Sans période, les rapports portent sur les 30 derniers jours.
• Net et brut. Le net est le chiffre d'affaires sur les marchandises après remises par coupon, hors livraison et taxes, c'est-à-dire le chiffre que WooCommerce Analytics présente comme ventes nettes. Le brut est ce que les clients ont payé au total.
• Remboursements complets. Une commande remboursée en totalité passe au statut Remboursée (Refunded) et disparaît de tous les chiffres de ventes.
• Remboursements partiels. Dans le récapitulatif, ils apparaissent comme des chiffres distincts, comptés le jour où l'argent a été restitué : le nombre de remboursements, le montant remboursé (taxes et livraison comprises) et le net après remboursements. Les ventes par produit sont nettes des remboursements partiels, donc les unités retournées sont déduites. Le rapport des meilleurs clients montre ce que chaque client a payé, sans déduire les remboursements.
• Montants des paiements. Le rapport de paiement indique le total brut des commandes par passerelle, car c'est l'argent qui est passé par elle. Les commandes sans moyen de paiement, comme certaines commandes manuelles, apparaissent sous (aucun).
• Montants de livraison. Le rapport de livraison indique ce que les clients ont payé pour la livraison. Ce que votre transporteur vous a facturé n'est stocké nulle part dans WooCommerce, pas plus que les frais de passerelle, donc aucun rapport ne peut donner le bénéfice sur la livraison ou les frais de paiement. Les commandes sans ligne de livraison, comme les produits virtuels, ne figurent pas dans le rapport de livraison, dont le nombre de commandes peut donc être inférieur au total.

Graphiques de ventes dans le chat

Le graphique est dessiné par l'assistant à partir des chiffres que BEAR a renvoyés ; décrivez donc l'image souhaitée en même temps que la question. Claude dans le navigateur et l'application de bureau affichent les graphiques dans la conversation ; ChatGPT et les autres clients qui ne peuvent pas afficher de HTML donnent les mêmes chiffres sous forme de tableau, sans rien de moins que le dessin.

• "Les ventes par mois cette année en colonnes, avec la possibilité de passer à une courbe."
• "Les dix premiers produits en unités et en chiffre d'affaires, côte à côte."
• "Les moyens de paiement en parts, avec le pourcentage dans la légende."

Passer des colonnes à une courbe ou à des parts réutilise des chiffres que l'assistant possède déjà. Une autre période ou un autre groupe de produits est une nouvelle question et retourne interroger votre boutique pour obtenir des chiffres à jour. Les images des produits n'apparaissent pas dans ces graphiques : l'espace où l'assistant dessine ne peut pas charger de fichiers depuis votre site.

Boutiques multidevises : totaux dans votre devise de base

WooCommerce Analytics stocke chaque montant dans la devise dans laquelle la commande a été payée. Sur une boutique qui vend en euros et en dollars, une simple somme additionnerait les deux. Les rapports de BEAR reconvertissent donc chaque montant dans votre devise de base.

• Avec FOX – WooCommerce Currency Switcher, chaque commande est convertie au taux de change que FOX a enregistré sur elle au moment du paiement, de sorte qu'une commande de mars est valorisée aux taux de mars. Une commande sans taux enregistré est convertie au taux du jour.
• Avec une autre extension de devises, BEAR ne peut pas connaître le taux auquel chaque commande a été payée. Lorsque la période contient des commandes dans plusieurs devises, la réponse dit clairement que les totaux mélangent des devises et ne sont pas fiables, et l'assistant a pour consigne de vous prévenir avant de citer un total.
• Dans le rapport des meilleurs clients, une commande qui ne peut pas être convertie reste en dehors du total du client et est comptée à part, afin que l'écart soit visible.

Une boutique qui vend dans une seule devise n'a besoin de rien de tout cela, et la réponse le dit.

Noms des clients et qui peut voir ces rapports

Les rapports de totaux, de produits, de paiement et de livraison ne contiennent aucune donnée personnelle : ils sont construits à partir des tables d'analyse de WooCommerce, qui n'en contiennent pas. Le rapport des meilleurs clients fait exception, car un classement de clients exige des noms. Il renvoie le nom et la ville, le nombre de commandes, le total dépensé et la date de la dernière commande. Les adresses e-mail et les numéros de téléphone ne sont jamais renvoyés. Les commandes en invité sont regroupées par leur adresse e-mail de facturation, qui reste sur le serveur, et une commande sans aucun nom est listée comme commande non attribuée avec son numéro, plutôt que fondue dans un grand client anonyme. Tout ce qu'un rapport renvoie fait partie de votre conversation avec le service d'IA : ne demandez donc des listes de clients que lorsque vous en avez besoin.

Qui peut lancer les rapports dépend de la clé. La clé de toute la boutique, dans les réglages de BEAR, ouvre tout. Un gestionnaire de boutique muni d'une clé personnelle n'obtient les rapports que si son compte WordPress possède la capacité view_woocommerce_reports, que le rôle Gestionnaire de boutique possède par défaut. Pour fermer les rapports à une personne tout en conservant le reste de son accès, un développeur peut ajouter ce filtre :

/*
 * BEAR MCP: no sales, customer or margin reports for user 57.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter( 'woobe_mcp_permissions', function ( $map, $user_id ) {
    if ( 57 === (int) $user_id ) {
        $map['reports'] = 'none';
    }
    return $map;
}, 10, 2 );

La zone reports couvre les ventes, les meilleurs clients, la marge, les ventilations par paiement et par livraison, l'utilisation des coupons et le stock rapporté à la vitesse de vente. L'assistant de cette personne ne voit plus ces rapports, et les vues d'ensemble préparées qui s'appuient sur eux ne lui sont plus proposées. La liste des commandes est une zone distincte, orders. La marge par produit, qui exige votre coût d'achat, est expliquée dans le rapport de marge bénéficiaire avec l'IA.

Pourquoi un rapport de ventes revient vide

• Analytics n'est pas disponible. Sans les tables WooCommerce Analytics, BEAR répond que les chiffres de ventes ne sont pas disponibles tant qu'Analytics n'est pas activé et n'a pas importé les commandes passées.
• L'import n'est pas terminé. Si Analytics a été activé récemment, l'import des anciennes commandes peut être encore en cours. Consultez WooCommerce → Statut → Actions planifiées (WooCommerce → Status → Scheduled Actions), ou lancez l'import des données historiques dans Analytique → Réglages (Analytics → Settings).
• Les commandes les plus récentes ne sont pas encore importées. Sur les boutiques où Analytics importe les commandes selon un calendrier, réglage par défaut de WooCommerce sur les nouvelles boutiques, les commandes du jour arrivent à l'exécution suivante, toutes les 12 heures par défaut. BEAR ajoute à chaque rapport une ligne indiquant combien de commandes et de remboursements passés ou modifiés depuis le dernier import ne figurent pas encore dans les chiffres, et la liste des commandes les affiche.
• Les statuts ne correspondent pas. Les commandes en En attente de paiement (Pending payment) ne sont pas comptées. Si votre boutique laisse les commandes payées dans un statut personnalisé, nommez-le dans la question.
• La période est trop courte. Sans dates, un rapport couvre les 30 derniers jours.
• Rien à afficher dans un rapport. Une boutique de téléchargements n'a aucune ligne de livraison : le rapport de livraison est donc vide alors que le récapitulatif ne l'est pas.
• Le rapport vous est fermé. Si votre compte n'a pas la capacité requise, ou si la zone des rapports a été fermée pour vous, l'assistant apprend que l'outil n'est pas disponible plutôt que de recevoir des chiffres vides.

Requêtes prêtes à l'emploi pour les rapports de ventes WooCommerce

• "Comment vont les ventes ? Comparez les trois derniers mois."
• "Les ventes WooCommerce par mois pour cette année, avec les commandes, la commande moyenne et les remboursements."
• "Les ventes par semaine depuis le 1er septembre, commandes terminées uniquement."
• "Les 20 premiers produits en chiffre d'affaires le trimestre dernier, chaque variation séparément."
• "Classez les produits du mois dernier par unités et par chiffre d'affaires et montrez où l'ordre change."
• "Comment se sont vendus les produits de la catégorie Vestes depuis mars, y compris ceux qui n'ont rien vendu ?"
• "Qui sont mes dix meilleurs clients cette année, et qui n'a pas commandé depuis six mois ?"
• "Quels moyens de paiement les clients ont-ils utilisés ces six derniers mois, en parts ?"
• "Quels modes de livraison les gens choisissent-ils, et combien avons-nous perçu pour chacun ?"
• "Montrez-moi les chiffres des six derniers mois sous forme de graphiques."

Rien à annuler : les rapports ne font que lire

Chaque outil de rapport est marqué en lecture seule, et les vues d'ensemble préparées le sont par construction : la partie de BEAR qui les exécute refuse tout outil qui écrit. Demander des chiffres ne change rien dans votre boutique, rien n'apparaît donc dans l'Historique et il n'y a rien à annuler.

Les rapports mènent souvent à une action, comme "mettre en promotion les dix produits qui se vendent le moins". C'est une étape distincte, avec sa propre protection : l'assistant trouve les produits, montre un aperçu des nouvelles valeurs, et la modification n'est écrite qu'après que vous avez confirmé le nombre exact de produits. Chaque modification en masse est enregistrée dans l'Historique (History) et peut être annulée. Les rapports ne sont pas limités dans la version gratuite de BEAR ; ses limites s'appliquent à l'écriture des modifications, comme l'expliquent les limites de la version gratuite.

Questions

Sont-ce les mêmes chiffres que WooCommerce Analytics ?

Ils sont lus dans les mêmes tables d'Analytics, et le chiffre d'affaires net est ce qu'Analytics appelle les ventes nettes. Si un total diffère de l'écran d'Analytics, comparez les statuts de commande et les dates : BEAR compte les commandes Terminée (Completed), En cours (Processing) et En attente (On hold) sauf si vous en nommez d'autres, et lit les dates dans le fuseau horaire de la boutique.

Cela fonctionne-t-il sans WooCommerce Analytics ?

Seulement le rapport des meilleurs clients, qui lit les commandes elles-mêmes. Les totaux, les ventes par produit et les ventilations par paiement et par livraison exigent les tables d'Analytics.

Y a-t-il une limite à la période ?

Toute période convient tant qu'Analytics a importé ses commandes. Le classement des meilleurs clients est construit à partir des 2 000 commandes les plus récentes de la période au maximum ; sur une boutique très active, demandez donc un trimestre ou un mois plutôt que plusieurs années.

Puis-je obtenir les ventes d'une couleur ou d'une taille ?

Oui. Demandez-le avec vos mots, par exemple "comment se sont vendues les variations rouges des robes d'été". L'assistant sélectionne d'abord les variations correspondantes, puis établit le rapport, une ligne par variation.

Liste de contrôle

• Le serveur MCP est activé et votre assistant est connecté.
• WooCommerce Analytics est activé et l'import des commandes passées est terminé.
• La question indique une période ; sinon elle couvre les 30 derniers jours.
• Les statuts comptés sont ceux que vous voulez : par défaut Terminée (Completed), En cours (Processing) et En attente (On hold).
• Quand les remboursements ne sont pas nuls, lisez-les à côté du chiffre d'affaires brut.
• Sur une boutique multidevises, la ligne sur la devise indique que les montants ont été convertis.
• Les noms des clients ne sont demandés que lorsque c'est nécessaire, et la zone des rapports est fermée pour toute personne qui ne doit pas les voir.

Si un rapport ne correspond pas à ce que vous voyez dans votre boutique, décrivez la question et la réponse sur le forum de support de BEAR.