Plugin B2Brouter pour WooCommerce

Guide pas à pas pour générer et envoyer automatiquement des factures électroniques à chaque commande WooCommerce.

B2Brouter pour WooCommerce est un plugin qui génère et envoie automatiquement les factures électroniques de votre boutique WooCommerce via B2Brouter. Chaque commande reçoit sa facture, au format exigé par chaque pays, sans que vous ayez à intervenir.

Conformité automatique. Les factures respectent la réglementation de facturation électronique de chaque pays.
Aucune tâche manuelle. Les factures sont générées automatiquement pour chaque commande, ou au moment que vous choisissez.
Formats standard. Factures structurées en UBL, en CII et dans d'autres formats.
Ventes internationales. Fonctionne pour les ventes B2B et B2C, y compris hors de votre pays.
Intégré à WooCommerce. Il ne change rien à la façon dont vous gérez votre boutique.

B2Brouter pour WooCommerce WordPress Plugin gratuit dans le dépôt officiel de WordPress.

Prérequis

Avant d'installer le plugin B2Brouter, assurez-vous de disposer de :

WordPress 5.8 ou supérieur
WooCommerce 5.0 ou supérieur, installé et activé
PHP 7.4 ou supérieur
Un compte B2Brouter avec un abonnement eDocExchange actif

Si WooCommerce n'est pas encore installé, allez dans Plugins → Add New, recherchez « WooCommerce », installez-le et activez-le avant de continuer.

Installation

Depuis le dépôt officiel de WordPress Option recommandée

Dans l'administration de WordPress, allez dans Plugins → Add New.
Recherchez « B2Brouter for WooCommerce ».
Cliquez sur Install Now, puis sur Activate.

Téléchargement manuel Alternatives

Si vous préférez l'installer manuellement, vous pouvez télécharger le fichier ZIP depuis :

Une fois le ZIP obtenu, allez dans Plugins → Add New → Upload Plugin, sélectionnez le fichier, puis cliquez sur Install Now et Activate.

Après l'activation, la page d'accueil du plugin s'affiche avec les instructions initiales. Dans le menu latéral, vous verrez la nouvelle section Invoices.

Tester le plugin dans un environnement de staging

Avant de connecter le plugin à votre boutique réelle, testez-le sur une copie de votre site WordPress (un site de staging WordPress) connectée à la sandbox de B2Brouter. Vous pourrez ainsi vérifier la numérotation, les taxes et les PDF sans générer de factures réelles. L'étape 1 explique comment créer cette copie.

Pourquoi tester d'abord

Avant de connecter le plugin à votre boutique de production, il est utile de vérifier dans un environnement de test :

