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.

    Guide Vidéo

    Regardez Comment Configurer SendPol pour WordPress/WooCommerce

    Apprenez à installer et configurer le plugin SendPol pour WordPress/WooCommerce en quelques minutes seulement.

    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.

    Mode test

    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 boutiques

    Installation

    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

    1

    Accédez à votre tableau de bord d'administration WordPress

    2

    Naviguez vers Extensions > Ajouter

    3

    Recherchez 'SendPol pour WooCommerce'

    4

    Cliquez sur 'Installer maintenant' sur le plugin SendPol

    5

    Cliquez sur 'Activer' après l'installation

    6

    Vous devriez voir 'SendPol' dans votre menu d'administration WordPress

    Méthode 2: Installation manuelle

    Alternative: Téléversez le fichier du plugin manuellement

    1

    Téléchargez le plugin SendPol pour WooCommerce

    2

    Accédez à votre tableau de bord d'administration WordPress

    3

    Naviguez vers Extensions > Ajouter > Téléverser une extension

    4

    Sélectionnez le fichier ZIP du plugin et cliquez sur 'Installer maintenant'

    5

    Cliquez sur 'Activer l'extension' après l'installation

    6

    Vous devriez voir 'SendPol' dans votre menu d'administration WordPress

    Configuration initiale

    Obtenir vos identifiants API

    1

    Inscrivez-vous sur SendPol

    Visitez www.sendpol.com et créez un compte ou connectez-vous à votre compte existant.

    2

    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é
    Tableau de bord SendPol - Gestion des webshops avec clé API

    Configuration initiale

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

    Configuration du plugin SendPol
    1

    Cliquez sur "SendPol" dans votre menu d'administration WordPress

    2

    Entrez l'URL de base de l'API: https://api.sendpol.com

    3

    Entrez votre clé API SendPol

    4

    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

    1

    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.

    2

    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.

    3

    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

    Tableau de bord SendPol

    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_urlsurcharger l’URL de base de l’API par programmation.
    • sendpol_wc_external_invoicefournir 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_statusdésactiver le rafraîchissement automatique du statut de la commande dans la metabox.
    • sendpol_wc_show_api_base_urlmasquer 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

    Configuration du plugin SendPol

    Tableau de bord et statistiques

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

    Tableau de bord du plugin SendPol

    Démarrage rapide

    Démarrez rapidement avec SendPol pour WordPress

    1

    Inscrivez-vous sur SendPol

    Créez un compte sur sendpol.com et obtenez votre clé API

    2

    Installez le plugin

    Téléchargez et activez le plugin SendPol dans votre tableau de bord WordPress

    3

    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