Facturexa Reader

ZUGFeRD-XML lesen und als PDF anzeigen

Der Reader liest eine vorhandene ZUGFeRD-/Factur-X-Rechnung (als reine XML-Datei oder als PDF mit eingebetteter XML) ein, stellt alle Rechnungsfelder als typisiertes .NET-ViewModel bereit und erzeugt daraus eine lesbare PDF-Ansicht der Rechnung – etwa für die Anzeige beim Empfänger oder die Weiterverarbeitung in Ihrer eigenen Anwendung.

Kostenlos – kein Lizenzschlüssel nötig

  • .NET Framework 4.8
  • .NET 8
  • .NET 10
  • ZUGFeRD 2.5.2 / Factur-X 1.09.2
  • XRechnung 3.0 (CII & UBL)
Facturexa.ZugferdReader
dotnet add package Facturexa.ZugferdReader
Install-Package Facturexa.ZugferdReader
1

XML oder PDF als Eingabe

Sowohl eine reine ZUGFeRD-/Factur-X- oder XRechnung-XML (CII oder UBL) als auch eine Rechnungs-PDF mit eingebetteter XML können eingelesen werden – die eingebettete XML wird dabei automatisch extrahiert.

2

Vollständiges ViewModel

ZugferdReader.Read(...) liefert alle Rechnungsfelder – Kopfdaten, Parteien, Positionen, Steuern, Zahlungsinformationen – als einfaches, typisiertes .NET-Objekt für die eigene Weiterverarbeitung.

3

Lesbare PDF-Ansicht

ZugferdReader.CreatePdf(...) rendert aus denselben Daten eine menschenlesbare PDF-Rechnungsansicht (Kopf-, Positions- und Summenblock) – eine reine Sichtansicht, keine PDF/A-3 mit eingebetteter XML.

So einfach ist die Integration

Ein Aufruf genügt, um aus einer ZUGFeRD-XML eine lesbare PDF-Ansicht zu erzeugen. Das folgende Beispiel entspricht dem tatsächlichen Ablauf, den auch die Live-Demo dieser Seite verwendet.

C# – Reader.cs
using Facturexa.ZugferdReader;

// XML (oder PDF mit eingebetteter XML) einlesen - liefert alle Rechnungsfelder als ViewModel.
var rechnung = ZugferdReader.Read(xmlOderPdfStream, fileName: "factur-x.xml");

Console.WriteLine(rechnung.InvoiceNumber);
Console.WriteLine(rechnung.Seller?.Name);
Console.WriteLine(rechnung.GrandTotalAmount);

// Aus demselben ViewModel eine lesbare PDF-Ansicht erzeugen (kein erneutes Parsen noetig).
byte[] pdfBytes = ZugferdReader.CreatePdf(rechnung);

// Oder in einem Schritt direkt aus der Datei:
using var stream2 = File.OpenRead("factur-x.xml");
byte[] pdfBytes2 = ZugferdReader.CreatePdf(stream2, fileName: "factur-x.xml");

Validator und Creator in einer Lizenz

E-Rechnungen prüfen und erzeugen – für eingehende wie ausgehende Rechnungen. Der Reader ist kostenlos.