LuaBill · Dokumentation

Probleme mit LuaBill lösen

Beginnen Sie mit der ersten konkreten Fehlermeldung im Erstellungsprotokoll. Sie erklärt meist mehr als die abschließende Meldung zum Abbruch.

LuaLaTeX kann kein PDF erstellen

Öffnen Sie den Reiter Erstellungsprotokoll und notieren Sie den erhaltenen Arbeitsordner. Lesen Sie pass1.txt und document.log ab der ersten Fehlermeldung. Fehlende .sty-Dateien, Schriften, Formate oder Sprachressourcen können die Kompilierung auch bei installiertem LuaLaTeX abbrechen.

Führen Sie den Assistenten zur Dokumentvorbereitung im Menü Hilfe für Ihr Format erneut aus. Sie können auch die LaTeX-Prüfdatei auf der Downloadseite laden und mit Ihrer TeX-Distribution kompilieren. MiKTeX kann fehlende Pakete bei entsprechender Einstellung nachinstallieren; TeX-Live-Pakete werden über die passende TeX-Live- oder Betriebssystem-Paketverwaltung gepflegt.

  • Die Versionsmeldung LuaHBTeX ist bei LuaLaTeX normal; rufen Sie lualatex auf, statt es durch luahbtex zu ersetzen.
  • Starten Sie LuaBill nach PATH-Änderungen oder der Installation von Dokumentwerkzeugen neu.
  • Hilfe → Komponenten und Installation prüft Werkzeuge erneut und bietet offizielle Downloadlinks.
Komponentenanforderungen und LaTeX-Prüfdatei →

XML- oder ZUGFeRD-Prüfung schlägt fehl

Kontrollieren Sie Dokumentart und Ausgabeformat und lesen Sie die genaue Validierungsmeldung. Häufige Ursachen sind unvollständige strukturierte Adressen, fehlende elektronische Adressen oder Käuferreferenzen, widersprüchliche Umsatzsteuerangaben und unvollständige Anzahlungsdaten.

Korrigieren Sie das Projekt und erstellen Sie die Ausgabe erneut. Ändern Sie nicht nur einen exportierten Betrag von Hand, während PDF oder Projekt unverändert bleiben. Hilfe → E-Rechnungsstandards und Aktualisierungen zeigt installierte Versionen und prüft auf Wunsch offizielle Veröffentlichungen; die lokalen Nachweisdateien nennen die für das Dokument verwendeten Regeln.

Daten und Berichte der XRechnung →ZUGFeRD-Verpackung und Prüfung →

Projekte, Ergebnisse und verschobene Bilder finden

Die .luabill-Datei ist Ihr bearbeitbares Projekt; PDF/XML sind erzeugte Ergebnisse. Der Ausgabeordner ist eine lokale Benutzereinstellung. Nach erfolgreicher Erstellung erreichen Sie die Dateien über PDF öffnen, XML öffnen oder Ausgabeordner öffnen in der Ergebnisanzeige.

Kopieren Sie beim Umzug eines Projekts auf einen anderen Computer auch eigene Unterschrifts- und Stempelbilder und wählen Sie deren neue Speicherorte. Oberflächensprache und Ausgabevorgaben bleiben lokal. Das Öffnen eines unveränderten Dokuments soll keine Warnung vor ungespeicherten Änderungen erzeugen; die Angebotsgültigkeit wird aus den Feldern berechnet, ohne verborgene bearbeitbare Zeilen anzuhängen.

Nennen Sie bei einer Problemmeldung LuaBill-Version, Betriebssystem, Ausgabeformat und die erste relevante Fehlermeldung. Prüfen Sie Protokolle und Beispieldateien vor dem Teilen auf vertrauliche Kunden-, Steuer- und Zahlungsangaben.

Autoren kontaktieren →Versionshinweise prüfen →
← Zurück zur Dokumentation

Vor dem ersten Start

Ist LuaBill auch geschäftlich kostenlos nutzbar?

Ja. Der eigene Code und die Dokumentation von LuaBill stehen unter Apache License 2.0, die nach ihren Bedingungen auch die kommerzielle Nutzung erlaubt. Es gibt kein LuaBill-Abonnement. Fremdkomponenten behalten ihre ursprünglichen Lizenzen.

Muss ich Lua oder LaTeX kennen?

