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 – 24.0 (getestet auf 24.0.0)
• PHP 7.4 – 8.5
• Keine externen API-Aufrufe, keine Cloud-Abhängigkeit
• Mitgelieferte Bibliothek: atgp/factur-x v3.3 für PDF/A-3-Einbettung

## Deutsch (DE)

### Version 1.1.2
- **KoSIT XRechnung 3.0 & EN16931 Konformitäts-Update**:
  - `BR-DE-21`: Aktualisierung der Spezifikationskennung (`BT-24`) auf die offizielle aktuelle KoSIT-Kennung `urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0`.
  - `PEPPOL-EN16931-R120`: Präzise Berechnung des Netto-Einzelpreises (`BT-146`) bei Zeilenrabatten (`total_ht / qty`), sodass Einzelpreis × Menge mathematisch exakt mit dem Positionsnettobetrag übereinstimmt.
  - `BR-DE-TMP-32` & `BR-FX-EN-04`: Automatische Bereitstellung des Liefer- und Leistungsdatums (`BT-72` / BG-14) in UBL (`cac:Delivery/cbc:ActualDeliveryDate`) und CII (`ram:ApplicableHeaderTradeDelivery/ram:ActualDeliverySupplyChainEvent`), abgeleitet aus Leistungsdatum, Lieferdatum oder Rechnungsdatum.
  - `PEPPOL-EN16931-R008` & `FX-SCH-A-000372`: Vollständige Beseitigung leerer XML-Elemente.
- **Behebung der XML-Einbettung im PDF/A-3-Container**:
  - Automatische Erstellung des Basis-PDFs, falls dieses zum Zeitpunkt des Triggers oder der Freigabe noch nicht im Dateisystem existiert.
  - ZUGFeRD-Kompatibilität maximiert: Im ZUGFeRD-Modus werden nun standardkonform sowohl `factur-x.xml` als auch `zugferd-invoice.xml` im PDF/A-3-Container eingebettet, wodurch sowohl internationale Factur-X-Reader als auch deutsche ZUGFeRD-Validatoren (z. B. Mustang, ZUV) die Datei fehlerfrei erkennen.
  - Vollständige Integration des Hooks `afterPDFCreation` (Kontext `pdfgeneration`): Beim manuellen oder automatischen Neugenerieren von Rechnungs-PDFs auf der Rechnungskarte wird das XML sofort zuverlässig erneut eingebettet.
  - Auf der Moduleinrichtungsseite (`admin/setup.php`) führt der Test-Erzeugen-Button nun auch die vollständige PDF/A-3-Einbettung inklusive Statusmeldung durch.
  - End-to-End per Playwright im Browser geprüft und validiert (0 Validierungsfehler / 0 Warnungen).

### Version 1.1.1
- **Neu: Automatisches Anhängen beim E-Mail-Versand**:
  - Die erzeugte E-Rechnung (X-Rechnung XML bzw. ZUGFeRD XML) wird beim Öffnen der Maske „E-Mail versenden“ automatisch als Anhang vorausgewählt (über Hook in FormMail).
  - Neue Option: Das Haupt-PDF der Rechnung wird bei Factur-X/ZUGFeRD automatisch durch das hybride PDF/A-3 ersetzt (`ERECHNUNG_REPLACE_PDF`), sodass beim normalen PDF-Versand und -Download immer die gültige E-Rechnung vorliegt.
  - Beide Optionen können in der Modul-Einrichtung individuell aktiviert/deaktiviert werden.
- **Kompatibilität mit Dolibarr 24.0.0 & PHP 8.5**:
  - Vollständige Freigabe und automatisierte Tests für Dolibarr 24.0.0 und die neueste PHP-Version 8.5 (v8.5.8).
  - Beseitigung aller PHP 8.5-Deprecations (strikte Typisierungen, deklarierte Klassen-Properties, sichere Typkonvertierungen).
- **Stabilität & Fehlerbehebungen**:
  - Robuste Einbindung von `main.inc.php`, `admin.lib.php` und `files.lib.php` in der Administrationsoberfläche zur Vermeidung von Namensraum- und Typkonflikten.
  - Korrektur der Parameterübergabe beim Lieferantenrechnungs-Import (`addline`), wodurch Mengen, Einzelpreise und Steuerbeträge mathematisch exakt übernommen werden.
  - Verbesserte Fallback-Routinen für Unternehmensstammdaten, USt-IdNr. und Währungsangaben.

### Version 1.1.0
- **Dolibarr 24.0.0 & PHP 8.5 Kompatibilität**:
  - Volle Unterstützung und Freigabe für Dolibarr 24.0.0.
  - Vollständige Kompatibilität mit PHP 8.5 (getestet unter PHP 8.5.8).
  - Bereinigung von Deprecation-Meldungen: Deklaration aller Klassen-Eigenschaften (u. a. `$license` in `modERechnung`), strikte Typisierungen und sichere Typkonvertierungen.
- **Optimierung des Lieferantenrechnungs-Imports**:
  - Korrektur der Parameterübergabe an `FactureFournisseur::addline`: Mengen, Einzelpreise und Steueranteile werden beim Import von UBL- und CII-Dateien präzise übernommen.
  - Erweiterte Erkennung von Lieferanten über USt-IdNr., Steuernummer oder Firmenname.
- **Erweiterte Validierung & Stabilität**:
  - Sichere Null-Prüfungen in der EN16931-Plausibilitätsprüfung (DOM-Knoten und Steuersubsummen).
  - Verbesserte Fallback-Routinen für Unternehmensstammdaten, Käufer-Metadaten und Standardwährungen.

### Version 1.0.0
- **Erstveröffentlichung (Initial Release)**:
  - Vollständige Erzeugung von **XRechnung 3.0 (UBL 2.1)** für Rechnungen und Gutschriften nach aktuellem B2G-Standard.
  - Vollständige Erzeugung von **ZUGFeRD 2.5 / Factur-X 1.09 (UN/CEFACT CII)** als hybrider PDF/A-3-Container.
  - Automatische Generierung beim Freigeben von Kundenrechnungen (`BILL_VALIDATE`).
  - 100 % lokale Verarbeitung auf dem eigenen Server – keine Cloud, keine externen Drittanbieter-Dienste.
  - Import-Assistent für Eingangsrechnungen (Lieferantenrechnungen) aus XRechnung- und ZUGFeRD-Dateien inklusive automatischer Zuordnung.
  - Integrierte EN16931-Validierung und Konfigurationsseite mit Test-Erstellungswerkzeug.