UltimateInvoice v24.0

📌 Modulversion: 24.0.2 📅 Letzte Aktualisierung: 28.07.2026 👤 Herausgeber/Lizenz: Philippe GRAND / Atoo-Net / GNU GPL v3+ 🌍 Sprachen der Benutzeroberfläche: 📧 Support: per E-Mail an contact@atoo-net.com ✅ Dolibarr-Kompatibilität: Dolibarr 23.0 und 24.0 ✅ Erforderliches Modul: Rechnungen ✅ Erforderliche PHP-Version: PHP 7.4 oder höher 💡 Kostenlose Updates für ein Jahr innerhalb derselben Version, danach 50 % Rabatt auf die Folgeversion.

Geben Sie Ihren Dolibarr-Rechnungen das Aussehen Ihres Unternehmens mit UltimateInvoice

Das Modul UltimateInvoice ersetzt die native PDF-Dokumentvorlage von Dolibarr für Rechnungen durch eine vollständig anpassbare Vorlage mit dem Namen ultimate_invoice.

Als echtes Schweizer Taschenmesser der PDF-Rechnung erlaubt es, Ihr Erscheinungsbild festzulegen (Logo, Farben, Ränder, Seitenhintergrund, Spaltenbreiten), genau zu bestimmen, was auf dem Dokument erscheint, Ihre AGB oder weitere PDF-Dateien anzuhängen, Barcodes und QR-Codes hinzuzufügen und die erzeugte Datei digital zu signieren.

Es ist keine Zeile Code erforderlich: Alles wird über die Konfigurationsseiten des Moduls eingestellt, mit grafischen Vorschauen und Anfassern zum Ändern der Breiten per Maus.

UltimateInvoice ist die abgespeckte Version des Moduls UltimatePDF: Es deckt ausschließlich Rechnungen ab. Für Angebote, Bestellungen, Verträge, Lieferungen, Spesenabrechnungen, Interventionen, Projekte, Produkte/Stücklisten oder Lieferantendokumente wird die Vollversion UltimatePDF benötigt.

🎨 Was Sie anpassen können

🧩 Zwei Konfigurationsebenen, die nicht zu verwechseln sind

Das Modul beruht auf zwei getrennten Begriffen:

1. Das Design (Reiter Models) legt fest, wie das Dokument aussieht: Farben, Ränder, Logo, Firmenalias, Seitenhintergrund, Spaltenbreiten.

2. Die Seiten Optionen und Rechnungen entscheiden, was auf dem Dokument erscheint: sichtbare Spalten, Adressblöcke, Pflichtangaben, gedruckte Unterschriften.

Mehrere Designs können nebeneinander bestehen. Nur eines ist standardmäßig aktiv, und über eine Auswahl oben rechts in der Anwendung lässt sich sofort zwischen ihnen wechseln, ohne den Weg über die Konfiguration.

Jeder Block des Design-Formulars besitzt eine eigene Schaltfläche Speichern: Sie bestätigen Block für Block, ohne Ihre Eingaben in den übrigen Blöcken zu verlieren.

🖌️ Grafische Anpassung (Designs)

• Seitenhintergrund: Hintergrundbild oder Hintergrund-PDF, um bereits gestaltetes Briefpapier zu verwenden, mit Einstellung von Transparenz und Position X/Y.

• Kopfbereich: Höhe und Breite des Logos, zweites Logo für einen Partner oder eine Zertifizierung, Breite des Absenderblocks mit Drag-and-drop-Vorschau und Voreinstellung für Fensterumschläge nach französischer Postnorm.

• Firmenalias: Zeigen Sie eine Firmenbezeichnung, eine Anschrift, ein Stammkapital oder eine Umsatzsteuer-Identifikationsnummer an, die von der tatsächlichen juristischen Einheit abweichen, etwa für eine Handelsmarke oder eine Tochtergesellschaft.

• Ränder und Spalten: Ränder des PDF und Breite jeder Spalte der Positionstabelle (Referenz, Bild, Datum, Typ, Projekt, MwSt., Einzelpreis, Menge, Einheit, Rabatt), per Maus in einer grafischen Vorschau verstellbar.

• Fußzeile: Schriftgröße, für den Freitext reservierte Höhe, Text- und Hintergrundfarben.

