Guide d'utilisation de B2Brouter pour WooCommerce

Sommaire

Introduction
Prérequis et installation
Tester le plugin dans un environnement de test
Configuration initiale
Génération de factures
Configuration des taxes
Collecte du NIF/TVA
Configuration des webhooks
Gestion des PDFs
Expérience client
Résolution de problèmes

Introduction

B2Brouter for WooCommerce est un plugin qui automatise la génération et l’envoi de factures électroniques depuis votre boutique WooCommerce en utilisant la plateforme B2Brouter.

Principaux avantages

Conformité légale : conformité automatique avec les réglementations de facturation électronique de plusieurs pays.
Gain de temps : génération automatique de factures électroniques sans intervention manuelle.
Professionnalisme : factures structurées dans des formats standard (UBL, CII, XML, etc.)
Transfrontalier : support pour les transactions B2B et B2C internationales.
Intégration totale : fonctionne parfaitement avec WooCommerce sans affecter le flux de travail.

Prérequis et installation

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 actif
PHP 7.4 ou supérieur
Un compte B2Brouter avec abonnement eDocExchange actif

Si vous n’avez pas encore WooCommerce installé, allez dans Plugins → Ajouter nouveau, recherchez « WooCommerce », installez-le et activez-le avant de continuer.

Installation du plugin B2Brouter

Option recommandée — depuis le dépôt officiel WordPress

Dans l’administration WordPress, allez dans Plugins → Ajouter nouveau.
Recherchez « B2Brouter for WooCommerce ».
Cliquez sur Installer maintenant puis sur Activer.

Alternatives — téléchargement manuel

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

Une fois le ZIP téléchargé, allez dans Plugins → Ajouter nouveau → Téléverser une extension, sélectionnez le fichier et cliquez sur Installer maintenant puis Activer.

Une fois activé, la page de bienvenue du plugin s’affichera avec les instructions initiales. Dans le menu latéral, vous verrez la nouvelle section Factures.

À partir de là, vous pouvez procéder à la configuration initiale.

Tester le plugin dans un environnement de test

⚠️ Important — n’utilisez pas le Sandbox sur votre boutique de production

Le Sandbox de B2BRouter génère des documents marqués comme « Non valide » et ses webhooks sont complètement indépendants de ceux de production. Si vous configurez le plugin avec une clé sandbox (test_…) sur votre vraie boutique WooCommerce :

Les commandes de vos vrais clients généreraient des factures sans valeur légale.

Les changements d’état (facture émise, enregistrée, etc.) n’arriveraient pas sur votre WooCommerce, car les webhooks de production et de sandbox ne communiquent pas entre eux.

Vous perdriez la traçabilité de la numérotation et du quota.

Le Sandbox est destiné exclusivement aux environnements de test. Avant de configurer le plugin sur votre compte réel, nous recommandons de le tester dans un environnement de staging.

Pourquoi il vaut la peine de tester d’abord

Avant de connecter le plugin à votre boutique de production, il vaut la peine 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’autoliquidation intracommunautaire) sont calculées comme prévu.
Que le champ NIF/TVA est collecté au checkout et propagé à la facture.
Que les webhooks mettent correctement à jour l’état de la commande dans WooCommerce.
Que les PDFs sont générés et peuvent être téléchargés depuis « Mon compte ».
Que les e-mails au client fonctionnent avec le texte et les pièces jointes corrects.

Tout cela peut être validé de bout en bout dans le sandbox sans consommer de quota, sans rien envoyer via PEPPOL et sans générer de mouvements comptables réels.

Étape 1 : Créez un environnement de staging pour votre WordPress

Vous avez deux options :

Option A — Staging de votre hébergeur (recommandé si disponible)

La plupart des hébergeurs WordPress gérés incluent 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 → Créer staging

Vérifiez le panneau de votre hébergeur avant d’installer quoi que ce soit — c’est la façon la plus propre d’avoir un staging.

Option B — Plugin WP STAGING

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

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

Étape 2 : Obtenez une clé API sandbox

Connectez-vous à B2BRouter avec votre compte habituel.
Allez dans Developers → Sandboxes et ouvrez (ou créez) un sandbox.
À l’intérieur du 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 plus de détails sur ce que le sandbox inclut et n’inclut pas, consultez la documentation technique du sandbox.

