XRechnung und ZUGFeRD

XRechnung und ZUGFeRD sind digitale Rechnungsformate, welche in der Praxis als XML-Dateien oder PDFs mit eingebetteten XML-Daten verschickt werden.

Seit MärzMärz 2026 bilden in Deutschland bei hybriden E-Rechnungen die im strukturierten Teil (XML) vorliegenden Rechnungsdaten den führendenführenden Teil.
Aufgrunddessen werden ZUGFeRD Belege seit Version 2.30 automatisch im strikten Modus verarbeitet (siehe Strict Mode)

Validierung von digitalen Rechnungen

Nicht alle digitalen Rechnungen, die Sie erhalten erfüllenerfüllen die öffentlichenöffentlichen Standards. In der Praxis kann es daher passieren, dass Lieferanten digitale Rechnungen senden, die nicht durch Squeeze verarbeitet werden, weil die Dateien nicht valide sind.

Eine digitale Rechnung ist valide, wenn sie diese zwei Kriterien erfüllt:erfüllt:

- Die Datei (i. d. R. XML) ist korrekt formatiert. Sie enthältenthält also gültigesgültiges XML
- Die fachlichen Kriterien an eine EN-16931 + Extension XML sind erfüllt.erfüllt. Beispiel: Die Rechnung enthältenthält eine gültigegültige Kombination aus Netto-, Steuer- und Brutto-Beträgen.Beträgen.

In der Validierung (UI) weist ein Icon darauf hin, dass ein Dokument als XRechnung verarbeitet wurde.

Validatoren

Hier ein Liste von Validatoren, mit denen Sie prüfenprüfen können,können, ob eine digitale Rechnung valide ist:

• https://erechnungsvalidator.service-bw.de/
• https://validator.invoice-portal.de/
• https://ecosio.com/en/peppol-and-xml-document-validator/
• https://peppol.munich-enterprise.com/xrechnung/
• https://www.zugferd-community.net/de/dashboard/validation (Speziell auch alle ZugFERD Varianten)

Extraktion

Schritt	Aktuelle Pipeline
Extraktion	ÜblicheÜbliche Extraktionsmechanismen werden ausgeführtausgeführt oder übersprungenübersprungen durch die Stapelklasseneigenschaft: SkipXmlExtraction. intermediate.xml wird genutzt, um Kreditor und Mandant der XML zu ermitteln. Die eigentliche XML-Extraktion basiert auf der intermediate.xml.

Konfiguration von XML-Auswertungen

Ab der Version 2.13 und nach Freischaltung durch Dexpro oder einen der Partner, könnenkönnen Sie in die Extraktion von XML-Werten bei EN16931 konformen XML-Dokumenten eingreifen.

• Konfiguration von XML-Auswertungen

Siehe auch XRechnung und ZUGFeRD Auswertungstabellen

PDF-Rendering

Das PDF-Rendering fürfür XRechnung und ZUGFeRD hat sich ebenfalls geändert:geändert:

• EN-16931 konforme XML-Dokumente: FürFür standardisierte XML-Dokumente wie XRechnung und ZUGFeRD wird eine PDF aus dem Zwischenformat erstellt, das im InitStep generiert wurde. Dieses Zwischenformat basiert auf der intermediate.xml und wird genutzt, um alle relevanten Daten in einer übersichtlichenübersichtlichen PDF-Darstellung zu präsentieren.präsentieren.

In der zukünftigenzukünftigen Version von Squeeze wird die vollständigevollständige UnterstützungUnterstützung fürfür die PDF-Erzeugung von nicht EN16931-konformen XML-Dokumenten implementiert. Dies wird die FlexibilitätFlexibilität und Integration fürfür benutzerdefinierte XML-Formate weiter verbessern.

XML-PrüfberichtPrüfbericht KoSIT

Ab Version 2.15 von Squeeze bietet unsere Squeeze-LösungenLösungen die Möglichkeit,Möglichkeit, automatisch PrüfberichtePrüfberichte fürfür verarbeitete ZUGFeRD und XRechnung-Daten zu erstellen. Diese Berichte entsprechen den KoSIT-Standards und gewährleistengewährleisten die Datenqualität.Datenqualität. WährendWährend bei XRechnungen eine strikte FehlerprüfungFehlerprüfung erfolgt, um die DatenintegritätDatenintegrität zu schützen,schützen, bietet das System fürfür ZUGFeRD-Belege eine größeregrößere Flexibilität.Flexibilität. Dies ermöglichtermöglicht eine individuelle Anpassung der Verarbeitungsprozesse an die spezifischen Anforderungen der Kunden.

Die Aktivierung der FunktionalitätFunktionalität erfolgt durch unsere Partner oder unserer Berater. Den KoSIT Prüfbericht,Prüfbericht, könnenkönnen Sie  sich in der Validierung des Dokumentes anzeigen lassen oder direkt überüber das Kontext-MenüMenü in der Validierung herunterladen.

_{ValidierungsoberflächeValidierungsoberfläche}

UmschlüsselungUmschlüsselung von Codes in Werte

Ab der Version 2.16 ist es möglich,möglich, Codes die in elektronischen Belegen genutzt werden in eigene Werte umzuschlüsseln.umzuschlüsseln. Solche Codes werden z.B. verwendet um Mengeneinheiten festzulegen, SteuerfälleSteuerfälle zu definieren oder auch um den Vorgang festzulegen.