• Schriftart: Auswahl der Schriftart des Dokuments, mit DejaVuSans für erweiterte oder kyrillische Zeichensätze.

📄 Inhalt der Rechnung

Die Optionen werden unabhängig voneinander über einfache Kontrollkästchen aktiviert:

• Spalten der Positionen: Nummerierung, Produktfoto, Einzelpreis netto, Rabatt, Einzelpreis nach Rabatt, Menge, Gewicht und Gesamtgewicht, Einheit.

• Adressblöcke: Anschrift des Empfängers, des Kunden und des zuständigen Vertriebsmitarbeiters, Handelsregisterangaben, Umsatzsteuer-Identifikationsnummer, vertikale Stapelung der Kontaktblöcke.

• Layout: Kopfbereich nicht auf jeder Seite wiederholt, Faltmarke, Text neben dem Datum, Papierformat.

• Speziell für Rechnungen: zugehörige Lieferungen, Zahlungsbedingungen, Teilrechnung nach Baufortschritt, Link zur Online-Zahlung, offener Kundensaldo, Betrag in Worten, Bruttosummenzeile, Erzeugung ohne MwSt.-Spalte.

• Gedruckte Unterschriften: Unterschrift des Verantwortlichen auf dem Dokument und Unterschrift des zuständigen Vertriebsmitarbeiters in der Notiz. Es handelt sich um Bilder, die dem PDF hinzugefügt werden, nicht zu verwechseln mit der weiter unten beschriebenen kryptografischen Signatur.

📎 Zusammenführen von PDF-Dateien und AGB

🔏 Elektronische Signatur der Rechnungen (PAdES)

UltimateInvoice kann das PDF bei seiner Erzeugung digital signieren. Die Signatur belegt dem Empfänger die Echtheit des Dokuments (es stammt tatsächlich von Ihnen) und seine Unversehrtheit (es wurde seitdem nicht verändert). Adobe Acrobat Reader zeigt sie im Bereich Signaturen an, und auf der letzten Seite wird unten rechts ein sichtbares Signaturfeld gezeichnet.

Diese Funktion wird hier bewusst eindeutig beschrieben, damit ihr Umfang vor dem Kauf klar ist:

Akzeptierte Zertifikatsformate: .pem, .crt, .p12, .pfx. Die Datei muss das Zertifikat und den privaten Schlüssel enthalten. Sie wird im Dokumentenverzeichnis von Dolibarr abgelegt, außerhalb des Webordners des Moduls: Über einen Browser ist sie damit nicht herunterladbar.

Wichtige Einschränkung: Das Zusammenführen zusätzlicher Dateien schreibt das PDF nach seiner Erzeugung neu und würde die Signatur zerstören. Bei einer Rechnung, in die Dateien eingefügt werden, wird die Signatur daher automatisch übersprungen und ein Hinweis in das Dolibarr-Protokoll geschrieben, statt eine ungültige Signatur zu erzeugen. Das Anhängen der AGB bleibt hingegen kompatibel.

🔎 Barcodes, QR-Codes und Schweizer QR-Rechnung

• Produkt-Barcodes (EAN13 mit Prüfziffer, CODE128, CODE39) und Barcodes von Geschäftspartnern, am oberen oder unteren Seitenrand.

• QR-Codes für das eigene Unternehmen, für Geschäftspartner oder für die Rechnung.

• SEPA-Zahlungs-QR-Code (Norm EPC069-12) und Schweizer QR-Rechnung (Swiss QR-bill), einschließlich des vollständigen Zahlteils auf einer eigenen Seite.

Diese beiden letzten Einstellungen gehören zum Kern von Dolibarr (Start → Einstellungen → PDF → Reiter Spezifische Parameter, Abschnitt Rechnungen) und nicht zum Modul, das sie bei der Erzeugung lediglich berücksichtigt.

Für den vollständigen Schweizer Zahlteil muss die Zahlungsart die Banküberweisung sein, auf der Rechnung muss ein Bankkonto hinterlegt sein, die Anschrift Ihres Unternehmens muss vollständig und die IBAN gültig sein. QR-IBAN werden noch nicht unterstützt. Diese eigene Seite setzt PHP 8.1 oder höher voraus.

