Günther Obermaiers Webseite



Rechnungen im ZUGFeRD Standard mit dem Open Source Tool Fakturama 2 unter Linux erstellen

Je nach Umsatz ist man als Unternehmer in Deutschland ab 1.1.2027 oder 1.1.2028 verpflichtet, sogenannte E-Rechnungen zu erstellen. Einen defacto Standart stellt dabei das ZUGFeRD Format dar. Also suchte ich nach einer Open Source Lösung, um derartige Rechungen auf meinem Linux Systemen erstellen zu können.
Bei der Recherche bin ich auf das Open Source Programm Fakturama 2 gestossen ( www.fakturama.info ), das auf meinem Debian 13 / Trixie über JAVA laufen sollte. Bis ich die erste Rechnung im ZUGFeRD Format erstellen konnte, dauerte es ein bischen- Firmendaten, Produkte und Kunden mussten angelegt werden. Dann hatte ich mit dem ZUGFeRD Export über Libre Office zu kämpfen, was ich mit einem Hinweis aus den Weiten des Internets lösen konnte. Der aufwendigste Teil war dann die Anpassung des Rechnungsvordrucks an das Aussehen meiner bisherigen Firmenrechnungen.

Installation Fakturama 2 unter Linux

das aktuelle Debianpaket holte ich unter www.fakturama.info/downloads, in meinem Fall war das die Version 2.2.0, welche ich mit apt install installierte. Da Fakturama JAVA, mindestens in der Version 21 benötigt, installierte ich auch dies, letzteres direkt von Debian. Libre Office muss auf dem Rechner zum Export der PDFs im ZUGFeRD Format ebenfalls installiert sein.
# apt install Installer_Fakturama_linux-amd64_2.2.0.deb
# apt-get install openjdk-21-jre
Die installierte JAVA version kann man mit java -version prüfen. In meinem xfce Windowsmanager erscheint daraufhin Fakturama unter Anwendungen - Büro - Fakturama2. Damit der Export ins PDF wirklich funktioniert, muss man Libre Office starten und ein beliebiges Open Office Textdokument mit "Exportieren als PDF" erzeugen. Im Exportdialog muss "PDF/A-3b" eingestellt sein! Dann kann man Firmendaten, Kunden und Produkte anlegen, was ich als nicht wirklich intuitiv empfand. Anschliessend die Vorlage bearbeiten und als Finale die erste Rechnung erzeugen.
Nun hat man eine Rechnung als PDF, der man aber nicht ansieht, ob sie auch im ZUGFeRD 2 Standard ist und die richtigen XML-Daten enthält.

Prüfung einer ZUGFeRD Rechnung mit Mustang

Da kommt ein weiteres Open Source Tool ins Spiel, der Validator Mustang, den ich direkt in der Kommandozeilenversion benutze, es gibt aber auch Oberflächen oder darauf basierende Validatoren im Internet dafür. Mustang benötigt wie Fakturama JAVA ab Version 21 und kann lokal ein PDF im ZUGFeRD Standard prüfen, ohne dass Daten ins Internet gelangen! Die JAR Datei kann man vom www.mustangproject.org herunterladen, für die im Oktober 2026 aktuelle 2.26.0 ist dies der Downloadlink. Auf der Projektseite findet man Anleitungen zu den weiteren Möglichkeiten von Mustang, ich benutze es lediglich als Validator und um die enthaltenen Daten anzusehen.
Validierung mit:
$ java -jar /PFAD_ZU_MUSTANG/Mustang-CLI-2.26.0.jar --action=validate --source=/PFAD_ZU_FAKTURAMA/Dokumente/PDF/2026/Rechnungen/RE20260001_FIRMA.pdf 
die letzten Zeilen der XML sollten in der Art
     ...
  <summary status="valid"/>
</validation>
sein, ansonsten steht eine aussagekräftige Fehlermeldung in der XML Ausgabe.
XML Daten aus Rechnung extrahieren mit:
$ java -jar /PFAD_ZU_MUSTANG/Mustang-CLI-2.26.0.jar --action=extract --source=/PFAD_ZU_FAKTURAMA/Dokumente/PDF/2026/Rechnungen/RE20260001_FIRMA.pdf 
Dies erzeugt eine XML Datei im aktuellen Verzeichnis, was man natürlich auch auf eine vom Lieferanten geschickte ZUGFeRD Rechnung anwenden kann!