{"id":320759,"date":"2026-01-26T15:20:28","date_gmt":"2026-01-26T14:20:28","guid":{"rendered":"https:\/\/borncity.com\/blog\/?p=320759"},"modified":"2026-03-04T12:14:56","modified_gmt":"2026-03-04T11:14:56","slug":"opensource-loesung-fakturama-meine-loesung-im-hands-on-teil-3b","status":"publish","type":"post","link":"https:\/\/borncity.com\/blog\/2026\/01\/26\/opensource-loesung-fakturama-meine-loesung-im-hands-on-teil-3b\/","title":{"rendered":"OpenSource ZUGFeRD-L\u00f6sung Fakturama im Hands-on \u2013 Teil 3b"},"content":{"rendered":"

\"Paragraph\"In Teil 1<\/a> habe ich mich mit der elektronischen Rechnung als ZUGFeRD und XRechnung befasst und in Teil 2<\/a> habe ich einen Abriss m\u00f6glicher L\u00f6sungen zur Erzeugung und Anzeige solcher Rechnungen gegeben. In Teil 3a<\/a> wurde die von mir gew\u00e4hlte OpenSource-L\u00f6sung Fakturama im \"hands on\" vor gestellt. In Teil 3b gehe ich auf den letzten Teil der Konfigurierung ein und zeige auf, wo es leider immer noch hapert.<\/p>\n

<\/p>\n

Erste Einrichtungsschritte – so geht's schneller<\/h2>\n

\"\"Nach der Erstinstallation, die bei mir unter Windows 10, mit bereits installiertem Amazon Corretto (JAVA) und LibreOffice, problemlos ablief, bin ich aber erst einmal \"gegen die Wand gelaufen\", da ich vor lauter B\u00e4umen den Wald nicht mehr gesehen habe. In einer VM lief Fakturama zwar, aber die \"Rechnungen\" wurden als Mini-Icon angezeigt. Auf dem sp\u00e4teren Windows 10-Produktiv-System hatte ich pl\u00f6tzlich Brutto-Preise f\u00fcr Lieferungen einzugeben und ansonsten bin ich auch heftig in Probleme gelaufen. Nach ca. einem Tag Einarbeitung glaube ich, die gr\u00f6\u00dften H\u00fcrden genommen zu haben. Daher hier mein \"Waschzettel\" mit Anmerkungen, was ich h\u00e4tte vorher wissen sollen.<\/p>\n

Zuerst Einstellungen f\u00fcr LibreOffice, XRechnung etc. vornehmen<\/h3>\n

Als erstes empfehle ich, in Fakturama unter Datei – Einstellungen<\/em> das betreffende Einstellungsfenster aufzurufen. Unter\u00a0Dokumente\u00a0<\/em>findet sich eine Option, wo man Netto-Werte f\u00fcr Preise in Artikellisten<\/em> vorgeben kann (Standard war bei mir auf Brutto eingestellt).<\/p>\n

\"Fakturama<\/a><\/p>\n

Dann sollte unter Office-Integration der Pfad f\u00fcr die Integration von LibreOffice kontrolliert werden. Nachfolgender Screenshot zeigt, dass der Standardwert auf ein falsches Verzeichnis verweist – das musste ich korrigieren.<\/p>\n

\"Faktuara
\nOhne g\u00fcltige Faktuara LibreOffice-Integration klappt sp\u00e4ter das Drucken nicht – da habe ich einige Zeit mit Fehlersuche zugebracht, da die Druckfunktion nur einen Fehler auf fehlendes Office lieferte.<\/p>\n

Anpassen der ZUGFeRD-Einstellungen<\/h3>\n

Eine weitere Falle war f\u00fcr mich auch, dass ich mit den ZUGFeRD-Einstellungen herum experimentiert hatte, weil das Drucken nicht klappen wollte, sondern mit einer Export- oder Druckfehlermeldung abbrach.<\/p>\n

\"Fakturama<\/p>\n

Obiger Screenshot zeigt meine Einstellungen, die ich inzwischen verwende. Sollte eine g\u00fcltige ZUGFeRD-Rechnung mit XML-Anteil erzeugen.<\/p>\n

Wenn es Druckfehler beim Export gibt<\/h3>\n

Es gibt noch ein nerviges Problem in Fakturama, weil der Druck von ZUGFeRD-Rechnungen per LibreOffice-Writer passiert. Immer, wenn ich im Writer die Vorlage f\u00fcr die f\u00fcr mich angepasste Rechnung ge\u00e4ndert habe, scheiterte der Rechnungsdruck im Anschluss (es kommt nur ein Dialogfeld mit einem Hinweis auf einen Exportfehler).<\/p>\n

Gem\u00e4\u00df diesem Forenthread<\/a> und dem folgenden Hinweise auf Seite 60 im Faktorama-Handbuch, muss im LibreOffice die Erstellung von PDF\/A dauerhaft aktiviert werden, um ein g\u00fcltiges PDF zu erzeugen. Dies erreicht man, indem einmalig eine beliebige Writer-Datei ins PDF-Format konvertiert wird. Dabei ist in den Einstellungen anzugeben, dass PDF\/A zu erstellen ist.<\/p>\n

\"LibreOffice<\/p>\n

Ich rufe dann im LibreOffice Writer im Men\u00fc\u00a0Datei<\/em> den Befehl Exportieren als – Als PDF exportieren\u00a0<\/em>auf. Dann kann ich die in obigem Screenshot unter \"Allgemein\", \"Archiv (PDF\/A …\" angegebene PDF\/a-3b w\u00e4hlen und auf\u00a0Exportieren<\/em> klicken. Danach funktionierte bei mir der Rechnungsdruck.<\/p>\n

Anlegen Mehrwertsteuer, Debitoren, Waren, Rechnungen<\/h3>\n

Bevor man loslegen und Rechnungen drucken kann, sollte man in Fakturama im Fenster Eintr\u00e4ge f\u00fcr Steuers\u00e4tze, Debitoren (also Kunden), Kontakte und m\u00f6glichst Produkte anlegen. Das ist gem\u00e4\u00df nachfolgendem Fenster \u00fcber die Eintr\u00e4ge der Symbolleiste oder \u00fcber die linke Seitenleiste m\u00f6glich.<\/p>\n

<\/p>\n

Hier bin ich derzeit noch am Lernen, wie das alles bestm\u00f6glich funktioniert – manches ist halt \"a bisserl sperrig\" (z.B. keine Pull-Down-Auswahllisten, keine Kontextmen\u00fcs etc.).<\/p>\n

Anpassen der Vorlage(n)<\/h3>\n

Fakturama wird mit einem Satz an LibreOffice .ott-Vorlagen f\u00fcr Angebote, Rechnungen etc. ausgeliefert. Diese m\u00fcssen an die eigenen Bed\u00fcrfnisse und Vorstellungen angepasst werden. Ich habe mir die Fakturama-Ordner auf eine separate Partition legen lassen. Die Dokumentdateien wie Rechnungen etc. finden sich im Unterordner<\/p>\n

Fakturama<\/em>\/Dokumente<\/em><\/p>\n

wobei dort der Unterordner ODT<\/em>\u00a0 f\u00fcr die Writer-Dokumente und PDF<\/em> f\u00fcr die PDF-Ausgaben stehen. Darunter findet sich ein Unterordner f\u00fcr das Jahr (z.B. 2026) mit weiteren Unterordnern f\u00fcr Rechnungen, Angebote etc.<\/p>\n

\"Fakturama<\/p>\n

Die Vorlagen finden sich im Ordner\u00a0Vorlagen<\/em>, wobei der Ordner\u00a0Rechnung\u00a0<\/em>f\u00fcr die Rechnungserstellung interessiert (siehe obige Abbildung). Die Datei\u00a0Document.ott\u00a0<\/em>ist die Fakturama-Vorlage, ich habe mir Kopien davon im Ordner erstellt und diese dann benannt. Diese Namen werden mir beim Rechnungsdruck zur Auswahl angeboten (mit nur einer Datei habe ich die Situation, dass sich beim Drucke oft nichts tut).<\/p>\n

\"Fakturama<\/a><\/p>\n

Obiger Screenshot zeigt die urspr\u00fcngliche Rechnungsvorlage .ott, die ich dann f\u00fcr meine Zwecke angepasst habe. Die Felder im Writer-Dokument sollte man nur anfassen, wenn man wei\u00df, was man tut. \u00dcber diese Felder wird sp\u00e4ter das Dokument mit Inhalten gef\u00fcllt und die XML-Datei im ZUGFeRD-Dokument erzeugt.<\/p>\n

Hier h\u00e4lt die Vorlage von Fakturama in meinen Augen noch eine Falle bereit. Ich hatte in Fakturama eine Rechnung mit Netto-, MwST- und Brutto-Betr\u00e4gen, die auch stimmig war, angelegt, und bekam eine wunderbare ZUGFeRD-Rechnung als PDF. Aber dann sah ich, dass im PDF nur der Bruttobetrag und die enthaltene Mehrwertsteuer angezeigt wurde. Zwar korrekt, aber meine Kunden erwarten Netto-Betr\u00e4ge, Netto-Summe, Mehrwertsteuer und dann den Brutto-Wert.<\/p>\n

Eine schnelle Internetsuche half mit in der Fakturama-Community weiter – hier<\/a> steht\u00a0 \"Dann mu\u00dft Du die Platzhalter in der Vorlage entsprechend anpassen. Steht auch im Handbuch (NET statt GROSS).\" Genau so ist es, die Felder:<\/p>\n

<DOCUMENT.ITEMS.GROSS><\/p>\n

in der Rechnung m\u00fcssen in:<\/p>\n

<DOCUMENT.ITEMS.NET><\/p>\n

ge\u00e4ndert werden. Danach wurden mir die Rechnungsdaten auch im PDF-Teil der ZUGFeRD-Rechnung so ausgewiesen, wie ich sie erwartete habe. Alles weitere ist dem Fakturama-Handbuch<\/a> zu entnehmen oder findet sich in Antworten in der Fakturama-Community<\/a>.<\/p>\n

Im Nachgang habe ich noch diesen Beitrag<\/a> gefunden, in dem jemand einen schnellen Einstieg in Fakturama skizziert.<\/p><\/blockquote>\n

Fakturama scheitert bei ZUGFeRD<\/h2>\n

Erg\u00e4nzung:<\/strong> Nach einigen Tagen intensiver Nutzung bin ich zum betr\u00fcblichen Schluss gekommen, dass Fakturama aktuell (Ende Januar 2026) leider nicht f\u00fcr ZUGFeRD-Rechnungen verwendbar zu sein scheint. Es ist irgendwie arg kompliziert – Fakturama l\u00e4uft hier, wie ich das so haben wollte und erzeugt auch Rechnungen im ZUGFeRD-Format. Soweit so gut – ich war zufrieden.<\/p>\n

Zur Sicherheit habe ich dann diese Rechnung noch, wie in L\u00f6sungen zum Empfang und Erzeugen von ZUgFeRD-Rechnungen<\/a> \u2013 Teil 2 erw\u00e4hnt im Quba-Viewer sowie OpenIndex ZUGFeRD-Manager validieren lassen. Mir wurde gemeldet, dass da alles in Ordnung sei.<\/p>\n

Leider meldete sich ein Kunde am Ende des Tages mit dem Hinweis, dass meine ZUGFeRD-Rechnung nicht validierbar sei und von deren System abgewiesen werde. Ich habe einige Tests durchgef\u00fchrt, und auch den XML-Teil abgetrennt, um diesen beim s\u00a0E-Rechnungs-Validator-Portal<\/a> von Baden-W\u00fcrttemberg pr\u00fcfen zu lassen. Es gab zwar Warnungen, aber die Annahme wurde dort empfohlen.<\/p>\n

Am Ende des Tages habe ich dann die Validierung auf\u00a0ecosio.com<\/a> vornehmen lassen (die sagen zu, dass die Rechnungen nicht im persistenten Speicher gespeichert und nach der Validierung sofort verworfen werden). Die Validierung ist kostenlos und die Seite bietet ausf\u00fchrliche Validierungsoptionen. Ich habe die automatische ZUGFeRD-Validierung als Option gew\u00e4hlt, bekam aber immer Validierungsfehler angezeigt – die XML-Struktur ist valide, aber die Inhalte entsprechen nicht den Vorgaben.<\/p>\n

Ich habe einige Tests durchgef\u00fchrt – derzeit entsprechen bestimmte Werte (Entities) in den XML-Elementen von x-faktur.xml nicht den erwarteten Vorgaben. Am Ende des Tages habe ich dann noch auf die Schnelle eine E-Rechnung im ZUGFeRD-Format vom OpenIndex ZUGFeRD-Manager erstellen lassen. Auch diese lie\u00df sich nicht validieren, sondern es wurden Warnungen ausgegeben.<\/p>\n

Mir blieb nichts anderes \u00fcbrig,\u00a0mir dann auf die Schnelle eine E-Rechnung f\u00fcr den Kunden mittels PDF24 generieren zu lassen. Diese ZUGFeRD-Rechnung wurde zumindest bei der Validierung auf\u00a0ecosio.com<\/a> als korrekt ausgewiesen. Jetzt muss ich schauen, ob das System des Kunden die E-Rechnung auch akzeptiert. Ich werde (Stand 2. Februar 2026) weitere L\u00f6sungen testen und auch mal mit den Fakturama-Entwicklern Kontakt aufnehmen. Da ist angedacht, die ZUGFeRD-Geschichte in der Version 2.2 von Fakturama anzugehen – was ich in der Beta, die ich zum Test installiert hatte, aber nicht best\u00e4tigen kann (da gibt es noch die gleichen Validierungsfehler).<\/p>\n

Artikelreihe<\/strong>
\nZUGFeRD und XRechnung: Bestandsaufnahme und \u00dcberblick<\/a>\u00a0\u2013 Teil 1
\nL\u00f6sungen zum Empfang und Erzeugen von ZUgFeRD-Rechnungen<\/a>\u00a0\u2013 Teil 2
\nOpenSource ZUGFeRD-L\u00f6sung Fakturama im Hands-on<\/a> \u2013 Teil 3a
\nOpenSource ZUGFeRD-L\u00f6sung Fakturama im Hands-on<\/a> \u2013 Teil 3b
\nMeine Pleite mit ZUGFeRD-eRechnungen und der Validierung<\/a>\u00a0\u2013 Teil 4
\nRechnung-Fertig, eine L\u00f6sung f\u00fcr eRechnung (ZUGFeRD und XRechnung)<\/a>\u00a0\u2013 Teil 5<\/p>\n","protected":false},"excerpt":{"rendered":"

In Teil 1 habe ich mich mit der elektronischen Rechnung als ZUGFeRD und XRechnung befasst und in Teil 2 habe ich einen Abriss m\u00f6glicher L\u00f6sungen zur Erzeugung und Anzeige solcher Rechnungen gegeben. In Teil 3a wurde die von mir gew\u00e4hlte … Weiterlesen →<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[7459],"tags":[15523,3836,15520],"class_list":["post-320759","post","type-post","status-publish","format-standard","hentry","category-software","tag-fakturama","tag-software","tag-zugferd"],"_links":{"self":[{"href":"https:\/\/borncity.com\/blog\/wp-json\/wp\/v2\/posts\/320759","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/borncity.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/borncity.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/borncity.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/borncity.com\/blog\/wp-json\/wp\/v2\/comments?post=320759"}],"version-history":[{"count":10,"href":"https:\/\/borncity.com\/blog\/wp-json\/wp\/v2\/posts\/320759\/revisions"}],"predecessor-version":[{"id":322179,"href":"https:\/\/borncity.com\/blog\/wp-json\/wp\/v2\/posts\/320759\/revisions\/322179"}],"wp:attachment":[{"href":"https:\/\/borncity.com\/blog\/wp-json\/wp\/v2\/media?parent=320759"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/borncity.com\/blog\/wp-json\/wp\/v2\/categories?post=320759"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/borncity.com\/blog\/wp-json\/wp\/v2\/tags?post=320759"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}