Connecter Dolibarr à la facturation électronique avec SuperPDP et PDPConnectFR : le tutoriel pas à pas

Sommaire14 sections

1. 1Comment ça marche : le « schéma en Y »
2. 2Ce dont vous avez besoin avant de commencer
3. 3Étape 1 : créer votre compte sur SuperPDP
4. 4Étape 2 : installer le module PDPConnectFR dans Dolibarr
5. Où le récupérer
6. Méthode A — l'installateur intégré (Dolibarr 23 et plus)
7. Méthode B — par FTP (increvable, sans limite de taille)
8. 5Étape 3 : compléter les informations légales de votre société
9. 6Étape 4 : régler le format PDF sur Factur-X
10. 7Étape 5 : connecter PDPConnectFR à SuperPDP
11. 8Étape 6 : le cas des auto-entrepreneurs et de la franchise en base de TVA
12. 9Étape 7 : tester en Sandbox, puis passer en Production
13. 10Et la réception des factures fournisseurs ?
14. 11Récapitulatif en un coup d'œil
15. 12Dépannage : les erreurs les plus fréquentes
16. 13Questions fréquentes
17. 14Sources

À partir du 1ᵉʳ septembre 2026, toutes les entreprises françaises devront recevoir leurs factures fournisseurs au format électronique. L'obligation d'émettre suit un calendrier par taille : grandes entreprises et ETI au 1ᵉʳ septembre 2026, puis PME, TPE et micro-entreprises au 1ᵉʳ septembre 2027.

Le projet d'un portail public gratuit pour transmettre les factures ayant été abandonné, chaque entreprise doit désormais passer par une Plateforme Agréée (PA, ex-PDP) immatriculée par l'administration fiscale. Si vous utilisez Dolibarr, un module gratuit — PDPConnectFR — permet de le raccorder à une plateforme comme SuperPDP. Ce guide vous accompagne de bout en bout, écran par écran.

L'essentiel en 30 secondes. La facturation électronique devient obligatoire (réception dès septembre 2026). Vous ne pouvez plus émettre ni recevoir « à la main » : il faut une plateforme agréée (le transporteur) et un connecteur dans votre logiciel. Pour Dolibarr, ce connecteur — PDPConnectFR — est gratuit ; la plateforme — ici SuperPDP — est le service au bout. Comptez environ 45 minutes de configuration. Niveau : intermédiaire (accès administrateur Dolibarr requis).

Comment ça marche : le « schéma en Y »

Comprendre le principe évite bien des erreurs. Dans la réforme, une facture ne va plus directement de vous à votre client. Elle suit un « Y » :

• Vous émettez votre facture depuis Dolibarr, au format Factur-X.
• Elle part vers votre plateforme agréée (SuperPDP), qui la transmet à la plateforme du destinataire, qui la remet à votre client.
• En parallèle, les données fiscales (le « e-reporting ») remontent automatiquement à l'administration.

Dolibarr ne fait donc qu'une chose : générer la facture au bon format et la déposer sur votre plateforme. Tout le transport est assuré par la plateforme agréée.

Le calendrier en clair. Réception obligatoire pour toutes les entreprises au 1ᵉʳ septembre 2026. Émission : grandes entreprises et ETI au 1ᵉʳ septembre 2026 ; PME, TPE et micro-entreprises au 1ᵉʳ septembre 2027. Autrement dit : même une petite structure doit pouvoir recevoir dès 2026.

Ce dont vous avez besoin avant de commencer

• Un Dolibarr en version 22 minimum (idéalement 23 ou plus récent), avec PHP 7.2 ou supérieur.
• Un accès administrateur à votre Dolibarr.
• Un accès FTP à l'hébergement (utile si l'envoi du module par le navigateur bloque — voir l'étape 2).
• Les informations légales complètes de votre entreprise : SIREN, SIRET, numéro de TVA intracommunautaire, code NAF/APE, forme juridique.
• Une sauvegarde récente de votre base Dolibarr. Activer un module est réversible, mais sur une comptabilité de production, la sauvegarde est le réflexe de base.

