E-Rechnung: X-Rechnung 3.0, ZUGFeRD & Factur-X

Strukturierte E-Rechnung für Dolibarr — 100 % lokal

Dieses Modul ergänzt Dolibarr um normkonforme elektronische Rechnungen nach EN16931 — für B2B und B2G (öffentliche Auftraggeber). Alle Verarbeitungsschritte laufen ausschließlich auf Ihrem eigenen Server. Es werden keine Daten an externe Dienste übertragen und keine Cloud-Abonnements benötigt.

Exportformate

• X-Rechnung 3.0 (UBL 2.1) — Rechnung und Gutschrift im Format, das für Rechnungen an Bundesbehörden vorgeschrieben ist.
• ZUGFeRD / Factur-X (UN/CEFACT CII) — Strukturiertes XML, das mithilfe der mitgelieferten Bibliothek atgp/factur-x v3.3 als echtes PDF/A-3-Hybrid in die Rechnungs-PDF eingebettet wird. Empfänger erhalten in einer Datei sowohl ein lesbares PDF als auch ein maschinenlesbares XML.

Automatische Erzeugung bei Rechnungsfreigabe

Beim Freigeben (Validieren) einer Rechnung in Dolibarr erzeugt das Modul automatisch das XML und hängt es an das Dokument an. Der Trigger arbeitet mit Soft-Fail: Schlägt die Erzeugung fehl, läuft Dolibarr normal weiter und protokolliert den Fehler, ohne den Freigabe-Workflow zu blockieren.

Import von Lieferantenrechnungen

Laden Sie eine UBL-2.1- oder CII-XML-Datei hoch; das Modul legt automatisch einen Lieferantenrechnungs-Entwurf in Dolibarr an. Der Lieferant wird anhand der USt-IdNr. oder des Firmennamens abgeglichen; wird kein Treffer gefunden, wird ein neuer Datensatz automatisch angelegt. Positionen werden ohne manuelle Nacherfassung übernommen.

Integrierte EN16931-Plausibilitätsprüfung

Vor Erzeugung oder Import führt das Modul eine native PHP-Prüfung durch, die die EN16931-Pflichtfeld-Regeln (BR-*-Serie) und die arithmetischen Konsistenzregeln (BR-CO-*-Serie) abdeckt. Das Ergebnis wird als Fehler- und Warnungsliste direkt in der Dolibarr-Oberfläche angezeigt.

Hinweis zur Reichweite: Es handelt sich um eine Kernregel-Plausibilitätsprüfung in nativem PHP. Sie entspricht nicht der offiziellen KoSIT-Schematron-/Saxon-XSLT-2.0-Validierungssuite und ist nicht behördlich zertifiziert. Für Einreichungen, die eine KoSIT-zertifizierte Vorvalidierung erfordern, ist der offizielle KoSIT Validator separat zu verwenden.

Leitweg-ID für Behördenrechnungen (B2G)

Ein eigenes Extrafeld (BT-10, Leitweg-ID) wird bei der Modulinstallation automatisch im Kundenstamm angelegt. Nach einmaliger Pflege je Behördenkunde wird die Leitweg-ID in jede ausgehende X-Rechnung übernommen — ohne manuelle Eingabe je Rechnung.

Konfiguration

• Profilauswahl (X-Rechnung 3.0 UBL / ZUGFeRD EN16931 / Factur-X EN16931)
• Automatische Erzeugung bei Rechnungsfreigabe: ein/aus
• PDF/A-3-Einbettung: ein/aus
• EN16931-Plausibilitätsprüfung: ein/aus
• Optionale Factur-X-XSD-Schemaprüfung
• Test-Erzeugung direkt auf der Einrichtungsseite
• XML-Import-Upload für Lieferantenrechnungen
• Oberfläche auf Deutsch und Englisch

Technische Details

• Lizenz: GPLv3 — Open Source, kein Laufzeit-Lizenzschlüssel
• Dolibarr 18.0 – 23.0 (getestet auf 23.0.3)
• PHP 7.4 – 8.2
• Keine externen API-Aufrufe, keine Cloud-Abhängigkeit
• Mitgelieferte Bibliothek: atgp/factur-x v3.3 für PDF/A-3-Einbettung