Factur-X PDF Import

KSIDol Dolibarr Integrator Custom Development SaaS Hosting https://www.ksidol.io  support@ksidol.io

Main features

• Import Factur-X supplier PDF invoices (embedded XML).
• Extract XML (factur-x.xml) and read data: third party, VAT, totals, due date, references.
• Automatically create a draft supplier invoice (with Simulation mode).
• Line handling (products/services), multi-VAT, line discounts, quantities and units.
• Duplicate detection (SHA1) and import log (logs).

Requirements

• Compatibility: Dolibarr v20 to v23.
• PHP 8.1+ with DOM, SimpleXML, XMLReader/XMLWriter, ZIP extensions.
• Required Dolibarr modules: Third Parties + Supplier Invoices (Products/Services optional if mapping by product reference).

Installation

1. Download the module from DoliStore and install it in your Dolibarr (Home → Setup → Modules/Applications).
2. Enable the module.
3. Open the module setup to define: upload directory, duplicate policy, third-party creation options, default accounts/VAT (if applicable).

Usage

1. Open the module menu “Factur-X Supplier Import”.
2. Select a Factur-X PDF and run the import in Simulation first to verify parsing.
3. Uncheck Simulation to actually create the supplier invoice (draft).
4. Review the created invoice (third party, lines, VAT, totals) then validate according to your process.

Compatibility & formats

• Dolibarr: v20 to v23
• PHP: 8.1+
• Formats: Factur-X / ZUGFeRD (EN16931, XRechnung depending on the file)

Languages

FR, EN, IT, ES, DE

Limits / notes

• The module can import only PDFs that include an embedded Factur-X/ZUGFeRD XML (a “simple” PDF/scan cannot be imported).
• Depending on the Factur-X profile (Minimum/Basic/EN16931/Extended), some information may be missing.
• If the PDF is encrypted/protected or has a non-standard structure, the import may fail: check the import log.

Support 

Author: KSI — dolibarr@serveur2ksi30.fr