Hier die Anleitung, wie die UmschlüsselungUmschlüsselung der Codes aus elektronischen Belegen konfiguriert werden kann.

ZUGFeRD Strict Mode

Seit Version 2.30 (April 2026)

Laut gesetzlicher Verarbeitungsvorschrift bilden nunmehr die im strukturierten Teil (XML) vorliegenden Rechnungsdaten den führendenführenden Teil. Weitere Informationen im FAQ des Bundesfinanzministerium.

Der strikte Modus hat folgende Auswirkungen auf die Verarbeitung von ZUGFeRD VorgängenVorgängen in SQUEEZE:

E-Mail Anhang Filterung

Anlagenfilter werden zugunsten der XML Verarbeitung übersteuert.übersteuert.
Bestehende Filter, welche PDFs bevorzugen, werden demnach beim E-Mail Import übersteuert,übersteuert, sodass das XML bevorzugt verarbeitet wird.
Dieses Verhalten wird geloggt, um eine nachvollziehbare Verarbeitung zu gewährleisten.gewährleisten.
ZusätzlichZusätzlich gibt es eine SystemprüfungSystemprüfung, mit der eine eventuelle Fehlkonfiguration überprüftüberprüft werden kann.

Automatische Validierungsreport Generierung

In dem strikten Modus wird die Generierung eines Validerungsreports der XML forciert (ausgenommen Windows Systeme).
Wenn die Generierung des Reports nicht gewünschtgewünscht ist, muss der gesamte Strict Mode deaktiviert werden.

Original PDF als Anhang - Generierung Visualisierung

Die originale PDF Datei wird bei der Verarbeitung in den Anhang verschoben.

Zur Visualisierung wird wie bei xRechnungen eine Visualisierung der XML Rechnungsdaten als PDF erzeugt, dessen Basis die verarbeitete XML ist.
Damit soll sichergestellt werden, dass ausschließlichausschließlich die XML Daten angezeigt werden.
Dadurch treten keine fehlerhafte Diskrepanzen zwischen XML und PDF desselben Vorgangs auf.

ÜberspringenÜberspringen der XML Extraktion (SkipXmlExtraction)

Diese Eigenschaft wird durch den Strict Mode übersteuertübersteuert (und auch geloggt).
Die XML Verarbeitung wird forciert, auch wenn die Eigenschaft SkipXmlExtraction aktiviert ist.

Generische XMLs

Der ZUGFeRD strict mode findet KEINE Anwendung bei generischen XML Typen.

Bei generischen XML VorgängenVorgängen (nicht ZUGFeRD oder xRechnung) greifen die Auswirkungen des Strict Mode nicht, selbst wenn dieser fürfür die Stapelklasse aktiviert wurde.

Generierte PDF als Anhang bei StrictMode=Off

Mit der Squeeze Version 2.32 (Juni 2026) wurde die FunktionalitätFunktionalität erweitert und es wird jetzt immer eine Visualisierung generiert. 

Die Visualisierung wird ab Version 2.30 im Input Verzeichnis des Tenants generiert, wenn die Stapelklassen - Eigenschaft "ZUGFeRDStrictMode" den Wert "Ja" aufweist.
Mit EinführungEinführung der Version 2.32 kann die Visualisierung im Attachment Verzeichnis des Tenants generiert werden, wenn die Stapelklassen - Eigenschaft ZUGFeRDStrictMode den Wert "Nein" zugewiesen bekommt.

Dadurch gibt es die MöglichkeitMöglichkeit jederzeit die in der XML-Datei enthaltenen Werte zu überprüfen.überprüfen. 

ZUGFeRD 2.5 / Factur-X 1.09

Seit Version 2.33 (Juli 2026)

Am 01.07.2026 wurde die neue Version ZUGFeRD 2.5 veröffentlicht.veröffentlicht. ZUGFeRD 2.5 entspricht dabei Factur-X 1.09.

Die Leitweg-/Guideline-URNs sind identisch zu ZUGFeRD 2.4. Bereits verarbeitete Belege oder bestehende Konfigurationen (z. B. XML-Auswertungen, Umschlüsselungen)Umschlüsselungen) sind von dem Update nicht betroffen und benötigenbenötigen keine Anpassung.

Folgendes wurde fürfür ZUGFeRD 2.5 / Factur-X 1.09 aktualisiert:

- Neue XSD-Schemata und Schematron-Regeln fürfür alledie folgenden Profile  (MINIMUM,

• MINIMUM
• BASIC WL,WL
BASIC,
• BASIC
• EN16931/Comfort,Comfort
EXTENDED)
-
• EXTENDED

Der KoSIT-Validator wurde aktualisiert und erkennt entsprechende Belege im PrüfberichtPrüfbericht nun als „„ZUGFeRD 2.5/Factur-X 1.09" (vorher z. B. „„ZUGFeRD 2.4/Factur-X 1.08")
-

Abwärtskompatibilität

Abwärtskompatibilität zu allen vorherigen ZUGFeRD-Versionen (1.0 bis 2.4) bleibt vollständigvollständig bestehen

Eine ÜbersichtÜbersicht aller aktuell unterstütztenunterstützten Versionen finden Sie unter XML Formate in Squeeze.

Nicht rückwärtskompatible Änderung: TransformResult::getDetectedType() gibt jetzt InvoiceFormat (enum) Werte (bspw. "zugferd_1p0") statt strings zurück