🧱 Kompatibilität mit dem Modul Milestone

UltimateInvoice erkennt die Meilensteinzeilen des Moduls Milestone: Sie werden bei der Berechnung des Zeilengewichts und des Einzelpreises nach Rabatt nicht wie gewöhnliche Produktzeilen behandelt und behalten im PDF ihre eigene Formatierung.

📖 Integriertes Benutzerhandbuch

Ein vollständiges Handbuch auf Französisch und Englisch lässt sich direkt aus der Konfiguration des Moduls heraus aufrufen, Reiter User guide.

Es beschreibt jede Option Bildschirm für Bildschirm, mit einem durchgehenden roten Faden von Anfang bis Ende: Anlegen eines Designs, Einstellen der Optionen, Erzeugen einer Rechnung. Es wird mit jeder Version aktualisiert.

⚙️ Voraussetzungen

⚙️ Installation

1. Laden Sie die Archivdatei des Moduls (.zip) herunter.

2. Legen Sie die Datei im Stammverzeichnis von Dolibarr ab.

3. Entpacken Sie das Archiv und prüfen Sie, dass sich das Modul in htdocs/custom/ultimateinvoice befindet.

4. Aktivieren Sie das Modul über Start → Einstellungen → Module/Anwendungen, Reiter Atoo-Net.

5. Wählen Sie die Vorlage ultimate_invoice in der Auswahlliste Dokumentvorlage der Rechnungsmaske aus.

🧭 Typische Anwendungsfälle

• Rechnungen an Ihr Erscheinungsbild anpassen: vorhandene Farben, Logos und Briefpapier übernehmen, ohne eine PDF-Vorlage entwickeln zu lassen.

• Unter einer Handelsmarke fakturieren: über den Firmenalias eine andere Firmenbezeichnung oder Anschrift als die der juristischen Einheit anzeigen.

• Rechnungen per Post versenden: die Voreinstellung für Fensterumschläge und die Faltmarke nutzen, ohne manuell ausrichten zu müssen.

• Ihre AGB systematisch beifügen: dasselbe Vertragsdokument automatisch an jede Rechnung anhängen.

• Die Zahlung erleichtern: einen SEPA-Zahlungs-QR-Code hinzufügen oder den Schweizer Zahlteil für Kundschaft in der Schweiz.

• Vertrauen in die Herkunft des Dokuments schaffen: per E-Mail versandte Rechnungen digital signieren, damit der Empfänger prüfen kann, dass sie nicht verändert wurden.

❓ FAQ

• Worin besteht der Unterschied zum Modul UltimatePDF?
  UltimateInvoice ist die abgespeckte Version von UltimatePDF und auf Rechnungen beschränkt. Wenn Sie auch Angebote, Bestellungen, Verträge, Lieferungen, Spesenabrechnungen, Interventionen oder Lieferantendokumente anpassen möchten, ist UltimatePDF die richtige Wahl.

• Verändert das Modul den Kern von Dolibarr?
  Nein. UltimateInvoice fügt eine zusätzliche Dokumentvorlage hinzu und stützt sich auf die Standard-Hooks. Die native PDF-Vorlage bleibt verfügbar: Sie können jederzeit zurückwechseln, indem Sie sie in der Rechnungsmaske erneut auswählen.

• Kann ich mehrere unterschiedliche Layouts haben?
  Ja. Legen Sie so viele Designs an, wie Sie benötigen. Nur eines ist standardmäßig aktiv, und über eine Auswahl oben rechts in der Anwendung wechseln Sie zwischen ihnen.

• Sind technische Kenntnisse erforderlich?
  Nein. Die gesamte Konfiguration erfolgt über die Verwaltungsseiten, mit grafischen Vorschauen. Es muss keine Datei bearbeitet werden.

• Hat die elektronische Signatur rechtliche Beweiskraft?
  Es handelt sich um eine einfache Signatur vom Typ PAdES-B-B: Sie belegt die Unversehrtheit und die Herkunft der Datei, besitzt aber nicht die Beweiskraft einer qualifizierten Signatur nach eIDAS und enthält weder einen qualifizierten Zeitstempel noch eine Langzeitarchivierung.