Étape 3 : Configurez le plugin sur le staging

Sur votre WordPress de staging (pas sur la production) :

Installez et activez le plugin B2BRouter comme indiqué dans la section « Prérequis et installation ».
Dans la configuration du plugin, saisissez la clé test_… que vous avez générée.
Configurez le reste des paramètres (modèle de numérotation, taxes, PDFs, etc.) comme vous le feriez en production — vous pouvez revenir à la section « Configuration initiale » pour les détails.

Étape 4 : Configurez les webhooks du sandbox

🚧 La prise en charge des webhooks dans l’environnement sandbox sera disponible prochainement.

Étape 5 : Liste de contrôle avant de passer en production

Passez une commande de test sur le staging et confirmez :

Une facture est générée dans le sandbox B2BRouter à la fin de la commande.
Le numéro de facture suit le modèle que vous avez configuré.
Les taxes sont correctes, y compris l’autoliquidation si vous faites des ventes B2B intracommunautaires.
Si le client saisit un numéro de TVA, il est enregistré dans la facture.
Le webhook atteint le staging et l’état de la commande est mis à jour dans WooCommerce.
Le PDF se télécharge correctement depuis « Mon compte » (il portera la marque « Non valide » — c’est normal en sandbox).
Les e-mails se déclenchent avec les pièces jointes correctes.

Étape 6 : Passage en production

Quand tout fonctionne sur le staging :

Sur votre WordPress de production, installez le plugin (si vous ne l’avez pas encore fait) et configurez-le depuis zéro avec la clé prod_… de votre compte réel.
Configurez les webhooks sur le compte de production de B2BRouter pointant vers l’URL du WP de production.
Ne migrez pas de données du staging vers la production — les factures de test (celles marquées « Non valide ») doivent rester uniquement dans le sandbox.
Passez une petite commande réelle de test pour confirmer que tout le 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 B2Brouter.
Copiez la clé API et conservez-la en lieu sûr.

💡 Vous configurez l’environnement de production. Si vous n’avez pas encore testé le plugin, nous vous recommandons de le faire d’abord dans un environnement de staging avec une clé sandbox. Consultez la section « Tester le plugin dans un environnement de test ».

Étape 2 : Configurer le plugin

Accédez à la configuration :
- Dans WordPress, allez dans Factures → Configuration
Saisissez la clé API :
- Collez votre clé API B2Brouter.
- Cliquez sur Valider la clé.
- Si la clé API est correcte, le plugin affichera les informations de votre compte.
Configurez le mode de génération :
- Automatique : le plugin génère la facture automatiquement lorsqu’une commande passe à l’état Terminée. C’est l’option recommandée si vous souhaitez garantir que toutes les commandes aient leur 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 fiche de chaque commande et, une fois la commande à l’état terminé, 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 ce soit l’utilisateur qui décide quand générer la facture.

Étape 3 : Configurer la numérotation des factures

Codes de série :
- Code de série des factures : préfixe pour les factures régulières (par exemple, « FAC », « INV »)
- Code de série des notes de crédit : préfixe pour les notes de crédit (par exemple, « NC », « CN »)
Modèle de numérotation (choisissez une option) :

a) Automatique (recommandé) :
- B2Brouter génère des numéros séquentiels automatiquement.
- Pas besoin de gérer des compteurs.
b) Numéro de commande WooCommerce :
- Utilise le numéro de commande natif de WooCommerce.
- Exemple : si la commande est #1234, la facture sera FAC-1234.
c) Séquentiel :
- Le plugin maintient un compteur indépendant.
- Génère des numéros tels que : FAC-00001, FAC-00002, FAC-00003.
d) Modèle personnalisé :
- Définissez votre propre format en utilisant des marqueurs :
- {order_id} : ID de la commande
- {order_number} : numéro de commande WooCommerce
- {year} : année en cours (YYYY)
- {month} : mois en cours (MM)
- {day} : jour en cours (DD)
Exemples de modèles personnalisés :
- FAC-{year}-{order_id} → FAC-2025-123
- {year}/{month}/{order_number} → 2025/12/1234
- INV{year}{month}{day}-{order_id} → INV20251211-123