Que la numérotation des factures s'applique correctement et n'entre pas en conflit avec un autre outil.
Que les taxes (y compris l'auto-liquidation intracommunautaire) sont calculées comme prévu.
Que le champ numéro de TVA est bien collecté lors du paiement et reporté sur la facture.
Que les PDF sont générés et peuvent être téléchargés depuis « Mon compte ».
Que les e-mails envoyés au client fonctionnent avec le bon texte et les bonnes pièces jointes.

Tout cela peut être validé de bout en bout dans la sandbox sans consommer de quota, sans rien envoyer via Peppol et sans générer d'écritures comptables réelles.

Étape 1 : créer un environnement de staging pour votre site WordPress

Vous avez deux options :

Option A : staging de l'hébergeur (recommandé si disponible)

La plupart des hébergeurs WordPress infogérés proposent un système de staging en un clic depuis leur panneau de contrôle :

SiteGround — Site Tools → Dev → WordPress Staging
Kinsta — Sites → Create Staging Environment
WP Engine — Add Staging Environment
Cloudways — Application → Clone App / Create Staging
Hostinger — Hosting → Manage → Create staging

Consultez le panneau de votre hébergeur avant d'installer quoi que ce soit : c'est la manière la plus propre de disposer d'un environnement de staging.

Option B : plugin WP STAGING

Si votre hébergeur ne propose pas de staging ou si vous n'y avez pas accès, le plugin gratuit WP STAGING (wordpress.org/plugins/wp-staging) crée en un seul clic un clone de votre boutique dans un sous-répertoire (par exemple, yourstore.com/staging). Le clone dispose de son propre identifiant de connexion et de sa propre base de données, et ne touche à aucune donnée de la boutique réelle.

💡 Ne mélangez jamais une sandbox B2Brouter avec une boutique de production : vérifiez toujours que l'URL où vous configurez le plugin se termine par /staging ou correspond à un domaine de test avant de saisir une clé.

Étape 2 : obtenir une clé API de sandbox

Connectez-vous à B2Brouter avec votre compte habituel.
Allez dans Developers → Sandboxes et ouvrez (ou créez) une sandbox.
Dans la sandbox, allez dans API Keys et générez une nouvelle clé. Elle commencera par le préfixe test_.
Copiez la clé : vous en aurez besoin à l'étape suivante.

Pour en savoir plus sur ce que la sandbox inclut ou non, consultez la documentation technique de la sandbox.

Étape 3 : configurer le plugin sur le staging

Sur votre staging WordPress (et non en production) :

Installez et activez le plugin B2Brouter comme décrit dans les sections « Prérequis » et « Installation ».
Dans les réglages du plugin, saisissez la clé test_… que vous avez générée.
Configurez les autres paramètres (modèle de numérotation, taxes, PDF, etc.) comme vous le feriez en production ; reportez-vous à la section « Configuration initiale » pour plus de détails.

Étape 4 : configurer les webhooks de la sandbox

🚧 Les webhooks dans l'environnement sandbox seront bientôt disponibles.

Étape 5 : liste de contrôle avant la mise en production

Passez une commande de test sur le staging et vérifiez que :

Une facture est générée dans la sandbox de B2Brouter lorsque la commande est terminée.
Le numéro de facture suit le modèle que vous avez configuré.
Les taxes sont correctes, y compris l'auto-liquidation si vous réalisez des ventes B2B intracommunautaires.
Si le client saisit un numéro de TVA, celui-ci figure sur la facture.
Le PDF se télécharge correctement depuis « Mon compte » (il portera la mention « Not valid », ce qui est normal dans la sandbox).
Les e-mails sont envoyés avec les bonnes pièces jointes.

Étape 6 : passer en production

Lorsque tout fonctionne sur le staging :

Sur votre WordPress de production, installez le plugin (si ce n'est pas déjà fait) et configurez-le à partir de zéro avec la clé prod_… de votre compte réel.
Configurez les webhooks dans votre compte de production B2Brouter, en les faisant pointer vers l'URL du WordPress de production.
Ne migrez pas les données du staging vers la production : les factures de test (celles marquées « Not valid ») doivent rester uniquement dans la sandbox.
Passez une petite commande réelle de test pour confirmer que l'ensemble du flux fonctionne également en production.

Configuration initiale

Étape 1 : obtenir les identifiants B2Brouter

Inscrivez-vous sur app.b2brouter.net.
Souscrivez un abonnement eDocExchange.
Allez dans Developers → API Keys dans le tableau de bord de B2Brouter.
Copiez la clé API et conservez-la en lieu sûr.

Étape 2 : configurer le plugin

Accédez aux réglages :
- Dans WordPress, allez dans Invoices → Settings.
Saisissez la clé API :
- Collez votre clé API B2Brouter.
- Cliquez sur Validate Key.
- Si la clé API est correcte, le plugin affiche les informations de votre compte.
Configurez le mode de génération :
- Automatique : le plugin génère automatiquement la facture lorsqu'une commande passe au statut Completed. C'est l'option recommandée si vous voulez garantir que toutes les commandes disposent d'une facture associée.
- Manuel : le plugin ne génère pas la facture automatiquement. La facture peut être générée manuellement depuis la page de détail de chaque commande et, une fois la commande au statut Completed, le client peut également la générer depuis la page de son compte. C'est l'option recommandée si vous préférez que le client décide du moment où la facture est générée.

Étape 3 : configurer la numérotation des factures

Codes de série :
- Code de série des factures : préfixe des factures ordinaires (par exemple, « INV », « FAC »)
- Code de série des avoirs : préfixe des avoirs (par exemple, « CN », « NC »)
Modèle de numérotation : quatre options permettent de définir la numérotation des factures.

a) Automatique Recommandé
- B2Brouter génère automatiquement des numéros séquentiels.
- Aucun compteur à gérer.
b) Numéro de commande WooCommerce :
- Utilise le numéro de commande natif de WooCommerce.
- Exemple : si la commande est la n° 1234, la facture sera INV-1234.
c) Séquentiel :
- Le plugin tient un compteur indépendant.
- Génère des numéros tels que INV-00001, INV-00002, INV-00003.
d) Modèle personnalisé :
- Définissez votre propre format à l'aide des variables suivantes :
  - {order_id} : identifiant de la commande
  - {order_number} : numéro de commande WooCommerce
  - {year} : année en cours (AAAA)
  - {month} : mois en cours (MM)
  - {day} : jour en cours (JJ)
