# 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)