Étape 4 : Configurer les PDFs

Cache automatique de PDF :
- Activez cette option pour télécharger et enregistrer les PDFs sur le serveur, dans le dossier wp-content/uploads/b2brouter-Factures/.
- Améliore le temps de réponse pour les téléchargements des clients.
- Réduit les appels à l’API B2Brouter.
Nettoyage automatique :
- Activez le nettoyage programmé pour supprimer les PDFs dépassant 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 PDFs 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 WooCommerce.
- Joindre à l’e-mail de remboursement : inclut la note de crédit dans les e-mails de remboursement.

Mode de génération de factures

Génération automatique

Si vous avez activé le Mode Automatique :

Le client finalise un achat.
Vous traitez la commande et la marquez comme Terminée.
Le plugin :
- Génère automatiquement la facture dans B2Brouter.
- Enregistre les métadonnées de la facture (ID, numéro, date).
- Ajoute une note à la commande.
- Génère et enregistre le PDF (si activé).
- Envoie l’e-mail avec le PDF joint (si configuré).

Génération manuelle - Commande individuelle

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

Allez dans WooCommerce → Commandes.
Ouvrez la commande que vous souhaitez facturer.
Localisez le meta box B2Brouter Invoice.
Cliquez sur le bouton Générer la facture.
L’état et les détails principaux de la facture s’affichent dans le metabox.
Vous pouvez télécharger le PDF directement depuis ici.

Génération manuelle - Actions en masse

Pour traiter plusieurs commandes à la fois :

Allez dans WooCommerce → Commandes.
Sélectionnez les commandes terminées que vous souhaitez facturer.
Dans le menu déroulant des actions en masse, choisissez Générer les factures B2Brouter.
Cliquez sur Appliquer.
Un message s’affichera avec le résultat pour chaque commande :
- Factures générées correctement
- Factures qui existaient déjà
- Erreurs lors de la génération

Génération de notes de crédit

Les notes de crédit sont générées pour les remboursements WooCommerce :

Ouvrez la commande dans WooCommerce → Commandes.
Dans le meta box « Article », cliquez sur Rembourser (la commande doit avoir une facture).
Saisissez le montant du remboursement, qui peut être total ou partiel.
Confirmez le remboursement.
La note de crédit est générée automatiquement dans le format spécifique au pays (par exemple, les factures rectificatives espagnoles).

Configuration des taxes

Le plugin lit la configuration des taxes de WooCommerce et la convertit automatiquement en catégories fiscales PEPPOL.

Catégories fiscales PEPPOL

S (Standard rate) : taux standard - appliqué lorsque des taxes existent.
E (Exempt from tax) : exempté de taxe - produits taxables avec un taux de 0 %.
Z (Zero-rated goods) : biens à taux zéro - produits avec une classe fiscale à taux zéro explicite.
NS (Not subject to tax) : non soumis à taxe - produits non taxables.
AE (VAT Reverse Charge) : autoliquidation - détecté automatiquement pour les transactions intra-UE B2B.

Configuration des taxes dans WooCommerce

Activer le calcul des taxes :
- Allez dans WooCommerce → Options → Général.
- Dans la section Taxes et coupons, activez « Activer les types et les calculs d’imposition ».
Configurer les taxes :
- Une fois les taxes activées, allez dans WooCommerce → Options → Taxes. Depuis cette section, vous pouvez configurer les différents taux de taxes :
- Configurer les taux standards :
  - Cliquez sur l’onglet Taux standards.
  - Ajoutez vos taxes par pays :
    - Code du pays
    - Pourcentage de taxe
    - Nom de la taxe (TVA, VAT, etc.)
    - Si elle s’applique à l’expédition
- Configurer les taux à taux zéro :
  - Cliquez sur l’onglet Taux à taux zéro.
  - Ajoutez vos taxes par pays :
    - Code du pays
    - Nom de la taxe (TVA, VAT, etc.)
    - Si elle s’applique à l’expédition