Exemples de modèles personnalisés :
- INV-{year}-{order_id} → INV-2025-123
- {year}/{month}/{order_number} → 2025/12/1234
- INV{year}{month}{day}-{order_id} → INV20251211-123

Étape 4 : configurer les PDF

Cache automatique des PDF :
- Activez cette option pour télécharger et enregistrer les PDF sur le serveur, dans le dossier wp-content/uploads/b2brouter-Invoices/.
- Améliore le temps de réponse lors des téléchargements par les clients.
- Réduit les appels à l'API de B2Brouter.
Nettoyage automatique :
- Activez le nettoyage planifié pour supprimer les PDF qui dépassent le nombre de jours défini dans la période de conservation.
- Configurez la période de conservation (par défaut : 90 jours).
- Le nettoyage s'exécute quotidiennement via le cron de WordPress.
Joindre les PDF aux e-mails :
- Joindre à l'e-mail de commande terminée : inclut le PDF lors de l'envoi de l'e-mail de confirmation.
- Joindre à l'e-mail de facture client : inclut le PDF dans les e-mails de facture de WooCommerce.
- Joindre à l'e-mail de remboursement : inclut l'avoir dans les e-mails de remboursement.

Mode de génération des factures

Génération automatique

Si vous avez activé le mode Automatique :

Le client finalise un achat.
Traitez la commande et marquez-la comme Completed.
Le plugin :
- Génère automatiquement la facture dans B2Brouter.
- Enregistre les métadonnées de la facture (identifiant, numéro, date).
- Ajoute une note à la commande.
- Génère et enregistre le PDF (si cette option est activée).
- Envoie l'e-mail avec le PDF en pièce jointe (si cette option est configurée).

Génération manuelle : commande individuelle

Si vous avez activé le mode Manuel et devez générer une facture :

Allez dans WooCommerce → Orders.
Ouvrez la commande à facturer.
Repérez la meta box B2Brouter Invoice.
Cliquez sur le bouton Generate Invoice.
La meta box affiche le statut et les principales informations de la facture.
Vous pouvez télécharger le PDF directement depuis cet emplacement.

Génération manuelle : actions groupées

Pour traiter plusieurs commandes à la fois :

Allez dans WooCommerce → Orders.
Sélectionnez les commandes terminées à facturer.
Dans le menu déroulant des actions groupées, choisissez Generate B2Brouter Invoices.
Cliquez sur Apply.
Un message indique le résultat pour chaque commande :
- Factures générées avec succès
- Factures déjà existantes
- Erreurs lors de la génération

Génération des avoirs

Les avoirs sont générés à partir des remboursements WooCommerce :

Ouvrez la commande dans WooCommerce → Orders.
Dans la meta box « Item », cliquez sur Refund (la commande doit avoir une facture).
Saisissez le montant du remboursement, qui peut être total ou partiel.
Confirmez le remboursement.
L'avoir est généré automatiquement au format propre au pays (par exemple, les factures rectificatives espagnoles, facturas rectificativas).