Nein. Die normale Bearbeitung erfolgt im grafischen Formular. LuaLaTeX muss installiert sein; für die strukturierten Eingabefelder müssen Sie jedoch keine LaTeX-Befehle schreiben. Entwickler können Quellcode und Vorlagen anpassen.

Muss ich eine vollständige TeX-Distribution installieren?

Nein. Unter Windows kann der Assistent Basic MiKTeX und die für LuaBill erforderlichen Pakete einrichten. Der Anwendungsdownload bleibt kompakt; fehlende Dokumentwerkzeuge benötigen aber Internet und zusätzliche Downloads. Linux-Distributionspakete können größere Schrift- und Paketsammlungen enthalten. Unter macOS verwendet der Homebrew-Weg BasicTeX mit nötigen Ergänzungen. Geeignete vorhandene TeX-Installationen werden weiterverwendet.

Kann ich LaTeX-Formeln in Geschäftsdokumente einfügen?

Ja. Remarks unterstützt eine begrenzte Auswahl an LaTeX-Befehlen für Hervorhebungen und Formeln, etwa Integrale, Summen und Brüche. Setzen Sie mathematische Ausdrücke zwischen \( ... \) oder \[ ... \]; normaler Text benötigt keine Auszeichnung. Im PDF werden die Formeln gesetzt. In XML-exportierten Hinweisen bleibt der LaTeX-Quelltext einfacher Text und wird beim Empfänger nicht automatisch als Formel dargestellt. Der Einleitungstext erscheint nur im PDF. Beliebige Pakete und Makros werden nicht unterstützt.

Werden meine Kunden- und Rechnungsdaten hochgeladen?

LuaBill erstellt Dokumente lokal und lädt Rechnungen nicht zu einem Erzeugungsdienst hoch. Ein Klick auf In VIES prüfen sendet die USt-IdNr. des Kunden an den VIES-Dienst der Europäischen Kommission. Die Komponenteneinrichtung lädt Programme, Pakete und Schriften herunter. Eine angeforderte oder aktivierte wöchentliche Aktualisierungsprüfung liest öffentliche Versionsangaben, ohne Rechnungs-, Kunden- oder XML-Daten zu übertragen. Den Rechnungsversand steuern Sie selbst.

Wie funktionieren VIES-Prüfung und grünes Häkchen?

Tragen Sie die vollständige EU-USt-IdNr. mit Länderpräfix ein (XI für Nordirland, EL für Griechenland) und klicken Sie im Kundenbereich auf In VIES prüfen. Eine abgeschlossene Antwort erfasst Ergebnis und Datum; speichern Sie das .luabill-Projekt, um sie zu behalten. Eine negative Antwort entfernt das grüne Häkchen. Bei Dienst- oder Verbindungsfehlern bleibt der bisherige Eintrag erhalten. Die gewählte Gültigkeit zählt Kalendertage bezogen auf heute, beim PDF auf den Erstellungstag; das Rechnungsdatum ist dafür unerheblich. Name und Adresse des Kunden werden hier nicht geprüft; die Prüfung bestimmt auch nicht die steuerliche Behandlung des Umsatzes.

Kann ich Kunden außerhalb Deutschlands Rechnungen stellen?

Die aktuelle Version unterstützt Verkäufer mit Sitz in Deutschland und Kunden im Inland, in anderen EU-Ländern und außerhalb der EU. Wählen Sie den tatsächlichen Geschäftsvorgang und das Lieferland; ein ausländischer Kunde allein begründet keine Umsatzsteuerbefreiung.

Kann ich USD, RUB oder CNY verwenden?

Ja. Die Währung wird unabhängig vom Land des Kunden gewählt. LuaBill rechnet keine Wechselkurse um. Der Zahlungs-QR-Code gilt für geeignete EUR/SEPA-Rechnungen; elektronische Geldsummen unterstützen höchstens zwei Nachkommastellen.

Muss ich beim ZUGFeRD-PDF noch eine XML an die E-Mail anhängen?

Im hybriden PDF ist die XML bereits enthalten. Üblicherweise wird dieses PDF als Rechnung versandt; der Empfänger kann weitere Anforderungen haben. Eine XRechnung wird dagegen als XML-Datei übermittelt, nicht nur als PDF-Ansicht.

Wo liegen Projekte und Ergebnisdateien?

