Module Basix E-Rechnung fuer Dolibarr: Difference between revisions

Jump to navigation Jump to search

Module Basix E-Rechnung fuer Dolibarr (view source)

Revision as of 10:23, 18 August 2026

2,303 bytes removed ,  2 months ago
Text von der Seite „XRechnung“ überarbeitet und stärker auf das Modul „Module Basix E-Rechnung für Dolibarr“ ausgerichtet.
VisualWikitext
m (Service-Basix moved page XRechnung to Module Basix E-Rechnung fuer Dolibarr)
(Text von der Seite „XRechnung“ überarbeitet und stärker auf das Modul „Module Basix E-Rechnung für Dolibarr“ ausgerichtet.)
Tag: 2017 source edit
Line 1: Line 1:
=XRechnung=
= Basix E-Rechnung für Dolibarr =


Das Modul '''Factur-X''' (module id <code>facturx</code>) 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'''.
{{TemplateDocDev}}


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.
'''Basix E-Rechnung für Dolibarr''' ist eine von der Basix IT GmbH entwickelte und betreute Erweiterung für E-Rechnungsprozesse in Dolibarr. Die technische Modul-ID lautet <code>facturx</code>.


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.
Die Erweiterung wird von Basix im Rahmen eines direkt bei Basix gebuchten und betreuten Dolibarr- beziehungsweise DigiBasiX-Hostings bereitgestellt, eingerichtet und gepflegt. Ein früherer DoliStore-Eintrag ist nicht mehr verfügbar; die aktuelle Bereitstellung erfolgt direkt über Basix beziehungsweise als Bestandteil der betreuten DigiBasiX-Lösung.


__TOC__
'''Weitere Informationen und Anfrage:'''
* [https://digibasix.de/e-rechnung/ E-Rechnung mit DigiBasiX]
* [https://basix.de/e-rechnungen/ E-Rechnungs-Beratung und Umsetzung durch Basix]


==Modulinformationen==
== Informationen ==


{| class="wikitable"
{| class="wikitable"
!Item!!Value
|-
|-
|Modulname||Factur-X / ZUGFeRD / XRechnung / PEPPOL
! Bezeichnung
| Basix E-Rechnung für Dolibarr
|-
|-
|Modul-ID||<code>facturx</code>
! Technische Modul-ID
| <code>facturx</code>
|-
|-
|Bearbeiter||Basix IT GmbH, Hamburg, Deutschland
! Entwickler und Betreuung
| [https://basix.de/ Basix IT GmbH]
|-
|-
|Lizenz||GPL-3.0
! Bereitstellung
| Direkt über Basix im Rahmen eines betreuten Dolibarr-Hostings oder als Bestandteil von DigiBasiX; der frühere DoliStore-Eintrag ist nicht mehr verfügbar
|-
|-
|Support||info@basix.de, +49 40 3990 2030
! Produkt- und Prozessinformationen
|}
| [https://basix.de/e-rechnungen/ E-Rechnungen bei Basix] · [https://digibasix.de/e-rechnung/ E-Rechnung mit DigiBasiX]
 
==Kompatibilität==
 
{| class="wikitable"
!Component!!Requirement
|-
|-
|Dolibarr||Mit 23.0.x im Produktivbetrieb getestet
! Kontakt
| [mailto:info@basix.de info@basix.de] · +49 40 3990 2030
|-
|-
|PHP||7.4 oder höher
! Lizenz
|-
| GPL-3.0 <!-- Vor Veröffentlichung anhand des Quellcodes beziehungsweise der LICENSE-Datei bestätigen. -->
|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 <code>FACTURX_Validation_EffectiveMode</code> angezeigt.
== Unterstützte Formate und Funktionen ==
 
==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.
Die Erweiterung ist für E-Rechnungsprozesse mit Dolibarr vorgesehen. Je nach eingesetzter und getesteter Version können insbesondere XRechnung sowie Factur-X/ZUGFeRD relevant sein.
*'''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==
<!-- Vor Veröffentlichung durch die Entwicklung verbindlich ausfüllen:
* exakte Dolibarr-Versionen;
* unterstützte XRechnungs- und ZUGFeRD-/Factur-X-Versionen und Profile;
* Ausgang, Eingang oder beides;
* Validierung: lokal, extern oder nicht enthalten;
* Peppol: Formatunterstützung oder tatsächlicher Übertragungsweg;
* Voraussetzungen und bekannte Einschränkungen.
Keine Funktion allein aus dem bisherigen Modulnamen ableiten.
-->


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.
== Bereitstellung und Einrichtung ==


Das Modul ergänzt beim Datensatz des Geschäftspartners das zusätzliche Feld <code>facturx_buyer_reference</code>. 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.
Die Erweiterung wird durch Basix innerhalb der betreuten Kundenumgebung bereitgestellt. Basix übernimmt dabei – abhängig vom vereinbarten Leistungsumfang – die Kompatibilitätsprüfung, Installation, Grundkonfiguration, Aktualisierung und technische Betreuung.


==Tägliche Verwendung==
Eine allgemeine Anleitung zum Herunterladen und Hochladen eines Modularchivs ist nicht Bestandteil dieser Seite. Der frühere DoliStore-Eintrag ist nicht mehr verfügbar. Einrichtung, Konfiguration und Pflege erfolgen aktuell direkt durch Basix innerhalb der betreuten Kundenumgebung.


#Kundenrechnung wie gewohnt in Dolibarr erstellen.
Für eine Prüfung der Anforderungen und der eingesetzten Dolibarr-Version stehen die [https://basix.de/e-rechnungen/ E-Rechnungs-Beratung von Basix] und die Produktinformationen zu [https://digibasix.de/e-rechnung/ DigiBasiX E-Rechnung] zur Verfügung.
#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.
== Abgrenzung ==


==Validierung==
XRechnung, ZUGFeRD und Factur-X bezeichnen Standards beziehungsweise Formate. Die Bezeichnung dieser Erweiterung bedeutet nicht, dass sie Bestandteil des Dolibarr-Kerns ist. Der tatsächlich verfügbare Funktionsumfang hängt von der eingesetzten Dolibarr- und Modulversion sowie der vereinbarten Konfiguration ab.


Die Validierung erfolgt auf zwei Ebenen:
Technische Validierung ersetzt keine steuerliche oder rechtliche Prüfung. Betriebliche und rechtliche Anforderungen sollten mit der zuständigen Steuer- oder Rechtsberatung abgestimmt werden.


*'''Schema''': Das Dokument wird gegen das XSD-Schema des ausgewählten Profils geprüft.
== Siehe auch ==
*'''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.


==Siehe auch==
* [[XRechnung]]
* [[Electronic_Billing]]
* [[Dolibarr suppliers Germany]]


*[[Dolibarr suppliers Germany]]
[[Category:Complementary modules]]
[[Category:Billing]]
Retrieved from "https://wiki.dolibarr.org/index.php/Special:MobileDiff/66951"

Navigation menu