data
6e33cc7096
- ZUGFeRD/Factur-X XML-Generierung (EN16931) - XRechnung 3.0 Unterstützung - PDF-Einbettung (echtes ZUGFeRD-PDF) - Option XML nach Einbettung zu löschen - ODT-Template Unterstützung - E-Mail Anhang Funktion - XML-Vorschau Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
106 lines
3.1 KiB
Markdown
106 lines
3.1 KiB
Markdown
# 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:
|
|
|
|
```xml
|
|
<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](LICENSE)
|
|
|
|
## Autor
|
|
|
|
**Data IT Solution**
|
|
- E-Mail: data@data-it-solution.de
|
|
- Web: https://data-it-solution.de
|
|
|
|
## Changelog
|
|
|
|
Siehe [CHANGELOG.md](CHANGELOG.md)
|