E-invoices straight from Dolibarr - validated before they go out
This module turns your Dolibarr invoices into e-invoices according to the European standard EN 16931: as XRechnung (XML file, the German standard required by public authorities and clients who want pure data) or as ZUGFeRD/Factur-X (PDF with embedded XML data), which anyone can read and any accounting system can process automatically. On request, every file is validated right away with the official validator - locally on your server, without passing data to external services.
Why this module?
- Two formats, freely combined: XRechnung 3.0 and ZUGFeRD/Factur-X (profile EN 16931, PDF/A-3). One default template applies to all invoices; individual customers can have their own e-invoice format, which their new invoices get automatically.
- Your usual invoice layout: the readable PDF for XRechnung and the layout of the ZUGFeRD invoice are created with any Dolibarr invoice template, including ODT templates with automatic PDF conversion. Corrective invoices can use a template of their own.
- All invoice types: invoices, down payment and final invoices with deduction of the down payments, corrective and replacement invoices referring to the original invoice, discounts and charges, date of supply and service period, foreign currency with the VAT amount additionally in euros.
- Special VAT cases marked correctly: reverse charge, intra-community supplies, exports, VAT-exempt supplies and small businesses under section 19 of the German VAT Act (§ 19 UStG). For 0 % lines you set the tax category through the code of the VAT rate; missing details such as the customer's VAT ID are reported before the e-invoice is created. Already on the draft, the invoice card shows which tax cases the e-invoice will state - per VAT rate with its notice and lines.
- Official validation, locally: the KoSIT validator of the German Coordination Office for IT Standards checks every XRechnung and the data inside the ZUGFeRD PDF; Mustang (Mustangproject), the established open-source library for ZUGFeRD/Factur-X, additionally checks the complete PDF. The validation report is stored with the invoice, and errors point to the missing master data.
- No invalid invoice by accident: if an e-invoice is invalid according to its validation report, or missing, the invoice card and the email form show a clear notice; mass sending skips such invoices with a message.
- Issued means issued: validated e-invoices stay unchanged, even where Dolibarr would regenerate the document by itself, for example on a payment recorded through an interface. They are regenerated only when you explicitly ask for it.
- For public authorities, retail and proof of service: Leitweg-ID (the routing ID German public authorities require) and official project number, GLN and GTIN for retail chains and EDI, the customer's order number, and attachments such as proof of service embedded in the e-invoice.
- Self-billing: self-billed invoices to suppliers under § 14 (2) sentence 5 UStG (e.g. commission statements) as XRechnung or ZUGFeRD - with a marker on the supplier invoice, an own number range, the self-billing agreement on the third party and buttons for self-billed invoice, cancellation and correction by self-billing. With our module DATEV-Export, the number of the Gutschrift goes into Belegfeld 1 (document field 1).
- With a comprehensive handbook: the Handbuch E-Rechnung Export (PDF, 30 pages, in German) explains everything in detail - daily use, every setting and its effect, and the special VAT cases, with a cheat sheet for accounting.
Implementing the German Ministry of Finance letters on e-invoicing
The module implements the requirements of the letters of the German Federal Ministry of Finance (BMF) of 15 Oct 2024 (BStBl I p. 1320), 15 Oct 2025 and 15 Oct 2026 on mandatory e-invoicing, in particular:
- Mandatory items in the structured part following the mapping table of KoSIT and FeRD (recommendations on mandatory items, part I) that the BMF recommends.
- Date and period of supply in the data fields of the e-invoice, not only in the text; by setting the invoice date counts as date of supply, a period of supply replaces it.
- Final invoices: every deducted deposit with number, date, net amount and VAT per rate, also deposits used as a payment. Situation invoices (progress billing in construction) deduct the earlier situations and credit notes of the cycle; a retained warranty is stated with amount and due date in the payment terms.
- Deposit invoices carry the date of payment instead of an invented date of supply.
- Corrections: credit notes and replacement invoices as e-invoices with a correction type and a reference to the original invoice. A credit note without original invoice is reported, saying when it is enough (later bonus or rebate, § 17 UStG).
- Self-billed invoices: the mandatory word „Gutschrift“ and the date of the agreement in every self-billed invoice; none can be created without a prior agreement; an invoice issued by the supplier can be corrected by self-billing, referring to its invoice number. Deposit self-billed invoices are deducted in the final self-billed invoice and listed with number, date, net amount and VAT, also partly or used as a credit.
- Agreed price reductions (bonus, rebate) as a general hint per customer or as default; cash discount in structured form.
- VAT exemptions with their legal basis: the reason from the VAT dictionary (e.g. "Steuerfreie Heilbehandlung (§ 4 Nr. 14 UStG)"), intra-community supplies with their legal basis, reverse charge with the required wording "Steuerschuldnerschaft des Leistungsempfängers" (naming § 13b UStG only between two German businesses).
- Tax notices in the readable part too: the readable PDF (ZUGFeRD invoice, PDF with the XRechnung) shows the notices on exemption, reverse charge, intra-community supply and export in the same wording as the XML data, also when the invoice note lacks them - with every invoice template.
- E-invoice duty from 2027: a notice on the invoice card, on validation and in the e-mail form when a recognisably domestic business customer gets no e-invoice above 250 EUR; a switch for the transition rule of small businesses (duty only from 2028).
- Retention (§ 14b UStG): an issued e-invoice stays unchanged. Regenerated on purpose, the previous version is kept with its validation report; if it was sent, the notice says whether the new version is enough or a replacement invoice or credit note is needed.
- Validation before sending: the KoSIT validator checks format and business-rule errors as meant by the BMF letters; beforehand the module reports missing items such as a line without name, a missing street or the seller's e-mail address.
- Description of the supply and attachments: every line with name and description in the structured part; supporting documents embedded instead of linked.
Not implemented are special cases that standard Dolibarr does not support: travel services (§ 25 UStG), the margin scheme (§ 25a UStG), intra-community triangulation (§ 25b UStG) and fiscal representation (§ 22c UStG). The standard itself sets one more limit: supplies outside the scope of VAT (e.g. services to customers outside the EU) cannot be mixed with other tax categories in one e-invoice; the module reports this before generating.
How it works
- Set up: enable the formats, choose the default template, install the validation tools with one click.
- Validate the invoice: on validation the e-invoice is created - optionally only then, so editing a draft stays smooth - and checked right away.
- Send: in the email form the e-invoice and, if you like, the readable PDF are already attached, also in mass sending.
- Filing: e-invoice, PDF and validation report are stored with the invoice under its linked files.
Legal certainty and data protection
E-invoicing obligation in Germany: since 2025, businesses in Germany must be able to receive e-invoices. From 2027, businesses with a prior-year turnover above 800,000 euros must issue e-invoices, from 2028 all businesses (with exceptions, e.g. for small-amount invoices). Your customers have to check incoming invoices, and a faulty e-invoice can delay payment or put their input VAT deduction at risk. Checking your invoices before sending them saves queries.
What the module does not do: validation covers the formal correctness of an e-invoice, not its content. Invoices are sent by email from Dolibarr; transmission via Peppol or uploading to the invoice portals of public authorities is not included - you upload the generated file there yourself.
GDPR-compliant: all checks run locally on the Dolibarr server, without any data being transferred to third parties. Therefore no data processing agreement under the GDPR is required, as it would be with external validation services.
Supported languages in the user interface: German, English
Supported output formats: XRechnung 3.0.2 (UBL), ZUGFeRD/Factur-X profile EN 16931 (PDF/A-3 with embedded XML)
Requirements
Tested with Dolibarr 20 to 24 and PHP 7.4 to 8.5.
Please note: due to their size, the two validation tools are not included in the module (together almost 100 MB; uploading the module to Dolibarr would fail because of the size limit):
- KoSIT validator with the XRechnung configuration - official validator of the German Coordination Office for IT Standards (KoSIT), Apache License 2.0
- Mustang CLI (Mustangproject) - validation of the complete ZUGFeRD PDF, Apache License 2.0
After installing our module, both tools can be downloaded and installed with one click on the module's setup page - directly from their official GitHub repositories. Only a file matching the published checksum is installed; the setup page shows for each tool whether it matches the official release.
Validation requires Java on the Dolibarr server, Java 17 (LTS) or newer. XRechnung and ZUGFeRD are created without Java as well, then without validation. Note: with our hosting offer at DoliCenter, Java is available by default for all installations hosted with us.
An internet connection is needed once to install the tools. All checks then run locally on the Dolibarr server.
Tools shared with the E-Invoice Import module: if you also use our module E-Invoice Import, both modules share the same KoSIT and Mustang installation - no second download.
Included
With the purchase of the module you receive:
- A ZIP file for download and self-installation
- The handbook "Handbuch E-Rechnung Export" (PDF, in German)
- Updates within one year after purchase (downloadable in the Dolistore)
Please note, NOT included are:
- Installation and setup in your system
- Training and answering general user questions
- Individual customizations and extensions
If you are interested, we will be happy to provide you with a quote.
Documentation & Demo
A comprehensive description of the module and its setup (in German) can be found here: https://www.dolicenter.com/xrechnung-export
We have made the module available in our Dolibarr demo instance https://demo.portal.dolicenter.com so that it can be tested extensively before purchase.
|

|
|

|
|

|
| |
|
End ERP chaos. Automate manual processes. Your installation becomes a productivity machine.
|
|
Preferred Partner with experience. We actively shape the project and deliver solutions that work.
|
|