XRechnungLeser – E-Rechnung als PDF/A-3

// 01

Was in der PDF steckt

Eine Datei, die das DMS wie jede andere PDF anzeigt, durchsucht und archiviert. Die elektronische Rechnung geht dabei nicht verloren: Sie liegt bytegenau in der PDF.

Sichtfassung nach KoSIT

Die Darstellung stammt unverändert aus der XRechnung-Visualisierung der KoSIT. Käufer, Verkäufer, Beträge, Zahlungsdaten und Positionen stehen dort, wo Sachbearbeiter sie aus anderen Viewern kennen.

Original-XML als Anhang

Die Rechnung liegt als xrechnung.xml in der PDF. Ihre SHA-256-Prüfsumme steht im Prüfvermerk, sodass sich jederzeit nachweisen lässt, dass nichts verändert wurde.

Prüfvermerk

Der KoSIT-Validator prüft gegen XRechnung 3.0.2 und EN 16931. Das Urteil steht auf der letzten Seite, der vollständige Bericht als pruefbericht-kosit.xml im Anhang.

Anlagen der Rechnung

Dateien, die der Rechnungssteller mitschickt (BT-125), etwa Leistungsnachweise, bleiben als eigene Anhänge erhalten und lassen sich im PDF-Reader öffnen.

// 02

Ablauf je Rechnung

Darstellung und Prüfung laufen gleichzeitig. Am Ende steht genau eine Datei im Ausgangsordner, erst wenn sie vollständig geschrieben ist.

ErkennenUBL Invoice, UBL CreditNote und CII werden am Wurzelelement erkannt, aus ZUGFeRD- und Factur-X-PDFs wird die XML herausgelöst. Dateien mit DOCTYPE werden abgelehnt.

Darstellen und prüfenSaxon-HE übersetzt die Rechnung mit den KoSIT-Stylesheets in ein Satzformat. Parallel prüft der KoSIT-Validator die Rechnung.

SetzenApache FOP schreibt die PDF im Modus PDF/A-3b mit eingebetteter Schrift und ohne Ligaturen, damit die Volltextsuche des DMS jedes Wort findet.

// 03

Echte Ausgabe, keine Attrappe

Beide Seiten hat der XRechnungLeser aus Beispielrechnungen der offiziellen KoSIT-Testsuite erzeugt. Die Platzhalter wie „[Seller name]“ stammen aus der Testsuite.

Seite 1 der Sichtfassung: Übersicht mit Käufer, Verkäufer, Rechnungsdaten und Gesamtbeträgen — **Seite 1, Übersicht.** Testfall 01.15a (UBL) mit einer PDF-Anlage.

Prüfvermerk einer abgelehnten Rechnung mit Fehler CII-DT-097 — **Letzte Seite, Prüfvermerk.** Eine CII-Rechnung mit falschem Datumsformat, vom Validator abgelehnt.

Prüfvermerk	Bedeutung	Rückgabewert
gültig	Die Rechnung erfüllt alle Regeln von XRechnung 3.0.2 bzw. EN 16931.	0
nicht gültig	Mindestens eine Regel ist verletzt. Die PDF entsteht trotzdem, mit den Fehlern im Klartext, damit die Rechnung begründet zurückgewiesen werden kann.	2
nicht geprüft	Für das Format gibt es kein Prüfszenario, etwa ZUGFeRD EXTENDED, oder die Prüfung ist abgeschaltet.	0

// 04

Betrieb mit zwei Ordnern

Der Leser beobachtet einen Eingangsordner und legt jede fertige PDF in den Ordner, den das DMS einliest. Gelöscht wird nichts.

Eingang\ E-Rechnungen ablegen ├─ erledigt\2026-10\ Originale nach Verarbeitung ├─ fehler\ nicht lesbar, mit .fehler.txt └─ xrechnung-leser.log fuer-DMS\ fertige PDF/A-3 ├─ …_123456XX.pdf └─ …_123456XX.json Indexfelder

--ungueltige ORDNER legt PDFs abgelehnter Rechnungen getrennt ab.
--metadaten schreibt Rechnungsnummer, Datum, Rechnungssteller, Leitweg-ID, Beträge und IBAN als JSON neben jede PDF.
--einmal verarbeitet einen Durchgang und endet, für die Windows-Aufgabenplanung.

Eingabeaufforderung

