WordPress & WooCommerce
Guide d'installation
Guide technique complet pour l'installation et la configuration de SendPol pour WordPress et WooCommerce. Intégrez votre boutique au réseau Peppol en quelques étapes.
Regardez Comment Configurer SendPol pour WordPress/WooCommerce
Apprenez à installer et configurer le plugin SendPol pour WordPress/WooCommerce en quelques minutes seulement.
Table des matières
Qu'est-ce que SendPol?
SendPol pour WooCommerce est un plugin WordPress qui intègre automatiquement votre boutique WooCommerce au réseau Peppol. Il transforme votre traitement des commandes en convertissant automatiquement les commandes terminées en factures UBL (Universal Business Language) et en les envoyant via Peppol sans intervention manuelle.
Fonctionnalités principales
- Intégration complète de WooCommerce: Reconnaissance et conversion automatiques des commandes en factures
- Factures UBL (Universal Business Language): Compatible avec les administrations et les clients professionnels
- Envoi automatique via Peppol: Standardisé et juridiquement valide
- Prêt B2B: Parfait pour les entreprises vendant à d'autres entreprises ou entités gouvernementales
- Conformité UE: Prêt pour les exigences de facturation électronique Peppol (obligatoire à partir de 2026 dans de nombreux pays de l'UE)
Pourquoi choisir SendPol?
À partir de 2026, la facturation électronique Peppol deviendra obligatoire dans de plus en plus de pays européens, en particulier pour les entreprises et les contrats gouvernementaux. Avec SendPol, vous êtes prêt pour la conformité sans configurations complexes ni coûts de développement élevés.
Commencez en mode test
Par défaut, chaque nouvelle boutique est en mode test. Les documents sont validés et visibles dans votre tableau de bord SendPol, mais ne sont pas transmis au réseau Peppol. Vous pouvez ainsi tester votre flux de travail en toute sérénité avant qu'aucune facture ne parte en production.
Lorsque vous êtes prêt pour la production, désactivez le mode test dans les paramètres de votre boutique sous MonCompte.
Vers mes boutiquesInstallation
Prérequis
- WordPress 5.9 ou supérieur
- Plugin WooCommerce installé et activé
- PHP 7.4 ou supérieur
- Compte SendPol (inscrivez-vous sur www.sendpol.com)
Méthode 1: Installation via la boutique de plugins WordPress (Recommandé)
Le plugin SendPol est disponible dans la boutique officielle de plugins WordPress
Accédez à votre tableau de bord d'administration WordPress
Naviguez vers Extensions > Ajouter
Recherchez 'SendPol pour WooCommerce'
Cliquez sur 'Installer maintenant' sur le plugin SendPol
Cliquez sur 'Activer' après l'installation
Vous devriez voir 'SendPol' dans votre menu d'administration WordPress
Méthode 2: Installation manuelle
Alternative: Téléversez le fichier du plugin manuellement
Téléchargez le plugin SendPol pour WooCommerce
Accédez à votre tableau de bord d'administration WordPress
Naviguez vers Extensions > Ajouter > Téléverser une extension
Sélectionnez le fichier ZIP du plugin et cliquez sur 'Installer maintenant'
Cliquez sur 'Activer l'extension' après l'installation
Vous devriez voir 'SendPol' dans votre menu d'administration WordPress
Configuration initiale
Obtenir vos identifiants API
Inscrivez-vous sur SendPol
Visitez www.sendpol.com et créez un compte ou connectez-vous à votre compte existant.
Trouvez votre clé API dans le tableau de bord SendPol
API Base URL: https://api.sendpol.com
Pour trouver votre clé API:
- Accédez à www.sendpol.com et connectez-vous avec votre compte
- Sur le côté gauche du tableau de bord, sélectionnez "Webshops"
- Cliquez sur l'icône de clé (🔑) pour voir votre clé API
- Copiez cette clé et conservez-la en sécurité

Configuration initiale
Lors du premier accès au plugin, vous verrez un écran d'intégration

Cliquez sur "SendPol" dans votre menu d'administration WordPress
Entrez l'URL de base de l'API: https://api.sendpol.com
Entrez votre clé API SendPol
Cliquez sur "Activer SendPol" - le plugin testera automatiquement votre connexion
Configuration
Utiliser le plugin
Traitement automatique des factures
Une fois configuré, le plugin fonctionne automatiquement
Commande terminée
Lorsqu'une commande WooCommerce est marquée comme "Terminée" ou "En cours de traitement", le plugin génère automatiquement une facture UBL et l'envoie via Peppol au client.
Validation de commande
Le plugin valide les commandes avant l'envoi, vérifie les informations client requises, vérifie les numéros de TVA si fournis, et s'assure que toutes les données nécessaires sont présentes.
Suivi de statut
Surveillez le statut des factures dans le tableau de bord SendPol, consultez les confirmations de livraison et suivez les erreurs de traitement.
Actions manuelles
Renvoyer des factures
- Depuis la page de modification de commande: Allez dans WooCommerce > Commandes, modifiez la commande spécifique, recherchez la metabox "SendPol - Statut de commande" et cliquez sur "Renvoyer".
- Depuis le tableau de bord SendPol: Naviguez vers SendPol > Statuts de documents, trouvez le document pertinent et utilisez les actions disponibles pour retraiter.
Actions groupées
Traitez plusieurs commandes à la fois: Allez dans WooCommerce > Commandes, sélectionnez plusieurs commandes, choisissez les actions groupées SendPol dans le menu déroulant et appliquez l'action.
Notes de crédit & remboursements
SendPol prend en charge les remboursements totaux et partiels via des notes de crédit.
- Les remboursements totaux et partiels génèrent automatiquement une note de crédit.
- Les notes de crédit sont envoyées au réseau Peppol comme les factures.
- L’envoi manuel d’une note de crédit est disponible via le menu d’actions de la commande (« SendPol : Envoyer une note de crédit »).
- Suivi par remboursement : chaque remboursement est suivi séparément.
- Les notes de crédit pour les commandes annulées peuvent être automatisées (voir le réglage « Note de crédit automatique à l’annulation »).
Système de réessai automatique
Lorsqu’une facture échoue à l’envoi, le plugin planifie automatiquement de nouvelles tentatives.
- Le système utilise une attente exponentielle (les tentatives se font à des intervalles croissants).
- Un nombre maximal de tentatives est appliqué.
- L’état de la tentative est visible par commande dans la metabox SendPol de la commande.
- Les anciens enregistrements de tentatives sont nettoyés automatiquement.
- Une nouvelle tentative manuelle est toujours possible depuis la page de la commande.
Aperçu du tableau de bord

Le tableau de bord SendPol fournit un aperçu en temps réel de votre intégration Peppol avec les envois récents, les statuts de documents, l'état de la connexion et les journaux.
Statistiques (onglet Stats)
L’onglet statistiques du tableau de bord affiche :
- Documents envoyés ce mois-ci et total (depuis l’installation)
- Nombre total d’appels API
- Niveau d’abonnement SendPol et limite d’utilisation de l’API
- Statut de la connexion Peppol
- Documents téléversés vers Peppol
- Documents prêts à téléverser
- Documents en échec : erreur de validation
- Documents en échec : destinataire absent de Peppol
- Documents en échec : destinataire n’est pas une entreprise
Onglet Documents récents
- Dans l’onglet Documents récents, vous pouvez filtrer par statut, type de document, numéro de document et plage de dates.
- Par document : numéro de document, type (facture / note de crédit), nom du client, montant total, date de création et badge de statut.
- Actions par document : Envoyer à SendPol, Envoyer via Peppol, Réessayer et Réinitialiser — plus Mettre à niveau le forfait / Compléter le KYC lorsqu'un document est bloqué.
- Bouton de téléchargement UBL/XML par document.
Gestion des commandes
Colonne SendPol dans la liste des commandes
La liste des commandes WooCommerce reçoit une colonne « SendPol » supplémentaire affichant :
- Badge de statut coloré
- ID de document distant
- Un aperçu visuel rapide sans ouvrir chaque commande
- Fonctionne avec la vue classique des commandes et avec HPOS (High-Performance Order Storage).
Metabox « SendPol – Order Status » de la commande
Sur la page d’édition de la commande, la metabox « SendPol – Order Status » affiche :
- Statut actuel avec badge
- ID de document distant
- Horodatage de la dernière synchronisation
- Horodatage de la dernière tentative
- Erreurs de validation (le cas échéant)
- Saisie manuelle du numéro de TVA (un numéro de TVA peut être ajouté ou modifié directement sur la commande)
- Boutons d’action : Renvoyer, Supprimer et renvoyer, Envoyer une note de crédit, Rafraîchir le statut, Debug payload
Actions groupées
Deux actions groupées sont disponibles dans la liste des commandes :
- SendPol : Renvoyer — renvoie les commandes sélectionnées à SendPol.
- SendPol : Supprimer et renvoyer — supprime d’abord le document distant existant, puis renvoie (utile lorsqu’un document est bloqué).
Debug payload
Depuis la metabox de la commande, le bouton « Debug payload » affiche la charge JSON complète qui serait envoyée à l’API SendPol. Utile pour diagnostiquer le contenu d’une facture.
Compatibilité
Support de WooCommerce Blocks
Le champ de numéro de TVA fonctionne avec le checkout WooCommerce classique et avec le nouveau checkout WooCommerce Blocks. Aucune configuration supplémentaire n’est nécessaire.
Support de HPOS
Le plugin prend entièrement en charge WooCommerce High-Performance Order Storage (HPOS). Toutes les fonctionnalités (colonne de commande, metabox, actions groupées) fonctionnent avec HPOS activé.
Développeurs & filtres
Pour les développeurs, le plugin expose des outils admin et des filtres PHP.
Test de détection TVA
Dans les paramètres avancés, un outil permet de tester la détection TVA sur un ID de commande spécifique. Il indique quelle clé meta a été utilisée pour trouver le numéro de TVA, toutes les clés meta liées à la TVA présentes sur la commande, et si un numéro de TVA a été détecté.
Filtres PHP
Le plugin expose notamment les filtres suivants :
sendpol_wc_api_base_url— surcharger l’URL de base de l’API par programmation.sendpol_wc_external_invoice— fournir une facture UBL externe personnalisée pour une commande (retournez une chaîne XML UBL, ou null pour laisser SendPol en générer une).sendpol_wc_auto_refresh_order_status— désactiver le rafraîchissement automatique du statut de la commande dans la metabox.sendpol_wc_show_api_base_url— masquer le champ URL de base de l’API dans les paramètres (par ex. pour les installations managées).
// Override the API base URL programmatically
add_filter('sendpol_wc_api_base_url', function ($url) {
return 'https://staging.api.sendpol.com';
});
// Provide a custom external UBL invoice for an order
add_filter('sendpol_wc_external_invoice', function ($invoice, $order) {
// Return a UBL XML string, or null to let SendPol generate one
return null;
}, 10, 2);
// Disable auto-refresh of order status in the order edit metabox
add_filter('sendpol_wc_auto_refresh_order_status', '__return_false');
// Hide the API base URL field in settings (e.g. for managed installs)
add_filter('sendpol_wc_show_api_base_url', '__return_false');Dépannage
FAQ
Captures d'écran du plugin
Configuration et intégration
Configuration simple avec API et connexion automatique à Peppol

Tableau de bord et statistiques
Aperçu en temps réel de la connexion Peppol et des documents envoyés

Démarrage rapide
Démarrez rapidement avec SendPol pour WordPress
Inscrivez-vous sur SendPol
Créez un compte sur sendpol.com et obtenez votre clé API
Installez le plugin
Téléchargez et activez le plugin SendPol dans votre tableau de bord WordPress
Configurer l'API
Saisissez votre clé API et testez la connexion au réseau Peppol
Besoin d'aide?
Notre équipe d'assistance est prête à vous aider avec votre intégration SendPol