- Configurer les taux réduits :
  - Cliquez sur l’onglet Taux réduits.
  - Ajoutez vos taxes par pays :
    - Code du pays
    - Pourcentage de taxe
    - Nom de la taxe (TVA, VAT, etc.)
    - Si elle s’applique à l’expédition

Autoliquidation intra-UE

Le plugin détecte automatiquement quand l’autoliquidation s’applique :

Conditions :

Le client fournit un NIF valide.
Le pays du client est différent du pays du commerçant.
Les deux pays sont membres de l’UE (27 États).

Ce que fait le plugin :

Marque la transaction comme autoliquidation (catégorie AE).
Génère la facture sans taxes appliquées au client.
Indique que le client doit déclarer les taxes dans son pays.

Collecte du NIF/TVA

Configuration du champ NIF

Le plugin ajoute automatiquement un champ NIF au checkout WooCommerce. Compatible avec :

Checkout par blocs (WooCommerce 8.6+)
Checkout classique basé sur shortcodes

Fonctionnement

Au checkout :
- Le champ « NIF / Numéro de TVA » apparaît dans la section des informations de contact.
- Il est optionnel par défaut.
- Le client peut saisir son NIF pour les factures B2B/B2C.
Stockage :
- Le NIF est enregistré comme _billing_tin dans la boîte de métadonnées de la commande.
- Il est également enregistré dans le profil du client pour réutilisation.
Facturation :
- Si le client fournit un NIF, une facture standard est générée (IssuedInvoice).
- S’il n’y a pas de NIF, une facture simplifiée est générée (IssuedSimplifiedInvoice).
- Pour les transactions intra-UE avec NIF, l’autoliquidation s’applique.

Validation du NIF

Actuellement, le plugin ne valide pas le format du NIF. La validation peut être ajoutée via :

Plugins de validation tiers.
Validation personnalisée avec des hooks WooCommerce.
Validation via l’API B2Brouter.

Configuration des webhooks

Les webhooks de production et de sandbox sont complètement indépendants : chacun a sa propre configuration et les événements ne communiquent pas entre les environnements. Si vous testez le plugin en staging avec une clé sandbox, configurez les webhooks dans le sandbox en pointant vers l’URL du staging. Quand vous passerez en production, vous devrez les reconfigurer sur le compte de production.

Les webhooks permettent des mises à jour d’état des factures en temps réel (< 1 seconde) au lieu d’attendre la vérification horaire.

Pourquoi utiliser les webhooks ?

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

Configuration étape par étape

Étape 1 : Obtenir l’URL dans le panneau d’administration WordPress

Allez dans Factures → Settings.
Faites défiler jusqu’à « Configuration des webhooks ».
Activez « Activer les webhooks ».
Copiez l’URL du webhook depuis le champ en lecture seule.
- Elle ressemble à : https://votresite.com/wp-json/b2brouter/v1/webhook
Enregistrez la configuration.

Étape 2 : Créer l’endpoint dans le tableau de bord B2Brouter

Accédez à app.b2brouter.net.
Allez dans l’onglet Developers.
Cliquez sur Webhooks dans le menu principal.
Cliquez sur « Ajouter un webhook ».
Saisissez une description, par exemple « Boutique WooCommerce ».
Collez l’URL du webhook copiée depuis WordPress.
Sélectionnez les événements à envoyer. Recommandé : tout sélectionner.
Enregistrez l’endpoint et copiez la clé de signature du webhook généré.

Étape 3 : Finaliser la configuration dans le panneau d’administration WordPress

Retournez dans Factures → Configuration → Configuration des webhooks.
Collez la clé de signature de B2Brouter.
Laissez activée l’option « Activer la vérification de sécurité ».
Cliquez sur « Enregistrer la configuration ».

Vérification

Pour vérifier que les webhooks fonctionnent correctement :

Générez une facture de test.
L’état devrait apparaître en moins d’1 seconde.
En cas de problème :
- Vérifiez que l’URL du webhook correspond exactement.
- Assurez-vous que le Secret est bien collé (sans espaces supplémentaires).
- 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 avec des signatures invalides sont rejetées.
Validation du timestamp de 5 minutes pour prévenir les attaques par répétition.
Le secret est stocké de manière sécurisée dans les options WordPress.