xrechnung-leser.cmd selbsttestXRechnungLeser 1.0.0Java:       C:\…\jdk-17\bin\java.exe (Version 17)Validator:  vorhandenBereit. xrechnung-leser.cmd umwandeln *.xml -a fuer-DMSGÜLTIG        01.01a-INVOICE_ubl.xml -> fuer-DMS\2016-04-04_[Seller-name]_123456XX.pdfNICHT GÜLTIG  wrong-date-with-text-uncefact.xml -> fuer-DMS\[Seller-name]_123456XX.pdf              CII-DT-097: Date time string with format attribute 102 shall be YYYYMMDD.

// 05

Herunterladen und einrichten

Der Einzeiler lädt das Paket, installiert die zwei Python-Abhängigkeiten und führt den Selbsttest aus. Java installiert er nicht selbst, er nennt den passenden Befehl.

1.0.0XRechnungLeser, Stand 14.10.2026

ZIP herunterladen 26,1 MB

SHA-256: 4ff79216c91cc7011f52aa9810b728a8c585466f57d5d16152bf0a9c52eada22

Windows (PowerShell)

irm https://downloads.c3po42.de/xrechnung-leser/install.ps1 | iex

Linux

curl -fsSL https://downloads.c3po42.de/xrechnung-leser/install.sh | bash

SystemWindows 10/11 oder Linux
Python3.10 oder neuer, dazu lxml und pypdf
Java11 oder neuer, getestet mit Temurin 17
Platzrund 35 MB, Rechnungen bleiben auf dem Rechner

Rechtlich maßgeblich bleibt die elektronische Rechnung selbst. Die PDF ist ihre Sichtfassung und enthält sie unverändert.

Benutzerhandbuch · Technische Beschreibung (Markdown) · version.json

// 06

XRechnung-Spezifikation

Die Dokumente der KoSIT, nach denen der XRechnungLeser darstellt und prüft. Unverändert weitergegeben und bytegleich mit dem offiziellen Bundle vom 31.08.2026.

Dokument	Fassung	Umfang	Original
Spezifikation XRechnung 3.0.2SHA-256 2e10f3330e79bcd34a4084f2cb3e40e5011403f5df02eb6ecbfb9a5a70658220	20.06.2024	129 S. · 5,1 MB	xeinkauf.de
Syntax Binding UBL 2.1, Extension XRechnungSHA-256 316f2eee57d6134c0a846633b226e2c9e5a26ca655a5cd39accd9d252f1a2b15	20.06.2024	10 S. · 129 KB	xeinkauf.de
English Summary XRechnung 3.0.2SHA-256 09bb943f972d7d01048fcf8b899ab4a5544dacad30c5e92e35d66a850df26931	20.06.2024	16 S. · 472 KB	xeinkauf.de

Gültigkeit

XRechnung 3.0

In Kraft seit 01.02.2024, laut KoSIT mindestens bis 31.07.2027. Die im September 2026 veröffentlichte Vorversion 4.0 ist nicht für den produktiven Einsatz bestimmt, die endgültige Fassung ist für Frühjahr 2027 angekündigt.

Bundle

Technische Bestandteile

Schematron 2.6.0, Validator-Konfiguration, Visualisierung und Testsuite im Stand vom 31.08.2026 stellt die KoSIT als Bundle bereit (rund 60 MB): Bundle bei der KoSIT.

Norm

EN 16931

Das Datenmodell EN 16931-1 und die Syntaxliste CEN/TS 16931-2 gibt es unentgeltlich über das DIN. Die Urheberrechte liegen beim CEN, deshalb hier nur der Weg dorthin: Bezug der Norm (EU-Kommission).

Lizenz

Weitergabe

„Die Vervielfältigung ist durch die Genehmigung von CEN und DIN als urheberrechtstragende Institutionen gestattet.“ (Spezifikation XRechnung 3.0.2, S. 3). Herausgeber: Koordinierungsstelle für IT-Standards (KoSIT), xeinkauf.de.

// 07

Bausteine

Darstellung und Prüfung stammen aus den Referenzwerkzeugen der KoSIT. Alle Bausteine liegen im Paket, nichts wird zur Laufzeit nachgeladen.

KoSIT XRechnung-VisualisierungDarstellung, Stand 2026-08-31 für XRechnung 3.0.2Apache 2.0
KoSIT-ValidatorVersion 1.6.3 mit Konfiguration XRechnung 3.0.2Apache 2.0
Saxon-HEVersion 12.8, XSLT 2.0/3.0MPL 2.0
Apache FOPVersion 2.10, PDF/A-3bApache 2.0
Source Serif ProSchrift der Sichtfassung, in jede PDF eingebettetOFL 1.1

Aus der XRechnung wird eine lesbare PDF/A-3.

Übersicht