Configuration fiscale

Le plugin lit la configuration fiscale de WooCommerce et la convertit automatiquement en catégories de taxe Peppol.

Catégories de taxe Peppol

S (taux normal) : appliquée lorsque des taxes existent.
E (exonéré de taxe) : produits imposables avec un taux de 0 %.
Z (biens à taux zéro) : produits avec une classe de taxe zéro explicite.
NS (non soumis à la taxe) : produits non imposables.
AE (auto-liquidation de la TVA) : détectée automatiquement pour les transactions B2B intra-UE.

Configuration fiscale dans WooCommerce

Activez le calcul des taxes :
- Allez dans WooCommerce → Settings → General.
- Dans la section Tax and coupon, activez « Enable tax rates and calculations ».
Configurez les taxes :
- Une fois les taxes activées, allez dans WooCommerce → Settings → Tax. Depuis cette section, vous pouvez configurer les différents taux de taxe :
- Configurez les taux normaux :
  - Cliquez sur l'onglet Standard Rates.
  - Ajoutez vos taux par pays :
    - Code pays
    - Pourcentage de taxe
    - Nom de la taxe (TVA, etc.)
    - Application ou non à la livraison
- Configurez le taux zéro :
  - Cliquez sur l'onglet Zero Rate.
  - Ajoutez vos taux par pays :
    - Code pays
    - Nom de la taxe (TVA, etc.)
    - Application ou non à la livraison
- Configurez le taux réduit :
  - Cliquez sur l'onglet Reduced Rate.
  - Ajoutez vos taux par pays :
    - Code pays
    - Pourcentage de taxe
    - Nom de la taxe (TVA, etc.)
    - Application ou non à la livraison

Auto-liquidation intra-UE

Le plugin détecte automatiquement les cas d'auto-liquidation :

Conditions :

Le client fournit un numéro de TVA valide.
Le pays du client est différent de celui du marchand.
Les deux pays sont des États membres de l'UE (27 États).

Ce que fait le plugin :

Marque la transaction comme soumise à l'auto-liquidation (catégorie AE).
Génère la facture sans appliquer de taxes au client.
Indique que le client doit déclarer les taxes dans son propre pays.

Collecte du numéro de TVA

Configuration du champ numéro de TVA

Le plugin ajoute automatiquement un champ numéro de TVA au processus de paiement de WooCommerce. Compatible avec :

Le paiement basé sur les blocs (WooCommerce 8.6+)
Le paiement classique basé sur les shortcodes

Fonctionnement

Lors du paiement :
- Le champ « NIF / VAT Number » apparaît dans la section des coordonnées.
- Il est facultatif par défaut.
- Le client peut saisir son numéro de TVA pour les factures B2B/B2C.
Stockage :
- Le numéro de TVA est enregistré sous _billing_tin dans la boîte des métadonnées de la commande.
- Il est également enregistré dans le profil du client pour être réutilisé.
Facturation :
- Si le client fournit un numéro de TVA, une facture ordinaire (IssuedInvoice) est générée.
- En l'absence de numéro de TVA, une facture simplifiée (IssuedSimplifiedInvoice) est générée.
- Pour les transactions intra-UE avec un numéro de TVA, l'auto-liquidation s'applique.

Validation du numéro de TVA

Actuellement, le plugin ne valide pas le format du numéro de TVA. Une validation peut être ajoutée au moyen de :

Des plugins de validation tiers
Une validation personnalisée à l'aide des hooks de WooCommerce
Une validation via l'API de B2Brouter

Configuration des webhooks

Pourquoi utiliser les webhooks ?

Mises à jour instantanées : le statut de la facture apparaît immédiatement dans l'administration de WordPress.
Moins de charge : réduit les appels à l'API.
Plus fiable : avec une vérification de fallback toutes les heures.

Configuration pas à pas

Étape 1 : récupérer l'URL depuis le panneau d'administration de WordPress