Gestion des PDFs

Stockage sur le serveur

Lorsque vous activez « Cache automatique de PDF » :

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

Structure :

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

Nettoyage automatique

Le plugin inclut une tâche programmée pour nettoyer les anciens PDFs :

Configuration :
- Activez la case à cocher « Nettoyage automatique ».
- Définissez la période de conservation (par défaut : 90 jours).
Fonctionnement :
- S’exécute quotidiennement via le cron WordPress.
- Supprime les fichiers plus anciens que la période de conservation.
- Maintient la structure des dossiers.
- Enregistre les nettoyages dans le journal WordPress.
Désactivation du nettoyage :
- Si vous désactivez le nettoyage, les PDFs sont conservés indéfiniment.
- Vous devrez gérer l’espace disque manuellement.

Téléchargement manuel de factures depuis l’administration WordPress

Accédez à WooCommerce → Commandes et sélectionnez la commande dont vous souhaitez télécharger la facture.
Depuis le metabox « B2Brouter Invoice » de la commande, cliquez sur Télécharger le PDF.
Si le PDF est en cache, il est téléchargé immédiatement.
Sinon, le plugin :
- Demande le PDF à B2Brouter.
- Le met en cache (si activé).
- Le télécharge dans votre navigateur.

Expérience client

Téléchargement de factures

Les clients peuvent accéder à leurs factures de plusieurs manières :

Depuis leur compte → Commandes :

La liste des commandes s’affiche.
- Si la facture a déjà été générée, dans la colonne Actions de la liste des commandes, le bouton Télécharger la facture s’affichera. Cliquez dessus pour télécharger la facture.
- Si la facture n’a pas encore été générée, dans la colonne Actions de la liste des commandes, le bouton Générer la facture s’affichera. Cliquez dessus pour générer la facture. Une fois la facture générée, le bouton changera en Télécharger la facture. Cliquez dessus pour télécharger la facture.

Depuis leur compte → Commandes → Commande :

Depuis la liste des commandes, dans la colonne Actions d’une commande, cliquez sur Voir pour la commande.
Sur la page de détails de la commande, vous trouverez :
- Le bouton Télécharger la facture.
- Le bouton Télécharger la note de crédit (s’il y en a une).

Par e-mail :
- Si vous avez activé « Joindre aux e-mails ».
- Le PDF est inclus en pièce jointe dans l’e-mail de confirmation.
Génération par le client (mode manuel) :
- Si le mode est Manuel, les clients peuvent générer les factures eux-mêmes.
- Sur la page de détails de la commande, ils verront un bouton Générer la facture.
- Après avoir cliqué, la page se rafraîchit et le PDF est disponible.

Sécurité

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

Vérification de propriété : les clients ne peuvent accéder qu’à leurs propres factures.
Validation d’état : 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 par le client ne fonctionne qu’en mode Manuel.

Résolution de problèmes

Problèmes courants

1. Erreur de validation de la clé API

