Module Basix E-Rechnung fuer Dolibarr
XRechnung
Das Modul Factur-X (module id facturx) erstellt und validiert elektronische Rechnungen aus Kundenrechnungen in Dolibarr. Es unterstützt den deutschen Standard XRechnung sowie das hybride Factur-X / ZUGFeRD-Format und PEPPOL BIS Billing 3.0.
Seit dem 1. Januar 2025 muss jedes Unternehmen in Deutschland elektronische Rechnungen in einem strukturierten Format empfangen können. Eine per E-Mail versendete PDF-Datei erfüllt diese Anforderung nicht. Ab 2027 beginnt die Pflicht zur Versendung strukturierter Rechnungen für Unternehmen oberhalb eines festgelegten Jahresumsatzes, ab 2028 gilt sie für alle Unternehmen. Öffentliche Auftraggeber in Deutschland verlangen die XRechnung bereits seit mehreren Jahren.
Dieses Modul unterstützt den Rechnungsversand: Es wandelt eine bereits in Dolibarr vorhandene Rechnung in ein konformes XML-Dokument um, das entweder in die PDF-Datei eingebettet oder als separate Datei geschrieben wird.
Modulinformationen
| Item | Value |
|---|---|
| Modulname | Factur-X / ZUGFeRD / XRechnung / PEPPOL |
| Modul-ID | facturx
|
| Bearbeiter | Basix IT GmbH, Hamburg, Deutschland |
| Lizenz | GPL-3.0 |
| Support | info@basix.de, +49 40 3990 2030 |
Kompatibilität
| Component | Requirement |
|---|---|
| Dolibarr | Mit 23.0.x im Produktivbetrieb getestet |
| PHP | 7.4 oder höher |
| Rechnungsmodul | Muss aktiviert sein |
| Java und Saxon | Optional. Wird für die Schematron-Validierung benötigt. Ohne diese Komponenten verwendet das Modul ersatzweise ausschließlich die XSD-Validierung. |
Der tatsächlich verwendete Validierungsmodus wird auf der Moduleinstellungsseite als FACTURX_Validation_EffectiveMode angezeigt.
Unterstützte Formate und Profile
Das Ausgabeprofil wird in den Moduleinstellungen ausgewählt:
- Basic (Factur-X / ZUGFeRD)
- Extended (Factur-X / ZUGFeRD)
- XRechnung CII (Cross Industry Invoice Syntax)
- XRechnung UBL (Universal Business Language Syntax)
- PEPPOL BIS Billing 3.0
Alle Profile folgen dem europäischen semantischen Standard EN 16931.
XRechnungen können entweder in der CII- oder in der UBL-Syntax erstellt werden. Beide Varianten werden von deutschen öffentlichen Auftraggebern akzeptiert. Welche Variante verwendet werden soll, wird normalerweise vom Rechnungsempfänger vorgegeben.
Installation
Das Modul wird wie jedes andere externe Dolibarr-Modul installiert:
- Modularchiv herunterladen.
- Öffne zuerst Setup dann Modules/Applications und anschließend Deploy/install external app/module.
- Archiv hochladen und bestätigen.
- Das Modul in der Modulliste aktivieren.
Konfiguration
Die Einstellungsseite ist über die Modulliste erreichbar. Sie ist in die folgenden Bereiche gegliedert.
XML-Erstellung
- Profil: das Ausgabeprofil, siehe oben.
- Automatische Erstellung: Wenn aktiviert, wird das XML erstellt, sobald eine Rechnung validiert wird. Wenn deaktiviert, muss die Erstellung manuell ausgelöst werden.
XRechnung-spezifisch
XRechnung erfordert Kontaktdaten der für die Rechnung verantwortlichen Person. Diese werden einmalig eingetragen und für alle ausgehenden Dokumente verwendet:
- Geschäftsprozess-ID
- Ansprechpartner: Name, Abteilung, Telefon, E-Mail
Identifikation des Verkäufers
- Elektronische Adresse und deren Scheme-Identifier
- Globale Identifikationsnummer und deren Scheme-Identifier
Diese Felder enthalten die von PEPPOL und öffentlichen Rechnungsempfängern verwendeten Identifikatoren.
Rechnungspositionen
- Standardkategorie für umsatzsteuerfreie Positionen
- Standardbefreiungsgrund, der verwendet wird, wenn eine Position keine Umsatzsteuer enthält
Erweitert
- Vorabprüfung: Validiert die Rechnungsdaten, bevor das XML geschrieben wird, damit Probleme frühzeitig erkannt werden.
- XML validieren: Prüft das erstellte Dokument gegen das entsprechende Schema.
- XML-Ausgabe trotz Validierungsfehler: Schreibt die Datei auch dann, wenn die Validierung fehlschlägt. Dies ist während der Einrichtung hilfreich, sollte im Produktivbetrieb jedoch normalerweise deaktiviert sein.
- XML einbetten: Bettet das XML in die PDF-Datei ein und erzeugt ein hybrides PDF/A-3-Dokument. Wenn deaktiviert, wird das XML als separate Datei geschrieben.
- Logo einbetten
- Benutzerdefinierter Rechnungstyp
Käuferreferenz und Leitweg-ID
Deutsche öffentliche Auftraggeber benötigen eine Routing-Kennung, die sogenannte Leitweg-ID, die im Feld für die Käuferreferenz (BT-10) übertragen werden muss.
Das Modul ergänzt beim Datensatz des Geschäftspartners das zusätzliche Feld facturx_buyer_reference. Der Wert wird einmal pro Kunde gepflegt und bei jeder für diesen Kunden ausgestellten Rechnung eingetragen. Dies entspricht der praktischen Verwendung des Identifikators: Er gehört zum empfangenden Auftraggeber und nicht zur einzelnen Rechnung.
Tägliche Verwendung
- Kundenrechnung wie gewohnt in Dolibarr erstellen.
- Die Rechnung validieren. Bei aktivierter automatischer Erstellung wird das XML zu diesem Zeitpunkt erstellt und an das Rechnungsdokument angehängt.
- Die erstellte Datei erscheint in den Dokumenten der Rechnung und kann an den Empfänger gesendet werden.
Wenn die Validierung des erstellten Dokuments fehlschlägt, meldet das Modul die fehlerhaften Regeln. Abhängig von der oben beschriebenen Einstellung wird die Datei entweder nicht erstellt oder trotzdem geschrieben.
Validierung
Die Validierung erfolgt auf zwei Ebenen:
- Schema: Das Dokument wird gegen das XSD-Schema des ausgewählten Profils geprüft.
- Schematron: Die semantischen Regeln von EN 16931 werden geprüft. Dies umfasst Pflichtfelder und die rechnerische Konsistenz, beispielsweise ob Positionssummen, Steuerbeträge und der Gesamtbetrag korrekt miteinander übereinstimmen.