Zunächst werden die Ordner Dokumente/LuaBill/Projects und Dokumente/LuaBill/Output vorgeschlagen. Sie können andere Ordner wählen. Der Ausgabeort gehört zu Ihren Benutzereinstellungen auf diesem Computer und wird nicht als fester Pfad in jedem Projekt gespeichert.

Sind alle drei Betriebssysteme gleich weit geprüft?

Für Windows steht ein Installer mit enthaltenem Python und Qt bereit. Linux und macOS werden aus dem Quellcode installiert und sind derzeit Vorschaupakete. Native Installation und grafischer Start müssen auf diesen Betriebssystemen noch verifiziert werden.

Ist LuaBill ein vollständiges Buchhaltungs- oder Steuersystem?

LuaBill konzentriert sich auf die Erstellung von Geschäftsdokumenten. Es ersetzt weder Buchhaltung und Steuerberatung noch ein rechtlich geprüftes Archiv oder die Kontrolle Ihres Rechnungsnummernkreises. Angebote und Bestellungen bleiben PDF-Geschäftsdokumente und werden nicht zu E-Rechnungen.

Was mache ich, wenn die Erstellung fehlschlägt?

Lesen Sie den ersten Compilerfehler im Erstellungsprotokoll oder den Prüfbericht der Rechnung. Unter Hilfe → Dokumenterstellung vorbereiten können Sie Werkzeuge prüfen und ein Beispiel erzeugen. Im Assistenten lassen sich der Protokollordner öffnen und Diagnoseangaben kopieren. Auch der separate LaTeX-Test unten hilft bei fehlenden Paketen oder Schriften.

Muss ich LuaBill vor einer Aktualisierung deinstallieren?

Nein. Schließen Sie LuaBill und installieren Sie die neue Version in denselben Ordner. Unter Linux/macOS verwenden Sie Ihren bisherigen --prefix. Persönliche Projekte, Ergebnisse und Einstellungen bleiben erhalten. Manuelle Programmänderungen separat sichern; bei einem Dateikonflikt stoppt der Unix-Installer.

Warum meldet LuaLaTeX LuaHBTeX?

Die Versionsmeldung „This is LuaHBTeX“ ist normal: LuaLaTeX verwendet diese Engine in TeX Live. Der Aufruf muss weiterhin lualatex heißen; auch texlua benötigt seinen eigenen Aufrufnamen. LuaBill ab 0.1.14 erhält diese Verknüpfungen korrekt. Verwenden Sie das aktuelle Paket, statt lualatex durch den direkten Aufruf von luahbtex zu ersetzen.

Wo sehe ich, mit welchen Regeln meine Rechnung geprüft wurde?

Öffnen Sie Hilfe → E-Rechnungsstandards und Aktualisierungen oder die Schaltfläche Versionen der Prüfung beim erzeugten Ergebnis. Die Angaben unterscheiden aktive Regeln von älteren Ressourcen im ursprünglichen Mustang-JAR. Bewahren Sie .validation-info.json und beide XML-Prüfberichte bei der ausgestellten Rechnung auf: Sie dokumentieren Profil, Regelversionen, Prüfsummen und Ergebnisse der einzelnen Prüfschritte.

Sucht LuaBill automatisch nach neuen Rechnungsregeln?

Klicken Sie im Standarddialog auf Nach Aktualisierungen suchen oder aktivieren Sie die optionale wöchentliche Prüfung beim Programmstart. Sie ist zunächst ausgeschaltet. Die Prüfung vergleicht öffentliche technische Veröffentlichungen, überträgt keine Rechnungsdaten und installiert keine Regeln. Ein neuer Stand ist Anlass, eine LuaBill-Aktualisierung zu prüfen; daraus folgen nicht automatisch gesetzliche Fristen oder die Anforderungen Ihres Empfängers.

Warum bleiben nach der Deinstallation Dateien übrig?

LuaBill erhält persönliche Dokumente, Einstellungen sowie geänderte oder unbekannte Dateien absichtlich. Separat installierte Systemwerkzeuge und der heruntergeladene Paketordner bleiben ebenfalls bestehen. Der Bericht nennt Warnungen und verbleibende Pfade. Der Uninstaller des aktuellen Archivs kann eine ältere Installation ohne Neuinstallation entfernen.