Symptômes : message « Erreur lors de la validation de la clé API »

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 (non bloqué 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 Automatique dans la configuration.
Vérifiez que l’état de la commande est Terminée.
Consultez les notes de la commande pour voir s’il y a des erreurs.
Vérifiez les journaux WordPress pour voir les erreurs détaillées.

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

Symptômes : les e-mails sont envoyés mais sans le PDF joint.

Solutions :

Vérifiez que « Auto-enregistrer les PDFs » est activé.
Vérifiez que « Joindre aux e-mails » 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 voir s’il y a des erreurs d’envoi.

4. Les webhooks ne fonctionnent pas

Symptômes : l’état des factures ne se met pas à jour immédiatement.

Solutions :

Vérifiez que l’URL du webhook correspond exactement.
Vérifiez que le Secret du webhook est correct.
Assurez-vous que votre site est accessible depuis Internet (les webhooks ne fonctionnent pas sur localhost sans tunneling).
Consultez les journaux WordPress pour voir si des requêtes arrivent.
Vérifiez qu’il n’y a pas d’erreurs SSL dans le certificat de votre site.

5. Erreur « Impossible de générer le 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/ a les autorisations d’écriture.
Vérifiez l’état de la facture dans B2Brouter (elle n’est peut-être pas encore traitée).
Essayez de régénérer le PDF de force (Shift + clic).
Vérifiez que l’API B2Brouter est opérationnelle.

6. Les PDFs portent la mention « Non valide » ou les webhooks n’arrivent pas

Symptôme : les factures générées se téléchargent avec un filigrane indiquant « Non valide », et/ou l’état des commandes dans WooCommerce ne se met pas à jour après le traitement du paiement.

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

Solution :

Vérifiez le préfixe de la clé API dans la configuration du plugin :
- test_… → vous êtes en 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 que vous voulez sur la vraie boutique.
Si vous avez confirmé que la clé est prod_… mais que les webhooks n’arrivent pas, allez dans le compte de production de B2BRouter (pas dans le sandbox) et vérifiez la configuration des webhooks.
Si vous utilisez intentionnellement la clé test_… pour tester, assurez-vous de le faire dans un environnement de staging et non sur la vraie boutique. Consultez la section « Tester le plugin dans un environnement de test ».

7. Erreurs de taxes incorrectes

Symptômes : les catégories fiscales ne sont pas correctes dans les factures.

Solutions :

Vérifiez la configuration des taxes dans WooCommerce → Configuration → Taxes.
Assurez-vous que les classes fiscales sont configurées correctement.
Vérifiez que les produits ont la bonne classe fiscale assignée.
Pour les produits non taxables, définissez « État de la taxe » à « Aucun ».

Activer le mode de débogage

Pour obtenir plus d’informations sur les erreurs :

Ajoutez ces lignes à votre wp-config.php :

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

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

Obtenir de l’aide

Si vous ne pouvez pas résoudre le problème :

Support B2Brouter : les clients eDocExchange ont accès au support premium avec :
- Priorité dans la résolution des tickets.
- Assistance sept jours sur sept.
Problèmes sur GitHub : github.com/B2Brouter/b2brouter-woocommerce/issues

Meilleures Pratiques

Environnement de test

Commencez par le sandbox — c’est l’environnement recommandé pour la plupart des tests et le travail de développement initial. Utilisez l’environnement de staging complet uniquement pour les intégrations à grande échelle ou les tests exhaustifs de bout en bout.
Testez l’intégralité du flux de facturation avant de passer en production.
Générez des commandes de test avec différentes configurations (avec/sans numéro de TVA, différents pays, etc.).

Sauvegardes

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

Surveillance

Consultez régulièrement la page B2Brouter → Factures pour voir l’état.
Configurez des notifications pour les erreurs de génération de factures.
Vérifiez régulièrement les journaux WordPress.

Mises à jour

Maintenez le plugin à jour vers la dernière version.
Consultez le changelog avant de mettre à jour.
Testez les mises à jour dans l’environnement de staging en premier.

Performance

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

Exigences légales

Conformité fiscale

Le plugin aide à la conformité fiscale, mais :

Responsabilité : le commerçant est responsable de la conformité fiscale.
Configuration : assurez-vous que la configuration des taxes est correcte pour votre pays.
Conseil : consultez un conseiller fiscal pour les exigences spécifiques à votre pays.

Protection des données (RGPD)

Le plugin traite des données personnelles :

Base légale : nécessaire pour le respect des obligations légales.
Données traitées : nom, adresse, NIF, informations de commande.
Stockage : les données sont enregistrées dans WordPress et envoyées à B2Brouter.
Conservation : configurez la période de conservation selon vos exigences légales.

Mettez à jour votre politique de confidentialité pour inclure :

L’utilisation de B2Brouter pour la génération de factures.
Les données envoyées à B2Brouter.
Comment les clients peuvent exercer leurs droits.

Conclusion

Ce plugin offre une intégration complète entre WooCommerce et B2Brouter pour la gestion automatisée des factures électroniques. En suivant ce guide, vous pourrez configurer et utiliser toutes les fonctionnalités du plugin de manière efficace.

Pour toute question ou problème, n’hésitez pas à contacter le support B2Brouter ou à ouvrir un ticket dans le dépôt GitHub.

Profitez de la facturation électronique automatisée avec B2Brouter !