Allez dans Invoices → Settings.
Faites défiler jusqu'à « Webhook Configuration ».
Activez « Enable Webhooks ».
Copiez la Webhook URL depuis le champ en lecture seule.
- Elle ressemble à : https://yoursite.com/wp-json/b2brouter/v1/webhook
Enregistrez les réglages.

Étape 2 : créer l'endpoint dans le tableau de bord de B2Brouter

Connectez-vous à app.b2brouter.net.
Allez dans l'onglet Developers.
Cliquez sur Webhooks dans le menu principal.
Cliquez sur « Add webhook ».
Saisissez une description, par exemple « Boutique WooCommerce ».
Collez la Webhook URL copiée depuis WordPress.
Sélectionnez les événements à envoyer. Recommandé : sélectionnez-les tous.
Enregistrez l'endpoint et copiez la clé de signature du webhook généré.

Étape 3 : finaliser la configuration dans le panneau d'administration de WordPress

Revenez dans Invoices → Settings → Webhook Configuration.
Collez la clé de signature fournie par B2Brouter.
Laissez l'option « Enable Security Check » activée.
Cliquez sur « Save Settings ».

Vérification

Pour vérifier que les webhooks fonctionnent correctement :

Générez une facture de test.
Le statut devrait apparaître en moins d'une seconde.
En cas de problème :
- Vérifiez que la Webhook URL correspond exactement.
- Assurez-vous que la clé de signature a été collée correctement (sans espaces superflus).
- Vérifiez que votre site WordPress est accessible depuis Internet.

Sécurité des webhooks

Toutes les requêtes sont signées cryptographiquement avec HMAC-SHA256.
Les requêtes dont la signature est invalide sont rejetées.
Validation de l'horodatage avec une tolérance de 5 minutes pour empêcher les attaques par rejeu.
Le secret est stocké de manière sécurisée dans les options de WordPress.

Gestion des PDF

Stockage sur le serveur

Lorsque vous activez « Automatic PDF Cache » :

Emplacement : wp-content/uploads/b2brouter-Invoices/

Structure :

b2brouter-Invoices/
├── 2025/
│   ├── 01/
│   │   ├── invoice-123.pdf
│   │   └── credit-note-124.pdf
│   └── 02/
│       └── invoice-125.pdf

Nettoyage automatique

Le plugin comprend une tâche planifiée pour supprimer les anciens PDF :

Configuration :
- Cochez la case « Automatic cleanup ».
- Définissez la période de conservation (par défaut : 90 jours).
Fonctionnement :
- S'exécute quotidiennement via le cron de WordPress.
- Supprime les fichiers plus anciens que la période de conservation.
- Conserve la structure des dossiers.
- Consigne les nettoyages dans le journal de WordPress.
Désactivation du nettoyage :
- Si vous désactivez le nettoyage, les PDF sont conservés indéfiniment.
- Vous devrez gérer l'espace disque manuellement.

Téléchargement manuel des factures depuis l'administration de WordPress

Allez dans WooCommerce → Orders et sélectionnez la commande dont vous souhaitez télécharger la facture.
Dans la meta box « B2Brouter Invoice » de la commande, cliquez sur Download PDF.
Si le PDF est en cache, il se télécharge immédiatement.
Sinon, le plugin :
- Demande le PDF à B2Brouter.
- Le met en cache (si cette option est activée).
- Le télécharge dans votre navigateur.

Expérience client

Téléchargement des factures

Les clients peuvent accéder à leurs factures de plusieurs façons :

Depuis leur compte → Commandes :
- La liste des commandes s'affiche.
  - Si la facture a déjà été générée, le bouton Download Invoice apparaît dans la colonne Actions de la liste des commandes. Cliquez dessus pour télécharger la facture.
  - Si la facture n'a pas été générée, le bouton Generate Invoice apparaît dans la colonne Actions de la liste des commandes. Cliquez dessus pour générer la facture. Une fois celle-ci générée, le bouton devient Download Invoice. Cliquez dessus pour télécharger la facture.