Étape 1 : créer votre compte sur SuperPDP

SuperPDP est une Plateforme Agréée immatriculée par la DGFiP. C'est elle qui transportera réellement vos factures, et qui remontera les données à l'administration. Ce n'est pas la seule : il existe plus d'une centaine de plateformes agréées ; vous pouvez comparer et en choisir une autre sur la liste officielle (voir les sources en fin d'article). Nous prenons SuperPDP comme exemple car elle est testée avec Dolibarr.

1. Rendez-vous sur superpdp.fr et cliquez sur « Créer un compte » (e-mail + mot de passe).
2. Ajoutez votre entreprise en saisissant votre numéro SIREN à 9 chiffres ; la plateforme récupère automatiquement votre raison sociale.
3. Dans le tableau de bord, ouvrez, dans le menu de gauche, « Applications » puis « Nouvelle application ».
4. Choisissez le type « Confidentiel », et l'environnement « Test / Sandbox » pour commencer (on basculera en Production à la toute fin).
5. Notez soigneusement les deux identifiants générés : le client_id et le client_secret. Ils serviront à relier Dolibarr à SuperPDP.

⚠️ Point d'attention : ne mélangez jamais des identifiants de Test et de Production dans la même instance Dolibarr — c'est la source d'erreur la plus fréquente.

Étape 2 : installer le module PDPConnectFR dans Dolibarr

PDPConnectFR est édité par l'association Dolibarr et distribué gratuitement (licence GPLv3). Il embarque ses propres bibliothèques : ne supprimez rien de son contenu.

Où le récupérer

• Le code source officiel : le dépôt Dolibarr community-modules ou le dépôt de l'éditeur Webelys/pdpconnectfr. Une version prête à poser (dossier pdpconnectfr/ déjà structuré pour le FTP) est aussi téléchargeable directement ici : télécharger PDPConnectFR (ZIP, ~6 Mo). PDPConnectFR est édité par l'association Dolibarr et ses contributeurs, sous licence libre GPLv3. L'archive proposée ici est un repaquetage de la version officielle (dossiers de développement retirés) : le code source complet et le texte de la licence (fichier COPYING) sont inclus dans le ZIP.
• Sur Dolibarr 23, le plus simple reste l'installateur intégré (méthode A ci-dessous), qui va chercher le module tout seul.

Avant d'activer le module, faites une sauvegarde de votre base (Accueil → Configuration → Sauvegardes, ou un export depuis phpMyAdmin). L'activation ne crée que de nouvelles tables, mais mieux vaut être couvert.

Méthode A — l'installateur intégré (Dolibarr 23 et plus)

1. Connectez-vous en administrateur.
2. Allez dans Accueil → Configuration → Modules/Applications.
3. Ouvrez l'onglet « Déployer/installer un module externe » et envoyez le fichier ZIP.
4. Retournez dans Configuration → Modules, repérez PDPConnectFR (il peut aussi apparaître sous le nom « E-facture » / « EInvoice ») et activez-le.

⚠️ Le module pèse environ 7 Mo (à cause de ses bibliothèques, indispensables). Si l'envoi par le navigateur affiche « fichier trop volumineux », c'est une simple limite d'upload : passez par la méthode FTP ci-dessous, elle n'a aucune limite.

Méthode B — par FTP (increvable, sans limite de taille)

1. Décompressez le ZIP : vous obtenez un dossier nommé pdpconnectfr.
2. Avec un client FTP (FileZilla par exemple), déposez ce dossier dans le répertoire custom de Dolibarr, généralement .../dolibarr/htdocs/custom/. Vous devez alors avoir .../custom/pdpconnectfr/.
3. Dans Dolibarr : Accueil → Configuration → Modules → repérez PDPConnectFR → Activer.

Étape 3 : compléter les informations légales de votre société

C'est l'erreur numéro un : un seul champ société manquant fait échouer l'envoi de la première facture. Prenez cinq minutes pour tout renseigner avant d'aller plus loin.

Allez dans Accueil → Configuration → Société/Organisation et vérifiez la présence de :

• La raison sociale exacte et l'adresse complète (elle sert d'adresse d'e-facturation).
• Le SIREN (9 chiffres) et le SIRET (14 chiffres).
• Le numéro de TVA intracommunautaire.
• Le code NAF/APE, la forme juridique et le capital le cas échéant.

Astuce : ces informations doivent correspondre à celles connues de l'administration. En cas de doute sur votre SIREN/SIRET, vérifiez votre fiche sur l'annuaire officiel des entreprises avant de continuer.

Étape 4 : régler le format PDF sur Factur-X

La réforme impose un format structuré, lisible par les machines. Le format Factur-X est le plus pratique : c'est un PDF classique, lisible par un humain, qui contient à l'intérieur un fichier XML conforme à la norme européenne EN 16931. Les machines lisent le XML, vous lisez le PDF. Dolibarr sait le générer depuis la version 20.

Rendez-vous dans Accueil → Configuration → Factures (le module Factures/Avoirs), section « Modèles de documents PDF », et sélectionnez comme modèle par défaut celui qui produit du Factur-X.

⚠️ Le nom exact du modèle peut varier selon votre version de Dolibarr ; choisissez celui décrit comme « Factur-X » ou « e-facture ». Après activation de PDPConnectFR, ce format est en général proposé (voire présélectionné) automatiquement. Vérifiez toujours en générant une facture de test : ouvrez son PDF, il doit être annoncé comme Factur-X.

Étape 5 : connecter PDPConnectFR à SuperPDP

1. Allez dans Accueil → Configuration → Modules, repérez PDPConnectFR et cliquez sur sa roue crantée (configuration).
2. Dans la liste déroulante « Plateforme agréée », choisissez SuperPDP.
3. Collez le client_id et le client_secret obtenus à l'étape 1 (identifiants de l'environnement Test pour l'instant).
4. Cliquez sur « Se connecter » : Dolibarr récupère alors la clé de sécurité auprès de SuperPDP.
5. Lancez enfin le bouton « Vérification de la connexion (healthcheck) » : il doit passer au vert. S'il échoue, voir le dépannage plus bas.

Étape 6 : le cas des auto-entrepreneurs et de la franchise en base de TVA

Si vous ne facturez pas de TVA (micro-entreprise, franchise en base), il faut le déclarer explicitement : sinon vos factures partent avec un taux de 0 % non justifié et la plateforme les rejette.

Dans Accueil → Configuration → Divers, ajoutez la variable MAIN_VAT_EXEMPTION_CODE_FOR_0 avec la valeur VATEX-FR-FRANCHISE (qui correspond à l'article 293 B du Code général des impôts). C'est ce code qui indique à l'administration pourquoi vous ne facturez pas de TVA.

Étape 7 : tester en Sandbox, puis passer en Production

1. Toujours en environnement Test, créez une facture de démonstration et transmettez-la. Vérifiez qu'elle part sans erreur et que son statut de cycle de vie remonte dans Dolibarr (déposée, reçue…).
2. Une fois ce test concluant, retournez sur SuperPDP et créez une nouvelle Application « Confidentiel » en environnement Production. Récupérez les nouveaux client_id et client_secret.
3. Dans la configuration de PDPConnectFR, basculez la plateforme sur SuperPDP — Production, collez les identifiants de production, puis refaites un healthcheck.

Vous pouvez aussi, dans l'onglet « autres options » de la configuration, activer la génération automatique de l'e-facture pour ne plus y penser.

Et la réception des factures fournisseurs ?

On l'oublie souvent, mais c'est la première obligation (dès septembre 2026) : être capable de recevoir les factures de vos fournisseurs au format électronique. Une fois PDPConnectFR connecté à SuperPDP, la réception fonctionne dans le même canal : les factures qui vous sont adressées sont récupérées par la plateforme et importées dans Dolibarr (dans vos factures fournisseurs), avec leur statut de cycle de vie. Pensez à vérifier régulièrement cette arrivée, et à valider ou refuser chaque facture reçue.

Récapitulatif en un coup d'œil

Dépannage : les erreurs les plus fréquentes

• « Fichier trop volumineux » à l'installation → c'est une limite d'upload du navigateur, pas un problème de module. Installez-le par FTP (méthode B, étape 2).
• Erreur au moment d'envoyer la première facture → il manque presque toujours un champ dans la fiche société (étape 3). Reprenez-les un par un.
• Le healthcheck reste rouge → vous avez mélangé les environnements (identifiants Test dans une config Production, ou l'inverse), ou une espace s'est glissée en recopiant le client_secret. Vérifiez aussi que votre entreprise est bien enregistrée côté SuperPDP.
• Factures à 0 % rejetées → le code d'exonération de TVA n'est pas renseigné (étape 6).
• Le module n'apparaît pas dans la liste → le dossier n'est pas au bon endroit (il doit être custom/pdpconnectfr/, pas custom/pdpconnectfr-main/) ou les droits d'écriture manquent sur custom/.

⚠️ La réforme évolue encore. Ce guide reflète l'état connu au moment de sa rédaction. Les modalités, les noms d'écrans et les échéances peuvent changer : vérifiez toujours la version en vigueur sur impots.gouv.fr et auprès de votre plateforme avant de vous lancer.

Questions fréquentes

Le module PDPConnectFR est-il vraiment gratuit ?

Oui, PDPConnectFR est distribué gratuitement sous licence libre GPLv3. En revanche, la plateforme agréée SuperPDP est un service qui a sa propre tarification (souvent sur devis selon le volume) : vérifiez les conditions directement sur superpdp.fr.

Combien ça coûte au total ?

Le connecteur Dolibarr (PDPConnectFR) est gratuit. Le coût vient de la plateforme agréée que vous choisissez : les tarifs varient d'une plateforme à l'autre, souvent selon le nombre de factures. Comparez plusieurs plateformes de la liste officielle avant de vous engager.

Que se passe-t-il si je ne fais rien ?

Dès le 1ᵉʳ septembre 2026, si vous ne pouvez pas recevoir de factures électroniques, vos fournisseurs ne pourront plus vous en adresser dans les règles, et vous vous exposez à des difficultés (et, à terme, à des sanctions). Se préparer en avance évite la précipitation.

Quelle version de Dolibarr faut-il ?

Le module demande Dolibarr 22 au minimum. L'idéal est la version 23 ou plus récente, qui dispose d'un installateur de modules externes intégré et génère nativement le format Factur-X.

À partir de quand suis-je obligé ?

La réception de factures électroniques devient obligatoire pour toutes les entreprises au 1ᵉʳ septembre 2026. L'émission suit un calendrier par taille : 1ᵉʳ septembre 2026 pour les grandes entreprises et ETI, 1ᵉʳ septembre 2027 pour les PME, TPE et micro-entreprises.

Qu'est-ce que le format Factur-X ?

C'est un format hybride : un PDF lisible par un humain, dans lequel est embarqué un fichier XML structuré conforme à la norme européenne EN 16931. Les machines lisent le XML, vous lisez le PDF.

Puis-je changer de plateforme agréée plus tard ?

Oui. La plateforme se choisit dans la configuration du module et peut être changée. Consultez la liste officielle des plateformes agréées sur impots.gouv.fr pour comparer.

Sources

• SuperPDP — créer un compte (plateforme agréée)
• PDPConnectFR — dépôt officiel Dolibarr community-modules
• Documentation du module (wiki Dolibarr)
• Liste officielle des plateformes agréées (DGFiP)