- Qu'est-ce que Peppol ?
- Pourquoi EMPeppol ?
- Prérequis
- Installation
- Configuration initiale (Wizard)
- Envoi de factures
- Réception de factures
- Messagerie Peppol (Invoice Message Response)
- Découverte Peppol & Multi-ID
- Mapping TVA / VATEX
- Suivi & Statistiques
- Configuration avancée
- Maintenance et diagnostic
- FAQ
- Quels pays sont supportés ?
- EMPeppol fonctionne-t-il en multi-entité ?
- Quel format de facture est utilisé ?
- Peut-on envoyer des avoirs (notes de crédit) ?
- Peut-on joindre des fichiers aux factures ?
- Y a-t-il des frais par envoi ?
- Comment migrer depuis un autre module Peppol ?
- Comment mettre à jour le module ?
- Où trouver de l'aide ?
EMPeppol — Facturation électronique Peppol pour Dolibarr
EMPeppol connecte votre ERP Dolibarr au réseau européen Peppol via le point d'accès Peppyrus. Il vous permet d'envoyer et de recevoir des factures électroniques au format UBL, conformes aux standards EN 16931 et Peppol BIS Billing 3.0, directement depuis votre interface Dolibarr.
Qu'est-ce que Peppol ?
Peppol (Pan-European Public Procurement OnLine) est un réseau international standardisé pour l'échange de documents commerciaux électroniques. Utilisé dans plus de 30 pays, il est :
- Obligatoire pour la facturation B2G (Business-to-Government) dans la plupart des pays de l'UE
- Obligatoire en Belgique pour le B2B à partir de 2026
- Le standard de référence pour la facturation électronique en Europe
Pourquoi EMPeppol ?
- Intégration native — Envoyez et recevez vos factures Peppol directement depuis Dolibarr, sans logiciel tiers
- Envois gratuits et illimités — Grâce à Peppyrus, aucun coût par document échangé. Vous payez le module une fois, c'est tout
- Conformité complète — EN 16931, Peppol BIS 3.0, codes VATEX, Invoice Message Response
- Installation en 5 minutes — Un assistant de configuration vous guide étape par étape
- Pièces jointes multiples — Joignez le PDF de la facture et d'autres documents dans le fichier UBL
- Compatible Dolibarr 17 à 23 — PHP 7.4 à 8.3, Multicompany supporté
Prérequis
| Élément | Version minimum |
|---|---|
| Dolibarr | 17.0 ou supérieur |
| PHP | 7.4 ou supérieur |
| Extensions PHP | soap, xml, json, curl |
Vous aurez également besoin d'un compte Peppyrus (le point d'accès Peppol utilisé par EMPeppol). Votre clé API vous sera fournie lors de la souscription.
Note : EMPeppol est compatible avec les installations multi-entités de Dolibarr (Multicompany). Chaque entité peut avoir sa propre configuration.
Installation
Depuis le DoliStore
- Rendez-vous sur le DoliStore et recherchez EMPeppol
- Achetez le module et téléchargez l'archive ZIP
- Décompressez l'archive dans le dossier
htdocs/custom/de votre installation Dolibarr - Le dossier final doit être
htdocs/custom/empeppol/
Activation
- Connectez-vous à Dolibarr en tant qu'administrateur
- Allez dans Accueil → Configuration → Modules/Applications
- Recherchez "EMPeppol" et cliquez sur Activer
Un nouveau menu EMPeppol apparaît dans votre barre de navigation.
Configuration initiale (Wizard)
Lors du premier accès, un assistant de configuration vous guide en 6 étapes.
Étape 1 : Clé API Peppyrus
Saisissez votre clé API Peppyrus. La connexion est testée automatiquement.
Astuce : Si vous n'avez pas encore de clé API, contactez Peppyrus pour en obtenir une. EMPeppol fonctionne en environnement de test et de production.
Étape 2 : Vérification de l'organisation
EMPeppol récupère automatiquement les informations de votre organisation depuis Peppyrus : nom, TVA, participants Peppol associés. Sélectionnez le participant expéditeur correspondant à votre société.
Étape 3 : Mode d'envoi
Choisissez votre mode d'envoi préféré :
- Manuel : un bouton d'envoi sur chaque facture — vous gardez le contrôle
- Automatique : les factures sont envoyées dès leur validation dans Dolibarr
Vous pouvez aussi activer la découverte automatique des identifiants Peppol de vos clients.
Étape 4 : Réception
Activez la réception des factures fournisseurs entrantes et configurez la création automatique des tiers fournisseurs inconnus.
Étape 5 : Mapping TVA
Configurez la correspondance entre vos taux TVA Dolibarr et les catégories Peppol. EMPeppol propose une auto-détection intelligente qui fait le travail pour vous en un clic.
Étape 6 : Récapitulatif
Le wizard affiche un résumé de votre configuration et confirme que tout est opérationnel.
Envoi de factures
Préparer une facture
Pour qu'une facture puisse être envoyée via Peppol, elle doit remplir ces conditions :
- La facture doit être validée (statut "Non payée" ou supérieur)
- Le client doit avoir un identifiant Peppol renseigné (numéro d'entreprise, GLN, etc.)
- Les taux TVA de la facture doivent être mappés dans la configuration VATEX
Envoyer une facture
- Ouvrez la facture dans Dolibarr
- Cliquez sur l'onglet Peppol
- Vérifiez le résumé et les informations du destinataire
- Cliquez sur Envoyer via Peppol
Le système génère le document UBL, l'envoie via Peppyrus et affiche le statut en temps réel.
Pièces jointes multiples
EMPeppol vous permet de joindre plusieurs fichiers à la facture UBL envoyée sur le réseau Peppol. En plus du PDF de la facture (inclus automatiquement), vous pouvez ajouter des annexes, des bons de commande, des plans ou tout autre document pertinent.
Le destinataire reçoit ainsi un dossier complet avec la facture et toutes ses pièces justificatives — directement dans son système comptable.
Statuts d'envoi
| Statut | Description |
|---|---|
| En attente | La facture est prête mais pas encore envoyée |
| Envoyée | La facture a été transmise au réseau Peppol |
| Délivrée | Le destinataire a accusé réception |
| Erreur | L'envoi a échoué (consultez le message d'erreur) |
File d'attente
EMPeppol gère une file d'attente d'envoi pour les factures en mode automatique. Vous pouvez y consulter les factures en attente, les renvoyer manuellement ou les traiter en masse.
Pour les experts : La file d'attente peut être configurée avec une date de début (pour une reprise historique), un nombre maximum de tentatives de renvoi, et des tâches planifiées (cron) pour le traitement automatique et la vérification des statuts.
Réception de factures
EMPeppol reçoit automatiquement les factures fournisseurs entrantes via le réseau Peppol et les intègre dans Dolibarr.
Comment ça fonctionne
- EMPeppol interroge périodiquement Peppyrus pour les nouveaux documents
- Chaque document reçu est analysé et converti en facture fournisseur Dolibarr
- Si l'expéditeur correspond à un tiers existant, la facture est liée automatiquement
- Sinon, un nouveau tiers fournisseur est créé (si l'option est activée)
- Les lignes de facture sont créées avec les montants, taux TVA et descriptions du document Peppol
Liste des factures reçues
QR Code de paiement
Pour les factures d'achat reçues, EMPeppol affiche un QR code EPC permettant de payer rapidement par scan bancaire. La communication structurée est supportée.
Pour les experts : En mode expert, vous pouvez configurer la validation automatique des factures reçues, l'acquittement automatique des documents (MLR), la fréquence de synchronisation, et les pièces jointes stockées (XML/UBL source).
Messagerie Peppol (Invoice Message Response)
EMPeppol gère les réponses Peppol complètes (IMR — Invoice Message Response), une fonctionnalité rare parmi les modules Dolibarr. Elle fonctionne pour les factures d'achat et de vente.
Types de réponses supportés
| Réponse | Description |
|---|---|
| Accusé de réception | Confirmation de bonne réception du document |
| Acceptation | Le destinataire accepte la facture |
| Refus avec motif | Le destinataire refuse la facture et indique pourquoi |
| Notification de paiement | Le destinataire signale qu'il a procédé au paiement |
Workflow complet
Pour les experts : Les acquittements automatiques (MLR) peuvent être configurés pour répondre automatiquement aux documents reçus, conformément aux exigences Peppol.
Découverte Peppol & Multi-ID
EMPeppol détecte automatiquement si vos clients sont enregistrés sur le réseau Peppol à partir de leur numéro de TVA.
Fonctionnalités
- Découverte en masse : scannez tous vos clients en un clic pour trouver ceux qui sont sur Peppol
- Multi-ID : un client peut avoir plusieurs identifiants Peppol (numéro d'entreprise, GLN, etc.). EMPeppol les gère tous et vous permet de choisir le bon à l'envoi
- Onglet Peppol sur la fiche tiers : visualisez les identifiants détectés, le statut Peppol et l'historique des échanges
Mapping TVA / VATEX
Le mapping TVA est essentiel pour la conformité Peppol. Il établit la correspondance entre vos taux TVA Dolibarr et les catégories Peppol.
Codes TVA courants
| Code | Description | Utilisation |
|---|---|---|
| S | Standard | Taux TVA standard (21%, 6%, etc.) |
| Z | Zero rated | Taux à 0% avec droit à déduction |
| E | Exempt | Exonéré de TVA |
| AE | Reverse charge | Autoliquidation (intracommunautaire) |
| G | Export | Exportation hors UE |
EMPeppol propose une auto-détection intelligente qui associe automatiquement vos taux aux bonnes catégories. Vous pouvez aussi utiliser la pré-configuration en un clic pour les cas standards.
Important : Assurez-vous de mapper tous vos taux TVA utilisés avant d'envoyer des factures. Un taux non mappé provoquera une erreur à l'envoi.
Suivi & Statistiques
Le tableau de bord EMPeppol vous donne une vue complète de vos échanges Peppol.
- Répartition par statut : livrées, en attente, échouées — avec les montants
- Historique mensuel : évolution des envois et réceptions dans le temps
- File d'attente : traitement en masse des factures en attente
- Colonnes Peppol dans la liste des factures : visualisez le statut Peppol directement depuis vos listes
Configuration avancée
Mode Simple vs Mode Expert
EMPeppol propose deux modes de configuration :
- Mode Simple : les options essentielles, parfait pour démarrer rapidement
- Mode Expert : toutes les options de personnalisation pour un contrôle total
Options d'envoi avancées
- File d'attente : date de début configurable pour reprise historique
- Renvoi automatique : nombre maximum de tentatives en cas d'échec
- Tâches planifiées : traitement automatique de la file d'attente et vérification des statuts via cron
- Événements : déclenchement d'actions sur les événements de facture (validation, envoi)
Options de réception avancées
- Validation automatique : valider automatiquement les factures fournisseurs reçues
- Acquittement automatique : répondre automatiquement aux documents (MLR)
- Invoice Response : envoi de réponses automatiques (accusé, acceptation)
- Pièces jointes : stockage du fichier XML/UBL source
- Fréquence de synchronisation : configurable selon vos besoins
Autres options
- Mode debug : logs détaillés dans
documents/empeppol/logs/ - Timeout API : durée maximale d'attente pour les appels Peppyrus (défaut : 30s)
- Stockage des documents : conservation locale des documents UBL
- Webhook : URL de callback pour les notifications de réception
Maintenance et diagnostic
Accédez à EMPeppol → Maintenance pour vérifier l'état de votre installation :
- Connexion API : test de connectivité avec Peppyrus
- Extensions PHP : vérification de
soap,xml,curl - Configuration : validation des paramètres du module
- Logs : consultation des logs d'envoi et de réception (mode debug)
Problèmes courants
L'envoi échoue avec "Invalid participant" → Vérifiez que l'identifiant Peppol du destinataire est correct et qu'il est bien enregistré sur le réseau.
"VATEX mapping missing" → Un taux TVA utilisé dans la facture n'a pas de correspondance Peppol. Configurez-le dans le mapping TVA.
Erreur de connexion API → Vérifiez votre clé API, testez la connectivité depuis la page Maintenance, et assurez-vous que votre serveur peut accéder à l'API Peppyrus (pas de blocage pare-feu).
Les factures reçues ne créent pas de tiers → Vérifiez que la création automatique des fournisseurs est activée dans les paramètres de réception.
Les statuts restent "Envoyée" sans passer à "Délivrée" → La vérification des statuts nécessite une tâche planifiée. Configurez-la dans les paramètres d'envoi avancés ou lancez-la manuellement.
FAQ
Quels pays sont supportés ?
Tous les pays connectés au réseau Peppol : la plupart des pays de l'UE, le Royaume-Uni, Singapour, l'Australie, la Nouvelle-Zélande et d'autres. Plus de 30 pays au total.
EMPeppol fonctionne-t-il en multi-entité ?
Oui. Chaque entité Dolibarr peut avoir sa propre configuration, clé API et participant Peppol.
Quel format de facture est utilisé ?
Le format UBL 2.1 conforme au profil Peppol BIS Billing 3.0, le standard européen de facturation électronique conforme à la norme EN 16931.
Peut-on envoyer des avoirs (notes de crédit) ?
Oui, EMPeppol supporte l'envoi de notes de crédit. Le processus est identique à l'envoi de factures.
Peut-on joindre des fichiers aux factures ?
Oui. Le PDF de la facture est inclus automatiquement dans le fichier UBL, et vous pouvez ajouter d'autres documents (annexes, bons de commande, etc.) avant l'envoi.
Y a-t-il des frais par envoi ?
Non. Avec le point d'accès Peppyrus, les envois et réceptions sont gratuits et illimités. Vous payez le module une seule fois.
Comment migrer depuis un autre module Peppol ?
- Si votre module actuel utilise déjà Peppyrus : récupération possible de l'historique d'envoi
- Depuis un autre point d'accès : configurez une date de début et les nouvelles factures partiront via EMPeppol
- Dans tous les cas, vous économisez sur le long terme grâce à l'absence d'abonnement
Comment mettre à jour le module ?
- Téléchargez la nouvelle version depuis le DoliStore
- Remplacez les fichiers dans
htdocs/custom/empeppol/ - Accédez à Dolibarr — le module détecte la mise à jour et applique les migrations automatiquement
Où trouver de l'aide ?
- Support E-dem : Contactez-nous pour toute question technique
- Documentation Peppol : peppol.eu pour les spécifications du réseau