Depuis leur compte → Commandes → Commande :
- Dans la liste des commandes, dans la colonne Actions d'une commande, cliquez sur View.
- La page de détail de la commande propose :
  - Le bouton Download Invoice.
  - Le bouton Download Credit Note (le cas échéant).
Depuis l'e-mail :
- Si vous avez activé « Attach to emails ».
- Le PDF est inclus en pièce jointe de l'e-mail de confirmation.
Factures générées par le client (mode Manuel) :
- En mode Manuel, les clients peuvent générer eux-mêmes leurs factures.
- Sur la page de détail de la commande, ils voient un bouton Generate Invoice.
- Après un clic, la page s'actualise et le PDF est disponible.

Sécurité

Le plugin met en œuvre plusieurs mesures de sécurité :

Vérification de la propriété : les clients ne peuvent accéder qu'à leurs propres factures.
Validation du statut : les factures ne peuvent être générées que pour les commandes terminées.
Protection CSRF : toutes les actions utilisent des nonces WordPress.
Validation du mode : la génération côté client ne fonctionne qu'en mode Manuel.

Bonnes pratiques

Environnement de test

Commencez par la sandbox et votre site de staging WordPress, comme expliqué dans « Tester le plugin dans un environnement de staging ».
Testez l'ensemble du flux de facturation avant de passer en production.
Générez des commandes de test avec différentes configurations (avec ou sans numéro de TVA, plusieurs pays, etc.).

Sauvegardes

Effectuez des sauvegardes régulières de votre base de données WordPress.
Incluez le répertoire wp-content/uploads/b2brouter-Invoices/ dans vos sauvegardes.
Testez périodiquement la restauration des sauvegardes.

Surveillance

Consultez régulièrement la page B2Brouter → Invoices pour vérifier le statut.
Configurez des notifications pour les erreurs de génération de factures.
Vérifiez périodiquement les journaux de WordPress.

Mises à jour

Maintenez le plugin à jour avec la dernière version.
Consultez le journal des modifications avant de mettre à jour.
Testez d'abord les mises à jour dans l'environnement de staging.

Performances

Activez « Auto-save PDFs » pour améliorer le temps de réponse.
Configurez le nettoyage automatique pour gérer l'espace disque.
Utilisez les webhooks pour des mises à jour de statut en temps réel.

Exigences légales

Conformité fiscale

Le plugin facilite la conformité fiscale, mais :

Responsabilité : le marchand est responsable de la conformité fiscale.
Configuration : assurez-vous que la configuration fiscale est correcte pour votre pays.
Conseil : consultez un conseiller fiscal pour connaître les exigences propres à votre pays.

Protection des données (RGPD)

Le plugin traite des données personnelles :

Base légale : nécessaire au respect d'obligations légales.
Données traitées : nom, adresse, numéro de TVA, informations de commande.
Stockage : les données sont enregistrées dans WordPress et envoyées à B2Brouter.
Conservation : configurez la période de conservation conformément à vos obligations légales.

Mettez à jour votre politique de confidentialité pour y inclure :

L'utilisation de B2Brouter pour la génération des factures.
Les données envoyées à B2Brouter.
La manière dont les clients peuvent exercer leurs droits.

Problèmes courants

Voici les problèmes les plus fréquents lors de la configuration et de l'utilisation du plugin, avec leur cause probable et la manière de les résoudre. Si votre cas ne figure pas dans la liste, ou si vous souhaitez plus de détails sur l'erreur, activez d'abord le mode débogage.

Ajoutez ces lignes à votre fichier wp-config.php :

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Les erreurs seront consignées dans wp-content/debug.log.
Recherchez les entrées contenant « B2Brouter » pour voir les erreurs du plugin.

1. Erreur de validation de la clé API

Symptômes : message « Error validating the API key ».

Solutions :

Vérifiez que la clé API est correcte.
Assurez-vous que votre abonnement eDocExchange est actif.
Vérifiez que votre serveur peut se connecter à B2Brouter (sans blocage par un pare-feu).

2. Les factures ne sont pas générées automatiquement