• Ersetzt die elektronische Signatur ZUGFeRD oder Factur-X?
  Nein. Das sind zwei verschiedene Themen. Die Signatur sichert die Unversehrtheit eines PDF; die elektronische Rechnungsstellung verlangt ein strukturiertes Format (ZUGFeRD, Factur-X, PDF/A-3), das UltimateInvoice nicht erzeugt.

• Wo wird das Kennwort des privaten Schlüssels gespeichert?
  In der Konstantentabelle von Dolibarr (llx_const), und zwar im Klartext, da Dolibarr keinen eigenen Passwortspeicher besitzt. Beschränken Sie den Zugriff auf die Datenbank entsprechend. Die Zertifikatsdatei selbst liegt außerhalb des Webordners des Moduls, bleibt aber für den Webserver lesbar: Vergeben Sie strenge Berechtigungen für dieses Verzeichnis.

• Warum wird meine Rechnung nicht signiert?
  Der häufigste Fall ist das Zusammenführen zusätzlicher Dateien bei dieser Rechnung: Beide Funktionen schließen sich gegenseitig aus, und die Signatur wird bewusst übersprungen, mit einem Hinweis im Dolibarr-Protokoll.

• Stammt der Zahlungs-QR-Code aus dem Modul?
  Der SEPA-QR-Code und die Schweizer QR-Rechnung sind Einstellungen im Kern von Dolibarr, unter Einstellungen → PDF → Spezifische Parameter. UltimateInvoice berücksichtigt sie bei der Erzeugung des Dokuments.

• Ist das Modul mit den Meilensteinen des Moduls Milestone kompatibel?
  Ja. Die Meilensteinzeilen werden erkannt und behalten im PDF ihre eigene Formatierung.

• Werden meine bisherigen Rechnungen verändert?
  Nein. Nur Dokumente, die nach der Auswahl der Vorlage neu erzeugt werden, verwenden das neue Layout. Bereits erstellte PDF-Dateien bleiben unverändert.

Warum UltimateInvoice einsetzen?

• Rechnungen im eigenen Erscheinungsbild erhalten, ohne eine PDF-Vorlage entwickeln zu lassen

• Das Layout über Verwaltungsseiten einstellen, mit Vorschauen und Größenänderung per Maus

• Mehrere Designs anlegen und mit einem Klick zwischen ihnen wechseln

• Vorhandenes Briefpapier als Seitenhintergrund verwenden, als Bild oder als PDF

• Dank Firmenalias unter einer Handelsmarke fakturieren

• Genau festlegen, welche Spalten und Blöcke auf dem Dokument erscheinen

• AGB und weitere PDF-Dateien automatisch beifügen

• Barcodes, QR-Codes, SEPA-QR-Code und Schweizer QR-Rechnung hinzufügen

• Per E-Mail versandte Rechnungen digital signieren

• Die native Vorlage von Dolibarr jederzeit weiter verfügbar halten

⚠️ Wichtiger Hinweis

Wie bei jedem Modul, das das Erscheinungsbild von Geschäftsdokumenten verändert, sollten Sie UltimateInvoice auf einer Testinstanz prüfen, bevor Sie es produktiv einsetzen.

Erstellen Sie vorab eine vollständige Sicherung von:

• Der Dolibarr-Datenbank

• Dem Dokumentenverzeichnis von Dolibarr

Erzeugen Sie nach der Konfiguration eine kurze und eine mehrseitige Rechnung und prüfen Sie Adressblöcke, Summen, Fußzeile und das Ausbleiben leerer Seiten, bevor Sie die Vorlage allgemein einsetzen.

📖 Dokumentation

Die vollständige Dokumentation des Moduls steht im offiziellen Dolibarr-Wiki zur Verfügung:

👉 Dolibarr-Wiki – Modul UltimateInvoice (DE)

Dokumentation in weiteren Sprachen:

👉 Dolibarr-Wiki – Modul UltimateInvoice (FR)

👉 Dolibarr-Wiki – Modul UltimateInvoice (EN)

👉 Dolibarr-Wiki – Modul UltimateInvoice (ES)

👉 Dolibarr-Wiki – Modul UltimateInvoice (IT)

Ein vollständiges Benutzerhandbuch ist außerdem im Modul integriert, im Reiter User guide seiner Konfigurationsseite.

Mehr Module