E-Invoice: XRechnung 3.0, ZUGFeRD & Factur-X

Structured E-Invoicing for Dolibarr — 100 % Local

This module adds fully structured electronic invoicing to Dolibarr. It covers both German public-sector (B2G) and business-to-business (B2B) requirements in a single, self-contained package that runs entirely on your own server. No data leaves your system, no subscription to a third-party conversion service is required.

Export Formats

• XRechnung 3.0 (UBL 2.1) — Invoice and CreditNote documents, the format required for invoices to German federal authorities.
• ZUGFeRD / Factur-X (UN/CEFACT CII) — Structured XML embedded into the invoice PDF as a true PDF/A-3 hybrid file, using the bundled atgp/factur-x library. Recipients get a human-readable PDF and a machine-readable XML in one attachment.

Automatic Generation on Invoice Approval

When you validate (approve) an invoice in Dolibarr, the module automatically generates the XML and attaches it to the document. The trigger uses a soft-fail design: if generation fails, Dolibarr continues normally and logs the error rather than blocking the approval workflow.

Supplier Invoice Import

Upload a UBL 2.1 or CII XML file and the module creates a draft supplier invoice in Dolibarr. The supplier is matched by VAT number or company name; if no match is found, a new supplier record is created automatically. Line items are transferred without manual re-entry.

Built-in EN16931 Plausibility Check

Before generating or importing, the module runs a native PHP validation pass covering EN16931 mandatory-field rules (BR-* series) and arithmetic consistency rules (BR-CO-* series). The result is a clear list of errors and warnings shown directly in the Dolibarr interface.

Scope of validation: This is a core-rule plausibility checker implemented in native PHP. It is not the official KoSIT Schematron/Saxon XSLT 2.0 validation suite and does not carry official government certification. For submissions requiring KoSIT-certified pre-validation, run the XML through the official KoSIT Validator separately.

Leitweg-ID for Public-Sector Invoices (B2G)

A dedicated custom field (BT-10, Leitweg-ID) is created automatically in the customer record when the module is installed. Fill it in once per public-sector customer and it is included in every outgoing XRechnung automatically — no manual entry per invoice.

Configuration

• Profile selection (XRechnung 3.0 UBL / ZUGFeRD EN16931 / Factur-X EN16931)
• Auto-generation on invoice approval: on/off
• PDF/A-3 embedding: on/off
• EN16931 plausibility validation: on/off
• Optional Factur-X XSD schema check
• Test-generation button directly on the setup page
• XML import upload for supplier invoices
• Interface available in German and English

Technical Details

• License: GPLv3 — open source, no runtime licence key
• Dolibarr 18.0 – 23.0 (tested on 23.0.3)
• PHP 7.4 – 8.2
• No external API calls, no cloud dependency
• Bundled library: atgp/factur-x v3.3 for PDF/A-3 embedding