ExportZugferd - Dolibarr Modul

Dolibarr-Modul zum Export von Kundenrechnungen im ZUGFeRD/Factur-X und XRechnung Format.

Beschreibung

Dieses Modul ermöglicht den automatischen Export von Kundenrechnungen im standardisierten elektronischen Rechnungsformat:

• ZUGFeRD 2.1 / Factur-X - Hybrides PDF/XML-Format
• XRechnung 3.0 - Deutscher Standard für Behördenrechnungen
• EN16931 - Europäische Norm für elektronische Rechnungen

Funktionen

• Automatische XML-Generierung bei PDF-Erstellung
• XML-Einbettung in PDF (echtes ZUGFeRD-PDF)
• Manuelle XML-Generierung über Rechnungsansicht
• Vorschau der generierten XML
• Automatisches Anhängen an E-Mails
• Unterstützung für ODT-Templates mit PDF-Konvertierung

Installation

1. Modul-Ordner nach htdocs/custom/exportzugferd kopieren
2. In Dolibarr: Einstellungen > Module > ExportZugferd aktivieren
3. Modul-Einstellungen konfigurieren

Konfiguration

Einstellungen (Einstellungen > Module > ExportZugferd > Einstellungen)

Option	Beschreibung
Profil	ZUGFeRD-Profil (EN16931 empfohlen)
Auto-Generierung	XML automatisch bei PDF-Erstellung generieren
In PDF einbetten	XML in das PDF einbetten (ZUGFeRD-konform)
XML nach Einbettung löschen	Separate XML-Datei nach Einbettung entfernen
An E-Mail anhängen	XML automatisch an Rechnungs-E-Mails anhängen

Unterstützte Profile

• MINIMUM - Minimale Rechnungsdaten (nur Archivierung)
• BASIC - Grundlegende strukturierte Rechnungsdaten
• EN16931 - Vollständige EU-konforme Rechnung (empfohlen)
• XRECHNUNG - Deutsche Behördenrechnung

Systemvoraussetzungen

• Dolibarr >= 15.0
• PHP >= 7.4
• TCPDF (in Dolibarr enthalten)
• TCPDI (in Dolibarr enthalten)
• LibreOffice (für ODT zu PDF Konvertierung)

Verwendung

Automatische Generierung

Wenn "Auto-Generierung" aktiviert ist, wird bei jeder PDF-Erstellung einer Kundenrechnung automatisch die ZUGFeRD-XML generiert und optional ins PDF eingebettet.

Manuelle Generierung

In der Rechnungsansicht wird eine ZUGFeRD-Zeile angezeigt mit folgenden Aktionen:

• XML generieren/neu generieren
• XML herunterladen
• XML-Vorschau anzeigen

Technische Details

Generierte XML-Struktur

Das Modul generiert CrossIndustryInvoice-XML nach dem UN/CEFACT CII Standard:

<rsm:CrossIndustryInvoice>
  <rsm:ExchangedDocumentContext>...</rsm:ExchangedDocumentContext>
  <rsm:ExchangedDocument>...</rsm:ExchangedDocument>
  <rsm:SupplyChainTradeTransaction>...</rsm:SupplyChainTradeTransaction>
</rsm:CrossIndustryInvoice>

Dateiablage

• XML-Dateien: documents/facture/{ref}/factur-x.xml
• XRechnung: documents/facture/{ref}/xrechnung-{ref}.xml

Hooks

Das Modul nutzt folgende Dolibarr-Hooks:

• afterPDFCreation - Nach PDF-Generierung
• afterODTCreation - Nach ODT-Generierung (mit PDF-Konvertierung)
• formObjectOptions - Anzeige in Rechnungsansicht

Lizenz

GPL v3 - siehe LICENSE

Autor

Data IT Solution

• E-Mail: data@data-it-solution.de
• Web: https://data-it-solution.de

Changelog

Siehe CHANGELOG.md