Symptômes : les commandes sont terminées, mais aucune facture n'est générée.

Solutions :

Vérifiez que le mode est réglé sur Automatique dans les réglages.
Vérifiez que le statut de la commande est Completed.
Consultez les notes de la commande pour repérer d'éventuelles erreurs.
Consultez les journaux de WordPress pour obtenir le détail des erreurs.

3. Les PDF ne sont pas joints aux e-mails

Symptômes : les e-mails sont envoyés, mais sans le PDF en pièce jointe.

Solutions :

Vérifiez que « Auto-save PDFs » est activé.
Vérifiez que « Attach to emails » est activé.
Assurez-vous que la facture a été générée avant l'envoi de l'e-mail.
Consultez les journaux du serveur SMTP pour repérer d'éventuelles erreurs d'envoi.

4. Les webhooks ne fonctionnent pas

Symptômes : le statut de la facture n'est pas mis à jour immédiatement.

Solutions :

Vérifiez que la Webhook URL correspond exactement.
Vérifiez que le Webhook Secret est correct.
Assurez-vous que votre site est accessible depuis Internet (les webhooks ne fonctionnent pas en localhost sans tunnel).
Consultez les journaux de WordPress pour voir si les requêtes arrivent.
Vérifiez qu'il n'y a pas d'erreurs SSL liées au certificat de votre site.

5. Erreur « Could not generate the PDF »

Symptômes : la facture est créée, mais le PDF ne peut pas être téléchargé.

Solutions :

Vérifiez que le répertoire wp-content/uploads/ dispose des droits d'écriture.
Consultez le statut de la facture dans B2Brouter (elle n'a peut-être pas encore été traitée).
Essayez de forcer la régénération du PDF (Maj + clic).
Vérifiez que l'API de B2Brouter est opérationnelle.

6. Les PDF portent le filigrane « Not valid » ou les webhooks n'arrivent pas

Symptômes : les factures générées se téléchargent avec un filigrane indiquant « Not valid » et/ou le statut de la commande dans WooCommerce n'est pas mis à jour après le traitement du paiement.

Cause la plus probable : vous utilisez une clé API de sandbox (commençant par test_) au lieu d'une clé de production (commençant par prod_), ou vos webhooks sont configurés dans la sandbox au lieu du compte réel.

Solutions :

Vérifiez le préfixe de la clé API dans les réglages du plugin :
- test_… → vous êtes dans la sandbox. Les documents n'ont aucune valeur légale et les webhooks de production n'arriveront pas.
- prod_… → vous êtes en production. C'est ce qu'il vous faut sur la boutique réelle.
Si vous avez confirmé que la clé est prod_… mais que les webhooks n'arrivent toujours pas, rendez-vous dans votre compte de production B2Brouter (et non dans la sandbox) et vérifiez la configuration des webhooks.
Si vous utilisez volontairement la clé test_… pour vos tests, assurez-vous de le faire dans un environnement de staging et non sur la boutique réelle. Consultez la section « Tester le plugin dans un environnement de staging ».

7. Catégories de taxe incorrectes

Symptômes : les catégories de taxe ne sont pas correctes sur les factures.

Solutions :

Vérifiez la configuration fiscale dans WooCommerce → Settings → Tax.
Assurez-vous que les classes de taxe sont correctement configurées.
Vérifiez que la bonne classe de taxe est attribuée aux produits.
Pour les produits non imposables, réglez « Tax status » sur « None ».

Obtenir de l'aide

Si aucune des solutions de la section « Problèmes courants » ne fonctionne, vous disposez de deux moyens d'obtenir de l'aide. Pour accélérer le traitement, joignez les entrées de debug.log liées à B2Brouter et indiquez vos versions du plugin, de WordPress et de WooCommerce.

Support B2Brouter : ouvrez un ticket de support depuis votre compte. Les clients eDocExchange bénéficient d'un support premium, avec une résolution prioritaire des tickets et une assistance sept jours sur sept.
GitHub Issues : github.com/B2Brouter/b2brouter-woocommerce/issues