Module PDPConnectFR

Information

Module name	EInvoice - PDPConnectFR
Editor / Editeur	Dolibarr community
Download or buy page / Page achat ou téléchargement
Status / Statut / Estado	Experimental
Prerequisites / Prérequis	Dolibarr min version: 21.0
Last update date / Date mise à jour fiche / Fecha última actualización	2026-05-19
Note / Nota	Recommended version: 24.0+

Features

This module adds support to EInvoice in Dolibarr for some countries. Generating, Sending and Receiving EInvoice is mandatory in some countries, this module deals with the case of France (even if it can be modified ot support other countries).

For a solution dedicated to other countries, take a look at the page Electronic Billing.

The module allows your Dolibarr to generate EInvoice and to connect to some official Access Point (Plateforme Agréées) to send and retrieve your invoice documents. The supported EInvoice format are:

Factur-X
CII
More format can be added by contributing (see Development chapter)

Installation

Install the electronic invoicing module in your Dolibarr /custom directory (in a future, an installation link will be available directly in your Dolibarr admin pages).

In the meantime, install the module in the /custom directory of your dolibarr. For this, go into the /custom directory:

cd mydolibarrdir/htdocs/custom

Then download the module directory pdpconnectfr

git clone https://github.com/Dolibarr/dolibarr-community-modules; mkdir pdpconnectfr; cp -pr dolibarr-community-modules/pdpconnectfr/* pdpconnectfr; rm -fr dolibarr-community-modules;

Setup

Go onto the setup of the modulefrom menu "Home - Setup - Modules - Module EInvoice - Wheel configuration".

The first step is to choose, from the combo list, which Access Point you want to use to send your EInvoice. You can select between one in the following list:

EsaLink (hubtimize)
SuperPDP
More providers are coming (See chapter Development to know how to contibute to add your own Provider)

All access point provided by the module are official Access Points (Plateforme Agréée).

Setup with Esalink/Hubtimize Access point

TODO

Setup with SuperPDP Access Point

If you choose SuperPDP as your official Production Access Point (or as a Test Access Point), you must create an account by clicking on the link suggested by the setup page of the module (https://www.superpdp.tech/app/users/create).

Note that for a production usage, you may need to provide a scan of an identity card. The process of creating an account may last few minutes.

Once your account is created, you must generate credentials to allow Dolibarr to connect to SuperPDP. For this, go into your SuperPDP dashboard, and from the left menu "Applications", click on "New Application" to create a new setup for the application Dolibarr. Choose if you want a setup for Production or for Test (Sandbox). Then select the company and the type of application "confidential" and click "Create" (you can keep the field "URLs of redirection" to empty or paste the value provided by Dolibarr setup page).

The page to get credentials for an application

Your credential (client_id and client_secret) are created and are shown on screen.

Go into Dolibarr, into the page to setup the module EInvoice and enter these 2 values, click on Save to save the data and click on "Connect" to get the security key to exchange with SuperPDP.

That's all, you are connected with SuperPDP (For Production usage or for Test depending on the choice you made). To be sure, you can try the link "Test of connection (healthcheck)" to verify the connection.

Example of setup for sandbox use with an account of SuperPDP

By default, you can enter only one set of credentials for the Production mode and one set of credentials for the Test mode, so if your Dolibarr instance is a test instance, enter test credentials and set the switch to Test, and if your Dolibarr instance is a production instance, enter credentials of production and set the switch to Production. Even if you can switch from one environment to another one, it is seriously not recommended to save and use both Test and Production credentials in the same Dolibarr instance; Only the Access Point environment is different but your Dolibarr is the same. So if you mix two Access Point environments (Test and Prod) in the same Dolibarr, you may get or send tests invoices on your production instance (and the opposite), so the best thing to avoid this is to enter credentials only for one environment and never for the other. See chapter "Usage in sandbox for test" for more information on how to use the module in a sandbox context.

Usage for production

Send a customer invoice

Once a Dolibarr invoice is generated (and validated), you can use a new button "Generate the Einvoice".

Note: you can have this action done automatically if you enable the option from menu Home - Setup - Modules - Module Einvoice - Configuration - Tab "other options" and switch "Generate automatically Einvoice".

Once an EInvoice has been generated, you can use the button to "Send the invoice" to the access point. Wait a minute while the access point answers and observe the returned status code:

Code 200: the access point has successfully sent the invoice to the client and is waiting for an answer from the customer's approval
Code 213: the access point has detected an anomaly on the invoice and it has been rejected
Code 210: the customer refused the invoice

Retrieve vendor invoices

Go into menu Home - Invoice - EInvoice synchronization.

Click on the button to launch synchronization.

If you experience an error, follow the instruction. for example:

If you try to import a vendor invoice and the vendor can not be found in your Dolibarr database of suppliers, a link will be suggested to create it.
If you try to import a vendor invoice and a product line can not be found in your Dolibarr database of products, a link will be suggested to create the product (You may also prefer to edit the vendor card to define a default Product Ref to use when doing an import of a product that is unknown, so each time a product is unknown for this vendor, Dolibarr will use the same default product instead of creating a new one each time).

Usage in a sandbox for test

Using the module in sandbox environment is the same than using it in production mode. Only the credentials to connect to your Access Point differ.

If you are a developper, you can enable the option PDPCONNECTFR_ALLOW_DEV_TOOLS to 1 into menu "Home - Setup - Other". This will add more features for developers into an additional tab "Dev tools". You can also switch the Test / Production mode from the main tab of the setup section of the module. WARNING: Using the switch is dangerous as it allows mixing invoices from different networks in the same Dolibarr instance.

Using the sandbox and Peppol test Network for multi Access Point tests

If you are using credentials to use the sandbox mode of SuperPDP, you may need to modify the setup of your company (Menu Home - Setup - Company/Organization) to record the same SIREN than the one of the test company provided by SuperPDP sandbox (So "000000001" for Tricatel or "000000002" for Burger Queen).

However the EInvoice address is NOT the same than the SIREN (it is the same in production mode only), so you must also force the Einvoice address of the company into the setup of the module Einvoice: To know your EInvoice address of your test company, go into the SuperPDP dashboard, in sandbox mode, and click on the label of the test company (for example Tricatel), you should see a list of the addresses of this test company in the annuary (the address to find you on the shared test Access Point network). The invoice address to use is the value after the "225:", the one starting with 315143296_XXX with XXX that depends on your account. Once both are saved, a warning may appear to say that SIREN and Einvoice address ID are not the same. You can ignore it in test environment.

If your SIREN (menu Home - Setup - Company/Organisation) and your EInvoice address (menu Setup - Modules - Einvoice - Configuration) are correctly filled (Example: SIREN: 00000001 and EInvoice address 315143296_XXX), then you can send and retreive invoices from or to any other Access Points working on the Peppol Test network (The SuperPDP sandbox is automatically linked to the Peppol Test network when you use the sandbox credential).

To send an invoice to a test customer available onto another Access Point, as the Peppol network are using addresses that are different from SIREN, you can force the customer EInvoice address from the thirdparty card by editing the field EInvoice address.

Example of the thirdparty card to send an einvoice from SuperPDP to the customer Test with SIREN 145678239 available at Esalink

Troubleshooting error codes

Development

The development of this module is included inside the official GIT repository of Dolibarr community modules:

GIT Repository: git clone https://github.com/Dolibarr/dolibarr-community-modules

They are all Open Source modules and you can contribute by doing Pull Request like you can contribute to Dolibarr itself.